commit 31e46c5bf6ddaf1f6a2fbaa3bc9a2797209286b6 Author: sjk <2513533895@qq.com> Date: Mon Nov 17 14:09:17 2025 +0800 init diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..21a6fb6 --- /dev/null +++ b/.gitignore @@ -0,0 +1,93 @@ +# 编译文件 +*.exe +*.exe~ +*.dll +*.so +*.dylib +*.test +*.out + +# Go工作区文件 +go.work + +# 依赖目录 +vendor/ + +# 编译输出 +bin/ +dist/ +build/ + + +# 日志文件 +*.log +logs/ +serve/logs/ + +# 数据库文件 +*.db +*.sqlite +*.sqlite3 + +# 临时文件 +*.tmp +*.temp +*.swp +*.swo +*~ + +# IDE和编辑器 +.vscode/ +.idea/ +*.iml +.DS_Store +Thumbs.db + +# 环境变量文件 +.env +.env.local +.env.*.local + +# Python +__pycache__/ +*.py[cod] +*$py.class +*.so +.Python +env/ +venv/ +ENV/ +*.egg-info/ +.pytest_cache/ + +# Node.js +node_modules/ +npm-debug.log* +yarn-debug.log* +yarn-error.log* + +# Flutter/Dart +client/.dart_tool/ +client/.flutter-plugins +client/.flutter-plugins-dependencies +client/.packages +client/build/ +client/pubspec.lock + +# 测试覆盖率 +coverage/ +*.cover +.coverage +htmlcov/ + +# 数据文件（可选） +data/*.xlsx +data/*.csv +!data/README.md + +.windsurf/ + +docs/ +*.zip + +**/build/** \ No newline at end of file diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..c36291c --- /dev/null +++ b/Makefile @@ -0,0 +1,206 @@ +# Makefile for AI English Learning Project + +# 变量定义 +APP_NAME := ai-english-learning +VERSION := $(shell git describe --tags --always --dirty) +BUILD_TIME := $(shell date +%Y-%m-%d_%H:%M:%S) +GO_VERSION := $(shell go version | awk '{print $$3}') +GIT_COMMIT := $(shell git rev-parse HEAD) + +# Go相关变量 +GOCMD := go +GOBUILD := $(GOCMD) build +GOCLEAN := $(GOCMD) clean +GOTEST := $(GOCMD) test +GOGET := $(GOCMD) get +GOMOD := $(GOCMD) mod + +# 构建标志 +LDFLAGS := -ldflags "-X main.Version=$(VERSION) -X main.BuildTime=$(BUILD_TIME) -X main.GitCommit=$(GIT_COMMIT)" + +# 目录 +SERVE_DIR := ./serve +CLIENT_DIR := ./client +DOCS_DIR := ./docs + +.PHONY: help build clean test deps docker-build docker-run docker-stop dev prod lint format check + +# 默认目标 +all: clean deps test build + +# 帮助信息 +help: + @echo "AI English Learning Project Makefile" + @echo "" + @echo "Available targets:" + @echo " build - Build the Go application" + @echo " clean - Clean build artifacts" + @echo " test - Run tests" + @echo " deps - Download dependencies" + @echo " dev - Run in development mode" + @echo " prod - Run in production mode" + @echo " docker-build - Build Docker image" + @echo " docker-run - Run production environment" + @echo " docker-dev - Run development environment" + @echo " docker-stop - Stop all Docker services" + @echo " restart - Restart production environment" + @echo " restart-dev - Restart development environment" + @echo " logs - Show production logs" + @echo " logs-dev - Show development logs" + @echo " lint - Run linter" + @echo " format - Format code" + @echo " check - Run all checks (lint, test, build)" + @echo " migrate - Run database migrations" + @echo " seed - Seed database with test data" + +# 构建应用 +build: + @echo "Building $(APP_NAME)..." + cd $(SERVE_DIR) && $(GOBUILD) $(LDFLAGS) -o $(APP_NAME) . + @echo "Build completed: $(SERVE_DIR)/$(APP_NAME)" + +# 清理构建产物 +clean: + @echo "Cleaning..." + cd $(SERVE_DIR) && $(GOCLEAN) + rm -f $(SERVE_DIR)/$(APP_NAME) + rm -rf $(SERVE_DIR)/logs/* + docker-compose down --volumes --remove-orphans 2>/dev/null || true + docker system prune -f 2>/dev/null || true + +# 下载依赖 +deps: + @echo "Downloading dependencies..." + cd $(SERVE_DIR) && $(GOMOD) download + cd $(SERVE_DIR) && $(GOMOD) tidy + +# 运行测试 +test: + @echo "Running tests..." + cd $(SERVE_DIR) && $(GOTEST) -v ./... + +# 开发模式运行 +dev: deps + @echo "Starting development server..." + cd $(SERVE_DIR) && go run main.go + +# 生产模式运行 +prod: build + @echo "Starting production server..." + cd $(SERVE_DIR) && ./$(APP_NAME) + +# Docker构建 +docker-build: + @echo "Building Docker image..." + docker-compose build ai-english-backend + +# Docker运行（生产环境） +docker-run: + @echo "Starting services with Docker Compose..." + docker-compose up -d + @echo "Services started. Frontend available at http://localhost:80" + @echo "Backend available at http://localhost:8080" + @echo "Use 'make logs' to view logs" + +# Docker运行（开发环境） +docker-dev: + @echo "Starting development environment..." + docker-compose -f docker-compose.dev.yml up -d + @echo "Development environment started!" + @echo "Backend: http://localhost:8080" + @echo "Database Admin: http://localhost:8081" + @echo "Redis Admin: http://localhost:8082" + +# Docker停止 +docker-stop: + @echo "Stopping Docker Compose services..." + docker-compose down + docker-compose -f docker-compose.dev.yml down + +# 代码检查 +lint: + @echo "Running linter..." + cd $(SERVE_DIR) && golangci-lint run ./... || echo "golangci-lint not installed, skipping..." + +# 代码格式化 +format: + @echo "Formatting code..." + cd $(SERVE_DIR) && go fmt ./... + cd $(SERVE_DIR) && goimports -w . 2>/dev/null || echo "goimports not installed, skipping..." + +# 运行所有检查 +check: format lint test build + @echo "All checks passed!" + +# 数据库迁移 +migrate: + @echo "Running database migrations..." + @echo "Please ensure database is running and execute SQL files manually" + @echo "SQL files location: $(DOCS_DIR)/database_schema.sql" + +# 数据库种子数据 +seed: + @echo "Seeding database..." + @echo "Please implement seed data scripts" + +# 查看日志（生产环境） +logs: + @echo "Showing application logs..." + docker-compose logs -f + +# 查看日志（开发环境） +logs-dev: + @echo "Showing development logs..." + docker-compose -f docker-compose.dev.yml logs -f + +# 查看所有服务状态 +status: + @echo "Service status:" + docker-compose ps + +# 重启服务（生产环境） +restart: docker-stop docker-run + +# 重启服务（开发环境） +restart-dev: + @echo "Restarting development environment..." + docker-compose -f docker-compose.dev.yml restart + +# 安装开发工具 +install-tools: + @echo "Installing development tools..." + go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest + go install golang.org/x/tools/cmd/goimports@latest + +# 生成API文档 +docs: + @echo "Generating API documentation..." + @echo "API documentation available in $(DOCS_DIR)/API接口文档.md" + +# 备份数据库 +backup: + @echo "Creating database backup..." + mkdir -p ./backups + docker-compose exec mysql mysqldump -u ai_english -pai_english_password ai_english_learning > ./backups/backup_$(shell date +%Y%m%d_%H%M%S).sql + +# 恢复数据库 +restore: + @echo "To restore database, run:" + @echo "docker-compose exec -T mysql mysql -u ai_english -pai_english_password ai_english_learning < ./backups/your_backup_file.sql" + +# 性能测试 +bench: + @echo "Running benchmarks..." + cd $(SERVE_DIR) && go test -bench=. -benchmem ./... + +# 安全扫描 +security: + @echo "Running security scan..." + cd $(SERVE_DIR) && gosec ./... 2>/dev/null || echo "gosec not installed, skipping..." + +# 版本信息 +version: + @echo "Version: $(VERSION)" + @echo "Build Time: $(BUILD_TIME)" + @echo "Go Version: $(GO_VERSION)" + @echo "Git Commit: $(GIT_COMMIT)" \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..8682dee --- /dev/null +++ b/README.md @@ -0,0 +1,800 @@ +# AI英语学习平台 + +一个基于AI技术的智能英语学习平台，提供个性化的英语学习体验，包括词汇学习、听力训练、阅读理解、写作练习和口语练习等功能。 + +## 🌟 特性 + +- **智能词汇学习**：基于艾宾浩斯遗忘曲线的智能复习系统 +- **听力训练**：多样化的听力材料和智能评估 +- **阅读理解**：分级阅读材料和理解测试 +- **写作练习**：AI智能批改和写作建议 +- **口语练习**：AI对话伙伴和发音评估 +- **学习统计**：详细的学习进度和成绩分析 +- **个性化推荐**：基于学习数据的智能内容推荐 + +## 🏗️ 技术架构 + +### 后端技术栈 +- **语言**：Go 1.19+ +- **框架**：Gin Web Framework +- **数据库**：MySQL 8.0+ +- **缓存**：Redis 7.0+ +- **认证**：JWT Token +- **日志**：Logrus +- **配置**：Viper +- **容器化**：Docker & Docker Compose + +### 前端技术栈 +- **框架**：Flutter +- **状态管理**：Provider/Riverpod +- **网络请求**：Dio +- **本地存储**：SharedPreferences/Hive + +## 📁 项目结构 + +``` +ai_english_learning/ +├── client/ # Flutter前端应用 +│ ├── lib/ +│ │ ├── models/ # 数据模型 +│ │ ├── services/ # 业务服务 +│ │ ├── screens/ # 页面组件 +│ │ ├── widgets/ # 通用组件 +│ │ └── utils/ # 工具类 +│ └── pubspec.yaml +├── serve/ # Go后端服务 +│ ├── api/ # API处理器 +│ ├── internal/ # 内部模块 +│ │ ├── config/ # 配置管理 +│ │ ├── database/ # 数据库操作 +│ │ ├── logger/ # 日志系统 +│ │ ├── middleware/ # 中间件 +│ │ ├── models/ # 数据模型 +│ │ └── services/ # 业务服务 +│ ├── config/ # 配置文件 +│ ├── logs/ # 日志文件 +│ ├── main.go # 应用入口 +│ ├── router.go # 路由配置 +│ ├── Dockerfile # Docker配置 +│ ├── Makefile # 构建脚本 +│ └── start.sh # 启动脚本 +├── docs/ # 项目文档 +│ ├── API接口文档.md +│ ├── 需求文档.md +│ ├── 技术架构文档.md +│ └── database_schema.sql +├── docker-compose.yml # Docker Compose配置 +├── DEPLOYMENT.md # 部署指南 +└── README.md # 项目说明 +``` + +## 🚀 快速开始 + +### 环境要求 + +- Go 1.19+ +- MySQL 8.0+ +- Redis 7.0+ +- Docker & Docker Compose (可选) +- Flutter 3.0+ (前端开发) + +### 使用Docker Compose（推荐） + +1. **克隆项目** +```bash +git clone +cd ai_english_learning +``` + +2. **启动所有服务** +```bash +docker-compose up -d +``` + +3. **查看服务状态** +```bash +docker-compose ps +``` + +4. **访问应用** +- 后端API：http://localhost:8080 +- 健康检查：http://localhost:8080/health +- API文档：查看 `docs/API接口文档.md` + +### 本地开发 + +#### 后端开发 + +1. **进入后端目录** +```bash +cd serve +``` + +2. **安装依赖** +```bash +go mod tidy +``` + +3. **配置数据库** +```bash +# 创建数据库 +mysql -u root -p -e "CREATE DATABASE ai_english_learning CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;" + +# 导入数据库结构 +mysql -u root -p ai_english_learning < ../docs/database_schema.sql +``` + +4. **配置应用** +```bash +# 复制配置文件 +cp config/config.yaml config/config.local.yaml + +# 编辑配置文件，修改数据库连接等信息 +vim config/config.local.yaml +``` + +5. **启动应用** +```bash +# 使用启动脚本（推荐） +./start.sh -d + +# 或者直接运行 +go run . + +# 或者使用Makefile +make dev +``` + +#### 前端开发 + +1. **进入前端目录** +```bash +cd client +``` + +2. **安装依赖** +```bash +flutter pub get +``` + +3. **运行应用** +```bash +flutter run +``` +4. **使用安卓模拟器启动预览** +``` +检查设备 +$ flutter devices +软件加速模式启动模拟器 +$ emulator -avd flutter_emulator -no-accel +使用完整路径来启动模拟器 +$ ANDROID_HOME/emulator/emulator -avd flutter_emulator -no-accel + +等待模拟器启动后，启动服务 +$ flutter run -d emulator-5554 +flutter run -d chrome --web-port=3003 +``` +# 进入前端目录 +cd /home/nanqipro01/gitlocal/YunQue-Tech-Projects/ai_english_learning/client + +# 在模拟器上运行应用 +flutter run -d emulator-5554 + +# 或者让Flutter自动选择设备 +flutter run + + +## 📖 API文档 + +详细的API文档请查看：[API接口文档.md](docs/API接口文档.md) + +### 主要API端点 + +- **认证相关** + - `POST /api/auth/register` - 用户注册 + - `POST /api/auth/login` - 用户登录 + - `POST /api/auth/refresh` - 刷新Token + +- **用户管理** + - `GET /api/users/profile` - 获取用户信息 + - `PUT /api/users/profile` - 更新用户信息 + - `GET /api/users/stats` - 获取学习统计 + +- **词汇学习** + - `GET /api/vocabulary/words` - 获取单词列表 + - `POST /api/vocabulary/learn` - 学习单词 + - `GET /api/vocabulary/review` - 获取复习单词 + +- **健康检查** + - `GET /health` - 综合健康检查 + - `GET /health/liveness` - 存活检查 + - `GET /health/readiness` - 就绪检查 + - `GET /version` - 版本信息 + +## 🔧 配置说明 + +### 环境变量 + +```bash +# 服务器配置 +SERVER_PORT=8080 +SERVER_MODE=release + +# 数据库配置 +DATABASE_HOST=localhost +DATABASE_PORT=3306 +DATABASE_USER=ai_english +DATABASE_PASSWORD=your_password +DATABASE_NAME=ai_english_learning + +# Redis配置 +REDIS_HOST=localhost +REDIS_PORT=6379 +REDIS_PASSWORD= + +# JWT配置 +JWT_SECRET=your-super-secret-jwt-key +JWT_ACCESS_TOKEN_TTL=3600 +JWT_REFRESH_TOKEN_TTL=604800 + +# 应用配置 +APP_ENVIRONMENT=production +LOG_LEVEL=info +``` + +### 配置文件 + +配置文件位于 `serve/config/config.yaml`，支持多环境配置。 + +## 🧪 测试 + +### 运行测试 + +```bash +# 后端测试 +cd serve +make test + +# 前端测试 +cd client +flutter test +``` + +### 性能测试 + +```bash +cd serve +make bench +``` + +## 📦 部署 + +详细的部署指南请查看：[DEPLOYMENT.md](DEPLOYMENT.md) + +### 生产环境部署 + +1. **构建Docker镜像** +```bash +make docker-build +``` + +2. **部署到生产环境** +```bash +docker-compose -f docker-compose.prod.yml up -d +``` + +3. **配置反向代理** +```nginx +server { + listen 80; + server_name your-domain.com; + + location / { + proxy_pass http://localhost:8080; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + } +} +``` + +## 🔍 监控和维护 + +### 日志查看 + +```bash +# 查看应用日志 +tail -f serve/logs/app.log + +# Docker环境日志 +docker-compose logs -f ai-english-backend +``` + +### 健康检查 + +```bash +# 检查服务状态 +curl http://localhost:8080/health + +# 检查版本信息 +curl http://localhost:8080/version +``` + +### 数据库备份 + +```bash +# 备份数据库 +mysqldump -u root -p ai_english_learning > backup_$(date +%Y%m%d_%H%M%S).sql + +# 使用Makefile +make backup +``` + +## 🤝 贡献指南 + +1. Fork 项目 +2. 创建特性分支 (`git checkout -b feature/AmazingFeature`) +3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) +4. 推送到分支 (`git push origin feature/AmazingFeature`) +5. 打开 Pull Request + +### 代码规范 + +- **Go代码**：遵循 `gofmt` 和 `golint` 规范 +- **Flutter代码**：遵循 Dart 官方代码规范 +- **提交信息**：使用语义化提交信息 + +## 📄 许可证 + +本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。 + +## 📞 联系我们 + +- **项目维护者**：[Your Name] +- **邮箱**：[your.email@example.com] +- **问题反馈**：[GitHub Issues](https://github.com/your-username/ai-english-learning/issues) + +## 🙏 致谢 + +感谢所有为这个项目做出贡献的开发者和用户。 + +--- + +**注意**：这是一个学习项目，仅供教育和研究目的使用。 + +## 核心特色 + +### 🤖 AI驱动的个性化学习 +- 基于用户学习数据的智能推荐系统 +- 自适应学习路径规划 +- 个性化学习内容匹配 +- 智能学习进度调整 + +### 📚 全技能覆盖 +- **词汇学习**：科学记忆算法，多维度词汇训练 +- **听力训练**：分级听力材料，智能语音识别 +- **阅读理解**：多样化文章，智能阅读辅助 +- **写作练习**：AI智能批改，实时反馈改进 +- **口语练习**：AI对话伙伴，发音智能评估 + +### 🎯 考试导向支持 +- 四六级英语考试专项训练 +- 托福、雅思考试备考模块 +- 考研英语专业辅导 +- 商务英语实用技能 + +### 📊 数据驱动的学习分析 +- 详细的学习数据统计 +- 多维度能力分析报告 +- 学习进度可视化展示 +- 个性化改进建议 + +## 主要功能模块 + +### 1. 个人主页 +- 学习数据概览（已学单词数、连续打卡天数、平均得分） +- 学习进度可视化（词库进度、技能雷达图） +- 今日学习推荐 +- 个人信息管理 + +### 2. 单词学习模块 +- **分级词库**：从小学到专业级别的完整词汇体系 +- **智能记忆**：基于艾宾浩斯记忆曲线的复习算法 +- **多模式学习**：卡片背诵、测试练习、语境学习 +- **AI助手**：智能例句生成、词汇关联、记忆技巧 + +### 3. 听力训练模块 +- **分级内容**：从日常对话到学术讲座的全覆盖 +- **智能播放**：语速调节、重复播放、字幕控制 +- **多样练习**：理解练习、听写练习、跟读练习 +- **能力分析**：语音识别、语义理解、语速适应能力评估 + +### 4. 阅读理解模块 +- **双模式阅读**：休闲阅读和练习阅读 +- **智能辅助**：即点即译、段落摘要、结构分析 +- **多样题型**：主旨大意、细节理解、推理判断 +- **技能训练**：快速阅读、精读、扫读、略读 + +### 5. 写作练习模块 +- **多种模式**：中译英练习、话题写作 +- **考试专项**：四六级、考研、托福、雅思写作 +- **AI智能批改**：语法检查、词汇评估、表达流畅度分析 +- **写作辅助**：模板库、素材库、例句参考 + +### 6. 口语练习模块 +- **AI对话伙伴**：商务、日常、旅行、学术等专业导师 +- **场景训练**：生活、职场、学术等真实场景对话 +- **智能评估**：发音准确度、流利度、语法正确性 +- **个性化训练**：能力诊断、适应性训练 + +### 7. AI智能助手 +- **个性化推荐**：学习内容和路径智能推荐 +- **智能答疑**：语言问题解答、学习方法指导 +- **学习分析**：行为分析、能力诊断 +- **多模态交互**：文本、语音、视觉交互支持 + +## 技术架构 + +### 前端技术 +- **Flutter**：跨平台移动应用开发 +- 支持iOS、Android、Web、桌面多平台 +- 响应式设计，优秀的用户体验 + +### 后端技术 +- **Go Gin**：高性能API服务 +- **微服务架构**：模块化、可扩展的系统设计 +- **MySQL 8.0**：可靠的关系型数据库 + +### AI技术栈 +- **Hugging Face Transformers**：自然语言处理 +- **PyTorch**：深度学习框架 +- **spaCy**：高级自然语言处理 +- **语音识别与合成**：智能语音处理 + +### 部署与运维 +- **Docker + Docker Compose**：容器化部署 +- **GitHub Actions/Codemagic**：CI/CD自动化 +- **Celery + RabbitMQ/Redis**：异步任务处理 + +## 项目结构 + +### 整体项目结构 + +``` +ai_english_learning/ +├── docs/ # 项目文档 +│ ├── UI界面设计/ # UI设计文件 +│ ├── 详细需求文档.md # 功能需求文档 +│ └── 技术选型.md # 技术架构文档 +├── client/ # 前端代码（Flutter） +├── serve/ # 后端代码（Go） +├── deployment/ # 部署配置 +├── tests/ # 测试代码 +├── docker-compose.yml # Docker编排文件 +└── README.md # 项目说明文档 +``` + +### 前端项目结构（Flutter） + +``` +client/ +├── android/ # Android平台配置 +├── ios/ # iOS平台配置 +├── lib/ # 主要源代码目录 +│ ├── main.dart # 应用入口文件 +│ ├── core/ # 核心功能模块 +│ │ ├── constants/ # 常量定义 +│ │ │ ├── app_constants.dart +│ │ │ ├── api_constants.dart +│ │ │ └── color_constants.dart +│ │ ├── services/ # 核心服务 +│ │ │ ├── api_service.dart # API服务封装 +│ │ │ ├── auth_service.dart # 认证服务 +│ │ │ ├── storage_service.dart # 本地存储 +│ │ │ └── notification_service.dart # 通知服务 +│ │ ├── utils/ # 工具类 +│ │ │ ├── validators.dart # 表单验证 +│ │ │ ├── formatters.dart # 数据格式化 +│ │ │ └── helpers.dart # 辅助函数 +│ │ └── widgets/ # 通用组件 +│ │ ├── custom_button.dart +│ │ ├── custom_text_field.dart +│ │ ├── loading_widget.dart +│ │ └── error_widget.dart +│ ├── features/ # 功能模块 +│ │ ├── auth/ # 认证模块 +│ │ │ ├── models/ # 数据模型 +│ │ │ ├── providers/ # 状态管理 +│ │ │ ├── screens/ # 页面组件 +│ │ │ └── widgets/ # 功能组件 +│ │ ├── home/ # 主页模块 +│ │ ├── vocabulary/ # 词汇学习模块 +│ │ ├── listening/ # 听力训练模块 +│ │ ├── reading/ # 阅读理解模块 +│ │ ├── writing/ # 写作练习模块 +│ │ ├── speaking/ # 口语练习模块 +│ │ ├── profile/ # 个人中心模块 +│ │ └── settings/ # 设置模块 +│ ├── models/ # 全局数据模型 +│ │ ├── user_model.dart +│ │ ├── vocabulary_model.dart +│ │ ├── learning_model.dart +│ │ └── response_model.dart +│ ├── providers/ # 全局状态管理 +│ │ ├── auth_provider.dart +│ │ ├── user_provider.dart +│ │ ├── theme_provider.dart +│ │ └── language_provider.dart +│ ├── routes/ # 路由配置 +│ │ ├── app_routes.dart +│ │ └── route_generator.dart +│ └── themes/ # 主题配置 +│ ├── app_theme.dart +│ ├── light_theme.dart +│ └── dark_theme.dart +├── assets/ # 静态资源 +│ ├── images/ # 图片资源 +│ ├── icons/ # 图标资源 +│ ├── fonts/ # 字体文件 +│ └── audio/ # 音频文件 +├── test/ # 测试文件 +├── pubspec.yaml # 依赖配置文件 +└── analysis_options.yaml # 代码分析配置 +``` + +### 后端项目结构（Go） + +``` +serve/ +├── main.go # 应用入口文件 +├── start.sh # 启动脚本 +├── go.mod # Go模块依赖 +├── go.sum # 依赖校验文件 +├── Dockerfile # Docker构建文件 +├── .dockerignore # Docker忽略文件 +├── config/ # 配置管理 +│ ├── config.go # 配置结构定义 +│ └── config.yaml # 配置文件 +├── api/ # API层 +│ ├── router.go # 路由配置 +│ ├── middleware.go # 中间件配置 +│ └── handlers/ # 请求处理器 +│ ├── auth_handler.go # 认证处理 +│ ├── user_handler.go # 用户管理 +│ ├── vocabulary_handler.go # 词汇功能 +│ ├── listening_handler.go # 听力功能 +│ ├── reading_handler.go # 阅读功能 +│ ├── writing_handler.go # 写作功能 +│ ├── speaking_handler.go # 口语功能 +│ └── health_handler.go # 健康检查 +├── internal/ # 内部模块 +│ ├── common/ # 通用组件 +│ │ ├── errors.go # 错误定义 +│ │ └── response.go # 响应格式 +│ ├── database/ # 数据库层 +│ │ ├── database.go # 数据库连接 +│ │ ├── migrate.go # 数据库迁移 +│ │ └── seed.go # 数据初始化 +│ ├── handler/ # 业务处理器 +│ │ ├── ai_handler.go # AI服务处理 +│ │ └── upload_handler.go # 文件上传处理 +│ ├── logger/ # 日志系统 +│ │ └── logger.go # 日志配置 +│ ├── middleware/ # 中间件 +│ │ ├── auth.go # 认证中间件 +│ │ ├── cors.go # 跨域中间件 +│ │ ├── error_handler.go # 错误处理中间件 +│ │ └── logger.go # 日志中间件 +│ ├── models/ # 数据模型 +│ │ ├── user.go # 用户模型 +│ │ ├── vocabulary.go # 词汇模型 +│ │ ├── learning.go # 学习记录模型 +│ │ └── ai_models.go # AI相关模型 +│ ├── services/ # 业务服务层 +│ │ ├── user_service.go # 用户服务 +│ │ ├── vocabulary_service.go # 词汇服务 +│ │ ├── listening_service.go # 听力服务 +│ │ ├── reading_service.go # 阅读服务 +│ │ ├── writing_service.go # 写作服务 +│ │ ├── speaking_service.go # 口语服务 +│ │ ├── ai_service.go # AI服务 +│ │ └── upload_service.go # 文件上传服务 +│ └── utils/ # 工具函数 +│ └── utils.go # 通用工具 +└── uploads/ # 文件上传目录 + ├── audio/ # 音频文件 + └── images/ # 图片文件 +``` + +### 核心技术架构 + +#### 前端架构特点 +- **模块化设计**：按功能模块组织代码，便于维护和扩展 +- **状态管理**：使用Provider进行全局状态管理 +- **组件复用**：通用组件和功能组件分离，提高代码复用性 +- **主题系统**：支持明暗主题切换，提供良好的用户体验 +- **路由管理**：统一的路由配置和导航管理 +- **响应式设计**：适配不同屏幕尺寸的设备 + +#### 后端架构特点 +- **分层架构**：Handler -> Service -> Model 的清晰分层 +- **中间件系统**：认证、日志、错误处理等中间件 +- **配置管理**：统一的配置文件和环境变量管理 +- **数据库设计**：GORM ORM框架，支持自动迁移和数据初始化 +- **API设计**：RESTful API设计，统一的响应格式 +- **日志系统**：结构化日志，支持不同级别和输出方式 +- **文件管理**：支持音频、图片等多媒体文件上传和管理 + +#### 数据库设计 +- **用户系统**：用户信息、偏好设置、社交链接 +- **词汇系统**：词汇分类、词汇定义、例句、图片 +- **学习记录**：听力、阅读、写作、口语的学习记录和进度 +- **AI服务**：AI相关的配置和使用记录 +- **关系设计**：合理的外键关系和索引优化 + +#### 安全特性 +- **JWT认证**：基于Token的无状态认证 +- **密码加密**：bcrypt加密存储用户密码 +- **CORS配置**：跨域请求安全控制 +- **输入验证**：前后端双重数据验证 +- **错误处理**：统一的错误处理和日志记录 + +## 快速开始 + +### 环境要求 +- Flutter SDK 3.0+ +- Go 1.19+ +- MySQL 8.0+ +- Docker & Docker Compose +- Node.js 16+ (用于部分工具) + +### 安装步骤 + +1. **克隆项目** +```bash +git clone https://github.com/your-org/ai_english_learning.git +cd ai_english_learning +``` + +2. **后端环境设置** +```bash +cd backend +# 初始化Go模块 +go mod init ai_english_learning +go mod tidy +``` + +3. **数据库设置** +```bash +# 启动MySQL数据库 +docker-compose up -d mysql + +# 运行数据库迁移 +go run cmd/migrate/main.go +``` + +4. **前端环境设置** +```bash +cd frontend +flutter pub get +flutter run +``` + +5. **启动开发服务器** +```bash +# 后端API服务 +cd backend +go run main.go + +# AI服务 +celery -A ai_services worker --loglevel=info +``` + +## 开发指南 + +### 代码规范 +- 遵循Go官方代码规范（gofmt, golint） +- 使用Flutter官方代码规范 +- 提交前运行代码格式化和静态检查 + +### 测试 +```bash +# 后端测试 +go test ./... + +# 前端测试 +flutter test +``` + +### 部署 +```bash +# 使用Docker Compose部署 +docker-compose up -d + +# 生产环境部署 +docker-compose -f docker-compose.prod.yml up -d +``` + +## 学习目标用户 + +### 学生群体 +- **小学生**：基础词汇学习，简单对话练习 +- **中学生**：考试备考，技能全面提升 +- **大学生**：四六级备考，学术英语提升 +- **研究生**：考研英语，学术写作训练 + +### 成人学习者 +- **职场人士**：商务英语，职业发展需求 +- **出国留学**：托福雅思备考，留学准备 +- **兴趣学习**：日常英语，文化交流 +- **专业提升**：行业英语，专业技能 + +## 学习效果 + +### 短期效果（1-3个月） +- 词汇量显著增加（500-1500词） +- 听力理解能力明显提升 +- 基础语法掌握更加牢固 +- 口语表达更加自信 + +### 中期效果（3-6个月） +- 阅读速度和理解能力大幅提升 +- 写作表达更加地道和流畅 +- 口语交流基本无障碍 +- 考试成绩显著提高 + +### 长期效果（6个月以上） +- 英语思维逐步建立 +- 能够进行复杂的英语交流 +- 具备独立的英语学习能力 +- 达到目标英语水平 + +## 贡献指南 + +我们欢迎社区贡献！请遵循以下步骤： + +1. Fork 项目仓库 +2. 创建功能分支 (`git checkout -b feature/AmazingFeature`) +3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) +4. 推送到分支 (`git push origin feature/AmazingFeature`) +5. 创建 Pull Request + +### 贡献类型 +- 🐛 Bug修复 +- ✨ 新功能开发 +- 📚 文档改进 +- 🎨 UI/UX优化 +- ⚡ 性能优化 +- 🧪 测试覆盖 + +## 许可证 + +本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。 + +## 联系我们 + +- **项目主页**：https://github.com/your-org/ai_english_learning +- **问题反馈**：https://github.com/your-org/ai_english_learning/issues +- **邮箱联系**：contact@ai-english-learning.com +- **官方网站**：https://www.ai-english-learning.com + +## 更新日志 + +### v1.0.0 (2024-01-01) +- 🎉 项目初始版本发布 +- ✨ 完整的词汇学习模块 +- ✨ 基础的听说读写功能 +- ✨ AI智能助手集成 +- ✨ 用户数据统计分析 + +### 即将发布 +- 🔄 更多AI功能集成 +- 📱 移动端应用优化 +- 🌐 多语言界面支持 +- 🎮 游戏化学习元素 +- 👥 社交学习功能 + +--- + +**让AI助力您的英语学习之旅！** 🚀 + +通过科学的学习方法和先进的AI技术，我们相信每个人都能够高效地掌握英语，实现自己的学习目标。立即开始您的智能英语学习体验吧！ \ No newline at end of file diff --git a/client/.dockerignore b/client/.dockerignore new file mode 100644 index 0000000..4483c22 --- /dev/null +++ b/client/.dockerignore @@ -0,0 +1,73 @@ +# Git相关 +.git +.gitignore + +# Flutter构建产物 +build/ +.dart_tool/ +.flutter-plugins +.flutter-plugins-dependencies +.packages +.pub-cache/ +.pub/ + +# IDE文件 +.vscode/ +.idea/ +*.swp +*.swo +*~ + +# 操作系统文件 +.DS_Store +Thumbs.db + +# 测试文件 +test/ +tests/ +coverage/ + +# 文档 +*.md +README* +DOCS* +docs/ + +# 日志文件 +*.log +logs/ + +# 临时文件 +tmp/ +temp/ +*.tmp +*.temp + +# 环境文件 +.env +.env.local +.env.*.local + +# Android相关 +android/.gradle/ +android/app/build/ +android/build/ +android/gradle/ +android/gradlew +android/gradlew.bat +android/local.properties +android/key.properties + +# iOS相关 +ios/Pods/ +ios/Runner.xcworkspace/xcuserdata/ +ios/Runner.xcodeproj/xcuserdata/ +ios/Flutter/flutter_export_environment.sh + +# Web相关（保留build/web用于生产构建） +# build/web + +# 其他 +*.bak +*.backup +node_modules/ \ No newline at end of file diff --git a/client/.gitignore b/client/.gitignore new file mode 100644 index 0000000..3820a95 --- /dev/null +++ b/client/.gitignore @@ -0,0 +1,45 @@ +# Miscellaneous +*.class +*.log +*.pyc +*.swp +.DS_Store +.atom/ +.build/ +.buildlog/ +.history +.svn/ +.swiftpm/ +migrate_working_dir/ + +# IntelliJ related +*.iml +*.ipr +*.iws +.idea/ + +# The .vscode folder contains launch configuration and tasks you configure in +# VS Code which you may wish to be included in version control, so this line +# is commented out by default. +#.vscode/ + +# Flutter/Dart/Pub related +**/doc/api/ +**/ios/Flutter/.last_build_id +.dart_tool/ +.flutter-plugins-dependencies +.pub-cache/ +.pub/ +/build/ +/coverage/ + +# Symbolication related +app.*.symbols + +# Obfuscation related +app.*.map.json + +# Android Studio will place build artifacts here +/android/app/debug +/android/app/profile +/android/app/release diff --git a/client/.metadata b/client/.metadata new file mode 100644 index 0000000..05a8ab4 --- /dev/null +++ b/client/.metadata @@ -0,0 +1,45 @@ +# This file tracks properties of this Flutter project. +# Used by Flutter tool to assess capabilities and perform upgrades etc. +# +# This file should be version controlled and should not be manually edited. + +version: + revision: "05db9689081f091050f01aed79f04dce0c750154" + channel: "stable" + +project_type: app + +# Tracks metadata for the flutter migrate command +migration: + platforms: + - platform: root + create_revision: 05db9689081f091050f01aed79f04dce0c750154 + base_revision: 05db9689081f091050f01aed79f04dce0c750154 + - platform: android + create_revision: 05db9689081f091050f01aed79f04dce0c750154 + base_revision: 05db9689081f091050f01aed79f04dce0c750154 + - platform: ios + create_revision: 05db9689081f091050f01aed79f04dce0c750154 + base_revision: 05db9689081f091050f01aed79f04dce0c750154 + - platform: linux + create_revision: 05db9689081f091050f01aed79f04dce0c750154 + base_revision: 05db9689081f091050f01aed79f04dce0c750154 + - platform: macos + create_revision: 05db9689081f091050f01aed79f04dce0c750154 + base_revision: 05db9689081f091050f01aed79f04dce0c750154 + - platform: web + create_revision: 05db9689081f091050f01aed79f04dce0c750154 + base_revision: 05db9689081f091050f01aed79f04dce0c750154 + - platform: windows + create_revision: 05db9689081f091050f01aed79f04dce0c750154 + base_revision: 05db9689081f091050f01aed79f04dce0c750154 + + # User provided section + + # List of Local paths (relative to this file) that should be + # ignored by the migrate tool. + # + # Files that are not part of the templates will be ignored by default. + unmanaged_files: + - 'lib/main.dart' + - 'ios/Runner.xcodeproj/project.pbxproj' diff --git a/client/Dockerfile b/client/Dockerfile new file mode 100644 index 0000000..c11a082 --- /dev/null +++ b/client/Dockerfile @@ -0,0 +1,32 @@ +# 使用官方Flutter镜像作为构建环境 +FROM cirrusci/flutter:stable AS build + +# 设置工作目录 +WORKDIR /app + +# 复制pubspec文件 +COPY pubspec.yaml pubspec.lock ./ + +# 获取依赖 +RUN flutter pub get + +# 复制源代码 +COPY . . + +# 构建Web应用 +RUN flutter build web --release + +# 使用nginx作为生产环境 +FROM nginx:alpine + +# 复制构建产物到nginx目录 +COPY --from=build /app/build/web /usr/share/nginx/html + +# 复制nginx配置 +COPY nginx.conf /etc/nginx/nginx.conf + +# 暴露端口 +EXPOSE 80 + +# 启动nginx +CMD ["nginx", "-g", "daemon off;"] \ No newline at end of file diff --git a/client/ENVIRONMENT_CONFIG.md b/client/ENVIRONMENT_CONFIG.md new file mode 100644 index 0000000..55bc832 --- /dev/null +++ b/client/ENVIRONMENT_CONFIG.md @@ -0,0 +1,186 @@ +# 多环境配置说明 + +## 概述 + +前端应用现在支持多环境后端 API 配置，可以在开发、预发布和生产环境之间切换。 + +## 环境类型 + +### 1. 开发环境 (Development) +- **默认 API 地址**: `http://localhost:8080/api/v1` +- **Android 模拟器**: `http://10.0.2.2:8080/api/v1` +- **用途**: 本地开发和测试 + +### 2. 预发布环境 (Staging) +- **默认 API 地址**: `http://your-staging-domain.com/api/v1` +- **用途**: 上线前测试 + +### 3. 生产环境 (Production) +- **默认 API 地址**: `http://your-production-domain.com/api/v1` +- **用途**: 正式上线 + +## 使用方法 + +### 方法一：通过命令行参数设置 + +#### 开发环境 +```bash +flutter run --dart-define=ENVIRONMENT=development +``` + +#### 预发布环境 +```bash +flutter run --dart-define=ENVIRONMENT=staging +``` + +#### 生产环境 +```bash +flutter run --dart-define=ENVIRONMENT=production +``` + +#### 自定义 API 地址 +```bash +flutter run --dart-define=API_BASE_URL=http://192.168.1.100:8080/api/v1 +``` + +### 方法二：通过开发者设置页面（推荐开发环境使用） + +1. 在应用的设置页面找到"开发者设置"选项 +2. 选择目标环境或输入自定义 API 地址 +3. 保存设置并重启应用 + +## 构建配置 + +### Android 构建 + +#### 开发版本 +```bash +flutter build apk --dart-define=ENVIRONMENT=development +``` + +#### 生产版本 +```bash +flutter build apk --dart-define=ENVIRONMENT=production --release +``` + +### iOS 构建 + +#### 开发版本 +```bash +flutter build ios --dart-define=ENVIRONMENT=development +``` + +#### 生产版本 +```bash +flutter build ios --dart-define=ENVIRONMENT=production --release +``` + +### Web 构建 + +#### 开发版本 +```bash +flutter build web --dart-define=ENVIRONMENT=development +``` + +#### 生产版本 +```bash +flutter build web --dart-define=ENVIRONMENT=production --release +``` + +## 配置文件位置 + +环境配置文件位于： +``` +lib/core/config/environment.dart +``` + +## 自定义环境配置 + +如需修改环境配置，编辑 `environment.dart` 文件： + +```dart +static const Map productionConfig = { + 'baseUrl': 'http://your-production-domain.com/api/v1', + 'wsUrl': 'ws://your-production-domain.com/ws', +}; +``` + +## 常见场景 + +### 场景 1: 本地开发（Web） +- **设备**: 开发电脑浏览器 +- **API 地址**: `http://localhost:8080/api/v1` +- **运行命令**: `flutter run -d chrome` + +### 场景 2: Android 模拟器开发 +- **设备**: Android 模拟器 +- **API 地址**: `http://10.0.2.2:8080/api/v1` +- **运行命令**: `flutter run -d android` +- **说明**: 10.0.2.2 是 Android 模拟器访问宿主机 localhost 的特殊地址 + +### 场景 3: 真机调试 +- **设备**: 手机真机 +- **API 地址**: `http://你的电脑IP:8080/api/v1` +- **设置方法**: + 1. 确保手机和电脑在同一局域网 + 2. 查看电脑 IP 地址（如 192.168.1.100） + 3. 在开发者设置中输入: `http://192.168.1.100:8080/api/v1` + 4. 或使用命令: `flutter run --dart-define=API_BASE_URL=http://192.168.1.100:8080/api/v1` + +### 场景 4: 生产环境部署 +- **设备**: 正式用户设备 +- **API 地址**: 生产服务器地址 +- **构建命令**: `flutter build apk --dart-define=ENVIRONMENT=production --release` + +## 环境检测 + +在代码中可以使用以下方法检测当前环境： + +```dart +import 'package:your_app/core/config/environment.dart'; + +// 检查是否为开发环境 +if (EnvironmentConfig.isDevelopment) { + print('当前是开发环境'); +} + +// 检查是否为生产环境 +if (EnvironmentConfig.isProduction) { + print('当前是生产环境'); +} + +// 获取当前 API 地址 +String apiUrl = EnvironmentConfig.baseUrl; +print('API 地址: $apiUrl'); +``` + +## 注意事项 + +1. **重启应用**: 修改环境配置后必须重启应用才能生效 +2. **生产环境**: 生产环境配置应该在构建时通过命令行参数指定，不要在代码中硬编码 +3. **安全性**: 不要在代码中提交敏感信息，如生产环境的真实 API 地址 +4. **测试**: 切换环境后应该进行充分测试，确保 API 连接正常 +5. **网络权限**: Android 需要在 `AndroidManifest.xml` 中添加网络权限 +6. **HTTPS**: 生产环境建议使用 HTTPS 协议 + +## 故障排查 + +### 问题 1: Android 模拟器无法连接 localhost +**解决方案**: 使用 `10.0.2.2` 代替 `localhost` + +### 问题 2: 真机无法连接开发服务器 +**解决方案**: +- 确保手机和电脑在同一网络 +- 检查防火墙设置 +- 使用电脑的局域网 IP 地址 + +### 问题 3: 环境切换后仍然连接旧地址 +**解决方案**: 完全关闭并重启应用 + +### 问题 4: iOS 模拟器无法连接 +**解决方案**: iOS 模拟器可以直接使用 `localhost`，无需特殊配置 + +## 扩展阅读 + +- [Flutter 环境变量配置](https://flutter.dev/docs/development/tools/sdk/overview#environment-variables) +- [Dart 编译时常量](https://dart.dev/guides/language/language-tour#const-keyword) diff --git a/client/README.md b/client/README.md new file mode 100644 index 0000000..2270002 --- /dev/null +++ b/client/README.md @@ -0,0 +1,20 @@ +# client + +A new Flutter project. + +## Getting Started + +This project is a starting point for a Flutter application. + +A few resources to get you started if this is your first Flutter project: + +- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab) +- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook) + +For help getting started with Flutter development, view the +[online documentation](https://docs.flutter.dev/), which offers tutorials, +samples, guidance on mobile development, and a full API reference. + + +flutter build apk --dart-define=ENVIRONMENT=production --release +flutter run -d chrome --web-port=3003 diff --git a/client/analysis_options.yaml b/client/analysis_options.yaml new file mode 100644 index 0000000..0d29021 --- /dev/null +++ b/client/analysis_options.yaml @@ -0,0 +1,28 @@ +# This file configures the analyzer, which statically analyzes Dart code to +# check for errors, warnings, and lints. +# +# The issues identified by the analyzer are surfaced in the UI of Dart-enabled +# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be +# invoked from the command line by running `flutter analyze`. + +# The following line activates a set of recommended lints for Flutter apps, +# packages, and plugins designed to encourage good coding practices. +include: package:flutter_lints/flutter.yaml + +linter: + # The lint rules applied to this project can be customized in the + # section below to disable rules from the `package:flutter_lints/flutter.yaml` + # included above or to enable additional rules. A list of all available lints + # and their documentation is published at https://dart.dev/lints. + # + # Instead of disabling a lint rule for the entire project in the + # section below, it can also be suppressed for a single line of code + # or a specific dart file by using the `// ignore: name_of_lint` and + # `// ignore_for_file: name_of_lint` syntax on the line or in the file + # producing the lint. + rules: + # avoid_print: false # Uncomment to disable the `avoid_print` rule + # prefer_single_quotes: true # Uncomment to enable the `prefer_single_quotes` rule + +# Additional information about this file can be found at +# https://dart.dev/guides/language/analysis-options diff --git a/client/android/.gitignore b/client/android/.gitignore new file mode 100644 index 0000000..be3943c --- /dev/null +++ b/client/android/.gitignore @@ -0,0 +1,14 @@ +gradle-wrapper.jar +/.gradle +/captures/ +/gradlew +/gradlew.bat +/local.properties +GeneratedPluginRegistrant.java +.cxx/ + +# Remember to never publicly share your keystore. +# See https://flutter.dev/to/reference-keystore +key.properties +**/*.keystore +**/*.jks diff --git a/client/android/app/build.gradle.kts b/client/android/app/build.gradle.kts new file mode 100644 index 0000000..666255a --- /dev/null +++ b/client/android/app/build.gradle.kts @@ -0,0 +1,43 @@ +plugins { + id("com.android.application") + id("kotlin-android") + // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins. + id("dev.flutter.flutter-gradle-plugin") +} + +android { + namespace = "com.aienglish.learning" + compileSdk = flutter.compileSdkVersion + ndkVersion = flutter.ndkVersion + + compileOptions { + sourceCompatibility = JavaVersion.VERSION_11 + targetCompatibility = JavaVersion.VERSION_11 + } + + kotlinOptions { + jvmTarget = JavaVersion.VERSION_11.toString() + } + + defaultConfig { + // AI英语学习应用的唯一 Application ID + applicationId = "com.aienglish.learning" + // 支持 Android 5.0 (Lollipop) 及以上版本 + minSdk = flutter.minSdkVersion + targetSdk = flutter.targetSdkVersion + versionCode = flutter.versionCode + versionName = flutter.versionName + } + + buildTypes { + release { + // TODO: Add your own signing config for the release build. + // Signing with the debug keys for now, so `flutter run --release` works. + signingConfig = signingConfigs.getByName("debug") + } + } +} + +flutter { + source = "../.." +} diff --git a/client/android/app/src/debug/AndroidManifest.xml b/client/android/app/src/debug/AndroidManifest.xml new file mode 100644 index 0000000..399f698 --- /dev/null +++ b/client/android/app/src/debug/AndroidManifest.xml @@ -0,0 +1,7 @@ + + + + diff --git a/client/android/app/src/main/AndroidManifest.xml b/client/android/app/src/main/AndroidManifest.xml new file mode 100644 index 0000000..c3ada88 --- /dev/null +++ b/client/android/app/src/main/AndroidManifest.xml @@ -0,0 +1,64 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/client/android/app/src/main/kotlin/com/aienglish/learning/MainActivity.kt b/client/android/app/src/main/kotlin/com/aienglish/learning/MainActivity.kt new file mode 100644 index 0000000..fb6f206 --- /dev/null +++ b/client/android/app/src/main/kotlin/com/aienglish/learning/MainActivity.kt @@ -0,0 +1,5 @@ +package com.aienglish.learning + +import io.flutter.embedding.android.FlutterActivity + +class MainActivity : FlutterActivity() diff --git a/client/android/app/src/main/res/drawable-hdpi/ic_launcher_foreground.png b/client/android/app/src/main/res/drawable-hdpi/ic_launcher_foreground.png new file mode 100644 index 0000000..02576ce Binary files /dev/null and b/client/android/app/src/main/res/drawable-hdpi/ic_launcher_foreground.png differ diff --git a/client/android/app/src/main/res/drawable-mdpi/ic_launcher_foreground.png b/client/android/app/src/main/res/drawable-mdpi/ic_launcher_foreground.png new file mode 100644 index 0000000..898ed79 Binary files /dev/null and b/client/android/app/src/main/res/drawable-mdpi/ic_launcher_foreground.png differ diff --git a/client/android/app/src/main/res/drawable-v21/launch_background.xml b/client/android/app/src/main/res/drawable-v21/launch_background.xml new file mode 100644 index 0000000..f74085f --- /dev/null +++ b/client/android/app/src/main/res/drawable-v21/launch_background.xml @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/client/android/app/src/main/res/drawable-xhdpi/ic_launcher_foreground.png b/client/android/app/src/main/res/drawable-xhdpi/ic_launcher_foreground.png new file mode 100644 index 0000000..b8578cd Binary files /dev/null and b/client/android/app/src/main/res/drawable-xhdpi/ic_launcher_foreground.png differ diff --git a/client/android/app/src/main/res/drawable-xxhdpi/ic_launcher_foreground.png b/client/android/app/src/main/res/drawable-xxhdpi/ic_launcher_foreground.png new file mode 100644 index 0000000..18c735a Binary files /dev/null and b/client/android/app/src/main/res/drawable-xxhdpi/ic_launcher_foreground.png differ diff --git a/client/android/app/src/main/res/drawable-xxxhdpi/ic_launcher_foreground.png b/client/android/app/src/main/res/drawable-xxxhdpi/ic_launcher_foreground.png new file mode 100644 index 0000000..88e2ad7 Binary files /dev/null and b/client/android/app/src/main/res/drawable-xxxhdpi/ic_launcher_foreground.png differ diff --git a/client/android/app/src/main/res/drawable/launch_background.xml b/client/android/app/src/main/res/drawable/launch_background.xml new file mode 100644 index 0000000..304732f --- /dev/null +++ b/client/android/app/src/main/res/drawable/launch_background.xml @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/client/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/client/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml new file mode 100644 index 0000000..5f349f7 --- /dev/null +++ b/client/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml @@ -0,0 +1,5 @@ + + + + + diff --git a/client/android/app/src/main/res/mipmap-hdpi/ic_launcher.png b/client/android/app/src/main/res/mipmap-hdpi/ic_launcher.png new file mode 100644 index 0000000..5bfb65f Binary files /dev/null and b/client/android/app/src/main/res/mipmap-hdpi/ic_launcher.png differ diff --git a/client/android/app/src/main/res/mipmap-mdpi/ic_launcher.png b/client/android/app/src/main/res/mipmap-mdpi/ic_launcher.png new file mode 100644 index 0000000..c290767 Binary files /dev/null and b/client/android/app/src/main/res/mipmap-mdpi/ic_launcher.png differ diff --git a/client/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png b/client/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png new file mode 100644 index 0000000..1995204 Binary files /dev/null and b/client/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png differ diff --git a/client/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png b/client/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png new file mode 100644 index 0000000..4b81ba0 Binary files /dev/null and b/client/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png differ diff --git a/client/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/client/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png new file mode 100644 index 0000000..e8a9a9d Binary files /dev/null and b/client/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png differ diff --git a/client/android/app/src/main/res/values-night/styles.xml b/client/android/app/src/main/res/values-night/styles.xml new file mode 100644 index 0000000..06952be --- /dev/null +++ b/client/android/app/src/main/res/values-night/styles.xml @@ -0,0 +1,18 @@ + + + + + + + diff --git a/client/android/app/src/main/res/values/colors.xml b/client/android/app/src/main/res/values/colors.xml new file mode 100644 index 0000000..c5d5899 --- /dev/null +++ b/client/android/app/src/main/res/values/colors.xml @@ -0,0 +1,4 @@ + + + #FFFFFF + \ No newline at end of file diff --git a/client/android/app/src/main/res/values/styles.xml b/client/android/app/src/main/res/values/styles.xml new file mode 100644 index 0000000..cb1ef88 --- /dev/null +++ b/client/android/app/src/main/res/values/styles.xml @@ -0,0 +1,18 @@ + + + + + + + diff --git a/client/android/app/src/main/res/xml/network_security_config.xml b/client/android/app/src/main/res/xml/network_security_config.xml new file mode 100644 index 0000000..9a30a8b --- /dev/null +++ b/client/android/app/src/main/res/xml/network_security_config.xml @@ -0,0 +1,13 @@ + + + + localhost + 10.0.2.2 + 127.0.0.1 + + + + + + + \ No newline at end of file diff --git a/client/android/app/src/profile/AndroidManifest.xml b/client/android/app/src/profile/AndroidManifest.xml new file mode 100644 index 0000000..399f698 --- /dev/null +++ b/client/android/app/src/profile/AndroidManifest.xml @@ -0,0 +1,7 @@ + + + + diff --git a/client/android/build.gradle.kts b/client/android/build.gradle.kts new file mode 100644 index 0000000..dbee657 --- /dev/null +++ b/client/android/build.gradle.kts @@ -0,0 +1,24 @@ +allprojects { + repositories { + google() + mavenCentral() + } +} + +val newBuildDir: Directory = + rootProject.layout.buildDirectory + .dir("../../build") + .get() +rootProject.layout.buildDirectory.value(newBuildDir) + +subprojects { + val newSubprojectBuildDir: Directory = newBuildDir.dir(project.name) + project.layout.buildDirectory.value(newSubprojectBuildDir) +} +subprojects { + project.evaluationDependsOn(":app") +} + +tasks.register("clean") { + delete(rootProject.layout.buildDirectory) +} diff --git a/client/android/gradle.properties b/client/android/gradle.properties new file mode 100644 index 0000000..d061fb8 --- /dev/null +++ b/client/android/gradle.properties @@ -0,0 +1,15 @@ +org.gradle.jvmargs=-Xmx8G -XX:MaxMetaspaceSize=4G -XX:ReservedCodeCacheSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dhttps.protocols=TLSv1.2,TLSv1.3 -Djdk.tls.client.protocols=TLSv1.2,TLSv1.3 +android.useAndroidX=true +android.enableJetifier=true + +# Network and TLS configuration +systemProp.https.protocols=TLSv1.2,TLSv1.3 +systemProp.jdk.tls.client.protocols=TLSv1.2,TLSv1.3 +systemProp.javax.net.ssl.trustStore= +systemProp.javax.net.ssl.trustStorePassword= + +# Gradle daemon configuration +org.gradle.daemon=true +org.gradle.parallel=true +org.gradle.configureondemand=true +org.gradle.caching=true diff --git a/client/android/gradle/wrapper/gradle-wrapper.properties b/client/android/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..ac3b479 --- /dev/null +++ b/client/android/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,5 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.12-all.zip diff --git a/client/android/settings.gradle.kts b/client/android/settings.gradle.kts new file mode 100644 index 0000000..fb605bc --- /dev/null +++ b/client/android/settings.gradle.kts @@ -0,0 +1,26 @@ +pluginManagement { + val flutterSdkPath = + run { + val properties = java.util.Properties() + file("local.properties").inputStream().use { properties.load(it) } + val flutterSdkPath = properties.getProperty("flutter.sdk") + require(flutterSdkPath != null) { "flutter.sdk not set in local.properties" } + flutterSdkPath + } + + includeBuild("$flutterSdkPath/packages/flutter_tools/gradle") + + repositories { + google() + mavenCentral() + gradlePluginPortal() + } +} + +plugins { + id("dev.flutter.flutter-plugin-loader") version "1.0.0" + id("com.android.application") version "8.9.1" apply false + id("org.jetbrains.kotlin.android") version "2.1.0" apply false +} + +include(":app") diff --git a/client/assets/images/logo.png b/client/assets/images/logo.png new file mode 100644 index 0000000..6faf2d5 Binary files /dev/null and b/client/assets/images/logo.png differ diff --git a/client/build_prod.bat b/client/build_prod.bat new file mode 100644 index 0000000..1c8d6d7 --- /dev/null +++ b/client/build_prod.bat @@ -0,0 +1,85 @@ +@echo off +REM 生产环境构建脚本 (Windows) + +echo ======================================== +echo Building AI English Learning App for Production +echo ======================================== +echo. + +:menu +echo Please select build target: +echo 1. Android APK +echo 2. Android App Bundle (AAB) +echo 3. iOS +echo 4. Web +echo 5. Windows +echo 6. Exit +echo. +set /p choice=Enter your choice (1-6): + +if "%choice%"=="1" goto android_apk +if "%choice%"=="2" goto android_aab +if "%choice%"=="3" goto ios +if "%choice%"=="4" goto web +if "%choice%"=="5" goto windows +if "%choice%"=="6" goto end +echo Invalid choice. Please try again. +echo. +goto menu + +:android_apk +echo. +echo Building Android APK... +flutter build apk --dart-define=ENVIRONMENT=production --release +echo. +echo Build completed! APK location: +echo build\app\outputs\flutter-apk\app-release.apk +echo. +pause +goto end + +:android_aab +echo. +echo Building Android App Bundle... +flutter build appbundle --dart-define=ENVIRONMENT=production --release +echo. +echo Build completed! AAB location: +echo build\app\outputs\bundle\release\app-release.aab +echo. +pause +goto end + +:ios +echo. +echo Building iOS... +flutter build ios --dart-define=ENVIRONMENT=production --release +echo. +echo Build completed! Please open Xcode to archive and distribute. +echo. +pause +goto end + +:web +echo. +echo Building Web... +flutter build web --dart-define=ENVIRONMENT=production --release +echo. +echo Build completed! Web files location: +echo build\web +echo. +pause +goto end + +:windows +echo. +echo Building Windows... +flutter build windows --dart-define=ENVIRONMENT=production --release +echo. +echo Build completed! Windows executable location: +echo build\windows\runner\Release +echo. +pause +goto end + +:end +exit diff --git a/client/devtools_options.yaml b/client/devtools_options.yaml new file mode 100644 index 0000000..fa0b357 --- /dev/null +++ b/client/devtools_options.yaml @@ -0,0 +1,3 @@ +description: This file stores settings for Dart & Flutter DevTools. +documentation: https://docs.flutter.dev/tools/devtools/extensions#configure-extension-enablement-states +extensions: diff --git a/client/ios/.gitignore b/client/ios/.gitignore new file mode 100644 index 0000000..7a7f987 --- /dev/null +++ b/client/ios/.gitignore @@ -0,0 +1,34 @@ +**/dgph +*.mode1v3 +*.mode2v3 +*.moved-aside +*.pbxuser +*.perspectivev3 +**/*sync/ +.sconsign.dblite +.tags* +**/.vagrant/ +**/DerivedData/ +Icon? +**/Pods/ +**/.symlinks/ +profile +xcuserdata +**/.generated/ +Flutter/App.framework +Flutter/Flutter.framework +Flutter/Flutter.podspec +Flutter/Generated.xcconfig +Flutter/ephemeral/ +Flutter/app.flx +Flutter/app.zip +Flutter/flutter_assets/ +Flutter/flutter_export_environment.sh +ServiceDefinitions.json +Runner/GeneratedPluginRegistrant.* + +# Exceptions to above rules. +!default.mode1v3 +!default.mode2v3 +!default.pbxuser +!default.perspectivev3 diff --git a/client/ios/Flutter/AppFrameworkInfo.plist b/client/ios/Flutter/AppFrameworkInfo.plist new file mode 100644 index 0000000..1dc6cf7 --- /dev/null +++ b/client/ios/Flutter/AppFrameworkInfo.plist @@ -0,0 +1,26 @@ + + + + + CFBundleDevelopmentRegion + en + CFBundleExecutable + App + CFBundleIdentifier + io.flutter.flutter.app + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + App + CFBundlePackageType + FMWK + CFBundleShortVersionString + 1.0 + CFBundleSignature + ???? + CFBundleVersion + 1.0 + MinimumOSVersion + 13.0 + + diff --git a/client/ios/Flutter/Debug.xcconfig b/client/ios/Flutter/Debug.xcconfig new file mode 100644 index 0000000..592ceee --- /dev/null +++ b/client/ios/Flutter/Debug.xcconfig @@ -0,0 +1 @@ +#include "Generated.xcconfig" diff --git a/client/ios/Flutter/Release.xcconfig b/client/ios/Flutter/Release.xcconfig new file mode 100644 index 0000000..592ceee --- /dev/null +++ b/client/ios/Flutter/Release.xcconfig @@ -0,0 +1 @@ +#include "Generated.xcconfig" diff --git a/client/ios/Runner.xcodeproj/project.pbxproj b/client/ios/Runner.xcodeproj/project.pbxproj new file mode 100644 index 0000000..9dc9c5d --- /dev/null +++ b/client/ios/Runner.xcodeproj/project.pbxproj @@ -0,0 +1,616 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 54; + objects = { + +/* Begin PBXBuildFile section */ + 1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */ = {isa = PBXBuildFile; fileRef = 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */; }; + 331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C807B294A618700263BE5 /* RunnerTests.swift */; }; + 3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */ = {isa = PBXBuildFile; fileRef = 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */; }; + 74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 74858FAE1ED2DC5600515810 /* AppDelegate.swift */; }; + 97C146FC1CF9000F007C117D /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FA1CF9000F007C117D /* Main.storyboard */; }; + 97C146FE1CF9000F007C117D /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FD1CF9000F007C117D /* Assets.xcassets */; }; + 97C147011CF9000F007C117D /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */; }; +/* End PBXBuildFile section */ + +/* Begin PBXContainerItemProxy section */ + 331C8085294A63A400263BE5 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = 97C146E61CF9000F007C117D /* Project object */; + proxyType = 1; + remoteGlobalIDString = 97C146ED1CF9000F007C117D; + remoteInfo = Runner; + }; +/* End PBXContainerItemProxy section */ + +/* Begin PBXCopyFilesBuildPhase section */ + 9705A1C41CF9048500538489 /* Embed Frameworks */ = { + isa = PBXCopyFilesBuildPhase; + buildActionMask = 2147483647; + dstPath = ""; + dstSubfolderSpec = 10; + files = ( + ); + name = "Embed Frameworks"; + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXCopyFilesBuildPhase section */ + +/* Begin PBXFileReference section */ + 1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = GeneratedPluginRegistrant.h; sourceTree = ""; }; + 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = GeneratedPluginRegistrant.m; sourceTree = ""; }; + 331C807B294A618700263BE5 /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = ""; }; + 331C8081294A63A400263BE5 /* RunnerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RunnerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; }; + 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; name = AppFrameworkInfo.plist; path = Flutter/AppFrameworkInfo.plist; sourceTree = ""; }; + 74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "Runner-Bridging-Header.h"; sourceTree = ""; }; + 74858FAE1ED2DC5600515810 /* AppDelegate.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = ""; }; + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = Release.xcconfig; path = Flutter/Release.xcconfig; sourceTree = ""; }; + 9740EEB21CF90195004384FC /* Debug.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; name = Debug.xcconfig; path = Flutter/Debug.xcconfig; sourceTree = ""; }; + 9740EEB31CF90195004384FC /* Generated.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; name = Generated.xcconfig; path = Flutter/Generated.xcconfig; sourceTree = ""; }; + 97C146EE1CF9000F007C117D /* Runner.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Runner.app; sourceTree = BUILT_PRODUCTS_DIR; }; + 97C146FB1CF9000F007C117D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = ""; }; + 97C146FD1CF9000F007C117D /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = ""; }; + 97C147001CF9000F007C117D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = ""; }; + 97C147021CF9000F007C117D /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; +/* End PBXFileReference section */ + +/* Begin PBXFrameworksBuildPhase section */ + 97C146EB1CF9000F007C117D /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 331C8082294A63A400263BE5 /* RunnerTests */ = { + isa = PBXGroup; + children = ( + 331C807B294A618700263BE5 /* RunnerTests.swift */, + ); + path = RunnerTests; + sourceTree = ""; + }; + 9740EEB11CF90186004384FC /* Flutter */ = { + isa = PBXGroup; + children = ( + 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */, + 9740EEB21CF90195004384FC /* Debug.xcconfig */, + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */, + 9740EEB31CF90195004384FC /* Generated.xcconfig */, + ); + name = Flutter; + sourceTree = ""; + }; + 97C146E51CF9000F007C117D = { + isa = PBXGroup; + children = ( + 9740EEB11CF90186004384FC /* Flutter */, + 97C146F01CF9000F007C117D /* Runner */, + 97C146EF1CF9000F007C117D /* Products */, + 331C8082294A63A400263BE5 /* RunnerTests */, + ); + sourceTree = ""; + }; + 97C146EF1CF9000F007C117D /* Products */ = { + isa = PBXGroup; + children = ( + 97C146EE1CF9000F007C117D /* Runner.app */, + 331C8081294A63A400263BE5 /* RunnerTests.xctest */, + ); + name = Products; + sourceTree = ""; + }; + 97C146F01CF9000F007C117D /* Runner */ = { + isa = PBXGroup; + children = ( + 97C146FA1CF9000F007C117D /* Main.storyboard */, + 97C146FD1CF9000F007C117D /* Assets.xcassets */, + 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */, + 97C147021CF9000F007C117D /* Info.plist */, + 1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */, + 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */, + 74858FAE1ED2DC5600515810 /* AppDelegate.swift */, + 74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */, + ); + path = Runner; + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXNativeTarget section */ + 331C8080294A63A400263BE5 /* RunnerTests */ = { + isa = PBXNativeTarget; + buildConfigurationList = 331C8087294A63A400263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */; + buildPhases = ( + 331C807D294A63A400263BE5 /* Sources */, + 331C807F294A63A400263BE5 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + 331C8086294A63A400263BE5 /* PBXTargetDependency */, + ); + name = RunnerTests; + productName = RunnerTests; + productReference = 331C8081294A63A400263BE5 /* RunnerTests.xctest */; + productType = "com.apple.product-type.bundle.unit-test"; + }; + 97C146ED1CF9000F007C117D /* Runner */ = { + isa = PBXNativeTarget; + buildConfigurationList = 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */; + buildPhases = ( + 9740EEB61CF901F6004384FC /* Run Script */, + 97C146EA1CF9000F007C117D /* Sources */, + 97C146EB1CF9000F007C117D /* Frameworks */, + 97C146EC1CF9000F007C117D /* Resources */, + 9705A1C41CF9048500538489 /* Embed Frameworks */, + 3B06AD1E1E4923F5004D2608 /* Thin Binary */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = Runner; + productName = Runner; + productReference = 97C146EE1CF9000F007C117D /* Runner.app */; + productType = "com.apple.product-type.application"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + 97C146E61CF9000F007C117D /* Project object */ = { + isa = PBXProject; + attributes = { + BuildIndependentTargetsInParallel = YES; + LastUpgradeCheck = 1510; + ORGANIZATIONNAME = ""; + TargetAttributes = { + 331C8080294A63A400263BE5 = { + CreatedOnToolsVersion = 14.0; + TestTargetID = 97C146ED1CF9000F007C117D; + }; + 97C146ED1CF9000F007C117D = { + CreatedOnToolsVersion = 7.3.1; + LastSwiftMigration = 1100; + }; + }; + }; + buildConfigurationList = 97C146E91CF9000F007C117D /* Build configuration list for PBXProject "Runner" */; + compatibilityVersion = "Xcode 9.3"; + developmentRegion = en; + hasScannedForEncodings = 0; + knownRegions = ( + en, + Base, + ); + mainGroup = 97C146E51CF9000F007C117D; + productRefGroup = 97C146EF1CF9000F007C117D /* Products */; + projectDirPath = ""; + projectRoot = ""; + targets = ( + 97C146ED1CF9000F007C117D /* Runner */, + 331C8080294A63A400263BE5 /* RunnerTests */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 331C807F294A63A400263BE5 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 97C146EC1CF9000F007C117D /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 97C147011CF9000F007C117D /* LaunchScreen.storyboard in Resources */, + 3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */, + 97C146FE1CF9000F007C117D /* Assets.xcassets in Resources */, + 97C146FC1CF9000F007C117D /* Main.storyboard in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXShellScriptBuildPhase section */ + 3B06AD1E1E4923F5004D2608 /* Thin Binary */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputPaths = ( + "${TARGET_BUILD_DIR}/${INFOPLIST_PATH}", + ); + name = "Thin Binary"; + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" embed_and_thin"; + }; + 9740EEB61CF901F6004384FC /* Run Script */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputPaths = ( + ); + name = "Run Script"; + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" build"; + }; +/* End PBXShellScriptBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 331C807D294A63A400263BE5 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 97C146EA1CF9000F007C117D /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */, + 1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin PBXTargetDependency section */ + 331C8086294A63A400263BE5 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + target = 97C146ED1CF9000F007C117D /* Runner */; + targetProxy = 331C8085294A63A400263BE5 /* PBXContainerItemProxy */; + }; +/* End PBXTargetDependency section */ + +/* Begin PBXVariantGroup section */ + 97C146FA1CF9000F007C117D /* Main.storyboard */ = { + isa = PBXVariantGroup; + children = ( + 97C146FB1CF9000F007C117D /* Base */, + ); + name = Main.storyboard; + sourceTree = ""; + }; + 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */ = { + isa = PBXVariantGroup; + children = ( + 97C147001CF9000F007C117D /* Base */, + ); + name = LaunchScreen.storyboard; + sourceTree = ""; + }; +/* End PBXVariantGroup section */ + +/* Begin XCBuildConfiguration section */ + 249021D3217E4FDB00AE95B9 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = iphoneos; + SUPPORTED_PLATFORMS = iphoneos; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + }; + name = Profile; + }; + 249021D4217E4FDB00AE95B9 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.example.client; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Profile; + }; + 331C8088294A63A400263BE5 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.client.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Debug; + }; + 331C8089294A63A400263BE5 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.client.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Release; + }; + 331C808A294A63A400263BE5 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.client.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Profile; + }; + 97C147031CF9000F007C117D /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = dwarf; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_TESTABILITY = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_DYNAMIC_NO_PIC = NO; + GCC_NO_COMMON_BLOCKS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "DEBUG=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = YES; + ONLY_ACTIVE_ARCH = YES; + SDKROOT = iphoneos; + TARGETED_DEVICE_FAMILY = "1,2"; + }; + name = Debug; + }; + 97C147041CF9000F007C117D /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = AppIcon; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = iphoneos; + SUPPORTED_PLATFORMS = iphoneos; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + }; + name = Release; + }; + 97C147061CF9000F007C117D /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.example.client; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Debug; + }; + 97C147071CF9000F007C117D /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.example.client; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Release; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 331C8087294A63A400263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 331C8088294A63A400263BE5 /* Debug */, + 331C8089294A63A400263BE5 /* Release */, + 331C808A294A63A400263BE5 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 97C146E91CF9000F007C117D /* Build configuration list for PBXProject "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 97C147031CF9000F007C117D /* Debug */, + 97C147041CF9000F007C117D /* Release */, + 249021D3217E4FDB00AE95B9 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 97C147061CF9000F007C117D /* Debug */, + 97C147071CF9000F007C117D /* Release */, + 249021D4217E4FDB00AE95B9 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = 97C146E61CF9000F007C117D /* Project object */; +} diff --git a/client/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/client/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..919434a --- /dev/null +++ b/client/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/client/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/client/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/client/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/client/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/client/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings new file mode 100644 index 0000000..f9b0d7c --- /dev/null +++ b/client/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings @@ -0,0 +1,8 @@ + + + + + PreviewsEnabled + + + diff --git a/client/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/client/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme new file mode 100644 index 0000000..e3773d4 --- /dev/null +++ b/client/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme @@ -0,0 +1,101 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/client/ios/Runner.xcworkspace/contents.xcworkspacedata b/client/ios/Runner.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..1d526a1 --- /dev/null +++ b/client/ios/Runner.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/client/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/client/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/client/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/client/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/client/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings new file mode 100644 index 0000000..f9b0d7c --- /dev/null +++ b/client/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings @@ -0,0 +1,8 @@ + + + + + PreviewsEnabled + + + diff --git a/client/ios/Runner/AppDelegate.swift b/client/ios/Runner/AppDelegate.swift new file mode 100644 index 0000000..6266644 --- /dev/null +++ b/client/ios/Runner/AppDelegate.swift @@ -0,0 +1,13 @@ +import Flutter +import UIKit + +@main +@objc class AppDelegate: FlutterAppDelegate { + override func application( + _ application: UIApplication, + didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? + ) -> Bool { + GeneratedPluginRegistrant.register(with: self) + return super.application(application, didFinishLaunchingWithOptions: launchOptions) + } +} diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json new file mode 100644 index 0000000..d36b1fa --- /dev/null +++ b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json @@ -0,0 +1,122 @@ +{ + "images" : [ + { + "size" : "20x20", + "idiom" : "iphone", + "filename" : "Icon-App-20x20@2x.png", + "scale" : "2x" + }, + { + "size" : "20x20", + "idiom" : "iphone", + "filename" : "Icon-App-20x20@3x.png", + "scale" : "3x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@1x.png", + "scale" : "1x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@2x.png", + "scale" : "2x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@3x.png", + "scale" : "3x" + }, + { + "size" : "40x40", + "idiom" : "iphone", + "filename" : "Icon-App-40x40@2x.png", + "scale" : "2x" + }, + { + "size" : "40x40", + "idiom" : "iphone", + "filename" : "Icon-App-40x40@3x.png", + "scale" : "3x" + }, + { + "size" : "60x60", + "idiom" : "iphone", + "filename" : "Icon-App-60x60@2x.png", + "scale" : "2x" + }, + { + "size" : "60x60", + "idiom" : "iphone", + "filename" : "Icon-App-60x60@3x.png", + "scale" : "3x" + }, + { + "size" : "20x20", + "idiom" : "ipad", + "filename" : "Icon-App-20x20@1x.png", + "scale" : "1x" + }, + { + "size" : "20x20", + "idiom" : "ipad", + "filename" : "Icon-App-20x20@2x.png", + "scale" : "2x" + }, + { + "size" : "29x29", + "idiom" : "ipad", + "filename" : "Icon-App-29x29@1x.png", + "scale" : "1x" + }, + { + "size" : "29x29", + "idiom" : "ipad", + "filename" : "Icon-App-29x29@2x.png", + "scale" : "2x" + }, + { + "size" : "40x40", + "idiom" : "ipad", + "filename" : "Icon-App-40x40@1x.png", + "scale" : "1x" + }, + { + "size" : "40x40", + "idiom" : "ipad", + "filename" : "Icon-App-40x40@2x.png", + "scale" : "2x" + }, + { + "size" : "76x76", + "idiom" : "ipad", + "filename" : "Icon-App-76x76@1x.png", + "scale" : "1x" + }, + { + "size" : "76x76", + "idiom" : "ipad", + "filename" : "Icon-App-76x76@2x.png", + "scale" : "2x" + }, + { + "size" : "83.5x83.5", + "idiom" : "ipad", + "filename" : "Icon-App-83.5x83.5@2x.png", + "scale" : "2x" + }, + { + "size" : "1024x1024", + "idiom" : "ios-marketing", + "filename" : "Icon-App-1024x1024@1x.png", + "scale" : "1x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png new file mode 100644 index 0000000..d618ec2 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png new file mode 100644 index 0000000..7694dce Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png new file mode 100644 index 0000000..12740b2 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png new file mode 100644 index 0000000..3fca145 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png new file mode 100644 index 0000000..0d0619a Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png new file mode 100644 index 0000000..1ed3088 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png new file mode 100644 index 0000000..20619d0 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png new file mode 100644 index 0000000..12740b2 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png new file mode 100644 index 0000000..2f5fe63 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png new file mode 100644 index 0000000..0f874c8 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-50x50@1x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-50x50@1x.png new file mode 100644 index 0000000..11f12cd Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-50x50@1x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-50x50@2x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-50x50@2x.png new file mode 100644 index 0000000..321a784 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-50x50@2x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-57x57@1x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-57x57@1x.png new file mode 100644 index 0000000..1777e87 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-57x57@1x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-57x57@2x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-57x57@2x.png new file mode 100644 index 0000000..3a3bf4c Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-57x57@2x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png new file mode 100644 index 0000000..0f874c8 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png new file mode 100644 index 0000000..6dee828 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-72x72@1x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-72x72@1x.png new file mode 100644 index 0000000..5bfb65f Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-72x72@1x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-72x72@2x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-72x72@2x.png new file mode 100644 index 0000000..4b81ba0 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-72x72@2x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png new file mode 100644 index 0000000..183a89d Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png new file mode 100644 index 0000000..3e21559 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png differ diff --git a/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png new file mode 100644 index 0000000..7a1f851 Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png differ diff --git a/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json b/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json new file mode 100644 index 0000000..0bedcf2 --- /dev/null +++ b/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "idiom" : "universal", + "filename" : "LaunchImage.png", + "scale" : "1x" + }, + { + "idiom" : "universal", + "filename" : "LaunchImage@2x.png", + "scale" : "2x" + }, + { + "idiom" : "universal", + "filename" : "LaunchImage@3x.png", + "scale" : "3x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png b/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png new file mode 100644 index 0000000..9da19ea Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png differ diff --git a/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png b/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png new file mode 100644 index 0000000..9da19ea Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png differ diff --git a/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png b/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png new file mode 100644 index 0000000..9da19ea Binary files /dev/null and b/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png differ diff --git a/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md b/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md new file mode 100644 index 0000000..89c2725 --- /dev/null +++ b/client/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md @@ -0,0 +1,5 @@ +# Launch Screen Assets + +You can customize the launch screen with your own desired assets by replacing the image files in this directory. + +You can also do it by opening your Flutter project's Xcode project with `open ios/Runner.xcworkspace`, selecting `Runner/Assets.xcassets` in the Project Navigator and dropping in the desired images. \ No newline at end of file diff --git a/client/ios/Runner/Base.lproj/LaunchScreen.storyboard b/client/ios/Runner/Base.lproj/LaunchScreen.storyboard new file mode 100644 index 0000000..f2e259c --- /dev/null +++ b/client/ios/Runner/Base.lproj/LaunchScreen.storyboard @@ -0,0 +1,37 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/client/ios/Runner/Base.lproj/Main.storyboard b/client/ios/Runner/Base.lproj/Main.storyboard new file mode 100644 index 0000000..f3c2851 --- /dev/null +++ b/client/ios/Runner/Base.lproj/Main.storyboard @@ -0,0 +1,26 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/client/ios/Runner/Info.plist b/client/ios/Runner/Info.plist new file mode 100644 index 0000000..7a134c8 --- /dev/null +++ b/client/ios/Runner/Info.plist @@ -0,0 +1,49 @@ + + + + + CFBundleDevelopmentRegion + $(DEVELOPMENT_LANGUAGE) + CFBundleDisplayName + Client + CFBundleExecutable + $(EXECUTABLE_NAME) + CFBundleIdentifier + $(PRODUCT_BUNDLE_IDENTIFIER) + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + client + CFBundlePackageType + APPL + CFBundleShortVersionString + $(FLUTTER_BUILD_NAME) + CFBundleSignature + ???? + CFBundleVersion + $(FLUTTER_BUILD_NUMBER) + LSRequiresIPhoneOS + + UILaunchStoryboardName + LaunchScreen + UIMainStoryboardFile + Main + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + UISupportedInterfaceOrientations~ipad + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + CADisableMinimumFrameDurationOnPhone + + UIApplicationSupportsIndirectInputEvents + + + diff --git a/client/ios/Runner/Runner-Bridging-Header.h b/client/ios/Runner/Runner-Bridging-Header.h new file mode 100644 index 0000000..308a2a5 --- /dev/null +++ b/client/ios/Runner/Runner-Bridging-Header.h @@ -0,0 +1 @@ +#import "GeneratedPluginRegistrant.h" diff --git a/client/ios/RunnerTests/RunnerTests.swift b/client/ios/RunnerTests/RunnerTests.swift new file mode 100644 index 0000000..86a7c3b --- /dev/null +++ b/client/ios/RunnerTests/RunnerTests.swift @@ -0,0 +1,12 @@ +import Flutter +import UIKit +import XCTest + +class RunnerTests: XCTestCase { + + func testExample() { + // If you add code to the Runner application, consider adding tests here. + // See https://developer.apple.com/documentation/xctest for more information about using XCTest. + } + +} diff --git a/client/lib/core/config/environment.dart b/client/lib/core/config/environment.dart new file mode 100644 index 0000000..5ec9c1e --- /dev/null +++ b/client/lib/core/config/environment.dart @@ -0,0 +1,133 @@ +/// 环境配置 +enum Environment { + development, + staging, + production, +} + +/// 环境配置管理 +class EnvironmentConfig { + static Environment _currentEnvironment = Environment.development; + + /// 获取当前环境 + static Environment get current => _currentEnvironment; + + /// 设置当前环境 + static void setEnvironment(Environment env) { + _currentEnvironment = env; + } + + /// 从字符串设置环境 + static void setEnvironmentFromString(String? envString) { + switch (envString?.toLowerCase()) { + case 'production': + case 'prod': + _currentEnvironment = Environment.production; + break; + case 'staging': + case 'stage': + _currentEnvironment = Environment.staging; + break; + case 'development': + case 'dev': + default: + _currentEnvironment = Environment.development; + break; + } + } + + /// 获取当前环境的API基础URL + static String get baseUrl { + switch (_currentEnvironment) { + case Environment.production: + return 'https://loukao.cn/api/v1'; + case Environment.staging: + return 'http://localhost:8080/api/v1'; + case Environment.development: + default: + // 开发环境：localhost 用于 Web，10.0.2.2 用于 Android 模拟器 + return const String.fromEnvironment( + 'API_BASE_URL', + defaultValue: 'http://localhost:8080/api/v1', + ); + } + } + + /// 获取环境名称 + static String get environmentName { + switch (_currentEnvironment) { + case Environment.production: + return 'Production'; + case Environment.staging: + return 'Staging'; + case Environment.development: + return 'Development'; + } + } + + /// 是否为开发环境 + static bool get isDevelopment => _currentEnvironment == Environment.development; + + /// 是否为生产环境 + static bool get isProduction => _currentEnvironment == Environment.production; + + /// 是否为预发布环境 + static bool get isStaging => _currentEnvironment == Environment.staging; + + /// 开发环境配置 + static const Map developmentConfig = { + 'baseUrl': 'http://localhost:8080/api/v1', + 'baseUrlAndroid': 'http://10.0.2.2:8080/api/v1', + 'wsUrl': 'ws://localhost:8080/ws', + }; + + /// 预发布环境配置 + static const Map stagingConfig = { + 'baseUrl': 'https://loukao.cn/api/v1', + 'wsUrl': 'ws://your-staging-domain.com/ws', + }; + + /// 生产环境配置 + static const Map productionConfig = { + 'baseUrl': 'https://loukao.cn/api/v1', + 'wsUrl': 'ws://your-production-domain.com/ws', + }; + + /// 获取当前环境配置 + static Map get config { + switch (_currentEnvironment) { + case Environment.production: + return productionConfig; + case Environment.staging: + return stagingConfig; + case Environment.development: + default: + return developmentConfig; + } + } + + /// 获取WebSocket URL + static String get wsUrl { + return config['wsUrl'] ?? ''; + } + + /// 获取连接超时时间（毫秒） + static int get connectTimeout { + return isProduction ? 10000 : 30000; + } + + /// 获取接收超时时间（毫秒） + static int get receiveTimeout { + return isProduction ? 10000 : 30000; + } + + /// 是否启用日志 + static bool get enableLogging { + return !isProduction; + } + + /// 是否启用调试模式 + static bool get debugMode { + return isDevelopment; + } +} diff --git a/client/lib/core/constants/app_constants.dart b/client/lib/core/constants/app_constants.dart new file mode 100644 index 0000000..d85906d --- /dev/null +++ b/client/lib/core/constants/app_constants.dart @@ -0,0 +1,88 @@ +import '../config/environment.dart'; + +/// 应用常量配置 +class AppConstants { + // 应用信息 + static const String appName = 'AI英语学习'; + static const String appVersion = '1.0.0'; + + // API配置 - 从环境配置获取 + static String get baseUrl => EnvironmentConfig.baseUrl; + static int get connectTimeout => EnvironmentConfig.connectTimeout; + static int get receiveTimeout => EnvironmentConfig.receiveTimeout; + + // 存储键名 + static const String accessTokenKey = 'access_token'; + static const String refreshTokenKey = 'refresh_token'; + static const String userInfoKey = 'user_info'; + static const String settingsKey = 'app_settings'; + + // 分页配置 + static const int defaultPageSize = 20; + static const int maxPageSize = 100; + + // 学习配置 + static const int dailyWordGoal = 50; + static const int maxRetryAttempts = 3; + static const Duration studySessionDuration = Duration(minutes: 25); + + // 音频配置 + static const double defaultPlaybackSpeed = 1.0; + static const double minPlaybackSpeed = 0.5; + static const double maxPlaybackSpeed = 2.0; + + // 图片配置 + static const int maxImageSize = 5 * 1024 * 1024; // 5MB + static const List supportedImageFormats = ['jpg', 'jpeg', 'png', 'webp']; + + // 缓存配置 + static const Duration cacheExpiration = Duration(hours: 24); + static const int maxCacheSize = 100 * 1024 * 1024; // 100MB +} + +/// 路由常量 +class RouteConstants { + static const String splash = '/splash'; + static const String onboarding = '/onboarding'; + static const String login = '/login'; + static const String register = '/register'; + static const String home = '/home'; + static const String profile = '/profile'; + static const String vocabulary = '/vocabulary'; + static const String vocabularyTest = '/vocabulary/test'; + static const String listening = '/listening'; + static const String reading = '/reading'; + static const String writing = '/writing'; + static const String speaking = '/speaking'; + static const String settings = '/settings'; +} + +/// 学习等级常量 +enum LearningLevel { + beginner('beginner', '初级'), + intermediate('intermediate', '中级'), + advanced('advanced', '高级'); + + const LearningLevel(this.value, this.label); + + final String value; + final String label; +} + +/// 词库类型常量 +enum VocabularyType { + elementary('elementary', '小学'), + junior('junior', '初中'), + senior('senior', '高中'), + cet4('cet4', '四级'), + cet6('cet6', '六级'), + toefl('toefl', '托福'), + ielts('ielts', '雅思'), + business('business', '商务'), + daily('daily', '日常'); + + const VocabularyType(this.value, this.label); + + final String value; + final String label; +} \ No newline at end of file diff --git a/client/lib/core/errors/app_error.dart b/client/lib/core/errors/app_error.dart new file mode 100644 index 0000000..3ca63ba --- /dev/null +++ b/client/lib/core/errors/app_error.dart @@ -0,0 +1,299 @@ +/// 应用错误基类 +abstract class AppError implements Exception { + final String message; + final String? code; + final dynamic originalError; + + const AppError({ + required this.message, + this.code, + this.originalError, + }); + + @override + String toString() { + return 'AppError(message: $message, code: $code)'; + } +} + +/// 网络错误 +class NetworkError extends AppError { + const NetworkError({ + required super.message, + super.code, + super.originalError, + }); + + factory NetworkError.connectionTimeout() { + return const NetworkError( + message: '连接超时，请检查网络连接', + code: 'CONNECTION_TIMEOUT', + ); + } + + factory NetworkError.noInternet() { + return const NetworkError( + message: '网络连接不可用，请检查网络设置', + code: 'NO_INTERNET', + ); + } + + factory NetworkError.serverError(int statusCode, [String? message]) { + return NetworkError( + message: message ?? '服务器错误 ($statusCode)', + code: 'SERVER_ERROR_$statusCode', + ); + } + + factory NetworkError.unknown([dynamic error]) { + return NetworkError( + message: '网络请求失败', + code: 'UNKNOWN_NETWORK_ERROR', + originalError: error, + ); + } +} + +/// 认证错误 +class AuthError extends AppError { + const AuthError({ + required super.message, + super.code, + super.originalError, + }); + + factory AuthError.unauthorized() { + return const AuthError( + message: '未授权访问，请重新登录', + code: 'UNAUTHORIZED', + ); + } + + factory AuthError.tokenExpired() { + return const AuthError( + message: '登录已过期，请重新登录', + code: 'TOKEN_EXPIRED', + ); + } + + factory AuthError.invalidCredentials() { + return const AuthError( + message: '用户名或密码错误', + code: 'INVALID_CREDENTIALS', + ); + } + + factory AuthError.accountLocked() { + return const AuthError( + message: '账户已被锁定，请联系客服', + code: 'ACCOUNT_LOCKED', + ); + } +} + +/// 验证错误 +class ValidationError extends AppError { + final Map>? fieldErrors; + + const ValidationError({ + required super.message, + super.code, + super.originalError, + this.fieldErrors, + }); + + factory ValidationError.required(String field) { + return ValidationError( + message: '$field不能为空', + code: 'FIELD_REQUIRED', + fieldErrors: {field: ['不能为空']}, + ); + } + + factory ValidationError.invalid(String field, String reason) { + return ValidationError( + message: '$field格式不正确：$reason', + code: 'FIELD_INVALID', + fieldErrors: {field: [reason]}, + ); + } + + factory ValidationError.multiple(Map> errors) { + return ValidationError( + message: '表单验证失败', + code: 'VALIDATION_FAILED', + fieldErrors: errors, + ); + } +} + +/// 业务逻辑错误 +class BusinessError extends AppError { + const BusinessError({ + required super.message, + super.code, + super.originalError, + }); + + factory BusinessError.notFound(String resource) { + return BusinessError( + message: '$resource不存在', + code: 'RESOURCE_NOT_FOUND', + ); + } + + factory BusinessError.alreadyExists(String resource) { + return BusinessError( + message: '$resource已存在', + code: 'RESOURCE_ALREADY_EXISTS', + ); + } + + factory BusinessError.operationNotAllowed(String operation) { + return BusinessError( + message: '不允许执行操作：$operation', + code: 'OPERATION_NOT_ALLOWED', + ); + } + + factory BusinessError.quotaExceeded(String resource) { + return BusinessError( + message: '$resource配额已用完', + code: 'QUOTA_EXCEEDED', + ); + } +} + +/// 存储错误 +class StorageError extends AppError { + const StorageError({ + required super.message, + super.code, + super.originalError, + }); + + factory StorageError.readFailed(String key) { + return StorageError( + message: '读取数据失败：$key', + code: 'STORAGE_READ_FAILED', + ); + } + + factory StorageError.writeFailed(String key) { + return StorageError( + message: '写入数据失败：$key', + code: 'STORAGE_WRITE_FAILED', + ); + } + + factory StorageError.notInitialized() { + return const StorageError( + message: '存储服务未初始化', + code: 'STORAGE_NOT_INITIALIZED', + ); + } +} + +/// 文件错误 +class FileError extends AppError { + const FileError({ + required super.message, + super.code, + super.originalError, + }); + + factory FileError.notFound(String path) { + return FileError( + message: '文件不存在：$path', + code: 'FILE_NOT_FOUND', + ); + } + + factory FileError.accessDenied(String path) { + return FileError( + message: '文件访问被拒绝：$path', + code: 'FILE_ACCESS_DENIED', + ); + } + + factory FileError.formatNotSupported(String format) { + return FileError( + message: '不支持的文件格式：$format', + code: 'FILE_FORMAT_NOT_SUPPORTED', + ); + } + + factory FileError.sizeTooLarge(int size, int maxSize) { + return FileError( + message: '文件大小超出限制：${size}B > ${maxSize}B', + code: 'FILE_SIZE_TOO_LARGE', + ); + } +} + +/// 音频错误 +class AudioError extends AppError { + const AudioError({ + required super.message, + super.code, + super.originalError, + }); + + factory AudioError.playbackFailed() { + return const AudioError( + message: '音频播放失败', + code: 'AUDIO_PLAYBACK_FAILED', + ); + } + + factory AudioError.recordingFailed() { + return const AudioError( + message: '音频录制失败', + code: 'AUDIO_RECORDING_FAILED', + ); + } + + factory AudioError.permissionDenied() { + return const AudioError( + message: '音频权限被拒绝', + code: 'AUDIO_PERMISSION_DENIED', + ); + } +} + +/// 学习相关错误 +class LearningError extends AppError { + const LearningError({ + required super.message, + super.code, + super.originalError, + }); + + factory LearningError.progressNotFound() { + return const LearningError( + message: '学习进度不存在', + code: 'LEARNING_PROGRESS_NOT_FOUND', + ); + } + + factory LearningError.vocabularyNotFound() { + return const LearningError( + message: '词汇不存在', + code: 'VOCABULARY_NOT_FOUND', + ); + } + + factory LearningError.testNotCompleted() { + return const LearningError( + message: '测试未完成', + code: 'TEST_NOT_COMPLETED', + ); + } + + factory LearningError.levelNotUnlocked() { + return const LearningError( + message: '等级未解锁', + code: 'LEVEL_NOT_UNLOCKED', + ); + } +} \ No newline at end of file diff --git a/client/lib/core/errors/app_exception.dart b/client/lib/core/errors/app_exception.dart new file mode 100644 index 0000000..c5db10d --- /dev/null +++ b/client/lib/core/errors/app_exception.dart @@ -0,0 +1,62 @@ +/// 应用异常基类 +class AppException implements Exception { + final String message; + final String? code; + final dynamic details; + + const AppException( + this.message, { + this.code, + this.details, + }); + + @override + String toString() { + return 'AppException: $message'; + } +} + +/// 网络异常 +class NetworkException extends AppException { + const NetworkException( + super.message, { + super.code, + super.details, + }); +} + +/// 认证异常 +class AuthException extends AppException { + const AuthException( + super.message, { + super.code, + super.details, + }); +} + +/// 服务器异常 +class ServerException extends AppException { + const ServerException( + super.message, { + super.code, + super.details, + }); +} + +/// 缓存异常 +class CacheException extends AppException { + const CacheException( + super.message, { + super.code, + super.details, + }); +} + +/// 验证异常 +class ValidationException extends AppException { + const ValidationException( + super.message, { + super.code, + super.details, + }); +} \ No newline at end of file diff --git a/client/lib/core/models/api_response.dart b/client/lib/core/models/api_response.dart new file mode 100644 index 0000000..ff380f8 --- /dev/null +++ b/client/lib/core/models/api_response.dart @@ -0,0 +1,121 @@ +/// API响应基础模型 +class ApiResponse { + final bool success; + final String message; + final T? data; + final int? code; + final Map? errors; + + const ApiResponse({ + required this.success, + required this.message, + this.data, + this.code, + this.errors, + }); + + factory ApiResponse.success({ + required String message, + T? data, + int? code, + }) { + return ApiResponse( + success: true, + message: message, + data: data, + code: code ?? 200, + ); + } + + factory ApiResponse.error({ + required String message, + int? code, + Map? errors, + }) { + return ApiResponse( + success: false, + message: message, + code: code ?? 400, + errors: errors, + ); + } + + factory ApiResponse.fromJson( + Map json, + T Function(dynamic)? fromJsonT, + ) { + return ApiResponse( + success: json['success'] ?? false, + message: json['message'] ?? '', + data: json['data'] != null && fromJsonT != null + ? fromJsonT(json['data']) + : json['data'], + code: json['code'], + errors: json['errors'], + ); + } + + Map toJson() { + return { + 'success': success, + 'message': message, + 'data': data, + 'code': code, + 'errors': errors, + }; + } + + @override + String toString() { + return 'ApiResponse{success: $success, message: $message, data: $data, code: $code}'; + } +} + +/// 分页响应模型 +class PaginatedResponse { + final List data; + final int total; + final int page; + final int pageSize; + final int totalPages; + final bool hasNext; + final bool hasPrevious; + + const PaginatedResponse({ + required this.data, + required this.total, + required this.page, + required this.pageSize, + required this.totalPages, + required this.hasNext, + required this.hasPrevious, + }); + + factory PaginatedResponse.fromJson( + Map json, + T Function(Map) fromJsonT, + ) { + final List dataList = json['data'] ?? []; + return PaginatedResponse( + data: dataList.map((item) => fromJsonT(item)).toList(), + total: json['total'] ?? 0, + page: json['page'] ?? 1, + pageSize: json['page_size'] ?? 10, + totalPages: json['total_pages'] ?? 0, + hasNext: json['has_next'] ?? false, + hasPrevious: json['has_previous'] ?? false, + ); + } + + Map toJson() { + return { + 'data': data, + 'total': total, + 'page': page, + 'page_size': pageSize, + 'total_pages': totalPages, + 'has_next': hasNext, + 'has_previous': hasPrevious, + }; + } +} \ No newline at end of file diff --git a/client/lib/core/models/user_model.dart b/client/lib/core/models/user_model.dart new file mode 100644 index 0000000..03da0a6 --- /dev/null +++ b/client/lib/core/models/user_model.dart @@ -0,0 +1,280 @@ +import 'package:json_annotation/json_annotation.dart'; + +part 'user_model.g.dart'; + +/// 用户模型 +@JsonSerializable() +class User { + final String id; + final String username; + final String email; + final String? phone; + final String? avatar; + final DateTime createdAt; + final DateTime updatedAt; + final UserProfile? profile; + final UserSettings? settings; + + const User({ + required this.id, + required this.username, + required this.email, + this.phone, + this.avatar, + required this.createdAt, + required this.updatedAt, + this.profile, + this.settings, + }); + + factory User.fromJson(Map json) => _$UserFromJson(json); + Map toJson() => _$UserToJson(this); + + User copyWith({ + String? id, + String? username, + String? email, + String? phone, + String? avatar, + DateTime? createdAt, + DateTime? updatedAt, + UserProfile? profile, + UserSettings? settings, + }) { + return User( + id: id ?? this.id, + username: username ?? this.username, + email: email ?? this.email, + phone: phone ?? this.phone, + avatar: avatar ?? this.avatar, + createdAt: createdAt ?? this.createdAt, + updatedAt: updatedAt ?? this.updatedAt, + profile: profile ?? this.profile, + settings: settings ?? this.settings, + ); + } +} + +/// 用户资料 +@JsonSerializable() +class UserProfile { + final String? firstName; + final String? lastName; + final String? phone; + final String? bio; + final String? avatar; + final String? realName; + final String? gender; + final DateTime? birthday; + final String? location; + final String? occupation; + final String? education; + final List? interests; + final LearningGoal? learningGoal; + final EnglishLevel? currentLevel; + final EnglishLevel? targetLevel; + final EnglishLevel? englishLevel; + final UserSettings? settings; + + const UserProfile({ + this.firstName, + this.lastName, + this.phone, + this.bio, + this.avatar, + this.realName, + this.gender, + this.birthday, + this.location, + this.occupation, + this.education, + this.interests, + this.learningGoal, + this.currentLevel, + this.targetLevel, + this.englishLevel, + this.settings, + }); + + factory UserProfile.fromJson(Map json) => _$UserProfileFromJson(json); + Map toJson() => _$UserProfileToJson(this); + + UserProfile copyWith({ + String? firstName, + String? lastName, + String? phone, + String? bio, + String? avatar, + String? realName, + String? gender, + DateTime? birthday, + String? location, + String? occupation, + String? education, + List? interests, + LearningGoal? learningGoal, + EnglishLevel? currentLevel, + EnglishLevel? targetLevel, + EnglishLevel? englishLevel, + UserSettings? settings, + }) { + return UserProfile( + firstName: firstName ?? this.firstName, + lastName: lastName ?? this.lastName, + phone: phone ?? this.phone, + bio: bio ?? this.bio, + avatar: avatar ?? this.avatar, + realName: realName ?? this.realName, + gender: gender ?? this.gender, + birthday: birthday ?? this.birthday, + location: location ?? this.location, + occupation: occupation ?? this.occupation, + education: education ?? this.education, + interests: interests ?? this.interests, + learningGoal: learningGoal ?? this.learningGoal, + currentLevel: currentLevel ?? this.currentLevel, + targetLevel: targetLevel ?? this.targetLevel, + englishLevel: englishLevel ?? this.englishLevel, + settings: settings ?? this.settings, + ); + } +} + +/// 用户设置 +@JsonSerializable() +class UserSettings { + final bool notificationsEnabled; + final bool soundEnabled; + final bool vibrationEnabled; + final String language; + final String theme; + final int dailyGoal; + final int dailyWordGoal; + final int dailyStudyMinutes; + final List reminderTimes; + final bool autoPlayAudio; + final double audioSpeed; + final bool showTranslation; + final bool showPronunciation; + + const UserSettings({ + this.notificationsEnabled = true, + this.soundEnabled = true, + this.vibrationEnabled = true, + this.language = 'zh-CN', + this.theme = 'system', + this.dailyGoal = 30, + this.dailyWordGoal = 20, + this.dailyStudyMinutes = 30, + this.reminderTimes = const ['09:00', '20:00'], + this.autoPlayAudio = true, + this.audioSpeed = 1.0, + this.showTranslation = true, + this.showPronunciation = true, + }); + + factory UserSettings.fromJson(Map json) => _$UserSettingsFromJson(json); + Map toJson() => _$UserSettingsToJson(this); + + UserSettings copyWith({ + bool? notificationsEnabled, + bool? soundEnabled, + bool? vibrationEnabled, + String? language, + String? theme, + int? dailyGoal, + int? dailyWordGoal, + int? dailyStudyMinutes, + List? reminderTimes, + bool? autoPlayAudio, + double? audioSpeed, + bool? showTranslation, + bool? showPronunciation, + }) { + return UserSettings( + notificationsEnabled: notificationsEnabled ?? this.notificationsEnabled, + soundEnabled: soundEnabled ?? this.soundEnabled, + vibrationEnabled: vibrationEnabled ?? this.vibrationEnabled, + language: language ?? this.language, + theme: theme ?? this.theme, + dailyGoal: dailyGoal ?? this.dailyGoal, + dailyWordGoal: dailyWordGoal ?? this.dailyWordGoal, + dailyStudyMinutes: dailyStudyMinutes ?? this.dailyStudyMinutes, + reminderTimes: reminderTimes ?? this.reminderTimes, + autoPlayAudio: autoPlayAudio ?? this.autoPlayAudio, + audioSpeed: audioSpeed ?? this.audioSpeed, + showTranslation: showTranslation ?? this.showTranslation, + showPronunciation: showPronunciation ?? this.showPronunciation, + ); + } +} + +/// 学习目标 +enum LearningGoal { + @JsonValue('daily_communication') + dailyCommunication, + @JsonValue('business_english') + businessEnglish, + @JsonValue('academic_study') + academicStudy, + @JsonValue('exam_preparation') + examPreparation, + @JsonValue('travel') + travel, + @JsonValue('hobby') + hobby, +} + +/// 英语水平 +enum EnglishLevel { + @JsonValue('beginner') + beginner, + @JsonValue('elementary') + elementary, + @JsonValue('intermediate') + intermediate, + @JsonValue('upper_intermediate') + upperIntermediate, + @JsonValue('advanced') + advanced, + @JsonValue('proficient') + proficient, + @JsonValue('expert') + expert, +} + +/// 认证响应 +@JsonSerializable() +class AuthResponse { + final User user; + final String token; + final String? refreshToken; + final DateTime expiresAt; + + const AuthResponse({ + required this.user, + required this.token, + this.refreshToken, + required this.expiresAt, + }); + + factory AuthResponse.fromJson(Map json) => _$AuthResponseFromJson(json); + Map toJson() => _$AuthResponseToJson(this); +} + +/// Token刷新响应 +@JsonSerializable() +class TokenRefreshResponse { + final String token; + final String? refreshToken; + final DateTime expiresAt; + + const TokenRefreshResponse({ + required this.token, + this.refreshToken, + required this.expiresAt, + }); + + factory TokenRefreshResponse.fromJson(Map json) => _$TokenRefreshResponseFromJson(json); + Map toJson() => _$TokenRefreshResponseToJson(this); +} \ No newline at end of file diff --git a/client/lib/core/models/user_model.g.dart b/client/lib/core/models/user_model.g.dart new file mode 100644 index 0000000..d1fb867 --- /dev/null +++ b/client/lib/core/models/user_model.g.dart @@ -0,0 +1,172 @@ +// GENERATED CODE - DO NOT MODIFY BY HAND + +part of 'user_model.dart'; + +// ************************************************************************** +// JsonSerializableGenerator +// ************************************************************************** + +User _$UserFromJson(Map json) => User( + id: json['id'] as String, + username: json['username'] as String, + email: json['email'] as String, + phone: json['phone'] as String?, + avatar: json['avatar'] as String?, + createdAt: DateTime.parse(json['createdAt'] as String), + updatedAt: DateTime.parse(json['updatedAt'] as String), + profile: json['profile'] == null + ? null + : UserProfile.fromJson(json['profile'] as Map), + settings: json['settings'] == null + ? null + : UserSettings.fromJson(json['settings'] as Map), + ); + +Map _$UserToJson(User instance) => { + 'id': instance.id, + 'username': instance.username, + 'email': instance.email, + 'phone': instance.phone, + 'avatar': instance.avatar, + 'createdAt': instance.createdAt.toIso8601String(), + 'updatedAt': instance.updatedAt.toIso8601String(), + 'profile': instance.profile, + 'settings': instance.settings, + }; + +UserProfile _$UserProfileFromJson(Map json) => UserProfile( + firstName: json['firstName'] as String?, + lastName: json['lastName'] as String?, + phone: json['phone'] as String?, + bio: json['bio'] as String?, + avatar: json['avatar'] as String?, + realName: json['realName'] as String?, + gender: json['gender'] as String?, + birthday: json['birthday'] == null + ? null + : DateTime.parse(json['birthday'] as String), + location: json['location'] as String?, + occupation: json['occupation'] as String?, + education: json['education'] as String?, + interests: (json['interests'] as List?) + ?.map((e) => e as String) + .toList(), + learningGoal: + $enumDecodeNullable(_$LearningGoalEnumMap, json['learningGoal']), + currentLevel: + $enumDecodeNullable(_$EnglishLevelEnumMap, json['currentLevel']), + targetLevel: + $enumDecodeNullable(_$EnglishLevelEnumMap, json['targetLevel']), + englishLevel: + $enumDecodeNullable(_$EnglishLevelEnumMap, json['englishLevel']), + settings: json['settings'] == null + ? null + : UserSettings.fromJson(json['settings'] as Map), + ); + +Map _$UserProfileToJson(UserProfile instance) => + { + 'firstName': instance.firstName, + 'lastName': instance.lastName, + 'phone': instance.phone, + 'bio': instance.bio, + 'avatar': instance.avatar, + 'realName': instance.realName, + 'gender': instance.gender, + 'birthday': instance.birthday?.toIso8601String(), + 'location': instance.location, + 'occupation': instance.occupation, + 'education': instance.education, + 'interests': instance.interests, + 'learningGoal': _$LearningGoalEnumMap[instance.learningGoal], + 'currentLevel': _$EnglishLevelEnumMap[instance.currentLevel], + 'targetLevel': _$EnglishLevelEnumMap[instance.targetLevel], + 'englishLevel': _$EnglishLevelEnumMap[instance.englishLevel], + 'settings': instance.settings, + }; + +const _$LearningGoalEnumMap = { + LearningGoal.dailyCommunication: 'daily_communication', + LearningGoal.businessEnglish: 'business_english', + LearningGoal.academicStudy: 'academic_study', + LearningGoal.examPreparation: 'exam_preparation', + LearningGoal.travel: 'travel', + LearningGoal.hobby: 'hobby', +}; + +const _$EnglishLevelEnumMap = { + EnglishLevel.beginner: 'beginner', + EnglishLevel.elementary: 'elementary', + EnglishLevel.intermediate: 'intermediate', + EnglishLevel.upperIntermediate: 'upper_intermediate', + EnglishLevel.advanced: 'advanced', + EnglishLevel.proficient: 'proficient', + EnglishLevel.expert: 'expert', +}; + +UserSettings _$UserSettingsFromJson(Map json) => UserSettings( + notificationsEnabled: json['notificationsEnabled'] as bool? ?? true, + soundEnabled: json['soundEnabled'] as bool? ?? true, + vibrationEnabled: json['vibrationEnabled'] as bool? ?? true, + language: json['language'] as String? ?? 'zh-CN', + theme: json['theme'] as String? ?? 'system', + dailyGoal: (json['dailyGoal'] as num?)?.toInt() ?? 30, + dailyWordGoal: (json['dailyWordGoal'] as num?)?.toInt() ?? 20, + dailyStudyMinutes: (json['dailyStudyMinutes'] as num?)?.toInt() ?? 30, + reminderTimes: (json['reminderTimes'] as List?) + ?.map((e) => e as String) + .toList() ?? + const ['09:00', '20:00'], + autoPlayAudio: json['autoPlayAudio'] as bool? ?? true, + audioSpeed: (json['audioSpeed'] as num?)?.toDouble() ?? 1.0, + showTranslation: json['showTranslation'] as bool? ?? true, + showPronunciation: json['showPronunciation'] as bool? ?? true, + ); + +Map _$UserSettingsToJson(UserSettings instance) => + { + 'notificationsEnabled': instance.notificationsEnabled, + 'soundEnabled': instance.soundEnabled, + 'vibrationEnabled': instance.vibrationEnabled, + 'language': instance.language, + 'theme': instance.theme, + 'dailyGoal': instance.dailyGoal, + 'dailyWordGoal': instance.dailyWordGoal, + 'dailyStudyMinutes': instance.dailyStudyMinutes, + 'reminderTimes': instance.reminderTimes, + 'autoPlayAudio': instance.autoPlayAudio, + 'audioSpeed': instance.audioSpeed, + 'showTranslation': instance.showTranslation, + 'showPronunciation': instance.showPronunciation, + }; + +AuthResponse _$AuthResponseFromJson(Map json) => AuthResponse( + user: User.fromJson(json['user'] as Map), + token: json['token'] as String, + refreshToken: json['refreshToken'] as String?, + expiresAt: DateTime.parse(json['expiresAt'] as String), + ); + +Map _$AuthResponseToJson(AuthResponse instance) => + { + 'user': instance.user, + 'token': instance.token, + 'refreshToken': instance.refreshToken, + 'expiresAt': instance.expiresAt.toIso8601String(), + }; + +TokenRefreshResponse _$TokenRefreshResponseFromJson( + Map json) => + TokenRefreshResponse( + token: json['token'] as String, + refreshToken: json['refreshToken'] as String?, + expiresAt: DateTime.parse(json['expiresAt'] as String), + ); + +Map _$TokenRefreshResponseToJson( + TokenRefreshResponse instance) => + { + 'token': instance.token, + 'refreshToken': instance.refreshToken, + 'expiresAt': instance.expiresAt.toIso8601String(), + }; diff --git a/client/lib/core/network/ai_api_service.dart b/client/lib/core/network/ai_api_service.dart new file mode 100644 index 0000000..4df004d --- /dev/null +++ b/client/lib/core/network/ai_api_service.dart @@ -0,0 +1,209 @@ +import 'dart:convert'; +import 'dart:io'; +import 'package:http/http.dart' as http; +import '../services/storage_service.dart'; +import 'api_endpoints.dart'; +import '../config/environment.dart'; + +/// AI相关API服务 +class AIApiService { + static String get _baseUrl => EnvironmentConfig.baseUrl; + + /// 获取认证头部 + Map _getAuthHeaders() { + final storageService = StorageService.instance; + final token = storageService.getString(StorageKeys.accessToken); + return { + 'Content-Type': 'application/json', + if (token != null) 'Authorization': 'Bearer $token', + }; + } + + /// 写作批改 + Future> correctWriting({ + required String content, + required String taskType, + }) async { + try { + final headers = _getAuthHeaders(); + final response = await http.post( + Uri.parse('$_baseUrl/api/v1/ai/writing/correct'), + headers: headers, + body: json.encode({ + 'content': content, + 'task_type': taskType, + }), + ); + + if (response.statusCode == 200) { + return json.decode(response.body); + } else { + throw Exception('Failed to correct writing: ${response.statusCode}'); + } + } catch (e) { + throw Exception('Error correcting writing: $e'); + } + } + + /// 口语评估 + Future> evaluateSpeaking({ + required String audioText, + required String prompt, + }) async { + try { + final headers = _getAuthHeaders(); + final response = await http.post( + Uri.parse('$_baseUrl/api/v1/ai/speaking/evaluate'), + headers: headers, + body: json.encode({ + 'audio_text': audioText, + 'prompt': prompt, + }), + ); + + if (response.statusCode == 200) { + return json.decode(response.body); + } else { + throw Exception('Failed to evaluate speaking: ${response.statusCode}'); + } + } catch (e) { + throw Exception('Error evaluating speaking: $e'); + } + } + + /// 获取AI使用统计 + Future> getAIUsageStats() async { + try { + final headers = _getAuthHeaders(); + final response = await http.get( + Uri.parse('$_baseUrl/api/v1/ai/stats'), + headers: headers, + ); + + if (response.statusCode == 200) { + return json.decode(response.body); + } else { + throw Exception('Failed to get AI stats: ${response.statusCode}'); + } + } catch (e) { + throw Exception('Error getting AI stats: $e'); + } + } + + /// 上传音频文件 + Future> uploadAudio(File audioFile) async { + try { + final storageService = StorageService.instance; + final token = storageService.getString(StorageKeys.accessToken); + final request = http.MultipartRequest( + 'POST', + Uri.parse('$_baseUrl/api/v1/upload/audio'), + ); + + if (token != null) { + request.headers['Authorization'] = 'Bearer $token'; + } + request.files.add( + await http.MultipartFile.fromPath('audio', audioFile.path), + ); + + final streamedResponse = await request.send(); + final response = await http.Response.fromStream(streamedResponse); + + if (response.statusCode == 200) { + return json.decode(response.body); + } else { + throw Exception('Failed to upload audio: ${response.statusCode}'); + } + } catch (e) { + throw Exception('Error uploading audio: $e'); + } + } + + /// 上传图片文件 + Future> uploadImage(File imageFile) async { + try { + final storageService = StorageService.instance; + final token = storageService.getString(StorageKeys.accessToken); + final request = http.MultipartRequest( + 'POST', + Uri.parse('$_baseUrl/api/v1/upload/image'), + ); + + if (token != null) { + request.headers['Authorization'] = 'Bearer $token'; + } + request.files.add( + await http.MultipartFile.fromPath('image', imageFile.path), + ); + + final streamedResponse = await request.send(); + final response = await http.Response.fromStream(streamedResponse); + + if (response.statusCode == 200) { + return json.decode(response.body); + } else { + throw Exception('Failed to upload image: ${response.statusCode}'); + } + } catch (e) { + throw Exception('Error uploading image: $e'); + } + } + + /// 删除文件 + Future> deleteFile(String fileId) async { + try { + final headers = _getAuthHeaders(); + final response = await http.delete( + Uri.parse('$_baseUrl/api/v1/upload/file/$fileId'), + headers: headers, + ); + + if (response.statusCode == 200) { + return json.decode(response.body); + } else { + throw Exception('Failed to delete file: ${response.statusCode}'); + } + } catch (e) { + throw Exception('Error deleting file: $e'); + } + } + + /// 获取文件信息 + Future> getFileInfo(String fileId) async { + try { + final headers = _getAuthHeaders(); + final response = await http.get( + Uri.parse('$_baseUrl/api/v1/upload/file/$fileId'), + headers: headers, + ); + + if (response.statusCode == 200) { + return json.decode(response.body); + } else { + throw Exception('Failed to get file info: ${response.statusCode}'); + } + } catch (e) { + throw Exception('Error getting file info: $e'); + } + } + + /// 获取上传统计 + Future> getUploadStats({int days = 30}) async { + try { + final headers = _getAuthHeaders(); + final response = await http.get( + Uri.parse('$_baseUrl/api/v1/upload/stats?days=$days'), + headers: headers, + ); + + if (response.statusCode == 200) { + return json.decode(response.body); + } else { + throw Exception('Failed to get upload stats: ${response.statusCode}'); + } + } catch (e) { + throw Exception('Error getting upload stats: $e'); + } + } +} \ No newline at end of file diff --git a/client/lib/core/network/api_client.dart b/client/lib/core/network/api_client.dart new file mode 100644 index 0000000..d55dfbb --- /dev/null +++ b/client/lib/core/network/api_client.dart @@ -0,0 +1,252 @@ +import 'package:dio/dio.dart'; +import '../constants/app_constants.dart'; +import '../services/storage_service.dart'; +import '../services/navigation_service.dart'; +import '../routes/app_routes.dart'; + +/// API客户端配置 +class ApiClient { + static ApiClient? _instance; + late Dio _dio; + late StorageService _storageService; + + ApiClient._internal() { + _dio = Dio(); + } + + static Future getInstance() async { + if (_instance == null) { + _instance = ApiClient._internal(); + _instance!._storageService = await StorageService.getInstance(); + await _instance!._setupInterceptors(); + } + return _instance!; + } + + static ApiClient get instance { + if (_instance == null) { + throw Exception('ApiClient not initialized. Call ApiClient.getInstance() first.'); + } + return _instance!; + } + + Dio get dio => _dio; + + /// 配置拦截器 + Future _setupInterceptors() async { + // 基础配置 + _dio.options = BaseOptions( + baseUrl: AppConstants.baseUrl, + connectTimeout: Duration(milliseconds: AppConstants.connectTimeout), + receiveTimeout: Duration(milliseconds: AppConstants.receiveTimeout), + headers: { + 'Content-Type': 'application/json', + 'Accept': 'application/json', + }, + ); + + // 请求拦截器 + _dio.interceptors.add( + InterceptorsWrapper( + onRequest: (options, handler) async { + // 添加认证token + final token = await _storageService.getToken(); + if (token != null && token.isNotEmpty) { + options.headers['Authorization'] = 'Bearer $token'; + } + + handler.next(options); + }, + onResponse: (response, handler) { + handler.next(response); + }, + onError: (error, handler) async { + // 处理401错误，尝试刷新token + if (error.response?.statusCode == 401) { + final refreshed = await _refreshToken(); + if (refreshed) { + // 重新发送请求 + final options = error.requestOptions; + final token = await _storageService.getToken(); + options.headers['Authorization'] = 'Bearer $token'; + + try { + final response = await _dio.fetch(options); + handler.resolve(response); + return; + } catch (e) { + // 刷新后仍然失败，清除token并跳转登录 + await _clearTokensAndRedirectToLogin(); + } + } else { + // 刷新失败，清除token并跳转登录 + await _clearTokensAndRedirectToLogin(); + } + } + + handler.next(error); + }, + ), + ); + + // 日志拦截器（仅在调试模式下） + if (const bool.fromEnvironment('dart.vm.product') == false) { + _dio.interceptors.add( + LogInterceptor( + requestHeader: true, + requestBody: true, + responseBody: true, + responseHeader: false, + error: true, + logPrint: (obj) => print(obj), + ), + ); + } + } + + /// 刷新token + Future _refreshToken() async { + try { + final refreshToken = await _storageService.getRefreshToken(); + if (refreshToken == null || refreshToken.isEmpty) { + return false; + } + + final response = await _dio.post( + '/auth/refresh', + data: {'refresh_token': refreshToken}, + options: Options( + headers: {'Authorization': null}, // 移除Authorization头 + ), + ); + + if (response.statusCode == 200) { + final data = response.data; + await _storageService.saveToken(data['access_token']); + if (data['refresh_token'] != null) { + await _storageService.saveRefreshToken(data['refresh_token']); + } + return true; + } + } catch (e) { + print('Token refresh failed: $e'); + } + + return false; + } + + /// 清除token并跳转登录 + Future _clearTokensAndRedirectToLogin() async { + await _storageService.clearTokens(); + + // 跳转到登录页面并清除所有历史记录 + NavigationService.instance.navigateToAndClearStack(Routes.login); + + // 显示提示信息 + NavigationService.instance.showErrorSnackBar('登录已过期，请重新登录'); + } + + /// GET请求 + Future> get( + String path, { + Map? queryParameters, + Options? options, + CancelToken? cancelToken, + }) async { + return await _dio.get( + path, + queryParameters: queryParameters, + options: options, + cancelToken: cancelToken, + ); + } + + /// POST请求 + Future> post( + String path, { + dynamic data, + Map? queryParameters, + Options? options, + CancelToken? cancelToken, + }) async { + return await _dio.post( + path, + data: data, + queryParameters: queryParameters, + options: options, + cancelToken: cancelToken, + ); + } + + /// PUT请求 + Future> put( + String path, { + dynamic data, + Map? queryParameters, + Options? options, + CancelToken? cancelToken, + }) async { + return await _dio.put( + path, + data: data, + queryParameters: queryParameters, + options: options, + cancelToken: cancelToken, + ); + } + + /// DELETE请求 + Future> delete( + String path, { + dynamic data, + Map? queryParameters, + Options? options, + CancelToken? cancelToken, + }) async { + return await _dio.delete( + path, + data: data, + queryParameters: queryParameters, + options: options, + cancelToken: cancelToken, + ); + } + + /// 上传文件 + Future> upload( + String path, + FormData formData, { + Map? queryParameters, + Options? options, + CancelToken? cancelToken, + ProgressCallback? onSendProgress, + }) async { + return await _dio.post( + path, + data: formData, + queryParameters: queryParameters, + options: options, + cancelToken: cancelToken, + onSendProgress: onSendProgress, + ); + } + + /// 下载文件 + Future download( + String urlPath, + String savePath, { + Map? queryParameters, + Options? options, + CancelToken? cancelToken, + ProgressCallback? onReceiveProgress, + }) async { + return await _dio.download( + urlPath, + savePath, + queryParameters: queryParameters, + options: options, + cancelToken: cancelToken, + onReceiveProgress: onReceiveProgress, + ); + } +} \ No newline at end of file diff --git a/client/lib/core/network/api_endpoints.dart b/client/lib/core/network/api_endpoints.dart new file mode 100644 index 0000000..949fd14 --- /dev/null +++ b/client/lib/core/network/api_endpoints.dart @@ -0,0 +1,77 @@ +import '../config/environment.dart'; + +/// API端点配置 +class ApiEndpoints { + // 基础URL - 从环境配置获取 + static String get baseUrl => EnvironmentConfig.baseUrl; + + // 认证相关 + static const String login = '/auth/login'; + static const String register = '/auth/register'; + static const String logout = '/auth/logout'; + static const String refreshToken = '/auth/refresh'; + static const String forgotPassword = '/auth/forgot-password'; + static const String resetPassword = '/auth/reset-password'; + static const String changePassword = '/auth/change-password'; + static const String socialLogin = '/auth/social-login'; + static const String verifyEmail = '/auth/verify-email'; + static const String resendVerificationEmail = '/auth/resend-verification'; + + // 用户相关 + static const String userInfo = '/user/profile'; + static const String updateProfile = '/user/profile'; + static const String uploadAvatar = '/user/avatar'; + static const String checkUsername = '/user/check-username'; + static const String checkEmail = '/user/check-email'; + + // 学习相关 + static const String learningProgress = '/learning/progress'; + static const String learningStats = '/learning/stats'; + static const String dailyGoal = '/learning/daily-goal'; + + // 词汇相关 + static const String vocabulary = '/vocabulary'; + static const String vocabularyTest = '/vocabulary/test'; + static const String vocabularyProgress = '/vocabulary/progress'; + static const String wordBooks = '/vocabulary/books'; + static const String wordLists = '/vocabulary/lists'; + + // 听力相关 + static const String listening = '/listening'; + static const String listeningMaterials = '/listening/materials'; + static const String listeningRecords = '/listening/records'; + static const String listeningStats = '/listening/stats'; + + // 阅读相关 + static const String reading = '/reading'; + static const String readingMaterials = '/reading/materials'; + static const String readingRecords = '/reading/records'; + static const String readingStats = '/reading/stats'; + + // 写作相关 + static const String writing = '/writing'; + static const String writingPrompts = '/writing/prompts'; + static const String writingSubmissions = '/writing/submissions'; + static const String writingStats = '/writing/stats'; + + // 口语相关 + static const String speaking = '/speaking'; + static const String speakingScenarios = '/speaking/scenarios'; + static const String speakingRecords = '/speaking/records'; + static const String speakingStats = '/speaking/stats'; + + // AI相关 + static const String aiChat = '/ai/chat'; + static const String aiCorrection = '/ai/correction'; + static const String aiSuggestion = '/ai/suggestion'; + + // 文件上传 + static const String upload = '/upload'; + static const String uploadAudio = '/upload/audio'; + static const String uploadImage = '/upload/image'; + + // 系统相关 + static const String version = '/version'; + static const String config = '/system/config'; + static const String feedback = '/system/feedback'; +} \ No newline at end of file diff --git a/client/lib/core/providers/app_state_provider.dart b/client/lib/core/providers/app_state_provider.dart new file mode 100644 index 0000000..fc58399 --- /dev/null +++ b/client/lib/core/providers/app_state_provider.dart @@ -0,0 +1,154 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../shared/providers/auth_provider.dart'; +import '../../shared/providers/vocabulary_provider.dart'; +import '../../shared/services/auth_service.dart'; +import '../../shared/services/vocabulary_service.dart'; +import '../network/api_client.dart'; + +/// 全局应用状态管理 +class AppStateNotifier extends StateNotifier { + AppStateNotifier() : super(const AppState()); + + void updateTheme(ThemeMode themeMode) { + state = state.copyWith(themeMode: themeMode); + } + + void updateLocale(String locale) { + state = state.copyWith(locale: locale); + } + + void updateNetworkStatus(bool isOnline) { + state = state.copyWith(isOnline: isOnline); + } + + void updateLoading(bool isLoading) { + state = state.copyWith(isGlobalLoading: isLoading); + } +} + +/// 应用状态模型 +class AppState { + final ThemeMode themeMode; + final String locale; + final bool isOnline; + final bool isGlobalLoading; + + const AppState({ + this.themeMode = ThemeMode.light, + this.locale = 'zh_CN', + this.isOnline = true, + this.isGlobalLoading = false, + }); + + AppState copyWith({ + ThemeMode? themeMode, + String? locale, + bool? isOnline, + bool? isGlobalLoading, + }) { + return AppState( + themeMode: themeMode ?? this.themeMode, + locale: locale ?? this.locale, + isOnline: isOnline ?? this.isOnline, + isGlobalLoading: isGlobalLoading ?? this.isGlobalLoading, + ); + } +} + +/// 全局状态Provider +final appStateProvider = StateNotifierProvider( + (ref) => AppStateNotifier(), +); + +/// API客户端Provider +final apiClientProvider = Provider( + (ref) => ApiClient.instance, +); + +/// 认证服务Provider +final authServiceProvider = Provider( + (ref) => AuthService(), +); + +/// 词汇服务Provider +final vocabularyServiceProvider = Provider( + (ref) => VocabularyService(), +); + +/// 认证Provider +final authProvider = ChangeNotifierProvider( + (ref) { + final authService = ref.read(authServiceProvider); + return AuthProvider()..initialize(); + }, +); + +/// 词汇Provider +final vocabularyProvider = ChangeNotifierProvider( + (ref) { + final vocabularyService = ref.read(vocabularyServiceProvider); + return VocabularyProvider(vocabularyService); + }, +); + +/// 网络状态Provider +final networkStatusProvider = StreamProvider( + (ref) async* { + // 这里可以实现网络状态监听 + yield true; // 默认在线状态 + }, +); + +/// 缓存管理Provider +final cacheManagerProvider = Provider( + (ref) => CacheManager(), +); + +/// 缓存管理器 +class CacheManager { + final Map _cache = {}; + final Map _cacheTimestamps = {}; + final Duration _defaultCacheDuration = const Duration(minutes: 30); + + /// 设置缓存 + void set(String key, dynamic value, {Duration? duration}) { + _cache[key] = value; + _cacheTimestamps[key] = DateTime.now(); + } + + /// 获取缓存 + T? get(String key, {Duration? duration}) { + final timestamp = _cacheTimestamps[key]; + if (timestamp == null) return null; + + final cacheDuration = duration ?? _defaultCacheDuration; + if (DateTime.now().difference(timestamp) > cacheDuration) { + remove(key); + return null; + } + + return _cache[key] as T?; + } + + /// 移除缓存 + void remove(String key) { + _cache.remove(key); + _cacheTimestamps.remove(key); + } + + /// 清空缓存 + void clear() { + _cache.clear(); + _cacheTimestamps.clear(); + } + + /// 检查缓存是否存在且有效 + bool isValid(String key, {Duration? duration}) { + final timestamp = _cacheTimestamps[key]; + if (timestamp == null) return false; + + final cacheDuration = duration ?? _defaultCacheDuration; + return DateTime.now().difference(timestamp) <= cacheDuration; + } +} \ No newline at end of file diff --git a/client/lib/core/providers/providers.dart b/client/lib/core/providers/providers.dart new file mode 100644 index 0000000..f07914e --- /dev/null +++ b/client/lib/core/providers/providers.dart @@ -0,0 +1,85 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import 'app_state_provider.dart'; +import '../../shared/providers/network_provider.dart'; +import '../../shared/providers/error_provider.dart'; +import '../../features/auth/providers/auth_provider.dart' as auth; +import '../../features/vocabulary/providers/vocabulary_provider.dart' as vocab; +import '../../features/comprehensive_test/providers/test_riverpod_provider.dart' as test; + +/// 全局Provider配置 +class GlobalProviders { + static final List overrides = [ + // 这里可以添加测试时的Provider覆盖 + ]; + + static final List observers = [ + ProviderLogger(), + ]; + + /// 获取所有核心Provider + static List get coreProviders => [ + // 应用状态 + appStateProvider, + networkProvider, + errorProvider, + + // 认证相关 + auth.authProvider, + + // 词汇相关 + vocab.vocabularyProvider, + + // 综合测试相关 + test.testProvider, + ]; + + /// 预加载Provider + static Future preloadProviders(ProviderContainer container) async { + // 预加载网络状态 + container.read(networkProvider.notifier).refreshNetworkStatus(); + + // 认证状态会在AuthNotifier构造时自动检查 + // 这里只需要读取provider来触发初始化 + container.read(auth.authProvider); + } +} + +/// Provider状态监听器 +class ProviderLogger extends ProviderObserver { + @override + void didUpdateProvider( + ProviderBase provider, + Object? previousValue, + Object? newValue, + ProviderContainer container, + ) { + print('Provider ${provider.name ?? provider.runtimeType} updated: $newValue'); + } + + @override + void didAddProvider( + ProviderBase provider, + Object? value, + ProviderContainer container, + ) { + print('Provider ${provider.name ?? provider.runtimeType} added: $value'); + } + + @override + void didDisposeProvider( + ProviderBase provider, + ProviderContainer container, + ) { + print('Provider ${provider.name ?? provider.runtimeType} disposed'); + } + + @override + void providerDidFail( + ProviderBase provider, + Object error, + StackTrace stackTrace, + ProviderContainer container, + ) { + print('Provider ${provider.name ?? provider.runtimeType} failed: $error'); + } +} \ No newline at end of file diff --git a/client/lib/core/routes/app_routes.dart b/client/lib/core/routes/app_routes.dart new file mode 100644 index 0000000..baf931d --- /dev/null +++ b/client/lib/core/routes/app_routes.dart @@ -0,0 +1,496 @@ +import 'package:flutter/material.dart'; +import '../../features/auth/screens/splash_screen.dart'; +import '../../features/auth/screens/login_screen.dart'; +import '../../features/auth/screens/register_screen.dart'; +import '../../features/auth/screens/forgot_password_screen.dart'; +import '../../features/main/screens/main_app_screen.dart'; +import '../../features/learning/screens/learning_home_screen.dart'; +import '../../features/vocabulary/screens/vocabulary_home_screen.dart'; +import '../../features/vocabulary/screens/vocabulary_category_screen.dart'; + +import '../../features/vocabulary/screens/vocabulary_book_screen.dart'; +import '../../features/vocabulary/screens/word_learning_screen.dart'; +import '../../features/vocabulary/screens/smart_review_screen.dart'; +import '../../features/vocabulary/screens/vocabulary_test_screen.dart'; +import '../../features/vocabulary/screens/daily_words_screen.dart'; +import '../../features/vocabulary/screens/ai_recommendation_screen.dart'; +import '../../features/vocabulary/screens/word_book_screen.dart'; +import '../../features/vocabulary/screens/study_plan_screen.dart'; +import '../../features/vocabulary/models/word_model.dart'; +import '../../features/vocabulary/models/vocabulary_book_model.dart'; +import '../../features/vocabulary/models/review_models.dart'; +import '../../features/listening/screens/listening_home_screen.dart'; +import '../../features/listening/screens/listening_category_screen.dart'; +import '../../features/listening/screens/listening_exercise_detail_screen.dart'; +import '../../features/listening/screens/listening_difficulty_screen.dart'; +import '../../features/listening/screens/listening_stats_screen.dart'; +import '../../features/listening/models/listening_exercise_model.dart'; +// 移除静态数据依赖 +import '../../features/reading/screens/reading_home_screen.dart'; +import '../../features/writing/screens/writing_home_screen.dart'; +import '../../features/speaking/screens/speaking_home_screen.dart'; +import '../../features/comprehensive_test/screens/comprehensive_test_screen.dart'; +import '../../features/profile/screens/profile_home_screen.dart'; +import '../../features/profile/screens/profile_edit_screen.dart'; +import '../../features/profile/screens/settings_screen.dart'; +import '../../features/profile/screens/help_feedback_screen.dart'; +import '../../features/ai/pages/ai_main_page.dart'; +import '../../features/ai/pages/ai_writing_page.dart'; +import '../../features/ai/pages/ai_speaking_page.dart'; +import '../../features/home/screens/learning_stats_detail_screen.dart'; +import '../../features/notification/screens/notification_list_screen.dart'; +import '../widgets/not_found_screen.dart'; + +// 学习模式枚举 +enum LearningMode { + normal, + review, + test +} + + + + + +/// 路由名称常量 +class Routes { + static const String splash = '/splash'; + static const String login = '/login'; + static const String register = '/register'; + static const String forgotPassword = '/forgot-password'; + static const String home = '/home'; + static const String learning = '/learning'; + static const String profile = '/profile'; + static const String editProfile = '/edit-profile'; + static const String settings = '/settings'; + static const String helpFeedback = '/help-feedback'; + static const String vocabularyHome = '/vocabulary'; + static const String vocabularyCategory = '/vocabulary/category'; + static const String vocabularyList = '/vocabulary/list'; + static const String vocabularyBook = '/vocabulary/book'; + static const String wordDetail = '/vocabulary/word'; + static const String vocabularyTest = '/vocabulary/test'; + static const String wordLearning = '/vocabulary/learning'; + static const String smartReview = '/vocabulary/smart-review'; + static const String dailyWords = '/vocabulary/daily-words'; + static const String aiRecommendation = '/vocabulary/ai-recommendation'; + static const String wordBook = '/vocabulary/word-book'; + static const String studyPlan = '/vocabulary/study-plan'; + static const String listeningHome = '/listening'; + static const String listeningExercise = '/listening/exercise'; + static const String listeningCategory = '/listening/category'; + static const String listeningExerciseDetail = '/listening/exercise-detail'; + static const String listeningDifficulty = '/listening/difficulty'; + static const String listeningStats = '/listening/stats'; + static const String readingHome = '/reading'; + static const String readingExercise = '/reading/exercise'; + static const String writingHome = '/writing'; + static const String writingExercise = '/writing/exercise'; + static const String speakingHome = '/speaking'; + static const String speakingExercise = '/speaking/exercise'; + static const String comprehensiveTest = '/comprehensive-test'; + static const String ai = '/ai'; + static const String aiWriting = '/ai/writing'; + static const String aiSpeaking = '/ai/speaking'; + static const String learningStatsDetail = '/learning-stats-detail'; + static const String notifications = '/notifications'; +} + +/// 应用路由配置 +class AppRoutes { + /// 路由映射表 + static final Map _routes = { + Routes.splash: (context) => const SplashScreen(), + Routes.login: (context) => const LoginScreen(), + Routes.register: (context) => const RegisterScreen(), + Routes.forgotPassword: (context) => const ForgotPasswordScreen(), + Routes.home: (context) => const MainAppScreen(), + Routes.learning: (context) => const LearningHomeScreen(), + Routes.vocabularyHome: (context) => const VocabularyHomeScreen(), + // TODO: 这些路由需要参数，暂时注释掉，后续通过onGenerateRoute处理 + // Routes.vocabularyList: (context) => const VocabularyBookScreen(), + // Routes.wordDetail: (context) => const WordLearningScreen(), + // Routes.vocabularyTest: (context) => const VocabularyTestScreen(), + // Routes.wordLearning: (context) => const SmartReviewScreen(), + Routes.dailyWords: (context) => const DailyWordsScreen(), + Routes.aiRecommendation: (context) => const AIRecommendationScreen(), + Routes.wordBook: (context) => const WordBookScreen(), + Routes.studyPlan: (context) => const StudyPlanScreen(), + Routes.listeningHome: (context) => const ListeningHomeScreen(), + Routes.listeningDifficulty: (context) => const ListeningDifficultyScreen(), + Routes.listeningStats: (context) => const ListeningStatsScreen(), + Routes.readingHome: (context) => const ReadingHomeScreen(), + Routes.writingHome: (context) => const WritingHomeScreen(), + Routes.speakingHome: (context) => const SpeakingHomeScreen(), + Routes.comprehensiveTest: (context) => const ComprehensiveTestScreen(), + Routes.profile: (context) => const ProfileHomeScreen(), + Routes.editProfile: (context) => const ProfileEditScreen(), + Routes.settings: (context) => const SettingsScreen(), + Routes.helpFeedback: (context) => const HelpFeedbackScreen(), + Routes.ai: (context) => const AIMainPage(), + Routes.aiWriting: (context) => const AIWritingPage(), + Routes.aiSpeaking: (context) => const AISpeakingPage(), + Routes.learningStatsDetail: (context) => const LearningStatsDetailScreen(), + Routes.notifications: (context) => const NotificationListScreen(), + // TODO: 添加其他页面路由 + }; + + /// 获取路由映射表 + static Map get routes => _routes; + + /// 路由生成器 + static Route? onGenerateRoute(RouteSettings settings) { + final String routeName = settings.name ?? ''; + final arguments = settings.arguments; + + // 处理带参数的词汇学习路由 + switch (routeName) { + case Routes.vocabularyCategory: + if (arguments is Map) { + final category = arguments['category']; + if (category != null) { + return MaterialPageRoute( + builder: (context) => VocabularyCategoryScreen(category: category), + settings: settings, + ); + } + } + break; + + case Routes.vocabularyList: + if (arguments is Map) { + final vocabularyBook = arguments['vocabularyBook']; + if (vocabularyBook != null) { + return MaterialPageRoute( + builder: (context) => VocabularyBookScreen(vocabularyBook: vocabularyBook), + settings: settings, + ); + } + } + break; + + case Routes.wordLearning: + if (arguments is Map) { + final vocabularyBook = arguments['vocabularyBook']; + final specificWords = arguments['specificWords']; + final mode = arguments['mode']; + if (vocabularyBook != null) { + return MaterialPageRoute( + builder: (context) => WordLearningScreen( + vocabularyBook: vocabularyBook, + specificWords: specificWords, + mode: mode ?? LearningMode.normal, + ), + settings: settings, + ); + } + } + break; + + case Routes.vocabularyTest: + // 词汇测试路由，支持带参数和不带参数的情况 + if (arguments is Map) { + final vocabularyBook = arguments['vocabularyBook']; + final testType = arguments['testType']; + final questionCount = arguments['questionCount']; + return MaterialPageRoute( + builder: (context) => VocabularyTestScreen( + vocabularyBook: vocabularyBook, + testType: testType ?? TestType.vocabularyLevel, + questionCount: questionCount ?? 20, + ), + settings: settings, + ); + } else { + // 没有参数时，使用默认设置 + return MaterialPageRoute( + builder: (context) => const VocabularyTestScreen( + testType: TestType.vocabularyLevel, + questionCount: 20, + ), + settings: settings, + ); + } + break; + + case Routes.wordDetail: + if (arguments is Map) { + final vocabularyBook = arguments['vocabularyBook']; + final reviewMode = arguments['reviewMode']; + final dailyTarget = arguments['dailyTarget']; + return MaterialPageRoute( + builder: (context) => SmartReviewScreen( + vocabularyBook: vocabularyBook, + reviewMode: reviewMode ?? ReviewMode.adaptive, + dailyTarget: dailyTarget ?? 20, + ), + settings: settings, + ); + } + break; + + case Routes.smartReview: + // 智能复习路由，支持带参数和不带参数的情况 + if (arguments is Map) { + final vocabularyBook = arguments['vocabularyBook']; + final reviewMode = arguments['reviewMode']; + final dailyTarget = arguments['dailyTarget']; + return MaterialPageRoute( + builder: (context) => SmartReviewScreen( + vocabularyBook: vocabularyBook, + reviewMode: reviewMode ?? ReviewMode.adaptive, + dailyTarget: dailyTarget ?? 20, + ), + settings: settings, + ); + } else { + // 没有参数时，使用默认设置 + return MaterialPageRoute( + builder: (context) => const SmartReviewScreen( + reviewMode: ReviewMode.adaptive, + dailyTarget: 20, + ), + settings: settings, + ); + } + break; + + // 听力相关路由 + case Routes.listeningCategory: + if (arguments is Map) { + final type = arguments['type'] as ListeningExerciseType; + final title = arguments['title'] as String; + final category = ListeningCategory( + id: type.toString(), + name: title, + description: '${title}练习材料', + icon: Icons.headphones, + exerciseCount: 0, + type: type, + ); + return MaterialPageRoute( + builder: (context) => ListeningCategoryScreen( + category: category, + ), + settings: settings, + ); + } + break; + + case Routes.listeningExerciseDetail: + if (arguments is Map) { + final exerciseId = arguments['exerciseId']; + if (exerciseId != null) { + return MaterialPageRoute( + builder: (context) => ListeningExerciseDetailScreen( + exerciseId: exerciseId, + ), + settings: settings, + ); + } + } + break; + } + + // 默认路由处理 + final WidgetBuilder? builder = _routes[routeName]; + if (builder != null) { + return MaterialPageRoute( + builder: builder, + settings: settings, + ); + } + + // 未找到路由时的处理 + return MaterialPageRoute( + builder: (context) => const NotFoundScreen(), + settings: settings, + ); + } + + /// 路由守卫 - 检查是否需要认证 + static bool requiresAuth(String routeName) { + const publicRoutes = [ + Routes.splash, + Routes.login, + Routes.register, + Routes.forgotPassword, + ]; + + return !publicRoutes.contains(routeName); + } + + /// 获取初始路由 + static String getInitialRoute(bool isLoggedIn) { + return isLoggedIn ? Routes.home : Routes.splash; + } +} + +/// 启动页面 +class SplashScreen extends StatefulWidget { + const SplashScreen({super.key}); + + @override + State createState() => _SplashScreenState(); +} + +class _SplashScreenState extends State { + @override + void initState() { + super.initState(); + _initializeApp(); + } + + Future _initializeApp() async { + // 初始化应用配置 + await Future.delayed(const Duration(seconds: 2)); + + if (mounted) { + // 导航到登录页面，让用户进行认证 + Navigator.of(context).pushReplacementNamed(Routes.login); + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + body: Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + // TODO: 添加应用Logo + Icon( + Icons.school, + size: 100, + color: Theme.of(context).primaryColor, + ), + const SizedBox(height: 24), + Text( + 'AI英语学习', + style: Theme.of(context).textTheme.headlineMedium?.copyWith( + fontWeight: FontWeight.bold, + color: Theme.of(context).primaryColor, + ), + ), + const SizedBox(height: 16), + Text( + '智能化英语学习平台', + style: Theme.of(context).textTheme.bodyLarge?.copyWith( + color: Theme.of(context).textTheme.bodySmall?.color, + ), + ), + const SizedBox(height: 48), + const CircularProgressIndicator(), + ], + ), + ), + ); + } +} + +/// 404页面 +class NotFoundScreen extends StatelessWidget { + const NotFoundScreen({super.key}); + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('页面未找到'), + ), + body: Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 100, + color: Theme.of(context).colorScheme.error, + ), + const SizedBox(height: 24), + Text( + '404', + style: Theme.of(context).textTheme.headlineLarge?.copyWith( + fontWeight: FontWeight.bold, + color: Theme.of(context).colorScheme.error, + ), + ), + const SizedBox(height: 16), + Text( + '抱歉，您访问的页面不存在', + style: Theme.of(context).textTheme.bodyLarge, + ), + const SizedBox(height: 32), + ElevatedButton( + onPressed: () { + Navigator.of(context).pushNamedAndRemoveUntil( + Routes.home, + (route) => false, + ); + }, + child: const Text('返回首页'), + ), + ], + ), + ), + ); + } +} + +/// 路由导航辅助类 +class AppNavigator { + /// 导航到指定页面 + static Future push( + BuildContext context, + String routeName, { + Object? arguments, + }) { + return Navigator.of(context).pushNamed( + routeName, + arguments: arguments, + ); + } + + /// 替换当前页面 + static Future pushReplacement( + BuildContext context, + String routeName, { + Object? arguments, + TO? result, + }) { + return Navigator.of(context).pushReplacementNamed( + routeName, + arguments: arguments, + result: result, + ); + } + + /// 清空栈并导航到指定页面 + static Future pushAndRemoveUntil( + BuildContext context, + String routeName, { + Object? arguments, + bool Function(Route)? predicate, + }) { + return Navigator.of(context).pushNamedAndRemoveUntil( + routeName, + predicate ?? (route) => false, + arguments: arguments, + ); + } + + /// 返回上一页 + static void pop(BuildContext context, [T? result]) { + Navigator.of(context).pop(result); + } + + /// 返回到指定页面 + static void popUntil(BuildContext context, String routeName) { + Navigator.of(context).popUntil(ModalRoute.withName(routeName)); + } + + /// 检查是否可以返回 + static bool canPop(BuildContext context) { + return Navigator.of(context).canPop(); + } +} \ No newline at end of file diff --git a/client/lib/core/services/api_service.dart b/client/lib/core/services/api_service.dart new file mode 100644 index 0000000..008a9f8 --- /dev/null +++ b/client/lib/core/services/api_service.dart @@ -0,0 +1,284 @@ +import 'package:dio/dio.dart'; +import 'package:flutter/foundation.dart'; +import 'storage_service.dart'; +import '../config/environment.dart'; + +class ApiResponse { + final dynamic data; + final int statusCode; + final String? message; + + ApiResponse({ + required this.data, + required this.statusCode, + this.message, + }); +} + +class ApiService { + late final Dio _dio; + final StorageService _storageService; + + ApiService({required StorageService storageService}) + : _storageService = storageService { + _dio = Dio(BaseOptions( + baseUrl: EnvironmentConfig.baseUrl, + connectTimeout: Duration(milliseconds: EnvironmentConfig.connectTimeout), + receiveTimeout: Duration(milliseconds: EnvironmentConfig.receiveTimeout), + headers: { + 'Content-Type': 'application/json', + 'Accept': 'application/json', + }, + )); + + _setupInterceptors(); + } + + void _setupInterceptors() { + // 请求拦截器 + _dio.interceptors.add(InterceptorsWrapper( + onRequest: (options, handler) async { + // 添加认证token + final token = await _storageService.getToken(); + if (token != null) { + options.headers['Authorization'] = 'Bearer $token'; + } + + if (kDebugMode) { + print('API Request: ${options.method} ${options.uri}'); + print('Headers: ${options.headers}'); + if (options.data != null) { + print('Data: ${options.data}'); + } + } + + handler.next(options); + }, + onResponse: (response, handler) { + if (kDebugMode) { + print('API Response: ${response.statusCode} ${response.requestOptions.uri}'); + } + handler.next(response); + }, + onError: (error, handler) { + if (kDebugMode) { + print('API Error: ${error.message}'); + print('Response: ${error.response?.data}'); + } + handler.next(error); + }, + )); + } + + // GET请求 + Future get( + String path, { + Map? queryParams, + Options? options, + }) async { + try { + final response = await _dio.get( + path, + queryParameters: queryParams, + options: options, + ); + return ApiResponse( + data: response.data, + statusCode: response.statusCode ?? 200, + message: response.statusMessage, + ); + } on DioException catch (e) { + throw _handleError(e); + } + } + + // POST请求 + Future post( + String path, + dynamic data, { + Map? queryParams, + Options? options, + }) async { + try { + final response = await _dio.post( + path, + data: data, + queryParameters: queryParams, + options: options, + ); + return ApiResponse( + data: response.data, + statusCode: response.statusCode ?? 200, + message: response.statusMessage, + ); + } on DioException catch (e) { + throw _handleError(e); + } + } + + // PUT请求 + Future put( + String path, + dynamic data, { + Map? queryParams, + Options? options, + }) async { + try { + final response = await _dio.put( + path, + data: data, + queryParameters: queryParams, + options: options, + ); + return ApiResponse( + data: response.data, + statusCode: response.statusCode ?? 200, + message: response.statusMessage, + ); + } on DioException catch (e) { + throw _handleError(e); + } + } + + // PATCH请求 + Future patch( + String path, + dynamic data, { + Map? queryParams, + Options? options, + }) async { + try { + final response = await _dio.patch( + path, + data: data, + queryParameters: queryParams, + options: options, + ); + return ApiResponse( + data: response.data, + statusCode: response.statusCode ?? 200, + message: response.statusMessage, + ); + } on DioException catch (e) { + throw _handleError(e); + } + } + + // DELETE请求 + Future delete( + String path, { + Map? queryParams, + Options? options, + }) async { + try { + final response = await _dio.delete( + path, + queryParameters: queryParams, + options: options, + ); + return ApiResponse( + data: response.data, + statusCode: response.statusCode ?? 200, + message: response.statusMessage, + ); + } on DioException catch (e) { + throw _handleError(e); + } + } + + // 上传文件 + Future uploadFile( + String path, + String filePath, { + String? fileName, + Map? data, + ProgressCallback? onSendProgress, + }) async { + try { + final formData = FormData.fromMap({ + 'file': await MultipartFile.fromFile( + filePath, + filename: fileName, + ), + ...?data, + }); + + final response = await _dio.post( + path, + data: formData, + options: Options( + headers: { + 'Content-Type': 'multipart/form-data', + }, + ), + onSendProgress: onSendProgress, + ); + + return ApiResponse( + data: response.data, + statusCode: response.statusCode ?? 200, + message: response.statusMessage, + ); + } on DioException catch (e) { + throw _handleError(e); + } + } + + // 下载文件 + Future downloadFile( + String url, + String savePath, { + ProgressCallback? onReceiveProgress, + CancelToken? cancelToken, + }) async { + try { + await _dio.download( + url, + savePath, + onReceiveProgress: onReceiveProgress, + cancelToken: cancelToken, + ); + } on DioException catch (e) { + throw _handleError(e); + } + } + + // 错误处理 + Exception _handleError(DioException error) { + switch (error.type) { + case DioExceptionType.connectionTimeout: + case DioExceptionType.sendTimeout: + case DioExceptionType.receiveTimeout: + return Exception('网络连接超时，请检查网络设置'); + case DioExceptionType.badResponse: + final statusCode = error.response?.statusCode; + final message = error.response?.data?['message'] ?? '请求失败'; + switch (statusCode) { + case 400: + return Exception('请求参数错误: $message'); + case 401: + return Exception('认证失败，请重新登录'); + case 403: + return Exception('权限不足: $message'); + case 404: + return Exception('请求的资源不存在'); + case 500: + return Exception('服务器内部错误，请稍后重试'); + default: + return Exception('请求失败($statusCode): $message'); + } + case DioExceptionType.cancel: + return Exception('请求已取消'); + case DioExceptionType.connectionError: + return Exception('网络连接失败，请检查网络设置'); + case DioExceptionType.unknown: + default: + return Exception('未知错误: ${error.message}'); + } + } + + // 取消所有请求 + void cancelRequests() { + _dio.close(); + } +} \ No newline at end of file diff --git a/client/lib/core/services/audio_service.dart b/client/lib/core/services/audio_service.dart new file mode 100644 index 0000000..30961b3 --- /dev/null +++ b/client/lib/core/services/audio_service.dart @@ -0,0 +1,378 @@ +import 'dart:io'; +import 'package:flutter/foundation.dart'; +import 'package:path_provider/path_provider.dart'; +import 'package:permission_handler/permission_handler.dart'; + +// 音频录制状态 +enum RecordingState { + idle, + recording, + paused, + stopped, +} + +// 音频播放状态 +enum PlaybackState { + idle, + playing, + paused, + stopped, +} + +class AudioService { + // 录制相关 + RecordingState _recordingState = RecordingState.idle; + String? _currentRecordingPath; + DateTime? _recordingStartTime; + + // 播放相关 + PlaybackState _playbackState = PlaybackState.idle; + String? _currentPlayingPath; + + // 回调函数 + Function(RecordingState)? onRecordingStateChanged; + Function(PlaybackState)? onPlaybackStateChanged; + Function(Duration)? onRecordingProgress; + Function(Duration)? onPlaybackProgress; + Function(String)? onRecordingComplete; + Function()? onPlaybackComplete; + + // Getters + RecordingState get recordingState => _recordingState; + PlaybackState get playbackState => _playbackState; + String? get currentRecordingPath => _currentRecordingPath; + String? get currentPlayingPath => _currentPlayingPath; + bool get isRecording => _recordingState == RecordingState.recording; + bool get isPlaying => _playbackState == PlaybackState.playing; + + // 初始化音频服务 + Future initialize() async { + // 请求麦克风权限 + await _requestPermissions(); + } + + // 请求权限 + Future _requestPermissions() async { + // Web平台不支持某些权限，需要特殊处理 + if (kIsWeb) { + // Web平台只需要麦克风权限，且通过浏览器API处理 + if (kDebugMode) { + print('Web平台：跳过权限请求'); + } + return true; + } + + try { + final microphoneStatus = await Permission.microphone.request(); + + if (microphoneStatus != PermissionStatus.granted) { + throw Exception('需要麦克风权限才能录音'); + } + + // 存储权限在某些平台可能不需要 + try { + final storageStatus = await Permission.storage.request(); + if (storageStatus != PermissionStatus.granted) { + if (kDebugMode) { + print('存储权限未授予，但继续执行'); + } + } + } catch (e) { + // 某些平台不支持存储权限，忽略错误 + if (kDebugMode) { + print('存储权限请求失败（可能不支持）: $e'); + } + } + + return true; + } catch (e) { + if (kDebugMode) { + print('权限请求失败: $e'); + } + // 在某些平台上，权限请求可能失败，但仍然可以继续 + return true; + } + } + + // 开始录音 + Future startRecording({String? fileName}) async { + try { + if (_recordingState == RecordingState.recording) { + throw Exception('已经在录音中'); + } + + await _requestPermissions(); + + // 生成录音文件路径 + if (kIsWeb) { + // Web平台使用内存存储或IndexedDB + fileName ??= 'recording_${DateTime.now().millisecondsSinceEpoch}.webm'; + _currentRecordingPath = '/recordings/$fileName'; + } else { + final directory = await getApplicationDocumentsDirectory(); + final recordingsDir = Directory('${directory.path}/recordings'); + if (!await recordingsDir.exists()) { + await recordingsDir.create(recursive: true); + } + + fileName ??= 'recording_${DateTime.now().millisecondsSinceEpoch}.m4a'; + _currentRecordingPath = '${recordingsDir.path}/$fileName'; + } + + // 这里应该使用实际的录音插件，比如 record 或 flutter_sound + // 由于没有实际的录音插件，这里只是模拟 + _recordingStartTime = DateTime.now(); + _setRecordingState(RecordingState.recording); + + if (kDebugMode) { + print('开始录音: $_currentRecordingPath'); + } + + // 模拟录音进度更新 + _startRecordingProgressTimer(); + + } catch (e) { + throw Exception('开始录音失败: ${e.toString()}'); + } + } + + // 停止录音 + Future stopRecording() async { + try { + if (_recordingState != RecordingState.recording) { + throw Exception('当前没有在录音'); + } + + // 这里应该调用实际录音插件的停止方法 + _setRecordingState(RecordingState.stopped); + + final recordingPath = _currentRecordingPath; + + if (kDebugMode) { + print('录音完成: $recordingPath'); + } + + // 通知录音完成 + if (recordingPath != null && onRecordingComplete != null) { + onRecordingComplete!(recordingPath); + } + + return recordingPath; + } catch (e) { + throw Exception('停止录音失败: ${e.toString()}'); + } + } + + // 暂停录音 + Future pauseRecording() async { + try { + if (_recordingState != RecordingState.recording) { + throw Exception('当前没有在录音'); + } + + // 这里应该调用实际录音插件的暂停方法 + _setRecordingState(RecordingState.paused); + + if (kDebugMode) { + print('录音已暂停'); + } + } catch (e) { + throw Exception('暂停录音失败: ${e.toString()}'); + } + } + + // 恢复录音 + Future resumeRecording() async { + try { + if (_recordingState != RecordingState.paused) { + throw Exception('录音没有暂停'); + } + + // 这里应该调用实际录音插件的恢复方法 + _setRecordingState(RecordingState.recording); + + if (kDebugMode) { + print('录音已恢复'); + } + } catch (e) { + throw Exception('恢复录音失败: ${e.toString()}'); + } + } + + // 播放音频 + Future playAudio(String audioPath) async { + try { + if (_playbackState == PlaybackState.playing) { + await stopPlayback(); + } + + _currentPlayingPath = audioPath; + + // 这里应该使用实际的音频播放插件，比如 audioplayers 或 just_audio + // 由于没有实际的播放插件，这里只是模拟 + _setPlaybackState(PlaybackState.playing); + + if (kDebugMode) { + print('开始播放: $audioPath'); + } + + // 模拟播放进度和完成 + _startPlaybackProgressTimer(); + + } catch (e) { + throw Exception('播放音频失败: ${e.toString()}'); + } + } + + // 暂停播放 + Future pausePlayback() async { + try { + if (_playbackState != PlaybackState.playing) { + throw Exception('当前没有在播放'); + } + + // 这里应该调用实际播放插件的暂停方法 + _setPlaybackState(PlaybackState.paused); + + if (kDebugMode) { + print('播放已暂停'); + } + } catch (e) { + throw Exception('暂停播放失败: ${e.toString()}'); + } + } + + // 恢复播放 + Future resumePlayback() async { + try { + if (_playbackState != PlaybackState.paused) { + throw Exception('播放没有暂停'); + } + + // 这里应该调用实际播放插件的恢复方法 + _setPlaybackState(PlaybackState.playing); + + if (kDebugMode) { + print('播放已恢复'); + } + } catch (e) { + throw Exception('恢复播放失败: ${e.toString()}'); + } + } + + // 停止播放 + Future stopPlayback() async { + try { + // 这里应该调用实际播放插件的停止方法 + _setPlaybackState(PlaybackState.stopped); + _currentPlayingPath = null; + + if (kDebugMode) { + print('播放已停止'); + } + } catch (e) { + throw Exception('停止播放失败: ${e.toString()}'); + } + } + + // 获取音频文件时长 + Future getAudioDuration(String audioPath) async { + try { + // 这里应该使用实际的音频插件获取时长 + // 模拟返回时长 + return const Duration(seconds: 30); + } catch (e) { + if (kDebugMode) { + print('获取音频时长失败: ${e.toString()}'); + } + return null; + } + } + + // 删除录音文件 + Future deleteRecording(String filePath) async { + try { + final file = File(filePath); + if (await file.exists()) { + await file.delete(); + return true; + } + return false; + } catch (e) { + if (kDebugMode) { + print('删除录音文件失败: ${e.toString()}'); + } + return false; + } + } + + // 获取所有录音文件 + Future> getAllRecordings() async { + try { + final directory = await getApplicationDocumentsDirectory(); + final recordingsDir = Directory('${directory.path}/recordings'); + + if (!await recordingsDir.exists()) { + return []; + } + + final files = await recordingsDir.list().toList(); + return files + .where((file) => file is File && file.path.endsWith('.m4a')) + .map((file) => file.path) + .toList(); + } catch (e) { + if (kDebugMode) { + print('获取录音文件列表失败: ${e.toString()}'); + } + return []; + } + } + + // 私有方法：设置录音状态 + void _setRecordingState(RecordingState state) { + _recordingState = state; + onRecordingStateChanged?.call(state); + } + + // 私有方法：设置播放状态 + void _setPlaybackState(PlaybackState state) { + _playbackState = state; + onPlaybackStateChanged?.call(state); + } + + // 私有方法：录音进度计时器 + void _startRecordingProgressTimer() { + // 这里应该实现实际的进度更新逻辑 + // 模拟进度更新 + } + + // 私有方法：播放进度计时器 + void _startPlaybackProgressTimer() { + // 这里应该实现实际的播放进度更新逻辑 + // 模拟播放完成 + Future.delayed(const Duration(seconds: 3), () { + _setPlaybackState(PlaybackState.stopped); + onPlaybackComplete?.call(); + }); + } + + // 释放资源 + void dispose() { + // 停止所有操作 + if (_recordingState == RecordingState.recording) { + stopRecording(); + } + if (_playbackState == PlaybackState.playing) { + stopPlayback(); + } + + // 清理回调 + onRecordingStateChanged = null; + onPlaybackStateChanged = null; + onRecordingProgress = null; + onPlaybackProgress = null; + onRecordingComplete = null; + onPlaybackComplete = null; + } +} \ No newline at end of file diff --git a/client/lib/core/services/auth_service.dart b/client/lib/core/services/auth_service.dart new file mode 100644 index 0000000..d2d06cb --- /dev/null +++ b/client/lib/core/services/auth_service.dart @@ -0,0 +1,327 @@ +import 'dart:convert'; +import 'package:dio/dio.dart'; +import '../models/user_model.dart'; +import '../network/api_client.dart'; +import '../network/api_endpoints.dart'; +import '../errors/app_exception.dart'; + +/// 认证服务 +class AuthService { + final ApiClient _apiClient; + + AuthService(this._apiClient); + + /// 登录 + Future login({ + required String account, // 用户名或邮箱 + required String password, + bool rememberMe = false, + }) async { + try { + final response = await _apiClient.post( + ApiEndpoints.login, + data: { + 'account': account, + 'password': password, + }, + ); + + // 后端返回格式: {code, message, data: {user, access_token, refresh_token, expires_in}} + final data = response.data['data']; + final userInfo = data['user']; + + return AuthResponse( + user: User( + id: userInfo['id'].toString(), + username: userInfo['username'], + email: userInfo['email'], + avatar: userInfo['avatar'], + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ), + token: data['access_token'], + refreshToken: data['refresh_token'], + expiresAt: DateTime.now().add(Duration(seconds: data['expires_in'])), + ); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('登录失败: $e'); + } + } + + /// 用户注册 + Future register({ + required String email, + required String password, + required String username, + required String nickname, + }) async { + try { + final response = await _apiClient.post( + ApiEndpoints.register, + data: { + 'email': email, + 'username': username, + 'password': password, + 'nickname': nickname, + }, + ); + + // 后端返回的数据结构需要转换 + final data = response.data['data']; + final userInfo = data['user']; + + return AuthResponse( + user: User( + id: userInfo['id'].toString(), + username: userInfo['username'], + email: userInfo['email'], + avatar: userInfo['avatar'], + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ), + token: data['access_token'], + refreshToken: data['refresh_token'], + expiresAt: DateTime.now().add(Duration(seconds: data['expires_in'])), + ); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('注册失败: $e'); + } + } + + /// 第三方登录 + Future socialLogin({ + required String provider, + required String accessToken, + }) async { + try { + final response = await _apiClient.post( + ApiEndpoints.socialLogin, + data: { + 'provider': provider, + 'access_token': accessToken, + }, + ); + + return AuthResponse.fromJson(response.data); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('第三方登录失败: $e'); + } + } + + /// 忘记密码 + Future forgotPassword(String email) async { + try { + await _apiClient.post( + ApiEndpoints.forgotPassword, + data: {'email': email}, + ); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('发送重置密码邮件失败: $e'); + } + } + + /// 重置密码 + Future resetPassword({ + required String token, + required String newPassword, + required String confirmPassword, + }) async { + try { + await _apiClient.post( + ApiEndpoints.resetPassword, + data: { + 'token': token, + 'new_password': newPassword, + 'confirm_password': confirmPassword, + }, + ); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('重置密码失败: $e'); + } + } + + /// 修改密码 + Future changePassword({ + required String currentPassword, + required String newPassword, + required String confirmPassword, + }) async { + try { + await _apiClient.put( + ApiEndpoints.changePassword, + data: { + 'current_password': currentPassword, + 'new_password': newPassword, + 'confirm_password': confirmPassword, + }, + ); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('修改密码失败: $e'); + } + } + + /// 刷新Token + Future refreshToken(String refreshToken) async { + try { + final response = await _apiClient.post( + ApiEndpoints.refreshToken, + data: {'refresh_token': refreshToken}, + ); + + return TokenRefreshResponse.fromJson(response.data); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('刷新Token失败: $e'); + } + } + + /// 登出 + Future logout() async { + try { + await _apiClient.post(ApiEndpoints.logout); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('登出失败: $e'); + } + } + + /// 获取用户信息 + Future getUserInfo() async { + try { + final response = await _apiClient.get(ApiEndpoints.userInfo); + return User.fromJson(response.data); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('获取用户信息失败: $e'); + } + } + + /// 获取当前用户信息（getUserInfo的别名） + Future getCurrentUser() async { + return await getUserInfo(); + } + + /// 更新用户信息 + Future updateUserInfo(Map data) async { + try { + final response = await _apiClient.put( + ApiEndpoints.userInfo, + data: data, + ); + return User.fromJson(response.data); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('更新用户信息失败: $e'); + } + } + + /// 验证邮箱 + Future verifyEmail(String token) async { + try { + await _apiClient.post( + ApiEndpoints.verifyEmail, + data: {'token': token}, + ); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('验证邮箱失败: $e'); + } + } + + /// 重新发送验证邮件 + Future resendVerificationEmail() async { + try { + await _apiClient.post(ApiEndpoints.resendVerificationEmail); + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('发送验证邮件失败: $e'); + } + } + + /// 检查用户名是否可用 + Future checkUsernameAvailability(String username) async { + try { + final response = await _apiClient.get( + '${ApiEndpoints.checkUsername}?username=$username', + ); + return response.data['available'] ?? false; + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('检查用户名失败: $e'); + } + } + + /// 检查邮箱是否可用 + Future checkEmailAvailability(String email) async { + try { + final response = await _apiClient.get( + '${ApiEndpoints.checkEmail}?email=$email', + ); + return response.data['available'] ?? false; + } on DioException catch (e) { + throw _handleDioException(e); + } catch (e) { + throw AppException('检查邮箱失败: $e'); + } + } + + /// 处理Dio异常 + AppException _handleDioException(DioException e) { + switch (e.type) { + case DioExceptionType.connectionTimeout: + return NetworkException('连接超时'); + case DioExceptionType.sendTimeout: + return NetworkException('发送超时'); + case DioExceptionType.receiveTimeout: + return NetworkException('接收超时'); + case DioExceptionType.badResponse: + final statusCode = e.response?.statusCode; + final message = e.response?.data?['message'] ?? '请求失败'; + + switch (statusCode) { + case 400: + return ValidationException(message); + case 401: + return AuthException('认证失败'); + case 403: + return AuthException('权限不足'); + case 404: + return AppException('资源不存在'); + case 422: + return ValidationException(message); + case 500: + return ServerException('服务器内部错误'); + default: + return AppException('请求失败: $message'); + } + case DioExceptionType.cancel: + return AppException('请求已取消'); + case DioExceptionType.connectionError: + return NetworkException('网络连接错误'); + case DioExceptionType.badCertificate: + return NetworkException('证书错误'); + case DioExceptionType.unknown: + default: + return AppException('未知错误: ${e.message}'); + } + } +} \ No newline at end of file diff --git a/client/lib/core/services/cache_service.dart b/client/lib/core/services/cache_service.dart new file mode 100644 index 0000000..5a8055a --- /dev/null +++ b/client/lib/core/services/cache_service.dart @@ -0,0 +1,252 @@ +import 'dart:convert'; +import 'package:flutter/foundation.dart'; +import '../storage/storage_service.dart'; + +/// API数据缓存服务 +class CacheService { + static const String _cachePrefix = 'api_cache_'; + static const String _timestampPrefix = 'cache_timestamp_'; + static const Duration _defaultCacheDuration = Duration(minutes: 30); + + /// 设置缓存 + static Future setCache( + String key, + dynamic data, { + Duration? duration, + }) async { + try { + final cacheKey = _cachePrefix + key; + final timestampKey = _timestampPrefix + key; + + // 存储数据 + final jsonData = jsonEncode(data); + await StorageService.setString(cacheKey, jsonData); + + // 存储时间戳 + final timestamp = DateTime.now().millisecondsSinceEpoch; + await StorageService.setInt(timestampKey, timestamp); + + if (kDebugMode) { + print('Cache set for key: $key'); + } + } catch (e) { + if (kDebugMode) { + print('Error setting cache for key $key: $e'); + } + } + } + + /// 获取缓存 + static Future getCache( + String key, { + Duration? duration, + T Function(Map)? fromJson, + }) async { + try { + final cacheKey = _cachePrefix + key; + final timestampKey = _timestampPrefix + key; + + // 检查缓存是否存在 + final cachedData = await StorageService.getString(cacheKey); + final timestamp = await StorageService.getInt(timestampKey); + + if (cachedData == null || timestamp == null) { + return null; + } + + // 检查缓存是否过期 + final cacheDuration = duration ?? _defaultCacheDuration; + final cacheTime = DateTime.fromMillisecondsSinceEpoch(timestamp); + final now = DateTime.now(); + + if (now.difference(cacheTime) > cacheDuration) { + // 缓存过期，删除缓存 + await removeCache(key); + return null; + } + + // 解析数据 + final jsonData = jsonDecode(cachedData); + + if (fromJson != null && jsonData is Map) { + return fromJson(jsonData); + } + + return jsonData as T; + } catch (e) { + if (kDebugMode) { + print('Error getting cache for key $key: $e'); + } + return null; + } + } + + /// 获取列表缓存 + static Future?> getListCache( + String key, { + Duration? duration, + required T Function(Map) fromJson, + }) async { + try { + final cacheKey = _cachePrefix + key; + final timestampKey = _timestampPrefix + key; + + // 检查缓存是否存在 + final cachedData = await StorageService.getString(cacheKey); + final timestamp = await StorageService.getInt(timestampKey); + + if (cachedData == null || timestamp == null) { + return null; + } + + // 检查缓存是否过期 + final cacheDuration = duration ?? _defaultCacheDuration; + final cacheTime = DateTime.fromMillisecondsSinceEpoch(timestamp); + final now = DateTime.now(); + + if (now.difference(cacheTime) > cacheDuration) { + // 缓存过期，删除缓存 + await removeCache(key); + return null; + } + + // 解析数据 + final jsonData = jsonDecode(cachedData); + + if (jsonData is List) { + return jsonData + .map((item) => fromJson(item as Map)) + .toList(); + } + + return null; + } catch (e) { + if (kDebugMode) { + print('Error getting list cache for key $key: $e'); + } + return null; + } + } + + /// 检查缓存是否有效 + static Future isCacheValid( + String key, { + Duration? duration, + }) async { + try { + final timestampKey = _timestampPrefix + key; + final timestamp = await StorageService.getInt(timestampKey); + + if (timestamp == null) { + return false; + } + + final cacheDuration = duration ?? _defaultCacheDuration; + final cacheTime = DateTime.fromMillisecondsSinceEpoch(timestamp); + final now = DateTime.now(); + + return now.difference(cacheTime) <= cacheDuration; + } catch (e) { + return false; + } + } + + /// 移除缓存 + static Future removeCache(String key) async { + try { + final cacheKey = _cachePrefix + key; + final timestampKey = _timestampPrefix + key; + + await StorageService.remove(cacheKey); + await StorageService.remove(timestampKey); + + if (kDebugMode) { + print('Cache removed for key: $key'); + } + } catch (e) { + if (kDebugMode) { + print('Error removing cache for key $key: $e'); + } + } + } + + /// 清空所有缓存 + static Future clearAllCache() async { + try { + final keys = StorageService.getKeys(); + final cacheKeys = keys.where((key) => + key.startsWith(_cachePrefix) || key.startsWith(_timestampPrefix)); + + for (final key in cacheKeys) { + await StorageService.remove(key); + } + + if (kDebugMode) { + print('All cache cleared'); + } + } catch (e) { + if (kDebugMode) { + print('Error clearing all cache: $e'); + } + } + } + + /// 获取缓存大小信息 + static Future> getCacheInfo() async { + try { + final keys = StorageService.getKeys(); + final cacheKeys = keys.where((key) => key.startsWith(_cachePrefix)); + final timestampKeys = keys.where((key) => key.startsWith(_timestampPrefix)); + + int totalSize = 0; + for (final key in cacheKeys) { + final data = await StorageService.getString(key); + if (data != null) { + totalSize += data.length; + } + } + + return { + 'count': cacheKeys.length, + 'size': totalSize, + 'timestamps': timestampKeys.length, + }; + } catch (e) { + return { + 'count': 0, + 'size': 0, + 'timestamps': 0, + }; + } + } + + /// 清理过期缓存 + static Future cleanExpiredCache() async { + try { + final keys = StorageService.getKeys(); + final timestampKeys = keys.where((key) => key.startsWith(_timestampPrefix)); + + for (final timestampKey in timestampKeys) { + final timestamp = await StorageService.getInt(timestampKey); + if (timestamp != null) { + final cacheTime = DateTime.fromMillisecondsSinceEpoch(timestamp); + final now = DateTime.now(); + + if (now.difference(cacheTime) > _defaultCacheDuration) { + final cacheKey = timestampKey.replaceFirst(_timestampPrefix, _cachePrefix); + await StorageService.remove(cacheKey); + await StorageService.remove(timestampKey); + } + } + } + + if (kDebugMode) { + print('Expired cache cleaned'); + } + } catch (e) { + if (kDebugMode) { + print('Error cleaning expired cache: $e'); + } + } + } +} \ No newline at end of file diff --git a/client/lib/core/services/enhanced_api_service.dart b/client/lib/core/services/enhanced_api_service.dart new file mode 100644 index 0000000..1e91267 --- /dev/null +++ b/client/lib/core/services/enhanced_api_service.dart @@ -0,0 +1,288 @@ +import 'package:flutter/foundation.dart'; +import 'package:dio/dio.dart'; +import '../network/api_client.dart'; +import '../services/cache_service.dart'; +import '../models/api_response.dart'; +import '../storage/storage_service.dart'; + +/// 增强版API服务，集成缓存功能 +class EnhancedApiService { + final ApiClient _apiClient = ApiClient.instance; + + /// GET请求，支持缓存 + Future> get( + String endpoint, { + Map? queryParameters, + bool useCache = true, + Duration? cacheDuration, + T Function(Map)? fromJson, + }) async { + try { + // 生成缓存键 + final cacheKey = _generateCacheKey('GET', endpoint, queryParameters); + + // 尝试从缓存获取数据 + if (useCache) { + final cachedData = await CacheService.getCache( + cacheKey, + duration: cacheDuration, + fromJson: fromJson, + ); + + if (cachedData != null) { + if (kDebugMode) { + print('Cache hit for: $endpoint'); + } + return ApiResponse.success( + data: cachedData, + message: 'Data from cache', + ); + } + } + + // 发起网络请求 + final response = await _apiClient.get( + endpoint, + queryParameters: queryParameters, + ); + + if (response.statusCode == 200 && response.data != null) { + // 缓存成功响应的数据 + if (useCache) { + await CacheService.setCache( + cacheKey, + response.data, + duration: cacheDuration, + ); + } + + return ApiResponse.success( + data: fromJson != null ? fromJson(response.data) : response.data, + message: 'Success', + ); + } + + return ApiResponse.error( + message: 'Request failed with status: ${response.statusCode}', + code: response.statusCode, + ); + } catch (e) { + if (kDebugMode) { + print('Error in enhanced GET request: $e'); + } + return ApiResponse.error( + message: e.toString(), + ); + } + } + + /// POST请求 + Future> post( + String endpoint, { + Map? data, + bool invalidateCache = true, + List? cacheKeysToInvalidate, + T Function(Map)? fromJson, + }) async { + try { + final response = await _apiClient.post( + endpoint, + data: data, + ); + + if (response.statusCode == 200 || response.statusCode == 201) { + // POST请求成功后，清除相关缓存 + if (invalidateCache) { + await _invalidateRelatedCache(endpoint, cacheKeysToInvalidate); + } + + return ApiResponse.success( + data: fromJson != null && response.data != null ? fromJson(response.data) : response.data, + message: 'Success', + ); + } + + return ApiResponse.error( + message: 'Request failed with status: ${response.statusCode}', + code: response.statusCode, + ); + } catch (e) { + if (kDebugMode) { + print('Error in enhanced POST request: $e'); + } + return ApiResponse.error( + message: e.toString(), + ); + } + } + + /// PUT请求 + Future> put( + String endpoint, { + Map? data, + bool invalidateCache = true, + List? cacheKeysToInvalidate, + T Function(Map)? fromJson, + }) async { + try { + final response = await _apiClient.put( + endpoint, + data: data, + ); + + if (response.statusCode == 200) { + // PUT请求成功后，清除相关缓存 + if (invalidateCache) { + await _invalidateRelatedCache(endpoint, cacheKeysToInvalidate); + } + + return ApiResponse.success( + data: fromJson != null && response.data != null ? fromJson(response.data) : response.data, + message: 'Success', + ); + } + + return ApiResponse.error( + message: 'Request failed with status: ${response.statusCode}', + code: response.statusCode, + ); + } catch (e) { + if (kDebugMode) { + print('Error in enhanced PUT request: $e'); + } + return ApiResponse.error( + message: e.toString(), + ); + } + } + + /// DELETE请求 + Future> delete( + String endpoint, { + bool invalidateCache = true, + List? cacheKeysToInvalidate, + }) async { + try { + final response = await _apiClient.delete( + endpoint, + ); + + if (response.statusCode == 200 || response.statusCode == 204) { + // DELETE请求成功后，清除相关缓存 + if (invalidateCache) { + await _invalidateRelatedCache(endpoint, cacheKeysToInvalidate); + } + + return ApiResponse.success( + data: null, + message: 'Success', + ); + } + + return ApiResponse.error( + message: 'Request failed with status: ${response.statusCode}', + code: response.statusCode, + ); + } catch (e) { + if (kDebugMode) { + print('Error in enhanced DELETE request: $e'); + } + return ApiResponse.error( + message: e.toString(), + ); + } + } + + /// 生成缓存键 + String _generateCacheKey( + String method, + String endpoint, + Map? queryParameters, + ) { + final buffer = StringBuffer(); + buffer.write(method); + buffer.write('_'); + buffer.write(endpoint.replaceAll('/', '_')); + + if (queryParameters != null && queryParameters.isNotEmpty) { + final sortedKeys = queryParameters.keys.toList()..sort(); + for (final key in sortedKeys) { + buffer.write('_${key}_${queryParameters[key]}'); + } + } + + return buffer.toString(); + } + + /// 清除相关缓存 + Future _invalidateRelatedCache( + String endpoint, + List? specificKeys, + ) async { + try { + // 清除指定的缓存键 + if (specificKeys != null) { + for (final key in specificKeys) { + await CacheService.removeCache(key); + } + } + + // 清除与当前端点相关的缓存 + final endpointKey = endpoint.replaceAll('/', '_'); + final keys = StorageService.getKeys(); + final relatedKeys = keys.where((key) => key.contains(endpointKey)); + + for (final key in relatedKeys) { + final cacheKey = key.replaceFirst('api_cache_', ''); + await CacheService.removeCache(cacheKey); + } + + if (kDebugMode) { + print('Cache invalidated for endpoint: $endpoint'); + } + } catch (e) { + if (kDebugMode) { + print('Error invalidating cache: $e'); + } + } + } + + /// 预加载数据到缓存 + Future preloadCache( + String endpoint, { + Map? queryParameters, + Duration? cacheDuration, + }) async { + try { + await get( + endpoint, + queryParameters: queryParameters, + useCache: true, + cacheDuration: cacheDuration, + ); + + if (kDebugMode) { + print('Cache preloaded for: $endpoint'); + } + } catch (e) { + if (kDebugMode) { + print('Error preloading cache: $e'); + } + } + } + + /// 获取缓存信息 + Future> getCacheInfo() async { + return await CacheService.getCacheInfo(); + } + + /// 清理过期缓存 + Future cleanExpiredCache() async { + await CacheService.cleanExpiredCache(); + } + + /// 清空所有缓存 + Future clearAllCache() async { + await CacheService.clearAllCache(); + } +} \ No newline at end of file diff --git a/client/lib/core/services/navigation_service.dart b/client/lib/core/services/navigation_service.dart new file mode 100644 index 0000000..8062138 --- /dev/null +++ b/client/lib/core/services/navigation_service.dart @@ -0,0 +1,125 @@ +import 'package:flutter/material.dart'; + +/// 全局导航服务 +/// 用于在非Widget上下文中进行页面导航 +class NavigationService { + static final NavigationService _instance = NavigationService._internal(); + + factory NavigationService() => _instance; + + NavigationService._internal(); + + static NavigationService get instance => _instance; + + final GlobalKey navigatorKey = GlobalKey(); + + /// 获取当前上下文 + BuildContext? get context => navigatorKey.currentContext; + + /// 获取Navigator + NavigatorState? get navigator => navigatorKey.currentState; + + /// 导航到指定路由 + Future? navigateTo(String routeName, {Object? arguments}) { + return navigator?.pushNamed(routeName, arguments: arguments); + } + + /// 替换当前路由 + Future? replaceWith(String routeName, {Object? arguments}) { + return navigator?.pushReplacementNamed(routeName, arguments: arguments); + } + + /// 导航到指定路由并清除所有历史 + Future? navigateToAndClearStack(String routeName, {Object? arguments}) { + return navigator?.pushNamedAndRemoveUntil( + routeName, + (route) => false, + arguments: arguments, + ); + } + + /// 返回上一页 + void goBack([T? result]) { + if (navigator?.canPop() ?? false) { + navigator?.pop(result); + } + } + + /// 返回到指定路由 + void popUntil(String routeName) { + navigator?.popUntil(ModalRoute.withName(routeName)); + } + + /// 显示SnackBar + void showSnackBar(String message, { + Duration duration = const Duration(seconds: 2), + SnackBarAction? action, + }) { + final scaffoldMessenger = ScaffoldMessenger.of(context!); + // 清除之前的所有SnackBar + scaffoldMessenger.clearSnackBars(); + scaffoldMessenger.showSnackBar( + SnackBar( + content: Text(message), + duration: duration, + action: action, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + ); + } + + /// 显示错误SnackBar + void showErrorSnackBar(String message) { + final scaffoldMessenger = ScaffoldMessenger.of(context!); + // 清除之前的所有SnackBar + scaffoldMessenger.clearSnackBars(); + scaffoldMessenger.showSnackBar( + SnackBar( + content: Text(message), + backgroundColor: Colors.red, + duration: const Duration(seconds: 2), + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + ); + } + + /// 显示成功SnackBar + void showSuccessSnackBar(String message) { + final scaffoldMessenger = ScaffoldMessenger.of(context!); + // 清除之前的所有SnackBar + scaffoldMessenger.clearSnackBars(); + scaffoldMessenger.showSnackBar( + SnackBar( + content: Text(message), + backgroundColor: Colors.green, + duration: const Duration(seconds: 2), + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + ); + } + + /// 显示对话框 + Future showDialogWidget(Widget dialog) { + return showDialog( + context: context!, + builder: (context) => dialog, + ); + } + + /// 显示底部弹窗 + Future showBottomSheetWidget(Widget bottomSheet) { + return showModalBottomSheet( + context: context!, + builder: (context) => bottomSheet, + ); + } +} diff --git a/client/lib/core/services/storage_service.dart b/client/lib/core/services/storage_service.dart new file mode 100644 index 0000000..608c5a9 --- /dev/null +++ b/client/lib/core/services/storage_service.dart @@ -0,0 +1,342 @@ +import 'dart:convert'; +import 'package:shared_preferences/shared_preferences.dart'; +import '../utils/exceptions.dart'; + +/// 存储服务 +class StorageService { + static StorageService? _instance; + static SharedPreferences? _prefs; + + StorageService._(); + + /// 获取单例实例 + static Future getInstance() async { + if (_instance == null) { + _instance = StorageService._(); + await _instance!._init(); + } + return _instance!; + } + + /// 获取已初始化的实例（同步方法，必须先调用getInstance） + static StorageService get instance { + if (_instance == null) { + throw Exception('StorageService not initialized. Call getInstance() first.'); + } + return _instance!; + } + + /// 初始化 + Future _init() async { + try { + _prefs = await SharedPreferences.getInstance(); + } catch (e) { + throw CacheException('初始化存储服务失败: $e'); + } + } + + // ==================== 普通存储 ==================== + + /// 存储字符串 + Future setString(String key, String value) async { + try { + return await _prefs!.setString(key, value); + } catch (e) { + throw CacheException('存储字符串失败: $e'); + } + } + + /// 获取字符串 + String? getString(String key, {String? defaultValue}) { + try { + return _prefs!.getString(key) ?? defaultValue; + } catch (e) { + throw CacheException('获取字符串失败: $e'); + } + } + + /// 存储整数 + Future setInt(String key, int value) async { + try { + return await _prefs!.setInt(key, value); + } catch (e) { + throw CacheException('存储整数失败: $e'); + } + } + + /// 获取整数 + int? getInt(String key, {int? defaultValue}) { + try { + return _prefs!.getInt(key) ?? defaultValue; + } catch (e) { + throw CacheException('获取整数失败: $e'); + } + } + + /// 存储布尔值 + Future setBool(String key, bool value) async { + try { + return await _prefs!.setBool(key, value); + } catch (e) { + throw CacheException('存储布尔值失败: $e'); + } + } + + /// 获取布尔值 + bool? getBool(String key, {bool? defaultValue}) { + try { + return _prefs!.getBool(key) ?? defaultValue; + } catch (e) { + throw CacheException('获取布尔值失败: $e'); + } + } + + /// 存储双精度浮点数 + Future setDouble(String key, double value) async { + try { + return await _prefs!.setDouble(key, value); + } catch (e) { + throw CacheException('存储双精度浮点数失败: $e'); + } + } + + /// 获取双精度浮点数 + double? getDouble(String key, {double? defaultValue}) { + try { + return _prefs!.getDouble(key) ?? defaultValue; + } catch (e) { + throw CacheException('获取双精度浮点数失败: $e'); + } + } + + /// 存储字符串列表 + Future setStringList(String key, List value) async { + try { + return await _prefs!.setStringList(key, value); + } catch (e) { + throw CacheException('存储字符串列表失败: $e'); + } + } + + /// 获取字符串列表 + List? getStringList(String key, {List? defaultValue}) { + try { + return _prefs!.getStringList(key) ?? defaultValue; + } catch (e) { + throw CacheException('获取字符串列表失败: $e'); + } + } + + /// 存储JSON对象 + Future setJson(String key, Map value) async { + try { + final jsonString = jsonEncode(value); + return await setString(key, jsonString); + } catch (e) { + throw CacheException('存储JSON对象失败: $e'); + } + } + + /// 获取JSON对象 + Map? getJson(String key) { + try { + final jsonString = getString(key); + if (jsonString == null) return null; + return jsonDecode(jsonString) as Map; + } catch (e) { + throw CacheException('获取JSON对象失败: $e'); + } + } + + /// 删除指定键的数据 + Future remove(String key) async { + try { + return await _prefs!.remove(key); + } catch (e) { + throw CacheException('删除数据失败: $e'); + } + } + + /// 清空所有数据 + Future clear() async { + try { + return await _prefs!.clear(); + } catch (e) { + throw CacheException('清空数据失败: $e'); + } + } + + /// 检查是否包含指定键 + bool containsKey(String key) { + try { + return _prefs!.containsKey(key); + } catch (e) { + throw CacheException('检查键是否存在失败: $e'); + } + } + + /// 获取所有键 + Set getKeys() { + try { + return _prefs!.getKeys(); + } catch (e) { + throw CacheException('获取所有键失败: $e'); + } + } + + // ==================== 安全存储 ==================== + + /// 安全存储字符串（用于敏感信息如Token） + Future setSecureString(String key, String value) async { + try { + await _prefs!.setString('secure_$key', value); + } catch (e) { + throw CacheException('安全存储字符串失败: $e'); + } + } + + /// 安全获取字符串 + Future getSecureString(String key) async { + try { + return _prefs!.getString('secure_$key'); + } catch (e) { + throw CacheException('安全获取字符串失败: $e'); + } + } + + /// 安全存储JSON对象 + Future setSecureJson(String key, Map value) async { + try { + final jsonString = jsonEncode(value); + await setSecureString(key, jsonString); + } catch (e) { + throw CacheException('安全存储JSON对象失败: $e'); + } + } + + /// 安全获取JSON对象 + Future?> getSecureJson(String key) async { + try { + final jsonString = await getSecureString(key); + if (jsonString == null) return null; + return jsonDecode(jsonString) as Map; + } catch (e) { + throw CacheException('安全获取JSON对象失败: $e'); + } + } + + /// 安全删除指定键的数据 + Future removeSecure(String key) async { + try { + await _prefs!.remove('secure_$key'); + } catch (e) { + throw CacheException('安全删除数据失败: $e'); + } + } + + /// 安全清空所有数据 + Future clearSecure() async { + try { + final keys = _prefs!.getKeys().where((key) => key.startsWith('secure_')).toList(); + for (final key in keys) { + await _prefs!.remove(key); + } + } catch (e) { + throw CacheException('安全清空数据失败: $e'); + } + } + + /// 安全检查是否包含指定键 + Future containsSecureKey(String key) async { + try { + return _prefs!.containsKey('secure_$key'); + } catch (e) { + throw CacheException('安全检查键是否存在失败: $e'); + } + } + + /// 安全获取所有键 + Future> getAllSecure() async { + try { + final result = {}; + final keys = _prefs!.getKeys().where((key) => key.startsWith('secure_')); + for (final key in keys) { + final value = _prefs!.getString(key); + if (value != null) { + result[key.substring(7)] = value; // 移除 'secure_' 前缀 + } + } + return result; + } catch (e) { + throw CacheException('安全获取所有数据失败: $e'); + } + } + + // ==================== Token 相关便捷方法 ==================== + + /// 保存访问令牌 + Future saveToken(String token) async { + await setSecureString(StorageKeys.accessToken, token); + } + + /// 获取访问令牌 + Future getToken() async { + return await getSecureString(StorageKeys.accessToken); + } + + /// 保存刷新令牌 + Future saveRefreshToken(String refreshToken) async { + await setSecureString(StorageKeys.refreshToken, refreshToken); + } + + /// 获取刷新令牌 + Future getRefreshToken() async { + return await getSecureString(StorageKeys.refreshToken); + } + + /// 清除所有令牌 + Future clearTokens() async { + await removeSecure(StorageKeys.accessToken); + await removeSecure(StorageKeys.refreshToken); + } +} + +/// 存储键常量 +class StorageKeys { + // 用户相关 + static const String accessToken = 'access_token'; + static const String refreshToken = 'refresh_token'; + static const String userInfo = 'user_info'; + static const String isLoggedIn = 'is_logged_in'; + static const String rememberMe = 'remember_me'; + + // 应用设置 + static const String appLanguage = 'app_language'; + static const String appTheme = 'app_theme'; + static const String firstLaunch = 'first_launch'; + static const String onboardingCompleted = 'onboarding_completed'; + + // 学习设置 + static const String dailyGoal = 'daily_goal'; + static const String reminderTimes = 'reminder_times'; + static const String notificationsEnabled = 'notifications_enabled'; + static const String soundEnabled = 'sound_enabled'; + static const String vibrationEnabled = 'vibration_enabled'; + + // 学习数据 + static const String learningProgress = 'learning_progress'; + static const String vocabularyProgress = 'vocabulary_progress'; + static const String listeningProgress = 'listening_progress'; + static const String readingProgress = 'reading_progress'; + static const String writingProgress = 'writing_progress'; + static const String speakingProgress = 'speaking_progress'; + + // 缓存数据 + static const String cachedWordBooks = 'cached_word_books'; + static const String cachedArticles = 'cached_articles'; + static const String cachedExercises = 'cached_exercises'; + + // 临时数据 + static const String tempData = 'temp_data'; + static const String draftData = 'draft_data'; +} \ No newline at end of file diff --git a/client/lib/core/services/tts_service.dart b/client/lib/core/services/tts_service.dart new file mode 100644 index 0000000..f02778f --- /dev/null +++ b/client/lib/core/services/tts_service.dart @@ -0,0 +1,151 @@ +import 'package:flutter_tts/flutter_tts.dart'; + +/// TTS语音播报服务 +class TTSService { + static final TTSService _instance = TTSService._internal(); + factory TTSService() => _instance; + TTSService._internal(); + + final FlutterTts _flutterTts = FlutterTts(); + bool _isInitialized = false; + + /// 初始化TTS + Future initialize() async { + if (_isInitialized) return; + + try { + // 设置语言为美式英语 + await _flutterTts.setLanguage("en-US"); + + // 设置语速 (0.0 - 1.0) + await _flutterTts.setSpeechRate(0.5); + + // 设置音量 (0.0 - 1.0) + await _flutterTts.setVolume(1.0); + + // 设置音调 (0.5 - 2.0) + await _flutterTts.setPitch(1.0); + + _isInitialized = true; + print('TTS服务初始化成功'); + } catch (e) { + print('TTS服务初始化失败: $e'); + } + } + + /// 播放单词发音 + /// [word] 要播放的单词 + /// [language] 语言代码，默认为美式英语 "en-US"，英式英语为 "en-GB" + Future speak(String word, {String language = "en-US"}) async { + if (!_isInitialized) { + await initialize(); + } + + try { + // 如果正在播放，先停止 + await _flutterTts.stop(); + + // 设置语言 + await _flutterTts.setLanguage(language); + + // 播放单词 + await _flutterTts.speak(word); + + print('播放单词发音: $word ($language)'); + } catch (e) { + print('播放单词发音失败: $e'); + } + } + + /// 停止播放 + Future stop() async { + try { + await _flutterTts.stop(); + } catch (e) { + print('停止播放失败: $e'); + } + } + + /// 暂停播放 + Future pause() async { + try { + await _flutterTts.pause(); + } catch (e) { + print('暂停播放失败: $e'); + } + } + + /// 设置语速 + /// [rate] 语速 (0.0 - 1.0) + Future setSpeechRate(double rate) async { + try { + await _flutterTts.setSpeechRate(rate); + } catch (e) { + print('设置语速失败: $e'); + } + } + + /// 设置音调 + /// [pitch] 音调 (0.5 - 2.0) + Future setPitch(double pitch) async { + try { + await _flutterTts.setPitch(pitch); + } catch (e) { + print('设置音调失败: $e'); + } + } + + /// 设置音量 + /// [volume] 音量 (0.0 - 1.0) + Future setVolume(double volume) async { + try { + await _flutterTts.setVolume(volume); + } catch (e) { + print('设置音量失败: $e'); + } + } + + /// 获取可用语言列表 + Future> getLanguages() async { + try { + return await _flutterTts.getLanguages; + } catch (e) { + print('获取语言列表失败: $e'); + return []; + } + } + + /// 获取可用语音列表 + Future> getVoices() async { + try { + return await _flutterTts.getVoices; + } catch (e) { + print('获取语音列表失败: $e'); + return []; + } + } + + /// 设置完成回调 + void setCompletionHandler(Function callback) { + _flutterTts.setCompletionHandler(() { + callback(); + }); + } + + /// 设置错误回调 + void setErrorHandler(Function(dynamic) callback) { + _flutterTts.setErrorHandler((msg) { + callback(msg); + }); + } + + /// 释放资源 + Future dispose() async { + try { + await _flutterTts.stop(); + _isInitialized = false; + } catch (e) { + print('释放TTS资源失败: $e'); + } + } +} diff --git a/client/lib/core/storage/storage_service.dart b/client/lib/core/storage/storage_service.dart new file mode 100644 index 0000000..f040358 --- /dev/null +++ b/client/lib/core/storage/storage_service.dart @@ -0,0 +1,150 @@ +import 'package:shared_preferences/shared_preferences.dart'; +import 'dart:convert'; + +/// 本地存储服务 +class StorageService { + static SharedPreferences? _prefs; + + /// 初始化存储服务 + static Future init() async { + _prefs = await SharedPreferences.getInstance(); + } + + /// 获取SharedPreferences实例 + static SharedPreferences get _instance { + if (_prefs == null) { + throw Exception('StorageService not initialized. Call StorageService.init() first.'); + } + return _prefs!; + } + + /// 存储字符串 + static Future setString(String key, String value) async { + return await _instance.setString(key, value); + } + + /// 获取字符串 + static String? getString(String key) { + return _instance.getString(key); + } + + /// 存储整数 + static Future setInt(String key, int value) async { + return await _instance.setInt(key, value); + } + + /// 获取整数 + static int? getInt(String key) { + return _instance.getInt(key); + } + + /// 存储双精度浮点数 + static Future setDouble(String key, double value) async { + return await _instance.setDouble(key, value); + } + + /// 获取双精度浮点数 + static double? getDouble(String key) { + return _instance.getDouble(key); + } + + /// 存储布尔值 + static Future setBool(String key, bool value) async { + return await _instance.setBool(key, value); + } + + /// 获取布尔值 + static bool? getBool(String key) { + return _instance.getBool(key); + } + + /// 存储字符串列表 + static Future setStringList(String key, List value) async { + return await _instance.setStringList(key, value); + } + + /// 获取字符串列表 + static List? getStringList(String key) { + return _instance.getStringList(key); + } + + /// 存储对象（JSON序列化） + static Future setObject(String key, Map value) async { + final jsonString = jsonEncode(value); + return await setString(key, jsonString); + } + + /// 获取对象（JSON反序列化） + static Map? getObject(String key) { + final jsonString = getString(key); + if (jsonString == null) return null; + + try { + return jsonDecode(jsonString) as Map; + } catch (e) { + print('Error decoding JSON for key $key: $e'); + return null; + } + } + + /// 存储对象列表（JSON序列化） + static Future setObjectList(String key, List> value) async { + final jsonString = jsonEncode(value); + return await setString(key, jsonString); + } + + /// 获取对象列表（JSON反序列化） + static List>? getObjectList(String key) { + final jsonString = getString(key); + if (jsonString == null) return null; + + try { + final decoded = jsonDecode(jsonString) as List; + return decoded.cast>(); + } catch (e) { + print('Error decoding JSON list for key $key: $e'); + return null; + } + } + + /// 检查键是否存在 + static bool containsKey(String key) { + return _instance.containsKey(key); + } + + /// 删除指定键 + static Future remove(String key) async { + return await _instance.remove(key); + } + + /// 清空所有数据 + static Future clear() async { + return await _instance.clear(); + } + + /// 获取所有键 + static Set getKeys() { + return _instance.getKeys(); + } + + /// 重新加载数据 + static Future reload() async { + await _instance.reload(); + } +} + +/// 存储键名常量 +class StorageKeys { + static const String accessToken = 'access_token'; + static const String refreshToken = 'refresh_token'; + static const String userInfo = 'user_info'; + static const String appSettings = 'app_settings'; + static const String learningProgress = 'learning_progress'; + static const String vocabularyCache = 'vocabulary_cache'; + static const String studyHistory = 'study_history'; + static const String offlineData = 'offline_data'; + static const String themeMode = 'theme_mode'; + static const String language = 'language'; + static const String firstLaunch = 'first_launch'; + static const String onboardingCompleted = 'onboarding_completed'; +} \ No newline at end of file diff --git a/client/lib/core/theme/app_colors.dart b/client/lib/core/theme/app_colors.dart new file mode 100644 index 0000000..f81dd59 --- /dev/null +++ b/client/lib/core/theme/app_colors.dart @@ -0,0 +1,278 @@ +import 'package:flutter/material.dart'; + +/// 应用颜色常量 +class AppColors { + // 私有构造函数，防止实例化 + AppColors._(); + + // ============ 浅色主题颜色 ============ + + /// 主色调 + static const Color primary = Color(0xFF1976D2); + static const Color onPrimary = Color(0xFFFFFFFF); + static const Color primaryContainer = Color(0xFFBBDEFB); + static const Color onPrimaryContainer = Color(0xFF0D47A1); + + /// 次要色调 + static const Color secondary = Color(0xFF03DAC6); + static const Color onSecondary = Color(0xFF000000); + static const Color secondaryContainer = Color(0xFFB2DFDB); + static const Color onSecondaryContainer = Color(0xFF004D40); + + /// 第三色调 + static const Color tertiary = Color(0xFF9C27B0); + static const Color onTertiary = Color(0xFFFFFFFF); + static const Color tertiaryContainer = Color(0xFFE1BEE7); + static const Color onTertiaryContainer = Color(0xFF4A148C); + + /// 错误色 + static const Color error = Color(0xFFD32F2F); + static const Color onError = Color(0xFFFFFFFF); + static const Color errorContainer = Color(0xFFFFCDD2); + static const Color onErrorContainer = Color(0xFFB71C1C); + + /// 背景颜色 + static const Color background = Color(0xFFFFFBFE); + static const Color onBackground = Color(0xFF1C1B1F); + + /// 表面色 + static const Color surface = Color(0xFFFFFFFF); + static const Color onSurface = Color(0xFF1C1B1F); + static const Color surfaceTint = Color(0xFF1976D2); + + /// 表面变体色 + static const Color surfaceVariant = Color(0xFFF3F3F3); + static const Color onSurfaceVariant = Color(0xFF49454F); + + /// 轮廓色 + static const Color outline = Color(0xFF79747E); + static const Color outlineVariant = Color(0xFFCAC4D0); + + /// 阴影颜色 + static const Color shadow = Color(0xFF000000); + static const Color scrim = Color(0xFF000000); + + /// 反转颜色 + static const Color inverseSurface = Color(0xFF313033); + static const Color onInverseSurface = Color(0xFFF4EFF4); + static const Color inversePrimary = Color(0xFF90CAF9); + + // ============ 深色主题颜色 ============ + + /// 主色调 - 深色 + static const Color primaryDark = Color(0xFF90CAF9); + static const Color onPrimaryDark = Color(0xFF003C8F); + static const Color primaryContainerDark = Color(0xFF1565C0); + static const Color onPrimaryContainerDark = Color(0xFFE3F2FD); + + /// 次要色调 - 深色 + static const Color secondaryDark = Color(0xFF80CBC4); + static const Color onSecondaryDark = Color(0xFF00251A); + static const Color secondaryContainerDark = Color(0xFF00695C); + static const Color onSecondaryContainerDark = Color(0xFFE0F2F1); + + /// 第三色调 - 深色 + static const Color tertiaryDark = Color(0xFFCE93D8); + static const Color onTertiaryDark = Color(0xFF4A148C); + static const Color tertiaryContainerDark = Color(0xFF7B1FA2); + static const Color onTertiaryContainerDark = Color(0xFFF3E5F5); + + /// 错误色 - 深色 + static const Color errorDark = Color(0xFFEF5350); + static const Color onErrorDark = Color(0xFF690005); + static const Color errorContainerDark = Color(0xFFD32F2F); + static const Color onErrorContainerDark = Color(0xFFFFEBEE); + + /// 背景颜色 - 深色 + static const Color backgroundDark = Color(0xFF1C1B1F); + static const Color onBackgroundDark = Color(0xFFE6E1E5); + + /// 表面色 - 深色 + static const Color surfaceDark = Color(0xFF121212); + static const Color onSurfaceDark = Color(0xFFE6E1E5); + static const Color surfaceTintDark = Color(0xFF90CAF9); + + /// 表面变体色 - 深色 + static const Color surfaceVariantDark = Color(0xFF49454F); + static const Color onSurfaceVariantDark = Color(0xFFCAC4D0); + + /// 轮廓色 - 深色 + static const Color outlineDark = Color(0xFF938F99); + static const Color outlineVariantDark = Color(0xFF49454F); + + /// 阴影颜色 - 深色 + static const Color shadowDark = Color(0xFF000000); + static const Color scrimDark = Color(0xFF000000); + + /// 反转色 - 深色 + static const Color inverseSurfaceDark = Color(0xFFE6E1E5); + static const Color onInverseSurfaceDark = Color(0xFF313033); + static const Color inversePrimaryDark = Color(0xFF1976D2); + + // ============ 功能性颜色 ============ + + /// 成功色 + static const Color success = Color(0xFF4CAF50); + static const Color onSuccess = Color(0xFFFFFFFF); + static const Color successContainer = Color(0xFFE8F5E8); + static const Color onSuccessContainer = Color(0xFF1B5E20); + + /// 警告色 + static const Color warning = Color(0xFFFF9800); + static const Color onWarning = Color(0xFFFFFFFF); + static const Color warningContainer = Color(0xFFFFF3E0); + static const Color onWarningContainer = Color(0xFFE65100); + + /// 信息色 + static const Color info = Color(0xFF2196F3); + static const Color onInfo = Color(0xFFFFFFFF); + static const Color infoContainer = Color(0xFFE3F2FD); + static const Color onInfoContainer = Color(0xFF0D47A1); + + // ============ 学习模块颜色 ============ + + /// 词汇学习 + static const Color vocabulary = Color(0xFF9C27B0); + static const Color onVocabulary = Color(0xFFFFFFFF); + static const Color vocabularyContainer = Color(0xFFF3E5F5); + static const Color onVocabularyContainer = Color(0xFF4A148C); + static const Color vocabularyDark = Color(0xFFBA68C8); + + /// 听力训练 + static const Color listening = Color(0xFF00BCD4); + static const Color onListening = Color(0xFFFFFFFF); + static const Color listeningContainer = Color(0xFFE0F7FA); + static const Color onListeningContainer = Color(0xFF006064); + static const Color listeningDark = Color(0xFF4DD0E1); + + /// 阅读理解 + static const Color reading = Color(0xFF4CAF50); + static const Color onReading = Color(0xFFFFFFFF); + static const Color readingContainer = Color(0xFFE8F5E8); + static const Color onReadingContainer = Color(0xFF1B5E20); + static const Color readingDark = Color(0xFF81C784); + + /// 写作练习 + static const Color writing = Color(0xFFFF5722); + static const Color onWriting = Color(0xFFFFFFFF); + static const Color writingContainer = Color(0xFFFBE9E7); + static const Color onWritingContainer = Color(0xFFBF360C); + static const Color writingDark = Color(0xFFFF8A65); + + /// 口语练习 + static const Color speaking = Color(0xFFE91E63); + static const Color onSpeaking = Color(0xFFFFFFFF); + static const Color speakingContainer = Color(0xFFFCE4EC); + static const Color onSpeakingContainer = Color(0xFF880E4F); + static const Color speakingDark = Color(0xFFF06292); + + // ============ 等级颜色 ============ + + /// 初级 + static const Color beginner = Color(0xFF4CAF50); + static const Color onBeginner = Color(0xFFFFFFFF); + static const Color beginnerDark = Color(0xFF81C784); + + /// 中级 + static const Color intermediate = Color(0xFFFF9800); + static const Color onIntermediate = Color(0xFFFFFFFF); + static const Color intermediateDark = Color(0xFFFFB74D); + + /// 高级 + static const Color advanced = Color(0xFFF44336); + static const Color onAdvanced = Color(0xFFFFFFFF); + static const Color advancedDark = Color(0xFFEF5350); + + // ============ 进度颜色 ============ + + /// 进度条背景 + static const Color progressBackground = Color(0xFFE0E0E0); + + /// 进度条前景 + static const Color progressForeground = Color(0xFF2196F3); + + /// 完成状态 + static const Color completed = Color(0xFF4CAF50); + + /// 进行中状态 + static const Color inProgress = Color(0xFFFF9800); + + /// 未开始状态 + static const Color notStarted = Color(0xFFBDBDBD); + + /// 进度等级颜色 + static const Color progressLow = Color(0xFFF44336); + static const Color progressLowDark = Color(0xFFEF5350); + static const Color progressMedium = Color(0xFFFF9800); + static const Color progressMediumDark = Color(0xFFFFB74D); + static const Color progressHigh = Color(0xFF4CAF50); + static const Color progressHighDark = Color(0xFF81C784); + + // ============ 特殊颜色 ============ + + /// 分割线 + static const Color divider = Color(0xFFE0E0E0); + + /// 禁用状态 + static const Color disabled = Color(0xFFBDBDBD); + static const Color onDisabled = Color(0xFF757575); + + /// 透明度变体 + static Color get primaryWithOpacity => primary.withValues(alpha: 0.12); + static Color get secondaryWithOpacity => secondary.withValues(alpha: 0.12); + static Color get errorWithOpacity => error.withValues(alpha: 0.12); + static Color get successWithOpacity => success.withValues(alpha: 0.12); + static Color get warningWithOpacity => warning.withValues(alpha: 0.12); + static Color get infoWithOpacity => info.withValues(alpha: 0.12); + + // ============ 渐变色 ============ + + /// 主要渐变 + static const LinearGradient primaryGradient = LinearGradient( + colors: [Color(0xFF2196F3), Color(0xFF21CBF3)], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ); + + /// 次要渐变 + static const LinearGradient secondaryGradient = LinearGradient( + colors: [Color(0xFF03DAC6), Color(0xFF00BCD4)], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ); + + /// 词汇渐变 + static const LinearGradient vocabularyGradient = LinearGradient( + colors: [Color(0xFF9C27B0), Color(0xFFE91E63)], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ); + + /// 听力渐变 + static const LinearGradient listeningGradient = LinearGradient( + colors: [Color(0xFF00BCD4), Color(0xFF2196F3)], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ); + + /// 阅读渐变 + static const LinearGradient readingGradient = LinearGradient( + colors: [Color(0xFF4CAF50), Color(0xFF8BC34A)], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ); + + /// 写作渐变 + static const LinearGradient writingGradient = LinearGradient( + colors: [Color(0xFFFF5722), Color(0xFFFF9800)], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ); + + /// 口语渐变 + static const LinearGradient speakingGradient = LinearGradient( + colors: [Color(0xFFE91E63), Color(0xFF9C27B0)], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ); +} \ No newline at end of file diff --git a/client/lib/core/theme/app_dimensions.dart b/client/lib/core/theme/app_dimensions.dart new file mode 100644 index 0000000..6940c75 --- /dev/null +++ b/client/lib/core/theme/app_dimensions.dart @@ -0,0 +1,365 @@ +/// 应用尺寸配置 +class AppDimensions { + // 私有构造函数，防止实例化 + AppDimensions._(); + + // ============ 间距 ============ + + /// 极小间距 + static const double spacingXs = 4.0; + + /// 小间距 + static const double spacingSm = 8.0; + + /// 中等间距 + static const double spacingMd = 16.0; + + /// 大间距 + static const double spacingLg = 24.0; + + /// 超大间距 + static const double spacingXl = 32.0; + + /// 超超大间距 + static const double spacingXxl = 48.0; + + // ============ 内边距 ============ + + /// 页面内边距 + static const double pagePadding = spacingMd; + + /// 卡片内边距 + static const double cardPadding = spacingMd; + + /// 按钮内边距 + static const double buttonPadding = spacingMd; + + /// 输入框内边距 + static const double inputPadding = spacingMd; + + /// 列表项内边距 + static const double listItemPadding = spacingMd; + + /// 对话框内边距 + static const double dialogPadding = spacingLg; + + /// 底部导航栏内边距 + static const double bottomNavPadding = spacingSm; + + /// AppBar内边距 + static const double appBarPadding = spacingMd; + + // ============ 外边距 ============ + + /// 页面外边距 + static const double pageMargin = spacingMd; + + /// 卡片外边距 + static const double cardMargin = spacingSm; + + /// 按钮外边距 + static const double buttonMargin = spacingSm; + + /// 输入框外边距 + static const double inputMargin = spacingSm; + + /// 列表项外边距 + static const double listItemMargin = spacingXs; + + /// 对话框外边距 + static const double dialogMargin = spacingLg; + + // ============ 圆角半径 ============ + + /// 极小圆角 + static const double radiusXs = 4.0; + + /// 小圆角 + static const double radiusSm = 8.0; + + /// 中等圆角 + static const double radiusMd = 12.0; + + /// 大圆角 + static const double radiusLg = 16.0; + + /// 超大圆角 + static const double radiusXl = 20.0; + + /// 圆形 + static const double radiusCircle = 999.0; + + // ============ 组件圆角 ============ + + /// 按钮圆角 + static const double buttonRadius = radiusSm; + + /// 卡片圆角 + static const double cardRadius = radiusMd; + + /// 输入框圆角 + static const double inputRadius = radiusSm; + + /// 对话框圆角 + static const double dialogRadius = radiusLg; + + /// 底部弹窗圆角 + static const double bottomSheetRadius = radiusLg; + + /// 芯片圆角 + static const double chipRadius = radiusLg; + + /// 头像圆角 + static const double avatarRadius = radiusCircle; + + /// 图片圆角 + static const double imageRadius = radiusSm; + + // ============ 高度 ============ + + /// AppBar高度 + static const double appBarHeight = 56.0; + + /// 底部导航栏高度 + static const double bottomNavHeight = 80.0; + + /// 标签栏高度 + static const double tabBarHeight = 48.0; + + /// 按钮高度 + static const double buttonHeight = 48.0; + + /// 小按钮高度 + static const double buttonHeightSm = 36.0; + + /// 大按钮高度 + static const double buttonHeightLg = 56.0; + + /// 输入框高度 + static const double inputHeight = 56.0; + + /// 列表项高度 + static const double listItemHeight = 56.0; + + /// 小列表项高度 + static const double listItemHeightSm = 48.0; + + /// 大列表项高度 + static const double listItemHeightLg = 72.0; + + /// 工具栏高度 + static const double toolbarHeight = 56.0; + + /// 搜索栏高度 + static const double searchBarHeight = 48.0; + + /// 进度条高度 + static const double progressBarHeight = 4.0; + + /// 分割线高度 + static const double dividerHeight = 1.0; + + // ============ 宽度 ============ + + /// 最小按钮宽度 + static const double buttonMinWidth = 64.0; + + /// 侧边栏宽度 + static const double drawerWidth = 304.0; + + /// 分割线宽度 + static const double dividerWidth = 1.0; + + /// 边框宽度 + static const double borderWidth = 1.0; + + /// 粗边框宽度 + static const double borderWidthThick = 2.0; + + // ============ 图标尺寸 ============ + + /// 极小图标 + static const double iconXs = 16.0; + + /// 小图标 + static const double iconSm = 20.0; + + /// 中等图标 + static const double iconMd = 24.0; + + /// 大图标 + static const double iconLg = 32.0; + + /// 超大图标 + static const double iconXl = 48.0; + + /// 超超大图标 + static const double iconXxl = 64.0; + + // ============ 头像尺寸 ============ + + /// 小头像 + static const double avatarSm = 32.0; + + /// 中等头像 + static const double avatarMd = 48.0; + + /// 大头像 + static const double avatarLg = 64.0; + + /// 超大头像 + static const double avatarXl = 96.0; + + // ============ 阴影 ============ + + /// 阴影偏移 + static const double shadowOffset = 2.0; + + /// 阴影模糊半径 + static const double shadowBlurRadius = 8.0; + + /// 阴影扩散半径 + static const double shadowSpreadRadius = 0.0; + + // ============ 动画持续时间 ============ + + /// 快速动画 + static const Duration animationFast = Duration(milliseconds: 150); + + /// 中等动画 + static const Duration animationMedium = Duration(milliseconds: 300); + + /// 慢速动画 + static const Duration animationSlow = Duration(milliseconds: 500); + + // ============ 学习相关尺寸 ============ + + /// 单词卡片高度 + static const double wordCardHeight = 200.0; + + /// 单词卡片宽度 + static const double wordCardWidth = 300.0; + + /// 进度圆环大小 + static const double progressCircleSize = 120.0; + + /// 等级徽章大小 + static const double levelBadgeSize = 40.0; + + /// 成就徽章大小 + static const double achievementBadgeSize = 60.0; + + /// 音频播放器高度 + static const double audioPlayerHeight = 80.0; + + /// 练习题选项高度 + static const double exerciseOptionHeight = 48.0; + + /// 学习统计卡片高度 + static const double statsCardHeight = 120.0; + + // ============ 响应式断点 ============ + + /// 手机断点 + static const double mobileBreakpoint = 600.0; + + /// 平板断点 + static const double tabletBreakpoint = 900.0; + + /// 桌面断点 + static const double desktopBreakpoint = 1200.0; + + // ============ 最大宽度 ============ + + /// 内容最大宽度 + static const double maxContentWidth = 1200.0; + + /// 对话框最大宽度 + static const double maxDialogWidth = 560.0; + + /// 卡片最大宽度 + static const double maxCardWidth = 400.0; + + // ============ 最小尺寸 ============ + + /// 最小触摸目标尺寸 + static const double minTouchTarget = 48.0; + + /// 最小按钮尺寸 + static const double minButtonSize = 36.0; + + // ============ 网格布局 ============ + + /// 网格间距 + static const double gridSpacing = spacingSm; + + /// 网格交叉轴间距 + static const double gridCrossAxisSpacing = spacingSm; + + /// 网格主轴间距 + static const double gridMainAxisSpacing = spacingSm; + + /// 网格子项宽高比 + static const double gridChildAspectRatio = 1.0; + + // ============ 列表布局 ============ + + /// 列表分割线缩进 + static const double listDividerIndent = spacingMd; + + /// 列表分割线结束缩进 + static const double listDividerEndIndent = spacingMd; + + // ============ 浮动操作按钮 ============ + + /// 浮动操作按钮大小 + static const double fabSize = 56.0; + + /// 小浮动操作按钮大小 + static const double fabSizeSmall = 40.0; + + /// 大浮动操作按钮大小 + static const double fabSizeLarge = 96.0; + + /// 浮动操作按钮边距 + static const double fabMargin = spacingMd; + + // ============ 辅助方法 ============ + + /// 根据屏幕宽度获取响应式间距 + static double getResponsiveSpacing(double screenWidth) { + if (screenWidth < mobileBreakpoint) { + return spacingSm; + } else if (screenWidth < tabletBreakpoint) { + return spacingMd; + } else { + return spacingLg; + } + } + + /// 根据屏幕宽度获取响应式内边距 + static double getResponsivePadding(double screenWidth) { + if (screenWidth < mobileBreakpoint) { + return spacingMd; + } else if (screenWidth < tabletBreakpoint) { + return spacingLg; + } else { + return spacingXl; + } + } + + /// 根据屏幕宽度判断是否为移动设备 + static bool isMobile(double screenWidth) { + return screenWidth < mobileBreakpoint; + } + + /// 根据屏幕宽度判断是否为平板设备 + static bool isTablet(double screenWidth) { + return screenWidth >= mobileBreakpoint && screenWidth < desktopBreakpoint; + } + + /// 根据屏幕宽度判断是否为桌面设备 + static bool isDesktop(double screenWidth) { + return screenWidth >= desktopBreakpoint; + } +} \ No newline at end of file diff --git a/client/lib/core/theme/app_text_styles.dart b/client/lib/core/theme/app_text_styles.dart new file mode 100644 index 0000000..9cc341a --- /dev/null +++ b/client/lib/core/theme/app_text_styles.dart @@ -0,0 +1,437 @@ +import 'package:flutter/material.dart'; +import 'app_colors.dart'; + +/// 应用文本样式配置 +class AppTextStyles { + // 私有构造函数，防止实例化 + AppTextStyles._(); + + // ============ 字体家族 ============ + + /// 默认字体 - 使用系统默认，不指定字体名称 + static const String? defaultFontFamily = null; + + /// 中文字体 - 使用系统默认，不指定字体名称 + static const String? chineseFontFamily = null; + + /// 等宽字体 - 使用系统默认，不指定字体名称 + static const String? monospaceFontFamily = null; + + // ============ 字体权重 ============ + + static const FontWeight light = FontWeight.w300; + static const FontWeight regular = FontWeight.w400; + static const FontWeight medium = FontWeight.w500; + static const FontWeight semiBold = FontWeight.w600; + static const FontWeight bold = FontWeight.w700; + static const FontWeight extraBold = FontWeight.w800; + + // ============ 基础文本样式 ============ + + /// 标题样式 + static const TextStyle displayLarge = TextStyle( + fontSize: 57, + fontWeight: bold, + letterSpacing: -0.25, + height: 1.12, + color: AppColors.onSurface, + ); + + static const TextStyle displayMedium = TextStyle( + fontSize: 45, + fontWeight: bold, + letterSpacing: 0, + height: 1.16, + color: AppColors.onSurface, + ); + + static const TextStyle displaySmall = TextStyle( + fontSize: 36, + fontWeight: bold, + letterSpacing: 0, + height: 1.22, + color: AppColors.onSurface, + ); + + /// 标题样式 + static const TextStyle headlineLarge = TextStyle( + fontSize: 32, + fontWeight: bold, + letterSpacing: 0, + height: 1.25, + color: AppColors.onSurface, + ); + + static const TextStyle headlineMedium = TextStyle( + fontSize: 28, + fontWeight: semiBold, + letterSpacing: 0, + height: 1.29, + color: AppColors.onSurface, + ); + + static const TextStyle headlineSmall = TextStyle( + fontSize: 24, + fontWeight: semiBold, + letterSpacing: 0, + height: 1.33, + color: AppColors.onSurface, + ); + + /// 标题样式 + static const TextStyle titleLarge = TextStyle( + fontSize: 22, + fontWeight: semiBold, + letterSpacing: 0, + height: 1.27, + color: AppColors.onSurface, + ); + + static const TextStyle titleMedium = TextStyle( + fontSize: 16, + fontWeight: medium, + letterSpacing: 0.15, + height: 1.50, + color: AppColors.onSurface, + ); + + static const TextStyle titleSmall = TextStyle( + fontSize: 14, + fontWeight: medium, + letterSpacing: 0.1, + height: 1.43, + color: AppColors.onSurface, + ); + + /// 标签样式 + static const TextStyle labelLarge = TextStyle( + fontSize: 14, + fontWeight: medium, + letterSpacing: 0.1, + height: 1.43, + color: AppColors.onSurface, + ); + + static const TextStyle labelMedium = TextStyle( + fontSize: 12, + fontWeight: medium, + letterSpacing: 0.5, + height: 1.33, + color: AppColors.onSurface, + ); + + static const TextStyle labelSmall = TextStyle( + fontSize: 11, + fontWeight: medium, + letterSpacing: 0.5, + height: 1.45, + color: AppColors.onSurface, + ); + + /// 正文样式 + static const TextStyle bodyLarge = TextStyle( + fontSize: 16, + fontWeight: regular, + letterSpacing: 0.5, + height: 1.50, + color: AppColors.onSurface, + ); + + static const TextStyle bodyMedium = TextStyle( + fontSize: 14, + fontWeight: regular, + letterSpacing: 0.25, + height: 1.43, + color: AppColors.onSurface, + ); + + static const TextStyle bodySmall = TextStyle( + fontSize: 12, + fontWeight: regular, + letterSpacing: 0.4, + height: 1.33, + color: AppColors.onSurfaceVariant, + ); + + // ============ 自定义文本样式 ============ + + /// 按钮文本样式 + static const TextStyle buttonLarge = TextStyle( + fontSize: 16, + fontWeight: semiBold, + letterSpacing: 0.1, + height: 1.25, + color: AppColors.onPrimary, + ); + + static const TextStyle buttonMedium = TextStyle( + fontSize: 14, + fontWeight: semiBold, + letterSpacing: 0.1, + height: 1.29, + color: AppColors.onPrimary, + ); + + static const TextStyle buttonSmall = TextStyle( + fontSize: 12, + fontWeight: medium, + letterSpacing: 0.5, + height: 1.33, + color: AppColors.onPrimary, + ); + + /// 输入框文本样式 + static const TextStyle inputText = TextStyle( + fontSize: 16, + fontWeight: regular, + letterSpacing: 0.5, + height: 1.50, + color: AppColors.onSurface, + ); + + static const TextStyle inputLabel = TextStyle( + fontSize: 16, + fontWeight: medium, + letterSpacing: 0.15, + height: 1.50, + color: AppColors.onSurfaceVariant, + ); + + static const TextStyle inputHint = TextStyle( + fontSize: 16, + fontWeight: regular, + letterSpacing: 0.5, + height: 1.50, + color: AppColors.onSurfaceVariant, + ); + + static const TextStyle inputError = TextStyle( + fontSize: 12, + fontWeight: regular, + letterSpacing: 0.4, + height: 1.33, + color: AppColors.error, + ); + + /// 导航文本样式 + static const TextStyle navigationLabel = TextStyle( + fontSize: 12, + fontWeight: medium, + letterSpacing: 0.5, + height: 1.33, + color: AppColors.onSurface, + ); + + static const TextStyle tabLabel = TextStyle( + fontSize: 14, + fontWeight: medium, + letterSpacing: 0.1, + height: 1.43, + color: AppColors.onSurface, + ); + + /// 卡片文本样式 + static const TextStyle cardTitle = TextStyle( + fontSize: 18, + fontWeight: semiBold, + letterSpacing: 0, + height: 1.33, + color: AppColors.onSurface, + ); + + static const TextStyle cardSubtitle = TextStyle( + fontSize: 14, + fontWeight: regular, + letterSpacing: 0.25, + height: 1.43, + color: AppColors.onSurfaceVariant, + ); + + static const TextStyle cardBody = TextStyle( + fontSize: 14, + fontWeight: regular, + letterSpacing: 0.25, + height: 1.43, + color: AppColors.onSurface, + ); + + /// 列表文本样式 + static const TextStyle listTitle = TextStyle( + fontSize: 16, + fontWeight: medium, + letterSpacing: 0.15, + height: 1.50, + color: AppColors.onSurface, + ); + + static const TextStyle listSubtitle = TextStyle( + fontSize: 14, + fontWeight: regular, + letterSpacing: 0.25, + height: 1.43, + color: AppColors.onSurfaceVariant, + ); + + /// 学习相关文本样式 + static const TextStyle wordText = TextStyle( + fontSize: 24, + fontWeight: semiBold, + letterSpacing: 0, + height: 1.33, + color: AppColors.onSurface, + ); + + static const TextStyle phoneticText = TextStyle( + fontSize: 16, + fontWeight: regular, + letterSpacing: 0.5, + height: 1.50, + color: AppColors.onSurfaceVariant, + fontFamily: monospaceFontFamily, + ); + + static const TextStyle definitionText = TextStyle( + fontSize: 16, + fontWeight: regular, + letterSpacing: 0.5, + height: 1.50, + color: AppColors.onSurface, + ); + + static const TextStyle exampleText = TextStyle( + fontSize: 14, + fontWeight: regular, + letterSpacing: 0.25, + height: 1.43, + color: AppColors.onSurfaceVariant, + fontStyle: FontStyle.italic, + ); + + /// 分数和统计文本样式 + static const TextStyle scoreText = TextStyle( + fontSize: 32, + fontWeight: bold, + letterSpacing: 0, + height: 1.25, + color: AppColors.primary, + ); + + static const TextStyle statisticNumber = TextStyle( + fontSize: 24, + fontWeight: semiBold, + letterSpacing: 0, + height: 1.33, + color: AppColors.onSurface, + ); + + static const TextStyle statisticLabel = TextStyle( + fontSize: 12, + fontWeight: medium, + letterSpacing: 0.5, + height: 1.33, + color: AppColors.onSurfaceVariant, + ); + + /// 状态文本样式 + static const TextStyle successText = TextStyle( + fontSize: 14, + fontWeight: medium, + letterSpacing: 0.1, + height: 1.43, + color: AppColors.success, + ); + + static const TextStyle warningText = TextStyle( + fontSize: 14, + fontWeight: medium, + letterSpacing: 0.1, + height: 1.43, + color: AppColors.warning, + ); + + static const TextStyle errorText = TextStyle( + fontSize: 14, + fontWeight: medium, + letterSpacing: 0.1, + height: 1.43, + color: AppColors.error, + ); + + static const TextStyle infoText = TextStyle( + fontSize: 14, + fontWeight: medium, + letterSpacing: 0.1, + height: 1.43, + color: AppColors.info, + ); + + // ============ Material 3 文本主题 ============ + + /// Material 3 文本主题 + static const TextTheme textTheme = TextTheme( + displayLarge: displayLarge, + displayMedium: displayMedium, + displaySmall: displaySmall, + headlineLarge: headlineLarge, + headlineMedium: headlineMedium, + headlineSmall: headlineSmall, + titleLarge: titleLarge, + titleMedium: titleMedium, + titleSmall: titleSmall, + labelLarge: labelLarge, + labelMedium: labelMedium, + labelSmall: labelSmall, + bodyLarge: bodyLarge, + bodyMedium: bodyMedium, + bodySmall: bodySmall, + ); + + // ============ 辅助方法 ============ + + /// 根据主题亮度调整文本颜色 + static TextStyle adaptiveTextStyle(TextStyle style, Brightness brightness) { + if (brightness == Brightness.dark) { + return style.copyWith( + color: _adaptColorForDarkTheme(style.color ?? AppColors.onSurface), + ); + } + return style; + } + + /// 为深色主题调整颜色 + static Color _adaptColorForDarkTheme(Color color) { + if (color == AppColors.onSurface) { + return AppColors.onSurfaceDark; + } else if (color == AppColors.onSurfaceVariant) { + return AppColors.onSurfaceVariantDark; + } else if (color == AppColors.primary) { + return AppColors.primaryDark; + } + return color; + } + + /// 创建带有特定颜色的文本样式 + static TextStyle withColor(TextStyle style, Color color) { + return style.copyWith(color: color); + } + + /// 创建带有特定字体大小的文本样式 + static TextStyle withFontSize(TextStyle style, double fontSize) { + return style.copyWith(fontSize: fontSize); + } + + /// 创建带有特定字体权重的文本样式 + static TextStyle withFontWeight(TextStyle style, FontWeight fontWeight) { + return style.copyWith(fontWeight: fontWeight); + } + + /// 创建带有特定行高的文本样式 + static TextStyle withHeight(TextStyle style, double height) { + return style.copyWith(height: height); + } + + /// 创建带有特定字母间距的文本样式 + static TextStyle withLetterSpacing(TextStyle style, double letterSpacing) { + return style.copyWith(letterSpacing: letterSpacing); + } +} \ No newline at end of file diff --git a/client/lib/core/theme/app_theme.dart b/client/lib/core/theme/app_theme.dart new file mode 100644 index 0000000..f51099f --- /dev/null +++ b/client/lib/core/theme/app_theme.dart @@ -0,0 +1,424 @@ +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import 'app_colors.dart'; +import 'app_text_styles.dart'; +import 'app_dimensions.dart'; + +/// 应用主题配置 +class AppTheme { + // 私有构造函数，防止实例化 + AppTheme._(); + + // ============ 亮色主题 ============ + + static ThemeData get lightTheme { + return ThemeData( + useMaterial3: true, + brightness: Brightness.light, + + // 禁用Google Fonts，使用系统默认字体 + fontFamily: null, // 不指定字体，使用系统默认 + + // 颜色方案 + colorScheme: const ColorScheme.light( + primary: AppColors.primary, + onPrimary: AppColors.onPrimary, + primaryContainer: AppColors.primaryContainer, + onPrimaryContainer: AppColors.onPrimaryContainer, + secondary: AppColors.secondary, + onSecondary: AppColors.onSecondary, + secondaryContainer: AppColors.secondaryContainer, + onSecondaryContainer: AppColors.onSecondaryContainer, + tertiary: AppColors.tertiary, + onTertiary: AppColors.onTertiary, + tertiaryContainer: AppColors.tertiaryContainer, + onTertiaryContainer: AppColors.onTertiaryContainer, + error: AppColors.error, + onError: AppColors.onError, + errorContainer: AppColors.errorContainer, + onErrorContainer: AppColors.onErrorContainer, + surface: AppColors.surface, + onSurface: AppColors.onSurface, + surfaceContainerHighest: AppColors.surfaceVariant, + onSurfaceVariant: AppColors.onSurfaceVariant, + outline: AppColors.outline, + outlineVariant: AppColors.outlineVariant, + shadow: AppColors.shadow, + scrim: AppColors.scrim, + inverseSurface: AppColors.inverseSurface, + onInverseSurface: AppColors.onInverseSurface, + inversePrimary: AppColors.inversePrimary, + surfaceTint: AppColors.surfaceTint, + ), + + // 文本主题 + textTheme: AppTextStyles.textTheme, + + // AppBar主题 + appBarTheme: AppBarTheme( + backgroundColor: AppColors.surface, + foregroundColor: AppColors.onSurface, + elevation: 0, + scrolledUnderElevation: 1, + centerTitle: true, + titleTextStyle: AppTextStyles.titleLarge, + toolbarHeight: AppDimensions.appBarHeight, + systemOverlayStyle: const SystemUiOverlayStyle( + statusBarColor: Colors.transparent, + statusBarIconBrightness: Brightness.dark, + statusBarBrightness: Brightness.light, + ), + ), + + // 按钮主题 + elevatedButtonTheme: ElevatedButtonThemeData( + style: ElevatedButton.styleFrom( + backgroundColor: AppColors.primary, + foregroundColor: AppColors.onPrimary, + textStyle: AppTextStyles.buttonMedium, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.buttonRadius), + ), + minimumSize: const Size(AppDimensions.buttonMinWidth, AppDimensions.buttonHeight), + padding: const EdgeInsets.symmetric( + horizontal: AppDimensions.buttonPadding, + vertical: AppDimensions.spacingSm, + ), + ), + ), + + filledButtonTheme: FilledButtonThemeData( + style: FilledButton.styleFrom( + backgroundColor: AppColors.primary, + foregroundColor: AppColors.onPrimary, + textStyle: AppTextStyles.buttonMedium, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.buttonRadius), + ), + minimumSize: const Size(AppDimensions.buttonMinWidth, AppDimensions.buttonHeight), + ), + ), + + outlinedButtonTheme: OutlinedButtonThemeData( + style: OutlinedButton.styleFrom( + foregroundColor: AppColors.primary, + textStyle: AppTextStyles.buttonMedium, + side: const BorderSide(color: AppColors.outline), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.buttonRadius), + ), + minimumSize: const Size(AppDimensions.buttonMinWidth, AppDimensions.buttonHeight), + ), + ), + + textButtonTheme: TextButtonThemeData( + style: TextButton.styleFrom( + foregroundColor: AppColors.primary, + textStyle: AppTextStyles.buttonMedium, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.buttonRadius), + ), + minimumSize: const Size(AppDimensions.buttonMinWidth, AppDimensions.buttonHeight), + ), + ), + + // 输入框主题 + inputDecorationTheme: InputDecorationTheme( + filled: true, + fillColor: AppColors.surfaceVariant, + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(AppDimensions.inputRadius), + borderSide: const BorderSide(color: AppColors.outline), + ), + enabledBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(AppDimensions.inputRadius), + borderSide: const BorderSide(color: AppColors.outline), + ), + focusedBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(AppDimensions.inputRadius), + borderSide: const BorderSide(color: AppColors.primary, width: 2), + ), + errorBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(AppDimensions.inputRadius), + borderSide: const BorderSide(color: AppColors.error), + ), + focusedErrorBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(AppDimensions.inputRadius), + borderSide: const BorderSide(color: AppColors.error, width: 2), + ), + labelStyle: AppTextStyles.inputLabel, + hintStyle: AppTextStyles.inputHint, + errorStyle: AppTextStyles.inputError, + contentPadding: const EdgeInsets.all(AppDimensions.inputPadding), + ), + + // 卡片主题 + cardTheme: CardThemeData( + color: AppColors.surface, + elevation: 1, + shadowColor: AppColors.shadow, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.cardRadius), + ), + margin: const EdgeInsets.all(AppDimensions.cardMargin), + ), + + // 底部导航栏主题 + bottomNavigationBarTheme: const BottomNavigationBarThemeData( + backgroundColor: AppColors.surface, + selectedItemColor: AppColors.primary, + unselectedItemColor: AppColors.onSurfaceVariant, + selectedLabelStyle: AppTextStyles.navigationLabel, + unselectedLabelStyle: AppTextStyles.navigationLabel, + type: BottomNavigationBarType.fixed, + elevation: 8, + ), + + // 标签栏主题 + tabBarTheme: TabBarThemeData( + labelColor: AppColors.primary, + unselectedLabelColor: AppColors.onSurfaceVariant, + labelStyle: AppTextStyles.tabLabel, + unselectedLabelStyle: AppTextStyles.tabLabel, + indicator: const UnderlineTabIndicator( + borderSide: BorderSide(color: AppColors.primary, width: 2), + ), + ), + + // 芯片主题 + chipTheme: ChipThemeData( + backgroundColor: AppColors.surfaceVariant, + selectedColor: AppColors.primaryContainer, + disabledColor: AppColors.surfaceVariant.withValues(alpha: 0.5), + labelStyle: AppTextStyles.labelMedium, + secondaryLabelStyle: AppTextStyles.labelMedium, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.chipRadius), + ), + padding: const EdgeInsets.symmetric( + horizontal: AppDimensions.spacingSm, + vertical: AppDimensions.spacingXs, + ), + ), + + // 对话框主题 + dialogTheme: DialogThemeData( + backgroundColor: AppColors.surface, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.dialogRadius), + ), + titleTextStyle: AppTextStyles.headlineSmall, + contentTextStyle: AppTextStyles.bodyMedium, + ), + + // 提示条主题 + snackBarTheme: SnackBarThemeData( + backgroundColor: AppColors.inverseSurface, + contentTextStyle: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onInverseSurface, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + ), + behavior: SnackBarBehavior.floating, + ), + + // 浮动操作按钮主题 + floatingActionButtonTheme: const FloatingActionButtonThemeData( + backgroundColor: AppColors.primary, + foregroundColor: AppColors.onPrimary, + elevation: 6, + focusElevation: 8, + hoverElevation: 8, + highlightElevation: 12, + ), + + // 分割线主题 + dividerTheme: const DividerThemeData( + color: AppColors.outline, + thickness: AppDimensions.dividerHeight, + space: AppDimensions.dividerHeight, + ), + + // 列表项主题 + listTileTheme: ListTileThemeData( + contentPadding: const EdgeInsets.symmetric( + horizontal: AppDimensions.listItemPadding, + vertical: AppDimensions.spacingXs, + ), + titleTextStyle: AppTextStyles.listTitle, + subtitleTextStyle: AppTextStyles.listSubtitle, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + ), + ), + + // 开关主题 + switchTheme: SwitchThemeData( + thumbColor: WidgetStateProperty.resolveWith((states) { + if (states.contains(WidgetState.selected)) { + return AppColors.onPrimary; + } + return AppColors.outline; + }), + trackColor: WidgetStateProperty.resolveWith((states) { + if (states.contains(WidgetState.selected)) { + return AppColors.primary; + } + return AppColors.surfaceVariant; + }), + ), + + // 复选框主题 + checkboxTheme: CheckboxThemeData( + fillColor: WidgetStateProperty.resolveWith((states) { + if (states.contains(WidgetState.selected)) { + return AppColors.primary; + } + return Colors.transparent; + }), + checkColor: WidgetStateProperty.all(AppColors.onPrimary), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.radiusXs), + ), + ), + + // 单选按钮主题 + radioTheme: RadioThemeData( + fillColor: WidgetStateProperty.resolveWith((states) { + if (states.contains(WidgetState.selected)) { + return AppColors.primary; + } + return AppColors.onSurfaceVariant; + }), + ), + + // 滑块主题 + sliderTheme: const SliderThemeData( + activeTrackColor: AppColors.primary, + inactiveTrackColor: AppColors.surfaceVariant, + thumbColor: AppColors.primary, + overlayColor: AppColors.primaryContainer, + valueIndicatorColor: AppColors.primary, + ), + + // 进度指示器主题 + progressIndicatorTheme: const ProgressIndicatorThemeData( + color: AppColors.primary, + linearTrackColor: AppColors.surfaceVariant, + circularTrackColor: AppColors.surfaceVariant, + ), + ); + } + + // ============ 深色主题 ============ + + static ThemeData get darkTheme { + return ThemeData( + useMaterial3: true, + brightness: Brightness.dark, + + // 禁用Google Fonts，使用系统默认字体 + fontFamily: null, // 不指定字体，使用系统默认 + + // 颜色方案 + colorScheme: const ColorScheme.dark( + primary: AppColors.primaryDark, + onPrimary: AppColors.onPrimaryDark, + primaryContainer: AppColors.primaryContainerDark, + onPrimaryContainer: AppColors.onPrimaryContainerDark, + secondary: AppColors.secondaryDark, + onSecondary: AppColors.onSecondaryDark, + secondaryContainer: AppColors.secondaryContainerDark, + onSecondaryContainer: AppColors.onSecondaryContainerDark, + tertiary: AppColors.tertiaryDark, + onTertiary: AppColors.onTertiaryDark, + tertiaryContainer: AppColors.tertiaryContainerDark, + onTertiaryContainer: AppColors.onTertiaryContainerDark, + error: AppColors.errorDark, + onError: AppColors.onErrorDark, + errorContainer: AppColors.errorContainerDark, + onErrorContainer: AppColors.onErrorContainerDark, + surface: AppColors.surfaceDark, + onSurface: AppColors.onSurfaceDark, + surfaceContainerHighest: AppColors.surfaceVariantDark, + onSurfaceVariant: AppColors.onSurfaceVariantDark, + outline: AppColors.outlineDark, + outlineVariant: AppColors.outlineVariantDark, + shadow: AppColors.shadowDark, + scrim: AppColors.scrimDark, + inverseSurface: AppColors.inverseSurfaceDark, + onInverseSurface: AppColors.onInverseSurfaceDark, + inversePrimary: AppColors.inversePrimaryDark, + surfaceTint: AppColors.surfaceTintDark, + ), + + // 文本主题（深色适配） + textTheme: AppTextStyles.textTheme.apply( + bodyColor: AppColors.onSurfaceDark, + displayColor: AppColors.onSurfaceDark, + ), + + // AppBar主题 + appBarTheme: AppBarTheme( + backgroundColor: AppColors.surfaceDark, + foregroundColor: AppColors.onSurfaceDark, + elevation: 0, + scrolledUnderElevation: 1, + centerTitle: true, + titleTextStyle: AppTextStyles.titleLarge.copyWith( + color: AppColors.onSurfaceDark, + ), + toolbarHeight: AppDimensions.appBarHeight, + systemOverlayStyle: const SystemUiOverlayStyle( + statusBarColor: Colors.transparent, + statusBarIconBrightness: Brightness.light, + statusBarBrightness: Brightness.dark, + ), + ), + + // 其他组件主题配置与亮色主题类似，但使用深色颜色 + // 为了简洁，这里省略了重复的配置 + // 实际项目中应该完整配置所有组件的深色主题 + ); + } + + // ============ 主题扩展 ============ + + /// 获取当前主题的学习模块颜色 + static Map getLearningColors(BuildContext context) { + final isDark = Theme.of(context).brightness == Brightness.dark; + return { + 'vocabulary': isDark ? AppColors.vocabularyDark : AppColors.vocabulary, + 'listening': isDark ? AppColors.listeningDark : AppColors.listening, + 'reading': isDark ? AppColors.readingDark : AppColors.reading, + 'writing': isDark ? AppColors.writingDark : AppColors.writing, + 'speaking': isDark ? AppColors.speakingDark : AppColors.speaking, + }; + } + + /// 获取等级颜色 + static Color getLevelColor(String level, {bool isDark = false}) { + switch (level.toLowerCase()) { + case 'beginner': + return isDark ? AppColors.beginnerDark : AppColors.beginner; + case 'intermediate': + return isDark ? AppColors.intermediateDark : AppColors.intermediate; + case 'advanced': + return isDark ? AppColors.advancedDark : AppColors.advanced; + default: + return isDark ? AppColors.primaryDark : AppColors.primary; + } + } + + /// 获取进度颜色 + static Color getProgressColor(double progress, {bool isDark = false}) { + if (progress < 0.3) { + return isDark ? AppColors.progressLowDark : AppColors.progressLow; + } else if (progress < 0.7) { + return isDark ? AppColors.progressMediumDark : AppColors.progressMedium; + } else { + return isDark ? AppColors.progressHighDark : AppColors.progressHigh; + } + } +} \ No newline at end of file diff --git a/client/lib/core/utils/exceptions.dart b/client/lib/core/utils/exceptions.dart new file mode 100644 index 0000000..ac7d270 --- /dev/null +++ b/client/lib/core/utils/exceptions.dart @@ -0,0 +1,141 @@ +/// 应用异常基类 +abstract class AppException implements Exception { + final String message; + final String? code; + final dynamic details; + + const AppException(this.message, {this.code, this.details}); + + @override + String toString() => 'AppException: $message'; +} + +/// 网络异常 +class NetworkException extends AppException { + const NetworkException(super.message, {super.code, super.details}); + + @override + String toString() => 'NetworkException: $message'; +} + +/// 认证异常 +class AuthException extends AppException { + const AuthException(super.message, {super.code, super.details}); + + @override + String toString() => 'AuthException: $message'; +} + +/// 验证异常 +class ValidationException extends AppException { + const ValidationException(super.message, {super.code, super.details}); + + @override + String toString() => 'ValidationException: $message'; +} + +/// 服务器异常 +class ServerException extends AppException { + const ServerException(super.message, {super.code, super.details}); + + @override + String toString() => 'ServerException: $message'; +} + +/// 缓存异常 +class CacheException extends AppException { + const CacheException(super.message, {super.code, super.details}); + + @override + String toString() => 'CacheException: $message'; +} + +/// 文件异常 +class FileException extends AppException { + const FileException(super.message, {super.code, super.details}); + + @override + String toString() => 'FileException: $message'; +} + +/// 权限异常 +class PermissionException extends AppException { + const PermissionException(super.message, {super.code, super.details}); + + @override + String toString() => 'PermissionException: $message'; +} + +/// 业务逻辑异常 +class BusinessException extends AppException { + const BusinessException(super.message, {super.code, super.details}); + + @override + String toString() => 'BusinessException: $message'; +} + +/// 超时异常 +class TimeoutException extends AppException { + const TimeoutException(super.message, {super.code, super.details}); + + @override + String toString() => 'TimeoutException: $message'; +} + +/// 数据解析异常 +class ParseException extends AppException { + const ParseException(super.message, {super.code, super.details}); + + @override + String toString() => 'ParseException: $message'; +} + +/// 通用应用异常 +class GeneralAppException extends AppException { + const GeneralAppException(super.message, {super.code, super.details}); + + @override + String toString() => 'GeneralAppException: $message'; +} + +/// 异常处理工具类 +class ExceptionHandler { + /// 处理异常并返回用户友好的错误信息 + static String getErrorMessage(dynamic error) { + if (error is AppException) { + return error.message; + } else if (error is Exception) { + return '发生了未知错误，请稍后重试'; + } else { + return '系统错误，请联系客服'; + } + } + + /// 记录异常 + static void logException(dynamic error, {StackTrace? stackTrace}) { + // 这里可以集成日志记录服务，如Firebase Crashlytics + print('Exception: $error'); + if (stackTrace != null) { + print('StackTrace: $stackTrace'); + } + } + + /// 判断是否为网络相关异常 + static bool isNetworkError(dynamic error) { + return error is NetworkException || + error is TimeoutException || + (error is AppException && error.code?.contains('network') == true); + } + + /// 判断是否为认证相关异常 + static bool isAuthError(dynamic error) { + return error is AuthException || + (error is AppException && error.code?.contains('auth') == true); + } + + /// 判断是否为验证相关异常 + static bool isValidationError(dynamic error) { + return error is ValidationException || + (error is AppException && error.code?.contains('validation') == true); + } +} \ No newline at end of file diff --git a/client/lib/core/utils/message_utils.dart b/client/lib/core/utils/message_utils.dart new file mode 100644 index 0000000..784d4d1 --- /dev/null +++ b/client/lib/core/utils/message_utils.dart @@ -0,0 +1,185 @@ +import 'package:flutter/material.dart'; + +/// 全局消息提示工具类 +/// +/// 特性： +/// - 新消息自动取消之前的提示 +/// - 统一的样式和动画 +/// - 缩短显示时间，避免堆积 +class MessageUtils { + MessageUtils._(); + + /// 显示普通消息 + static void showMessage( + BuildContext context, + String message, { + Duration duration = const Duration(seconds: 2), + SnackBarAction? action, + }) { + final scaffoldMessenger = ScaffoldMessenger.of(context); + // 清除之前的所有SnackBar + scaffoldMessenger.clearSnackBars(); + scaffoldMessenger.showSnackBar( + SnackBar( + content: Text(message), + duration: duration, + action: action, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + margin: const EdgeInsets.all(16), + ), + ); + } + + /// 显示成功消息 + static void showSuccess( + BuildContext context, + String message, { + Duration duration = const Duration(seconds: 2), + }) { + final scaffoldMessenger = ScaffoldMessenger.of(context); + scaffoldMessenger.clearSnackBars(); + scaffoldMessenger.showSnackBar( + SnackBar( + content: Row( + children: [ + const Icon(Icons.check_circle, color: Colors.white, size: 20), + const SizedBox(width: 12), + Expanded(child: Text(message)), + ], + ), + backgroundColor: Colors.green, + duration: duration, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + margin: const EdgeInsets.all(16), + ), + ); + } + + /// 显示错误消息 + static void showError( + BuildContext context, + String message, { + Duration duration = const Duration(seconds: 2), + }) { + final scaffoldMessenger = ScaffoldMessenger.of(context); + scaffoldMessenger.clearSnackBars(); + scaffoldMessenger.showSnackBar( + SnackBar( + content: Row( + children: [ + const Icon(Icons.error, color: Colors.white, size: 20), + const SizedBox(width: 12), + Expanded(child: Text(message)), + ], + ), + backgroundColor: Colors.red, + duration: duration, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + margin: const EdgeInsets.all(16), + ), + ); + } + + /// 显示警告消息 + static void showWarning( + BuildContext context, + String message, { + Duration duration = const Duration(seconds: 2), + }) { + final scaffoldMessenger = ScaffoldMessenger.of(context); + scaffoldMessenger.clearSnackBars(); + scaffoldMessenger.showSnackBar( + SnackBar( + content: Row( + children: [ + const Icon(Icons.warning, color: Colors.white, size: 20), + const SizedBox(width: 12), + Expanded(child: Text(message)), + ], + ), + backgroundColor: Colors.orange, + duration: duration, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + margin: const EdgeInsets.all(16), + ), + ); + } + + /// 显示信息消息 + static void showInfo( + BuildContext context, + String message, { + Duration duration = const Duration(seconds: 2), + }) { + final scaffoldMessenger = ScaffoldMessenger.of(context); + scaffoldMessenger.clearSnackBars(); + scaffoldMessenger.showSnackBar( + SnackBar( + content: Row( + children: [ + const Icon(Icons.info, color: Colors.white, size: 20), + const SizedBox(width: 12), + Expanded(child: Text(message)), + ], + ), + backgroundColor: Colors.blue, + duration: duration, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + margin: const EdgeInsets.all(16), + ), + ); + } + + /// 显示加载消息（不自动消失） + static void showLoading( + BuildContext context, + String message, + ) { + final scaffoldMessenger = ScaffoldMessenger.of(context); + scaffoldMessenger.clearSnackBars(); + scaffoldMessenger.showSnackBar( + SnackBar( + content: Row( + children: [ + const SizedBox( + width: 16, + height: 16, + child: CircularProgressIndicator( + strokeWidth: 2, + valueColor: AlwaysStoppedAnimation(Colors.white), + ), + ), + const SizedBox(width: 12), + Expanded(child: Text(message)), + ], + ), + duration: const Duration(days: 1), // 长时间显示 + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + margin: const EdgeInsets.all(16), + ), + ); + } + + /// 隐藏所有消息 + static void hideAll(BuildContext context) { + ScaffoldMessenger.of(context).clearSnackBars(); + } +} diff --git a/client/lib/core/utils/responsive_utils.dart b/client/lib/core/utils/responsive_utils.dart new file mode 100644 index 0000000..40675b4 --- /dev/null +++ b/client/lib/core/utils/responsive_utils.dart @@ -0,0 +1,148 @@ +import 'package:flutter/material.dart'; + +/// 响应式布局工具类 +class ResponsiveUtils { + // 断点定义 + static const double mobileBreakpoint = 600; + static const double tabletBreakpoint = 900; + static const double desktopBreakpoint = 1200; + + /// 判断是否为移动端 + static bool isMobile(BuildContext context) { + return MediaQuery.of(context).size.width < mobileBreakpoint; + } + + /// 判断是否为平板端 + static bool isTablet(BuildContext context) { + final width = MediaQuery.of(context).size.width; + return width >= mobileBreakpoint && width < desktopBreakpoint; + } + + /// 判断是否为桌面端 + static bool isDesktop(BuildContext context) { + return MediaQuery.of(context).size.width >= desktopBreakpoint; + } + + /// 获取网格列数 + static int getGridColumns(BuildContext context, { + int mobileColumns = 1, + int tabletColumns = 2, + int desktopColumns = 3, + }) { + if (isMobile(context)) return mobileColumns; + if (isTablet(context)) return tabletColumns; + return desktopColumns; + } + + /// 获取响应式边距 + static EdgeInsets getResponsivePadding(BuildContext context, { + EdgeInsets? mobile, + EdgeInsets? tablet, + EdgeInsets? desktop, + }) { + if (isMobile(context)) return mobile ?? const EdgeInsets.all(16); + if (isTablet(context)) return tablet ?? const EdgeInsets.all(20); + return desktop ?? const EdgeInsets.all(24); + } + + /// 获取响应式字体大小 + static double getResponsiveFontSize(BuildContext context, { + double mobileSize = 14, + double tabletSize = 16, + double desktopSize = 18, + }) { + if (isMobile(context)) return mobileSize; + if (isTablet(context)) return tabletSize; + return desktopSize; + } + + /// 获取分类卡片宽度 + static double getCategoryCardWidth(BuildContext context) { + if (isMobile(context)) return 80; + if (isTablet(context)) return 100; + return 120; + } + + /// 获取分类卡片高度 + static double getCategoryCardHeight(BuildContext context) { + if (isMobile(context)) return 90; + if (isTablet(context)) return 100; + return 110; + } + + /// 根据屏幕宽度返回不同的值 + static T getValueForScreenSize( + BuildContext context, { + required T mobile, + T? tablet, + T? desktop, + }) { + if (isMobile(context)) return mobile; + if (isTablet(context)) return tablet ?? mobile; + return desktop ?? tablet ?? mobile; + } +} + +/// 响应式布局构建器 +class ResponsiveBuilder extends StatelessWidget { + final Widget Function(BuildContext context, bool isMobile, bool isTablet, bool isDesktop) builder; + + const ResponsiveBuilder({ + super.key, + required this.builder, + }); + + @override + Widget build(BuildContext context) { + final isMobile = ResponsiveUtils.isMobile(context); + final isTablet = ResponsiveUtils.isTablet(context); + final isDesktop = ResponsiveUtils.isDesktop(context); + + return builder(context, isMobile, isTablet, isDesktop); + } +} + +/// 响应式网格视图 +class ResponsiveGridView extends StatelessWidget { + final List children; + final int mobileColumns; + final int tabletColumns; + final int desktopColumns; + final double spacing; + final EdgeInsets padding; + final double childAspectRatio; + + const ResponsiveGridView({ + super.key, + required this.children, + this.mobileColumns = 1, + this.tabletColumns = 2, + this.desktopColumns = 3, + this.spacing = 16, + this.padding = const EdgeInsets.all(16), + this.childAspectRatio = 1.0, + }); + + @override + Widget build(BuildContext context) { + final columns = ResponsiveUtils.getGridColumns( + context, + mobileColumns: mobileColumns, + tabletColumns: tabletColumns, + desktopColumns: desktopColumns, + ); + + return Padding( + padding: padding, + child: GridView.count( + crossAxisCount: columns, + crossAxisSpacing: spacing, + mainAxisSpacing: spacing, + childAspectRatio: childAspectRatio, + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + children: children, + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/core/widgets/custom_button.dart b/client/lib/core/widgets/custom_button.dart new file mode 100644 index 0000000..4b8208f --- /dev/null +++ b/client/lib/core/widgets/custom_button.dart @@ -0,0 +1,194 @@ +import 'package:flutter/material.dart'; +import '../theme/app_colors.dart'; +import '../theme/app_text_styles.dart'; +import '../theme/app_dimensions.dart'; + +/// 自定义按钮组件 +class CustomButton extends StatelessWidget { + final String text; + final VoidCallback? onPressed; + final bool isLoading; + final bool isOutlined; + final Color? backgroundColor; + final Color? textColor; + final IconData? icon; + final double? width; + final double? height; + final EdgeInsetsGeometry? padding; + + const CustomButton({ + super.key, + required this.text, + this.onPressed, + this.isLoading = false, + this.isOutlined = false, + this.backgroundColor, + this.textColor, + this.icon, + this.width, + this.height, + this.padding, + }); + + @override + Widget build(BuildContext context) { + final effectiveBackgroundColor = backgroundColor ?? + (isOutlined ? Colors.transparent : AppColors.primary); + final effectiveTextColor = textColor ?? + (isOutlined ? AppColors.primary : AppColors.onPrimary); + final effectivePadding = padding ?? EdgeInsets.symmetric( + vertical: AppDimensions.spacingMd, + horizontal: AppDimensions.spacingLg, + ); + + Widget buttonChild = isLoading + ? SizedBox( + width: 20, + height: 20, + child: CircularProgressIndicator( + strokeWidth: 2, + valueColor: AlwaysStoppedAnimation(effectiveTextColor), + ), + ) + : Row( + mainAxisSize: MainAxisSize.min, + mainAxisAlignment: MainAxisAlignment.center, + children: [ + if (icon != null) ...[ + Icon( + icon, + color: effectiveTextColor, + size: 20, + ), + SizedBox(width: AppDimensions.spacingSm), + ], + Text( + text, + style: AppTextStyles.bodyLarge.copyWith( + color: effectiveTextColor, + fontWeight: FontWeight.w600, + ), + ), + ], + ); + + if (isOutlined) { + return SizedBox( + width: width, + height: height, + child: OutlinedButton( + onPressed: isLoading ? null : onPressed, + style: OutlinedButton.styleFrom( + side: BorderSide( + color: onPressed != null ? AppColors.primary : AppColors.onSurface.withOpacity(0.3), + width: 1.5, + ), + padding: effectivePadding, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8.0), + ), + ), + child: buttonChild, + ), + ); + } + + return SizedBox( + width: width, + height: height, + child: ElevatedButton( + onPressed: isLoading ? null : onPressed, + style: ElevatedButton.styleFrom( + backgroundColor: effectiveBackgroundColor, + foregroundColor: effectiveTextColor, + padding: effectivePadding, + elevation: 2, + shadowColor: AppColors.primary.withOpacity(0.3), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8.0), + ), + disabledBackgroundColor: AppColors.onSurface.withOpacity(0.12), + disabledForegroundColor: AppColors.onSurface.withOpacity(0.38), + ), + child: buttonChild, + ), + ); + } +} + +/// 图标按钮组件 +class CustomIconButton extends StatelessWidget { + final IconData icon; + final VoidCallback? onPressed; + final Color? backgroundColor; + final Color? iconColor; + final double? size; + final String? tooltip; + final bool isLoading; + + const CustomIconButton({ + super.key, + required this.icon, + this.onPressed, + this.backgroundColor, + this.iconColor, + this.size, + this.tooltip, + this.isLoading = false, + }); + + @override + Widget build(BuildContext context) { + final effectiveSize = size ?? 48.0; + final effectiveBackgroundColor = backgroundColor ?? AppColors.primary; + final effectiveIconColor = iconColor ?? AppColors.onPrimary; + + Widget iconWidget = isLoading + ? SizedBox( + width: 20, + height: 20, + child: CircularProgressIndicator( + strokeWidth: 2, + valueColor: AlwaysStoppedAnimation(effectiveIconColor), + ), + ) + : Icon( + icon, + color: effectiveIconColor, + size: effectiveSize * 0.5, + ); + + Widget button = Container( + width: effectiveSize, + height: effectiveSize, + decoration: BoxDecoration( + color: effectiveBackgroundColor, + borderRadius: BorderRadius.circular(effectiveSize / 2), + boxShadow: [ + BoxShadow( + color: AppColors.primary.withOpacity(0.3), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Material( + color: Colors.transparent, + child: InkWell( + onTap: isLoading ? null : onPressed, + borderRadius: BorderRadius.circular(effectiveSize / 2), + child: Center(child: iconWidget), + ), + ), + ); + + if (tooltip != null) { + return Tooltip( + message: tooltip!, + child: button, + ); + } + + return button; + } +} \ No newline at end of file diff --git a/client/lib/core/widgets/custom_text_field.dart b/client/lib/core/widgets/custom_text_field.dart new file mode 100644 index 0000000..4eddfa2 --- /dev/null +++ b/client/lib/core/widgets/custom_text_field.dart @@ -0,0 +1,265 @@ +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import '../theme/app_colors.dart'; +import '../theme/app_text_styles.dart'; +import '../theme/app_dimensions.dart'; + +/// 自定义文本输入框组件 +class CustomTextField extends StatefulWidget { + final TextEditingController? controller; + final String? labelText; + final String? hintText; + final String? helperText; + final String? errorText; + final IconData? prefixIcon; + final Widget? suffixIcon; + final bool obscureText; + final TextInputType? keyboardType; + final TextInputAction? textInputAction; + final int? maxLines; + final int? minLines; + final int? maxLength; + final bool enabled; + final bool readOnly; + final bool autofocus; + final String? Function(String?)? validator; + final void Function(String)? onChanged; + final void Function()? onTap; + final void Function(String)? onSubmitted; + final List? inputFormatters; + final FocusNode? focusNode; + final EdgeInsetsGeometry? contentPadding; + final TextStyle? textStyle; + final TextStyle? labelStyle; + final TextStyle? hintStyle; + final Color? fillColor; + final Color? borderColor; + final Color? focusedBorderColor; + final Color? errorBorderColor; + final double? borderRadius; + final bool filled; + + const CustomTextField({ + super.key, + this.controller, + this.labelText, + this.hintText, + this.helperText, + this.errorText, + this.prefixIcon, + this.suffixIcon, + this.obscureText = false, + this.keyboardType, + this.textInputAction, + this.maxLines = 1, + this.minLines, + this.maxLength, + this.enabled = true, + this.readOnly = false, + this.autofocus = false, + this.validator, + this.onChanged, + this.onTap, + this.onSubmitted, + this.inputFormatters, + this.focusNode, + this.contentPadding, + this.textStyle, + this.labelStyle, + this.hintStyle, + this.fillColor, + this.borderColor, + this.focusedBorderColor, + this.errorBorderColor, + this.borderRadius, + this.filled = true, + }); + + @override + State createState() => _CustomTextFieldState(); +} + +class _CustomTextFieldState extends State { + late FocusNode _focusNode; + bool _isFocused = false; + + @override + void initState() { + super.initState(); + _focusNode = widget.focusNode ?? FocusNode(); + _focusNode.addListener(_onFocusChange); + } + + @override + void dispose() { + if (widget.focusNode == null) { + _focusNode.dispose(); + } else { + _focusNode.removeListener(_onFocusChange); + } + super.dispose(); + } + + void _onFocusChange() { + setState(() { + _isFocused = _focusNode.hasFocus; + }); + } + + @override + Widget build(BuildContext context) { + final effectiveBorderRadius = widget.borderRadius ?? 8.0; + final effectiveFillColor = widget.fillColor ?? AppColors.surface; + final effectiveBorderColor = widget.borderColor ?? AppColors.onSurface.withOpacity(0.3); + final effectiveFocusedBorderColor = widget.focusedBorderColor ?? AppColors.primary; + final effectiveErrorBorderColor = widget.errorBorderColor ?? AppColors.error; + + final effectiveContentPadding = widget.contentPadding ?? EdgeInsets.symmetric( + horizontal: AppDimensions.spacingMd, + vertical: AppDimensions.spacingMd, + ); + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + if (widget.labelText != null) ...[ + Text( + widget.labelText!, + style: widget.labelStyle ?? AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w500, + ), + ), + SizedBox(height: AppDimensions.spacingSm), + ], + + TextFormField( + controller: widget.controller, + focusNode: _focusNode, + obscureText: widget.obscureText, + keyboardType: widget.keyboardType, + textInputAction: widget.textInputAction, + maxLines: widget.maxLines, + minLines: widget.minLines, + maxLength: widget.maxLength, + enabled: widget.enabled, + readOnly: widget.readOnly, + autofocus: widget.autofocus, + validator: widget.validator, + onChanged: widget.onChanged, + onTap: widget.onTap, + onFieldSubmitted: widget.onSubmitted, + inputFormatters: widget.inputFormatters, + style: widget.textStyle ?? AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurface, + ), + decoration: InputDecoration( + hintText: widget.hintText, + hintStyle: widget.hintStyle ?? AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurface.withOpacity(0.6), + ), + helperText: widget.helperText, + errorText: widget.errorText, + prefixIcon: widget.prefixIcon != null + ? Icon( + widget.prefixIcon, + color: _isFocused ? effectiveFocusedBorderColor : AppColors.onSurface.withOpacity(0.6), + ) + : null, + suffixIcon: widget.suffixIcon, + filled: widget.filled, + fillColor: effectiveFillColor, + contentPadding: effectiveContentPadding, + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(effectiveBorderRadius), + borderSide: BorderSide( + color: effectiveBorderColor, + width: 1.0, + ), + ), + enabledBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(effectiveBorderRadius), + borderSide: BorderSide( + color: effectiveBorderColor, + width: 1.0, + ), + ), + focusedBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(effectiveBorderRadius), + borderSide: BorderSide( + color: effectiveFocusedBorderColor, + width: 2.0, + ), + ), + errorBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(effectiveBorderRadius), + borderSide: BorderSide( + color: effectiveErrorBorderColor, + width: 1.0, + ), + ), + focusedErrorBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(effectiveBorderRadius), + borderSide: BorderSide( + color: effectiveErrorBorderColor, + width: 2.0, + ), + ), + disabledBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(effectiveBorderRadius), + borderSide: BorderSide( + color: AppColors.onSurface.withOpacity(0.12), + width: 1.0, + ), + ), + ), + ), + ], + ); + } +} + +/// 搜索输入框组件 +class SearchTextField extends StatelessWidget { + final TextEditingController? controller; + final String? hintText; + final void Function(String)? onChanged; + final void Function(String)? onSubmitted; + final VoidCallback? onClear; + final bool autofocus; + final FocusNode? focusNode; + + const SearchTextField({ + super.key, + this.controller, + this.hintText, + this.onChanged, + this.onSubmitted, + this.onClear, + this.autofocus = false, + this.focusNode, + }); + + @override + Widget build(BuildContext context) { + return CustomTextField( + controller: controller, + hintText: hintText ?? '搜索...', + prefixIcon: Icons.search, + suffixIcon: controller?.text.isNotEmpty == true + ? IconButton( + icon: const Icon(Icons.clear), + onPressed: () { + controller?.clear(); + onClear?.call(); + }, + ) + : null, + onChanged: onChanged, + onSubmitted: onSubmitted, + autofocus: autofocus, + focusNode: focusNode, + textInputAction: TextInputAction.search, + ); + } +} \ No newline at end of file diff --git a/client/lib/core/widgets/not_found_screen.dart b/client/lib/core/widgets/not_found_screen.dart new file mode 100644 index 0000000..24f14d1 --- /dev/null +++ b/client/lib/core/widgets/not_found_screen.dart @@ -0,0 +1,106 @@ +import 'package:flutter/material.dart'; +import '../theme/app_colors.dart'; +import '../theme/app_text_styles.dart'; +import '../theme/app_dimensions.dart'; + +/// 404页面 - 页面未找到 +class NotFoundScreen extends StatelessWidget { + final String? routeName; + + const NotFoundScreen({ + super.key, + this.routeName, + }); + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('页面未找到'), + backgroundColor: AppColors.surface, + foregroundColor: AppColors.onSurface, + ), + body: Center( + child: Padding( + padding: EdgeInsets.all(AppDimensions.pagePadding), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + // 404图标 + Icon( + Icons.error_outline, + size: AppDimensions.iconXxl * 2, + color: AppColors.outline, + ), + + SizedBox(height: AppDimensions.spacingXl), + + // 标题 + Text( + '页面未找到', + style: AppTextStyles.headlineLarge.copyWith( + color: AppColors.onSurface, + ), + textAlign: TextAlign.center, + ), + + SizedBox(height: AppDimensions.spacingMd), + + // 描述 + Text( + routeName != null + ? '路由 "$routeName" 不存在' + : '您访问的页面不存在或已被移除', + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurfaceVariant, + ), + textAlign: TextAlign.center, + ), + + SizedBox(height: AppDimensions.spacingXxl), + + // 返回按钮 + ElevatedButton.icon( + onPressed: () { + if (Navigator.of(context).canPop()) { + Navigator.of(context).pop(); + } else { + Navigator.of(context).pushReplacementNamed('/'); + } + }, + icon: const Icon(Icons.arrow_back), + label: const Text('返回'), + style: ElevatedButton.styleFrom( + backgroundColor: AppColors.primary, + foregroundColor: AppColors.onPrimary, + padding: EdgeInsets.symmetric( + horizontal: AppDimensions.spacingXl, + vertical: AppDimensions.spacingMd, + ), + ), + ), + + SizedBox(height: AppDimensions.spacingMd), + + // 回到首页按钮 + TextButton( + onPressed: () { + Navigator.of(context).pushNamedAndRemoveUntil( + '/', + (route) => false, + ); + }, + child: Text( + '回到首页', + style: AppTextStyles.labelLarge.copyWith( + color: AppColors.primary, + ), + ), + ), + ], + ), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/ai/pages/ai_main_page.dart b/client/lib/features/ai/pages/ai_main_page.dart new file mode 100644 index 0000000..9d974e2 --- /dev/null +++ b/client/lib/features/ai/pages/ai_main_page.dart @@ -0,0 +1,405 @@ +import 'package:flutter/material.dart'; +import 'ai_writing_page.dart'; +import 'ai_speaking_page.dart'; +import '../../../core/network/ai_api_service.dart'; + +/// AI功能主页面 +class AIMainPage extends StatefulWidget { + const AIMainPage({Key? key}) : super(key: key); + + @override + State createState() => _AIMainPageState(); +} + +class _AIMainPageState extends State { + final AIApiService _aiApiService = AIApiService(); + Map? _usageStats; + bool _isLoadingStats = false; + + @override + void initState() { + super.initState(); + _loadUsageStats(); + } + + Future _loadUsageStats() async { + setState(() { + _isLoadingStats = true; + }); + + try { + final stats = await _aiApiService.getAIUsageStats(); + setState(() { + _usageStats = stats; + _isLoadingStats = false; + }); + } catch (e) { + setState(() { + _isLoadingStats = false; + }); + // 静默处理错误，不影响用户体验 + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('AI智能助手'), + backgroundColor: Theme.of(context).primaryColor, + foregroundColor: Colors.white, + actions: [ + IconButton( + icon: const Icon(Icons.refresh), + onPressed: _loadUsageStats, + tooltip: '刷新统计', + ), + ], + ), + body: SingleChildScrollView( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 欢迎卡片 + Card( + elevation: 4, + child: Container( + width: double.infinity, + padding: const EdgeInsets.all(20.0), + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(12), + gradient: LinearGradient( + colors: [ + Theme.of(context).primaryColor, + Theme.of(context).primaryColor.withOpacity(0.8), + ], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Row( + children: [ + Icon( + Icons.psychology, + color: Colors.white, + size: 32, + ), + SizedBox(width: 12), + Text( + 'AI智能助手', + style: TextStyle( + color: Colors.white, + fontSize: 24, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 8), + const Text( + '让AI帮助您提升英语学习效果', + style: TextStyle( + color: Colors.white70, + fontSize: 16, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + _buildFeatureChip('智能批改', Icons.edit), + const SizedBox(width: 8), + _buildFeatureChip('口语评估', Icons.mic), + const SizedBox(width: 8), + _buildFeatureChip('个性推荐', Icons.recommend), + ], + ), + ], + ), + ), + ), + const SizedBox(height: 24), + + // 功能模块 + const Text( + 'AI功能', + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + + // 功能卡片网格 + GridView.count( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + crossAxisCount: 2, + crossAxisSpacing: 16, + mainAxisSpacing: 16, + childAspectRatio: 1.2, + children: [ + _buildFeatureCard( + title: '写作批改', + subtitle: 'AI智能批改英文写作', + icon: Icons.edit_note, + color: Colors.blue, + onTap: () { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => const AIWritingPage(), + ), + ); + }, + ), + _buildFeatureCard( + title: '口语评估', + subtitle: 'AI评估发音和流利度', + icon: Icons.record_voice_over, + color: Colors.green, + onTap: () { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => const AISpeakingPage(), + ), + ); + }, + ), + _buildFeatureCard( + title: '智能推荐', + subtitle: '个性化学习内容推荐', + icon: Icons.lightbulb, + color: Colors.orange, + onTap: () { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('智能推荐功能即将上线')), + ); + }, + ), + _buildFeatureCard( + title: '练习生成', + subtitle: 'AI生成个性化练习题', + icon: Icons.quiz, + color: Colors.purple, + onTap: () { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('练习生成功能即将上线')), + ); + }, + ), + ], + ), + const SizedBox(height: 24), + + // 使用统计 + if (_usageStats != null) + Card( + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Row( + children: [ + Icon(Icons.analytics, color: Colors.blue), + SizedBox(width: 8), + Text( + '使用统计', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildStatItem( + '写作批改', + '${_usageStats!['writing_corrections'] ?? 0}', + Icons.edit, + Colors.blue, + ), + ), + Expanded( + child: _buildStatItem( + '口语评估', + '${_usageStats!['speaking_evaluations'] ?? 0}', + Icons.mic, + Colors.green, + ), + ), + ], + ), + const SizedBox(height: 12), + Row( + children: [ + Expanded( + child: _buildStatItem( + '总使用次数', + '${_usageStats!['total_usage'] ?? 0}', + Icons.trending_up, + Colors.orange, + ), + ), + Expanded( + child: _buildStatItem( + '本月使用', + '${_usageStats!['monthly_usage'] ?? 0}', + Icons.calendar_month, + Colors.purple, + ), + ), + ], + ), + ], + ), + ), + ), + + // 加载统计时的占位符 + if (_isLoadingStats) + const Card( + child: Padding( + padding: EdgeInsets.all(16.0), + child: Center( + child: Column( + children: [ + CircularProgressIndicator(), + SizedBox(height: 8), + Text('加载使用统计中...'), + ], + ), + ), + ), + ), + ], + ), + ), + ); + } + + Widget _buildFeatureChip(String label, IconData icon) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 6), + decoration: BoxDecoration( + color: Colors.white.withOpacity(0.2), + borderRadius: BorderRadius.circular(16), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon(icon, color: Colors.white, size: 16), + const SizedBox(width: 4), + Text( + label, + style: const TextStyle( + color: Colors.white, + fontSize: 12, + ), + ), + ], + ), + ); + } + + Widget _buildFeatureCard({ + required String title, + required String subtitle, + required IconData icon, + required Color color, + required VoidCallback onTap, + }) { + return Card( + elevation: 2, + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + shape: BoxShape.circle, + ), + child: Icon( + icon, + color: color, + size: 32, + ), + ), + const SizedBox(height: 12), + Text( + title, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 4), + Text( + subtitle, + style: TextStyle( + fontSize: 12, + color: Colors.grey.shade600, + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ), + ); + } + + Widget _buildStatItem( + String label, + String value, + IconData icon, + Color color, + ) { + return Container( + padding: const EdgeInsets.all(12), + margin: const EdgeInsets.symmetric(horizontal: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Column( + children: [ + Icon(icon, color: color, size: 24), + const SizedBox(height: 8), + Text( + value, + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: color, + ), + ), + const SizedBox(height: 4), + Text( + label, + style: TextStyle( + fontSize: 12, + color: Colors.grey.shade600, + ), + textAlign: TextAlign.center, + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/ai/pages/ai_speaking_page.dart b/client/lib/features/ai/pages/ai_speaking_page.dart new file mode 100644 index 0000000..03dab6d --- /dev/null +++ b/client/lib/features/ai/pages/ai_speaking_page.dart @@ -0,0 +1,475 @@ +import 'package:flutter/material.dart'; +import 'dart:io'; +import '../../../core/network/ai_api_service.dart'; + +/// AI口语评估页面 +class AISpeakingPage extends StatefulWidget { + const AISpeakingPage({Key? key}) : super(key: key); + + @override + State createState() => _AISpeakingPageState(); +} + +class _AISpeakingPageState extends State { + final AIApiService _aiApiService = AIApiService(); + + bool _isRecording = false; + bool _isLoading = false; + File? _audioFile; + Map? _evaluationResult; + String? _error; + String _selectedTask = 'pronunciation'; + + final List> _taskTypes = [ + {'value': 'pronunciation', 'label': '发音评估'}, + {'value': 'fluency', 'label': '流利度评估'}, + {'value': 'conversation', 'label': '对话评估'}, + {'value': 'presentation', 'label': '演讲评估'}, + ]; + + Future _startRecording() async { + // 这里应该集成录音功能 + // 暂时模拟录音状态 + setState(() { + _isRecording = true; + _error = null; + }); + + // 模拟录音过程 + await Future.delayed(const Duration(seconds: 2)); + + setState(() { + _isRecording = false; + // 模拟生成音频文件 + _audioFile = File('/tmp/mock_audio.wav'); + }); + + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('录音完成，可以开始评估')), + ); + } + + Future _stopRecording() async { + setState(() { + _isRecording = false; + }); + } + + Future _submitForEvaluation() async { + if (_audioFile == null) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('请先录制音频')), + ); + return; + } + + setState(() { + _isLoading = true; + _error = null; + _evaluationResult = null; + }); + + try { + final result = await _aiApiService.evaluateSpeaking( + audioText: '模拟音频转文本结果', // 实际应该是音频转文本的结果 + prompt: '请评估这段英语口语的$_selectedTask', + ); + + setState(() { + _evaluationResult = result; + _isLoading = false; + }); + } catch (e) { + setState(() { + _error = e.toString(); + _isLoading = false; + }); + } + } + + void _clearRecording() { + setState(() { + _audioFile = null; + _evaluationResult = null; + _error = null; + }); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('AI口语评估'), + backgroundColor: Theme.of(context).primaryColor, + foregroundColor: Colors.white, + actions: [ + IconButton( + icon: const Icon(Icons.clear), + onPressed: _clearRecording, + tooltip: '清空录音', + ), + ], + ), + body: SingleChildScrollView( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 任务类型选择 + Card( + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '评估类型', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + Wrap( + spacing: 8, + children: _taskTypes.map((type) { + final isSelected = _selectedTask == type['value']; + return ChoiceChip( + label: Text(type['label']!), + selected: isSelected, + onSelected: (selected) { + if (selected) { + setState(() { + _selectedTask = type['value']!; + }); + } + }, + ); + }).toList(), + ), + ], + ), + ), + ), + const SizedBox(height: 16), + + // 录音控制区域 + Card( + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '录音控制', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + + // 录音按钮 + Center( + child: Column( + children: [ + GestureDetector( + onTap: _isRecording ? _stopRecording : _startRecording, + child: Container( + width: 120, + height: 120, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: _isRecording + ? Colors.red.shade400 + : Theme.of(context).primaryColor, + boxShadow: [ + BoxShadow( + color: (_isRecording + ? Colors.red.shade400 + : Theme.of(context).primaryColor) + .withOpacity(0.3), + spreadRadius: _isRecording ? 10 : 5, + blurRadius: 20, + ), + ], + ), + child: Icon( + _isRecording ? Icons.stop : Icons.mic, + size: 50, + color: Colors.white, + ), + ), + ), + const SizedBox(height: 16), + Text( + _isRecording ? '点击停止录音' : '点击开始录音', + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + if (_audioFile != null) + Container( + margin: const EdgeInsets.only(top: 12), + padding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 8, + ), + decoration: BoxDecoration( + color: Colors.green.shade50, + borderRadius: BorderRadius.circular(20), + border: Border.all( + color: Colors.green.shade200, + ), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + Icons.check_circle, + color: Colors.green.shade600, + size: 16, + ), + const SizedBox(width: 4), + const Text( + '录音完成', + style: TextStyle(fontSize: 12), + ), + ], + ), + ), + ], + ), + ), + const SizedBox(height: 16), + + // 评估按钮 + SizedBox( + width: double.infinity, + child: ElevatedButton( + onPressed: (_audioFile != null && !_isLoading) + ? _submitForEvaluation + : null, + style: ElevatedButton.styleFrom( + backgroundColor: Theme.of(context).primaryColor, + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(vertical: 16), + ), + child: _isLoading + ? const Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + SizedBox( + width: 20, + height: 20, + child: CircularProgressIndicator( + strokeWidth: 2, + valueColor: AlwaysStoppedAnimation(Colors.white), + ), + ), + SizedBox(width: 8), + Text('AI评估中...'), + ], + ) + : const Text( + '开始AI评估', + style: TextStyle(fontSize: 16), + ), + ), + ), + ], + ), + ), + ), + const SizedBox(height: 16), + + // 错误显示 + if (_error != null) + Card( + color: Colors.red.shade50, + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Row( + children: [ + Icon(Icons.error, color: Colors.red.shade700), + const SizedBox(width: 8), + Expanded( + child: Text( + _error!, + style: TextStyle(color: Colors.red.shade700), + ), + ), + ], + ), + ), + ), + + // 评估结果显示 + if (_evaluationResult != null) + Card( + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.assessment, + color: Colors.blue.shade600, + ), + const SizedBox(width: 8), + const Text( + 'AI评估结果', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 16), + + // 总体评分 + if (_evaluationResult!['overall_score'] != null) + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.blue.shade50, + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + const Icon(Icons.star, color: Colors.amber), + const SizedBox(width: 8), + Text( + '总体评分: ${_evaluationResult!['overall_score']}/100', + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + ), + const SizedBox(height: 12), + + // 各项评分 + if (_evaluationResult!['scores'] != null) + Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '详细评分:', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + ...(_evaluationResult!['scores'] as Map) + .entries + .map( + (entry) => Padding( + padding: const EdgeInsets.symmetric(vertical: 4), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + _getScoreLabel(entry.key), + style: const TextStyle(fontSize: 14), + ), + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 2, + ), + decoration: BoxDecoration( + color: _getScoreColor(entry.value), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + '${entry.value}/100', + style: const TextStyle( + color: Colors.white, + fontSize: 12, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + ), + ), + ], + ), + + // 改进建议 + if (_evaluationResult!['suggestions'] != null) + Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const SizedBox(height: 16), + const Text( + '改进建议:', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.green.shade50, + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: Colors.green.shade200, + ), + ), + child: Text( + _evaluationResult!['suggestions'].toString(), + style: const TextStyle(fontSize: 14), + ), + ), + ], + ), + ], + ), + ), + ), + ], + ), + ), + ); + } + + String _getScoreLabel(String key) { + switch (key) { + case 'pronunciation': + return '发音准确度'; + case 'fluency': + return '流利度'; + case 'grammar': + return '语法正确性'; + case 'vocabulary': + return '词汇丰富度'; + case 'coherence': + return '连贯性'; + default: + return key; + } + } + + Color _getScoreColor(dynamic score) { + final scoreValue = score is int ? score : int.tryParse(score.toString()) ?? 0; + if (scoreValue >= 80) { + return Colors.green; + } else if (scoreValue >= 60) { + return Colors.orange; + } else { + return Colors.red; + } + } +} \ No newline at end of file diff --git a/client/lib/features/ai/pages/ai_writing_page.dart b/client/lib/features/ai/pages/ai_writing_page.dart new file mode 100644 index 0000000..e43582c --- /dev/null +++ b/client/lib/features/ai/pages/ai_writing_page.dart @@ -0,0 +1,351 @@ +import 'package:flutter/material.dart'; +import '../../../core/network/ai_api_service.dart'; + +/// AI写作批改页面 +class AIWritingPage extends StatefulWidget { + const AIWritingPage({Key? key}) : super(key: key); + + @override + State createState() => _AIWritingPageState(); +} + +class _AIWritingPageState extends State { + final TextEditingController _contentController = TextEditingController(); + final AIApiService _aiApiService = AIApiService(); + + String _selectedType = 'essay'; + bool _isLoading = false; + Map? _correctionResult; + String? _error; + + final List> _writingTypes = [ + {'value': 'essay', 'label': '议论文'}, + {'value': 'email', 'label': '邮件'}, + {'value': 'report', 'label': '报告'}, + {'value': 'letter', 'label': '信件'}, + {'value': 'story', 'label': '故事'}, + ]; + + @override + void dispose() { + _contentController.dispose(); + super.dispose(); + } + + Future _submitForCorrection() async { + if (_contentController.text.trim().isEmpty) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('请输入要批改的内容')), + ); + return; + } + + setState(() { + _isLoading = true; + _error = null; + _correctionResult = null; + }); + + try { + final result = await _aiApiService.correctWriting( + content: _contentController.text.trim(), + taskType: _selectedType, + ); + + setState(() { + _correctionResult = result; + _isLoading = false; + }); + } catch (e) { + setState(() { + _error = e.toString(); + _isLoading = false; + }); + } + } + + void _clearContent() { + setState(() { + _contentController.clear(); + _correctionResult = null; + _error = null; + }); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('AI写作批改'), + backgroundColor: Theme.of(context).primaryColor, + foregroundColor: Colors.white, + actions: [ + IconButton( + icon: const Icon(Icons.clear), + onPressed: _clearContent, + tooltip: '清空内容', + ), + ], + ), + body: SingleChildScrollView( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 写作类型选择 + Card( + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '写作类型', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + Wrap( + spacing: 8, + children: _writingTypes.map((type) { + final isSelected = _selectedType == type['value']; + return ChoiceChip( + label: Text(type['label']!), + selected: isSelected, + onSelected: (selected) { + if (selected) { + setState(() { + _selectedType = type['value']!; + }); + } + }, + ); + }).toList(), + ), + ], + ), + ), + ), + const SizedBox(height: 16), + + // 内容输入区域 + Card( + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '写作内容', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + TextField( + controller: _contentController, + maxLines: 10, + decoration: const InputDecoration( + hintText: '请输入您的英文写作内容...', + border: OutlineInputBorder(), + contentPadding: EdgeInsets.all(12), + ), + ), + const SizedBox(height: 16), + SizedBox( + width: double.infinity, + child: ElevatedButton( + onPressed: _isLoading ? null : _submitForCorrection, + style: ElevatedButton.styleFrom( + backgroundColor: Theme.of(context).primaryColor, + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(vertical: 16), + ), + child: _isLoading + ? const Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + SizedBox( + width: 20, + height: 20, + child: CircularProgressIndicator( + strokeWidth: 2, + valueColor: AlwaysStoppedAnimation(Colors.white), + ), + ), + SizedBox(width: 8), + Text('AI批改中...'), + ], + ) + : const Text( + '开始AI批改', + style: TextStyle(fontSize: 16), + ), + ), + ), + ], + ), + ), + ), + const SizedBox(height: 16), + + // 错误显示 + if (_error != null) + Card( + color: Colors.red.shade50, + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Row( + children: [ + Icon(Icons.error, color: Colors.red.shade700), + const SizedBox(width: 8), + Expanded( + child: Text( + _error!, + style: TextStyle(color: Colors.red.shade700), + ), + ), + ], + ), + ), + ), + + // 批改结果显示 + if (_correctionResult != null) + Card( + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.check_circle, + color: Colors.green.shade600, + ), + const SizedBox(width: 8), + const Text( + 'AI批改结果', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 16), + + // 总体评分 + if (_correctionResult!['score'] != null) + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.blue.shade50, + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + const Icon(Icons.star, color: Colors.amber), + const SizedBox(width: 8), + Text( + '总体评分: ${_correctionResult!['score']}/100', + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + ), + const SizedBox(height: 12), + + // 批改建议 + if (_correctionResult!['suggestions'] != null) + Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '批改建议:', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + Text( + _correctionResult!['suggestions'].toString(), + style: const TextStyle(fontSize: 14), + ), + ], + ), + + // 错误列表 + if (_correctionResult!['errors'] != null) + Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const SizedBox(height: 16), + const Text( + '发现的错误:', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + ...(_correctionResult!['errors'] as List).map( + (error) => Container( + margin: const EdgeInsets.only(bottom: 8), + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.orange.shade50, + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: Colors.orange.shade200, + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '错误类型: ${error['type'] ?? '未知'}', + style: TextStyle( + fontWeight: FontWeight.bold, + color: Colors.orange.shade700, + ), + ), + if (error['original'] != null) + Text('原文: ${error['original']}'), + if (error['corrected'] != null) + Text( + '建议: ${error['corrected']}', + style: TextStyle( + color: Colors.green.shade700, + fontWeight: FontWeight.bold, + ), + ), + if (error['explanation'] != null) + Text( + '说明: ${error['explanation']}', + style: const TextStyle(fontSize: 12), + ), + ], + ), + ), + ), + ], + ), + ], + ), + ), + ), + ], + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/auth/providers/auth_provider.dart b/client/lib/features/auth/providers/auth_provider.dart new file mode 100644 index 0000000..9934096 --- /dev/null +++ b/client/lib/features/auth/providers/auth_provider.dart @@ -0,0 +1,312 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/models/user_model.dart'; +import '../../../core/services/auth_service.dart'; +import '../../../core/services/storage_service.dart'; +import '../../../core/network/api_client.dart'; +import '../../../core/errors/app_exception.dart'; + +/// 认证状态 +class AuthState { + final User? user; + final bool isAuthenticated; + final bool isLoading; + final String? error; + + const AuthState({ + this.user, + this.isAuthenticated = false, + this.isLoading = false, + this.error, + }); + + AuthState copyWith({ + User? user, + bool? isAuthenticated, + bool? isLoading, + String? error, + }) { + return AuthState( + user: user ?? this.user, + isAuthenticated: isAuthenticated ?? this.isAuthenticated, + isLoading: isLoading ?? this.isLoading, + error: error, + ); + } +} + +/// 认证状态管理器 +class AuthNotifier extends StateNotifier { + final AuthService _authService; + final StorageService _storageService; + + AuthNotifier(this._authService, this._storageService) : super(const AuthState()) { + _checkAuthStatus(); + } + + /// 检查认证状态 + Future _checkAuthStatus() async { + try { + final token = await _storageService.getToken(); + if (token != null && token.isNotEmpty) { + // 获取真实用户信息 + try { + final user = await _authService.getUserInfo(); + state = state.copyWith( + user: user, + isAuthenticated: true, + ); + } catch (e) { + // Token可能已过期，清除token + await _storageService.clearTokens(); + } + } + } catch (e) { + // 忽略错误，保持未认证状态 + } + } + + /// 登录 + Future login({ + required String account, // 用户名或邮箱 + required String password, + bool rememberMe = false, + }) async { + state = state.copyWith(isLoading: true, error: null); + + try { + // 调用真实API + final authResponse = await _authService.login( + account: account, + password: password, + rememberMe: rememberMe, + ); + + // 保存token + await _storageService.saveToken(authResponse.token); + if (rememberMe && authResponse.refreshToken != null) { + await _storageService.saveRefreshToken(authResponse.refreshToken!); + } + + // 更新状态 + state = state.copyWith( + user: authResponse.user, + isAuthenticated: true, + isLoading: false, + ); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + rethrow; + } + } + + /// 注册 + Future register({ + required String email, + required String password, + required String username, + required String nickname, + }) async { + state = state.copyWith(isLoading: true, error: null); + + try { + // 调用真实API + final authResponse = await _authService.register( + email: email, + password: password, + username: username, + nickname: nickname, + ); + + // 保存token + await _storageService.saveToken(authResponse.token); + if (authResponse.refreshToken != null) { + await _storageService.saveRefreshToken(authResponse.refreshToken!); + } + + // 更新状态 + state = state.copyWith( + user: authResponse.user, + isAuthenticated: true, + isLoading: false, + ); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + rethrow; + } + } + + /// 登出 + Future logout() async { + state = state.copyWith(isLoading: true, error: null); + + try { + // 模拟网络延迟 + await Future.delayed(const Duration(milliseconds: 500)); + + await _storageService.clearTokens(); + + state = const AuthState(); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + rethrow; + } + } + + /// 忘记密码 + Future forgotPassword(String email) async { + state = state.copyWith(isLoading: true, error: null); + + try { + // 模拟网络延迟 + await Future.delayed(const Duration(milliseconds: 1000)); + + if (email.isEmpty) { + throw Exception('邮箱地址不能为空'); + } + + // 模拟发送重置邮件成功 + state = state.copyWith(isLoading: false); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + rethrow; + } + } + + /// 重置密码 + Future resetPassword({ + required String token, + required String newPassword, + }) async { + state = state.copyWith(isLoading: true, error: null); + + try { + // 模拟网络延迟 + await Future.delayed(const Duration(milliseconds: 1000)); + + if (newPassword.length < 6) { + throw Exception('密码长度不能少于6位'); + } + + state = state.copyWith(isLoading: false); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + rethrow; + } + } + + /// 更新用户信息 + Future updateProfile({ + String? username, + String? email, + String? phone, + String? avatar, + }) async { + if (state.user == null) return; + + state = state.copyWith(isLoading: true, error: null); + + try { + // 模拟网络延迟 + await Future.delayed(const Duration(milliseconds: 1000)); + + final updatedUser = state.user!.copyWith( + username: username ?? state.user!.username, + email: email ?? state.user!.email, + phone: phone ?? state.user!.phone, + avatar: avatar ?? state.user!.avatar, + updatedAt: DateTime.now(), + ); + + state = state.copyWith( + user: updatedUser, + isLoading: false, + ); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + rethrow; + } + } + + /// 修改密码 + Future changePassword({ + required String currentPassword, + required String newPassword, + }) async { + state = state.copyWith(isLoading: true, error: null); + + try { + // 模拟网络延迟 + await Future.delayed(const Duration(milliseconds: 1000)); + + if (currentPassword.isEmpty || newPassword.isEmpty) { + throw Exception('当前密码和新密码不能为空'); + } + + if (newPassword.length < 6) { + throw Exception('新密码长度不能少于6位'); + } + + state = state.copyWith(isLoading: false); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + rethrow; + } + } + + /// 清除错误 + void clearError() { + state = state.copyWith(error: null); + } +} + +/// 认证服务提供者 +final authServiceProvider = Provider((ref) { + return AuthService(ApiClient.instance); +}); + +/// 存储服务提供者 - 改为同步Provider，因为StorageService已在main中初始化 +final storageServiceProvider = Provider((ref) { + // StorageService已经在main.dart中初始化，直接获取实例 + // 这里使用一个技巧：通过Future.value包装已初始化的实例 + throw UnimplementedError('Use storageServiceInstanceProvider instead'); +}); + +/// 认证状态提供者 - 改为StateNotifierProvider以保持状态 +final authProvider = StateNotifierProvider((ref) { + final authService = ref.watch(authServiceProvider); + // 直接使用已初始化的StorageService实例 + final storageService = StorageService.instance; + + return AuthNotifier(authService, storageService); +}); + +/// 是否已认证的提供者 +final isAuthenticatedProvider = Provider((ref) { + return ref.watch(authProvider).isAuthenticated; +}); + +/// 当前用户提供者 +final currentUserProvider = Provider((ref) { + return ref.watch(authProvider).user; +}); \ No newline at end of file diff --git a/client/lib/features/auth/screens/forgot_password_screen.dart b/client/lib/features/auth/screens/forgot_password_screen.dart new file mode 100644 index 0000000..31c50b5 --- /dev/null +++ b/client/lib/features/auth/screens/forgot_password_screen.dart @@ -0,0 +1,273 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/widgets/custom_button.dart'; +import '../../../core/widgets/custom_text_field.dart'; +import '../providers/auth_provider.dart'; + +/// 忘记密码页面 +class ForgotPasswordScreen extends ConsumerStatefulWidget { + const ForgotPasswordScreen({super.key}); + + @override + ConsumerState createState() => _ForgotPasswordScreenState(); +} + +class _ForgotPasswordScreenState extends ConsumerState { + final _formKey = GlobalKey(); + final _emailController = TextEditingController(); + + bool _isLoading = false; + bool _emailSent = false; + + @override + void dispose() { + _emailController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.background, + appBar: AppBar( + backgroundColor: Colors.transparent, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back_ios, color: AppColors.onSurface), + onPressed: () => Navigator.of(context).pop(), + ), + ), + body: SafeArea( + child: SingleChildScrollView( + padding: const EdgeInsets.all(AppDimensions.spacingXl), + child: Form( + key: _formKey, + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题 + Text( + _emailSent ? '邮件已发送' : '忘记密码', + style: AppTextStyles.headlineLarge.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + Text( + _emailSent + ? '我们已向您的邮箱发送了重置密码的链接，请查收邮件并按照说明操作。' + : '请输入您的邮箱地址，我们将向您发送重置密码的链接。', + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + const SizedBox(height: AppDimensions.spacingXxl), + + if (!_emailSent) ...[ + // 邮箱输入框 + CustomTextField( + controller: _emailController, + labelText: '邮箱', + hintText: '请输入您的邮箱地址', + prefixIcon: Icons.email_outlined, + keyboardType: TextInputType.emailAddress, + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入邮箱地址'; + } + if (!RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$').hasMatch(value)) { + return '请输入有效的邮箱地址'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingXl), + + // 发送重置链接按钮 + CustomButton( + text: '发送重置链接', + onPressed: _handleSendResetLink, + isLoading: _isLoading, + width: double.infinity, + ), + ] else ...[ + // 成功图标 + Center( + child: Container( + width: 120, + height: 120, + decoration: BoxDecoration( + color: AppColors.success.withOpacity(0.1), + shape: BoxShape.circle, + ), + child: Icon( + Icons.mark_email_read_outlined, + size: 60, + color: AppColors.success, + ), + ), + ), + const SizedBox(height: AppDimensions.spacingXl), + + // 重新发送按钮 + CustomButton( + text: '重新发送', + onPressed: _handleResendEmail, + isLoading: _isLoading, + width: double.infinity, + isOutlined: true, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 返回登录按钮 + CustomButton( + text: '返回登录', + onPressed: () => Navigator.of(context).pop(), + width: double.infinity, + ), + ], + + const SizedBox(height: AppDimensions.spacingXl), + + // 帮助信息 + Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.surfaceVariant, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.info_outline, + size: 20, + color: AppColors.primary, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + '温馨提示', + style: AppTextStyles.labelLarge.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingSm), + Text( + '• 请检查您的垃圾邮件文件夹\n• 重置链接将在24小时后过期\n• 如果仍未收到邮件，请联系客服', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurfaceVariant, + height: 1.5, + ), + ), + ], + ), + ), + + const SizedBox(height: AppDimensions.spacingXl), + + // 联系客服 + Center( + child: GestureDetector( + onTap: _handleContactSupport, + child: Text( + '联系客服', + style: AppTextStyles.labelLarge.copyWith( + color: AppColors.primary, + decoration: TextDecoration.underline, + ), + ), + ), + ), + ], + ), + ), + ), + ), + ); + } + + /// 处理发送重置链接 + Future _handleSendResetLink() async { + if (!_formKey.currentState!.validate()) { + return; + } + + setState(() { + _isLoading = true; + }); + + try { + await ref.read(authProvider.notifier).forgotPassword(_emailController.text.trim()); + + if (mounted) { + setState(() { + _emailSent = true; + }); + } + } catch (e) { + if (mounted) { + _showSnackBar(e.toString()); + } + } finally { + if (mounted) { + setState(() { + _isLoading = false; + }); + } + } + } + + /// 处理重新发送邮件 + Future _handleResendEmail() async { + setState(() { + _isLoading = true; + }); + + try { + await ref.read(authProvider.notifier).forgotPassword(_emailController.text.trim()); + + if (mounted) { + _showSnackBar('重置链接已重新发送', isSuccess: true); + } + } catch (e) { + if (mounted) { + _showSnackBar(e.toString()); + } + } finally { + if (mounted) { + setState(() { + _isLoading = false; + }); + } + } + } + + /// 处理联系客服 + void _handleContactSupport() { + // TODO: 实现联系客服功能 + _showSnackBar('客服功能即将上线'); + } + + /// 显示提示信息 + void _showSnackBar(String message, {bool isSuccess = false}) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text(message), + backgroundColor: isSuccess ? AppColors.success : AppColors.error, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/auth/screens/login_screen.dart b/client/lib/features/auth/screens/login_screen.dart new file mode 100644 index 0000000..bd4acd2 --- /dev/null +++ b/client/lib/features/auth/screens/login_screen.dart @@ -0,0 +1,384 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/routes/app_routes.dart'; +import '../../../core/widgets/custom_button.dart'; +import '../../../core/widgets/custom_text_field.dart'; +import '../providers/auth_provider.dart'; +import '../../../shared/widgets/custom_app_bar.dart'; + +/// 登录页面 +class LoginScreen extends ConsumerStatefulWidget { + const LoginScreen({super.key}); + + @override + ConsumerState createState() => _LoginScreenState(); +} + +class _LoginScreenState extends ConsumerState { + final _formKey = GlobalKey(); + final _emailController = TextEditingController(); + final _passwordController = TextEditingController(); + bool _obscurePassword = true; + bool _rememberMe = false; + + @override + void dispose() { + _emailController.dispose(); + _passwordController.dispose(); + super.dispose(); + } + + Future _handleLogin() async { + if (!_formKey.currentState!.validate()) { + return; + } + + try { + await ref.read(authProvider.notifier).login( + account: _emailController.text.trim(), // 可以是邮箱或用户名 + password: _passwordController.text, + rememberMe: _rememberMe, + ); + + if (mounted) { + Navigator.of(context).pushReplacementNamed(Routes.home); + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('登录失败: ${e.toString()}'), + backgroundColor: AppColors.error, + ), + ); + } + } + } + + void _navigateToRegister() { + Navigator.of(context).pushNamed(Routes.register); + } + + void _navigateToForgotPassword() { + Navigator.of(context).pushNamed(Routes.forgotPassword); + } + + void _fillTestUser() { + setState(() { + _emailController.text = 'test@example.com'; + _passwordController.text = 'Test@123'; + _rememberMe = true; + }); + + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: const Text('已填充测试用户信息 (test@example.com / Test@123)'), + backgroundColor: AppColors.primary, + duration: const Duration(seconds: 2), + ), + ); + } + + @override + Widget build(BuildContext context) { + final authState = ref.watch(authProvider); + final isLoading = authState.isLoading; + + return Scaffold( + appBar: CustomAppBar( + title: '登录', + onBackPressed: () { + Navigator.of(context).pushReplacementNamed(Routes.splash); + }, + ), + backgroundColor: AppColors.surface, + body: SafeArea( + child: SingleChildScrollView( + padding: EdgeInsets.all(AppDimensions.pagePadding), + child: Form( + key: _formKey, + child: Column( + crossAxisAlignment: CrossAxisAlignment.stretch, + children: [ + SizedBox(height: AppDimensions.spacingXxl), + + // Logo和标题 + Column( + children: [ + Container( + width: 120, + height: 120, + decoration: BoxDecoration( + color: AppColors.primary, + borderRadius: BorderRadius.circular(60), + ), + child: Icon( + Icons.school, + size: 60, + color: AppColors.onPrimary, + ), + ), + SizedBox(height: AppDimensions.spacingLg), + Text( + 'AI英语学习', + style: AppTextStyles.headlineLarge.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.bold, + ), + ), + SizedBox(height: AppDimensions.spacingSm), + Text( + '智能化英语学习平台', + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurface.withOpacity(0.7), + ), + ), + ], + ), + + SizedBox(height: AppDimensions.spacingXxl), + + // 登录表单 + Text( + '登录', + style: AppTextStyles.headlineMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.bold, + ), + ), + + SizedBox(height: AppDimensions.spacingLg), + + // 邮箱输入框 + CustomTextField( + controller: _emailController, + labelText: '邮箱', + hintText: '请输入邮箱地址', + keyboardType: TextInputType.emailAddress, + prefixIcon: Icons.email_outlined, + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入邮箱地址'; + } + if (!RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$').hasMatch(value)) { + return '请输入有效的邮箱地址'; + } + return null; + }, + ), + + SizedBox(height: AppDimensions.spacingMd), + + // 密码输入框 + CustomTextField( + controller: _passwordController, + labelText: '密码', + hintText: '请输入密码', + obscureText: _obscurePassword, + prefixIcon: Icons.lock_outlined, + suffixIcon: IconButton( + icon: Icon( + _obscurePassword ? Icons.visibility_outlined : Icons.visibility_off_outlined, + ), + onPressed: () { + setState(() { + _obscurePassword = !_obscurePassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入密码'; + } + if (value.length < 6) { + return '密码长度不能少于6位'; + } + return null; + }, + ), + + SizedBox(height: AppDimensions.spacingMd), + + // 记住我和忘记密码 + Row( + children: [ + Checkbox( + value: _rememberMe, + onChanged: (value) { + setState(() { + _rememberMe = value ?? false; + }); + }, + activeColor: AppColors.primary, + ), + Text( + '记住我', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurface, + ), + ), + const Spacer(), + TextButton( + onPressed: _navigateToForgotPassword, + child: Text( + '忘记密码？', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.primary, + ), + ), + ), + ], + ), + + SizedBox(height: AppDimensions.spacingLg), + + // 测试用户快速填充按钮（仅开发模式显示） + if (const bool.fromEnvironment('dart.vm.product') == false || true) ...[ + OutlinedButton.icon( + onPressed: _fillTestUser, + icon: Icon( + Icons.bug_report, + color: AppColors.secondary, + size: 20, + ), + label: Text( + '填充测试用户', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.secondary, + ), + ), + style: OutlinedButton.styleFrom( + side: BorderSide(color: AppColors.secondary), + padding: EdgeInsets.symmetric( + vertical: AppDimensions.spacingSm, + horizontal: AppDimensions.spacingMd, + ), + ), + ), + SizedBox(height: AppDimensions.spacingMd), + ], + + // 登录按钮 + CustomButton( + text: '登录', + onPressed: isLoading ? null : _handleLogin, + isLoading: isLoading, + ), + + SizedBox(height: AppDimensions.spacingLg), + + // 分割线 + Row( + children: [ + Expanded( + child: Divider( + color: AppColors.onSurface.withOpacity(0.3), + ), + ), + Padding( + padding: EdgeInsets.symmetric(horizontal: AppDimensions.spacingMd), + child: Text( + '或', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurface.withOpacity(0.7), + ), + ), + ), + Expanded( + child: Divider( + color: AppColors.onSurface.withOpacity(0.3), + ), + ), + ], + ), + + SizedBox(height: AppDimensions.spacingLg), + + // 第三方登录按钮 + Row( + children: [ + Expanded( + child: OutlinedButton.icon( + onPressed: () { + // TODO: 实现微信登录 + }, + icon: Icon( + Icons.wechat, + color: AppColors.primary, + ), + label: Text( + '微信登录', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.primary, + ), + ), + style: OutlinedButton.styleFrom( + side: BorderSide(color: AppColors.primary), + padding: EdgeInsets.symmetric( + vertical: AppDimensions.spacingMd, + ), + ), + ), + ), + SizedBox(width: AppDimensions.spacingMd), + Expanded( + child: OutlinedButton.icon( + onPressed: () { + // TODO: 实现QQ登录 + }, + icon: Icon( + Icons.account_circle, + color: AppColors.primary, + ), + label: Text( + 'QQ登录', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.primary, + ), + ), + style: OutlinedButton.styleFrom( + side: BorderSide(color: AppColors.primary), + padding: EdgeInsets.symmetric( + vertical: AppDimensions.spacingMd, + ), + ), + ), + ), + ], + ), + + SizedBox(height: AppDimensions.spacingXl), + + // 注册链接 + Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Text( + '还没有账号？', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurface.withOpacity(0.7), + ), + ), + TextButton( + onPressed: _navigateToRegister, + child: Text( + '立即注册', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + ], + ), + ), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/auth/screens/profile_screen.dart b/client/lib/features/auth/screens/profile_screen.dart new file mode 100644 index 0000000..06c517f --- /dev/null +++ b/client/lib/features/auth/screens/profile_screen.dart @@ -0,0 +1,768 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/widgets/custom_button.dart'; +import '../../../core/widgets/custom_text_field.dart'; +import '../providers/auth_provider.dart'; +import '../../../core/models/user_model.dart'; + +/// 个人信息管理页面 +class ProfileScreen extends ConsumerStatefulWidget { + const ProfileScreen({super.key}); + + @override + ConsumerState createState() => _ProfileScreenState(); +} + +class _ProfileScreenState extends ConsumerState with SingleTickerProviderStateMixin { + late TabController _tabController; + final _formKey = GlobalKey(); + + // 个人信息控制器 + final _usernameController = TextEditingController(); + final _emailController = TextEditingController(); + final _phoneController = TextEditingController(); + final _bioController = TextEditingController(); + + // 密码修改控制器 + final _currentPasswordController = TextEditingController(); + final _newPasswordController = TextEditingController(); + final _confirmPasswordController = TextEditingController(); + + bool _isLoading = false; + bool _isEditing = false; + bool _obscureCurrentPassword = true; + bool _obscureNewPassword = true; + bool _obscureConfirmPassword = true; + + @override + void initState() { + super.initState(); + _tabController = TabController(length: 3, vsync: this); + _loadUserData(); + } + + @override + void dispose() { + _tabController.dispose(); + _usernameController.dispose(); + _emailController.dispose(); + _phoneController.dispose(); + _bioController.dispose(); + _currentPasswordController.dispose(); + _newPasswordController.dispose(); + _confirmPasswordController.dispose(); + super.dispose(); + } + + /// 加载用户数据 + void _loadUserData() async { + try { + final authNotifier = await ref.read(authProvider.future); + final user = authNotifier.state.user; + + if (user != null) { + _usernameController.text = user.username; + _emailController.text = user.email; + _phoneController.text = user.profile?.phone ?? ''; + _bioController.text = user.profile?.bio ?? ''; + } + } catch (e) { + // 处理错误 + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.background, + appBar: AppBar( + backgroundColor: AppColors.surface, + elevation: 0, + title: Text( + '个人信息', + style: AppTextStyles.headlineSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + actions: [ + if (_tabController.index == 0) + TextButton( + onPressed: () { + setState(() { + _isEditing = !_isEditing; + }); + }, + child: Text( + _isEditing ? '取消' : '编辑', + style: AppTextStyles.labelLarge.copyWith( + color: AppColors.primary, + ), + ), + ), + ], + bottom: TabBar( + controller: _tabController, + labelColor: AppColors.primary, + unselectedLabelColor: AppColors.onSurfaceVariant, + indicatorColor: AppColors.primary, + tabs: const [ + Tab(text: '基本信息'), + Tab(text: '安全设置'), + Tab(text: '学习偏好'), + ], + ), + ), + body: TabBarView( + controller: _tabController, + children: [ + _buildBasicInfoTab(), + _buildSecurityTab(), + _buildPreferencesTab(), + ], + ), + ); + } + + /// 基本信息标签页 + Widget _buildBasicInfoTab() { + return Consumer(builder: (context, ref, child) { + final authNotifierAsync = ref.watch(authProvider); + + return authNotifierAsync.when( + data: (authNotifier) { + final user = authNotifier.state.user; + + return SingleChildScrollView( + padding: const EdgeInsets.all(AppDimensions.spacingXl), + child: Form( + key: _formKey, + child: Column( + children: [ + // 头像 + Center( + child: Stack( + children: [ + CircleAvatar( + radius: 60, + backgroundColor: AppColors.surfaceVariant, + backgroundImage: user?.profile?.avatar != null + ? NetworkImage(user!.profile!.avatar!) + : null, + child: user?.profile?.avatar == null + ? Icon( + Icons.person, + size: 60, + color: AppColors.onSurfaceVariant, + ) + : null, + ), + if (_isEditing) + Positioned( + bottom: 0, + right: 0, + child: GestureDetector( + onTap: _handleAvatarChange, + child: Container( + padding: const EdgeInsets.all(8), + decoration: BoxDecoration( + color: AppColors.primary, + shape: BoxShape.circle, + border: Border.all( + color: AppColors.surface, + width: 2, + ), + ), + child: Icon( + Icons.camera_alt, + size: 20, + color: AppColors.onPrimary, + ), + ), + ), + ), + ], + ), + ), + const SizedBox(height: AppDimensions.spacingXl), + + // 用户名 + CustomTextField( + controller: _usernameController, + labelText: '用户名', + prefixIcon: Icons.person_outline, + enabled: _isEditing, + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入用户名'; + } + if (value.length < 3) { + return '用户名至少3个字符'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 邮箱 + CustomTextField( + controller: _emailController, + labelText: '邮箱', + prefixIcon: Icons.email_outlined, + enabled: false, // 邮箱不允许修改 + keyboardType: TextInputType.emailAddress, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 手机号 + CustomTextField( + controller: _phoneController, + labelText: '手机号', + prefixIcon: Icons.phone_outlined, + enabled: _isEditing, + keyboardType: TextInputType.phone, + validator: (value) { + if (value != null && value.isNotEmpty) { + if (!RegExp(r'^1[3-9]\d{9}$').hasMatch(value)) { + return '请输入有效的手机号'; + } + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 个人简介 + CustomTextField( + controller: _bioController, + labelText: '个人简介', + prefixIcon: Icons.edit_outlined, + enabled: _isEditing, + maxLines: 3, + hintText: '介绍一下自己吧...', + ), + const SizedBox(height: AppDimensions.spacingXl), + + // 保存按钮 + if (_isEditing) + CustomButton( + text: '保存修改', + onPressed: _handleSaveProfile, + isLoading: _isLoading, + width: double.infinity, + ), + ], + ), + ), + ); + }, + loading: () => const Center(child: CircularProgressIndicator()), + error: (error, stack) => Center( + child: Text('加载失败: $error'), + ), + ); + }); + } + + /// 安全设置标签页 + Widget _buildSecurityTab() { + return SingleChildScrollView( + padding: const EdgeInsets.all(AppDimensions.spacingXl), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 修改密码 + Text( + '修改密码', + style: AppTextStyles.titleMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 当前密码 + CustomTextField( + controller: _currentPasswordController, + labelText: '当前密码', + prefixIcon: Icons.lock_outline, + obscureText: _obscureCurrentPassword, + suffixIcon: IconButton( + icon: Icon( + _obscureCurrentPassword ? Icons.visibility_off : Icons.visibility, + color: AppColors.onSurfaceVariant, + ), + onPressed: () { + setState(() { + _obscureCurrentPassword = !_obscureCurrentPassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入当前密码'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 新密码 + CustomTextField( + controller: _newPasswordController, + labelText: '新密码', + prefixIcon: Icons.lock_outline, + obscureText: _obscureNewPassword, + suffixIcon: IconButton( + icon: Icon( + _obscureNewPassword ? Icons.visibility_off : Icons.visibility, + color: AppColors.onSurfaceVariant, + ), + onPressed: () { + setState(() { + _obscureNewPassword = !_obscureNewPassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入新密码'; + } + if (value.length < 8) { + return '密码至少8个字符'; + } + if (!RegExp(r'^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)').hasMatch(value)) { + return '密码必须包含大小写字母和数字'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 确认新密码 + CustomTextField( + controller: _confirmPasswordController, + labelText: '确认新密码', + prefixIcon: Icons.lock_outline, + obscureText: _obscureConfirmPassword, + suffixIcon: IconButton( + icon: Icon( + _obscureConfirmPassword ? Icons.visibility_off : Icons.visibility, + color: AppColors.onSurfaceVariant, + ), + onPressed: () { + setState(() { + _obscureConfirmPassword = !_obscureConfirmPassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请确认新密码'; + } + if (value != _newPasswordController.text) { + return '两次输入的密码不一致'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingXl), + + // 修改密码按钮 + CustomButton( + text: '修改密码', + onPressed: _handleChangePassword, + isLoading: _isLoading, + width: double.infinity, + ), + const SizedBox(height: AppDimensions.spacingXl), + + // 其他安全选项 + _buildSecurityOption( + icon: Icons.security, + title: '两步验证', + subtitle: '为您的账户添加额外的安全保护', + onTap: () => _showSnackBar('两步验证功能即将上线'), + ), + _buildSecurityOption( + icon: Icons.devices, + title: '设备管理', + subtitle: '查看和管理已登录的设备', + onTap: () => _showSnackBar('设备管理功能即将上线'), + ), + _buildSecurityOption( + icon: Icons.history, + title: '登录历史', + subtitle: '查看最近的登录记录', + onTap: () => _showSnackBar('登录历史功能即将上线'), + ), + ], + ), + ); + } + + /// 学习偏好标签页 + Widget _buildPreferencesTab() { + return Consumer(builder: (context, ref, child) { + final authNotifierAsync = ref.watch(authProvider); + + return authNotifierAsync.when( + data: (authNotifier) { + final user = authNotifier.state.user; + final settings = user?.profile?.settings; + + return SingleChildScrollView( + padding: const EdgeInsets.all(AppDimensions.spacingXl), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '学习设置', + style: AppTextStyles.titleMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + _buildPreferenceOption( + icon: Icons.notifications, + title: '学习提醒', + subtitle: '每日学习提醒通知', + value: settings?.notificationsEnabled ?? true, + onChanged: (value) => _updateSetting('notificationsEnabled', value), + ), + _buildPreferenceOption( + icon: Icons.volume_up, + title: '音效', + subtitle: '学习过程中的音效反馈', + value: settings?.soundEnabled ?? true, + onChanged: (value) => _updateSetting('soundEnabled', value), + ), + _buildPreferenceOption( + icon: Icons.vibration, + title: '震动反馈', + subtitle: '操作时的震动反馈', + value: settings?.vibrationEnabled ?? true, + onChanged: (value) => _updateSetting('vibrationEnabled', value), + ), + + const SizedBox(height: AppDimensions.spacingXl), + + Text( + '学习目标', + style: AppTextStyles.titleMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + _buildGoalOption( + title: '每日单词目标', + value: '${settings?.dailyWordGoal ?? 20} 个', + onTap: () => _showGoalDialog('dailyWordGoal', settings?.dailyWordGoal ?? 20), + ), + _buildGoalOption( + title: '每日学习时长', + value: '${settings?.dailyStudyMinutes ?? 30} 分钟', + onTap: () => _showGoalDialog('dailyStudyMinutes', settings?.dailyStudyMinutes ?? 30), + ), + + const SizedBox(height: AppDimensions.spacingXl), + + Text( + '英语水平', + style: AppTextStyles.titleMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + _buildLevelOption( + title: '当前水平', + value: _getLevelText(user?.profile?.englishLevel ?? EnglishLevel.beginner), + onTap: () => _showLevelDialog(), + ), + ], + ), + ); + }, + loading: () => const Center(child: CircularProgressIndicator()), + error: (error, stack) => Center( + child: Text('加载失败: $error'), + ), + ); + }); + } + + /// 构建安全选项 + Widget _buildSecurityOption({ + required IconData icon, + required String title, + required String subtitle, + required VoidCallback onTap, + }) { + return ListTile( + leading: Icon(icon, color: AppColors.primary), + title: Text( + title, + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurface, + ), + ), + subtitle: Text( + subtitle, + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + trailing: Icon( + Icons.arrow_forward_ios, + size: 16, + color: AppColors.onSurfaceVariant, + ), + onTap: onTap, + ); + } + + /// 构建偏好选项 + Widget _buildPreferenceOption({ + required IconData icon, + required String title, + required String subtitle, + required bool value, + required ValueChanged onChanged, + }) { + return ListTile( + leading: Icon(icon, color: AppColors.primary), + title: Text( + title, + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurface, + ), + ), + subtitle: Text( + subtitle, + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + trailing: Switch( + value: value, + onChanged: onChanged, + activeColor: AppColors.primary, + ), + ); + } + + /// 构建目标选项 + Widget _buildGoalOption({ + required String title, + required String value, + required VoidCallback onTap, + }) { + return ListTile( + title: Text( + title, + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurface, + ), + ), + trailing: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Text( + value, + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.primary, + ), + ), + const SizedBox(width: 8), + Icon( + Icons.arrow_forward_ios, + size: 16, + color: AppColors.onSurfaceVariant, + ), + ], + ), + onTap: onTap, + ); + } + + /// 构建水平选项 + Widget _buildLevelOption({ + required String title, + required String value, + required VoidCallback onTap, + }) { + return ListTile( + title: Text( + title, + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurface, + ), + ), + trailing: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Text( + value, + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.primary, + ), + ), + const SizedBox(width: 8), + Icon( + Icons.arrow_forward_ios, + size: 16, + color: AppColors.onSurfaceVariant, + ), + ], + ), + onTap: onTap, + ); + } + + /// 处理头像更改 + void _handleAvatarChange() { + // TODO: 实现头像更改功能 + _showSnackBar('头像更改功能即将上线'); + } + + /// 处理保存个人信息 + Future _handleSaveProfile() async { + if (!_formKey.currentState!.validate()) { + return; + } + + setState(() { + _isLoading = true; + }); + + try { + final authNotifier = await ref.read(authProvider.future); + await authNotifier.updateProfile( + username: _usernameController.text.trim(), + phone: _phoneController.text.trim(), + ); + + if (mounted) { + setState(() { + _isEditing = false; + }); + _showSnackBar('个人信息更新成功', isSuccess: true); + } + } catch (e) { + if (mounted) { + _showSnackBar(e.toString()); + } + } finally { + if (mounted) { + setState(() { + _isLoading = false; + }); + } + } + } + + /// 处理修改密码 + Future _handleChangePassword() async { + if (_currentPasswordController.text.isEmpty || + _newPasswordController.text.isEmpty || + _confirmPasswordController.text.isEmpty) { + _showSnackBar('请填写所有密码字段'); + return; + } + + if (_newPasswordController.text != _confirmPasswordController.text) { + _showSnackBar('两次输入的新密码不一致'); + return; + } + + setState(() { + _isLoading = true; + }); + + try { + final authNotifier = await ref.read(authProvider.future); + await authNotifier.changePassword( + currentPassword: _currentPasswordController.text, + newPassword: _newPasswordController.text, + ); + + if (mounted) { + _currentPasswordController.clear(); + _newPasswordController.clear(); + _confirmPasswordController.clear(); + _showSnackBar('密码修改成功', isSuccess: true); + } + } catch (e) { + if (mounted) { + _showSnackBar(e.toString()); + } + } finally { + if (mounted) { + setState(() { + _isLoading = false; + }); + } + } + } + + /// 更新设置 + void _updateSetting(String key, bool value) { + // TODO: 实现设置更新 + _showSnackBar('设置已更新', isSuccess: true); + } + + /// 显示目标设置对话框 + void _showGoalDialog(String type, int currentValue) { + // TODO: 实现目标设置对话框 + _showSnackBar('目标设置功能即将上线'); + } + + /// 显示水平选择对话框 + void _showLevelDialog() { + // TODO: 实现水平选择对话框 + _showSnackBar('水平设置功能即将上线'); + } + + /// 获取水平文本 + String _getLevelText(EnglishLevel level) { + switch (level) { + case EnglishLevel.beginner: + return '初级'; + case EnglishLevel.elementary: + return '基础'; + case EnglishLevel.intermediate: + return '中级'; + case EnglishLevel.upperIntermediate: + return '中高级'; + case EnglishLevel.advanced: + return '高级'; + case EnglishLevel.proficient: + return '精通'; + case EnglishLevel.expert: + return '专家'; + } + } + + /// 显示提示信息 + void _showSnackBar(String message, {bool isSuccess = false}) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text(message), + backgroundColor: isSuccess ? AppColors.success : AppColors.error, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/auth/screens/register_screen.dart b/client/lib/features/auth/screens/register_screen.dart new file mode 100644 index 0000000..8f46b7a --- /dev/null +++ b/client/lib/features/auth/screens/register_screen.dart @@ -0,0 +1,519 @@ +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/widgets/custom_button.dart'; +import '../../../core/widgets/custom_text_field.dart'; +import '../../../core/routes/app_routes.dart'; +import '../providers/auth_provider.dart'; + +/// 注册页面 +class RegisterScreen extends ConsumerStatefulWidget { + const RegisterScreen({super.key}); + + @override + ConsumerState createState() => _RegisterScreenState(); +} + +class _RegisterScreenState extends ConsumerState { + final _formKey = GlobalKey(); + final _usernameController = TextEditingController(); + final _nicknameController = TextEditingController(); + final _emailController = TextEditingController(); + final _passwordController = TextEditingController(); + final _confirmPasswordController = TextEditingController(); + + bool _obscurePassword = true; + bool _obscureConfirmPassword = true; + bool _agreeToTerms = false; + bool _isLoading = false; + + // 密码强度提示 + bool _hasMinLength = false; + bool _hasNumber = false; + bool _hasLowerCase = false; + bool _hasUpperCase = false; + bool _hasSpecialChar = false; + + @override + void initState() { + super.initState(); + // 监听密码输入，实时验证 + _passwordController.addListener(_validatePasswordStrength); + } + + /// 验证密码强度 + void _validatePasswordStrength() { + final password = _passwordController.text; + setState(() { + _hasMinLength = password.length >= 8; + _hasNumber = RegExp(r'[0-9]').hasMatch(password); + _hasLowerCase = RegExp(r'[a-z]').hasMatch(password); + _hasUpperCase = RegExp(r'[A-Z]').hasMatch(password); + _hasSpecialChar = RegExp(r'[!@#\$%^&*()_+\-=\[\]{};:"\\|,.<>\/?]').hasMatch(password); + }); + } + + @override + void dispose() { + _usernameController.dispose(); + _nicknameController.dispose(); + _emailController.dispose(); + _passwordController.dispose(); + _confirmPasswordController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.background, + appBar: AppBar( + backgroundColor: Colors.transparent, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back_ios, color: AppColors.onSurface), + onPressed: () => Navigator.of(context).pop(), + ), + ), + body: SafeArea( + child: SingleChildScrollView( + padding: const EdgeInsets.all(AppDimensions.pagePadding), + child: Form( + key: _formKey, + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题 + Text( + '创建账户', + style: AppTextStyles.headlineLarge.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: AppDimensions.spacingSm), + Text( + '加入AI英语学习平台，开启智能学习之旅', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + const SizedBox(height: AppDimensions.spacingXl), + + // 用户名输入框 + CustomTextField( + controller: _usernameController, + labelText: '用户名', + hintText: '请输入用户名', + prefixIcon: Icons.person_outline, + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入用户名'; + } + if (value.length < 3) { + return '用户名至少3个字符'; + } + if (value.length > 20) { + return '用户名不能超过20个字符'; + } + if (!RegExp(r'^[a-zA-Z0-9_]+$').hasMatch(value)) { + return '用户名只能包含字母、数字和下划线'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 昵称输入框 + CustomTextField( + controller: _nicknameController, + labelText: '昵称', + hintText: '请输入昵称', + prefixIcon: Icons.badge_outlined, + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入昵称'; + } + if (value.length < 2) { + return '昵称至少2个字符'; + } + if (value.length > 20) { + return '昵称不能超过20个字符'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 邮箱输入框 + CustomTextField( + controller: _emailController, + labelText: '邮箱', + hintText: '请输入邮箱地址', + prefixIcon: Icons.email_outlined, + keyboardType: TextInputType.emailAddress, + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入邮箱地址'; + } + if (!RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$').hasMatch(value)) { + return '请输入有效的邮箱地址'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 密码输入框 + CustomTextField( + controller: _passwordController, + labelText: '密码', + hintText: '请输入密码', + prefixIcon: Icons.lock_outline, + obscureText: _obscurePassword, + suffixIcon: IconButton( + icon: Icon( + _obscurePassword ? Icons.visibility_off : Icons.visibility, + color: AppColors.onSurfaceVariant, + ), + onPressed: () { + setState(() { + _obscurePassword = !_obscurePassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入密码'; + } + if (value.length < 8) { + return '密码至少8个字符'; + } + // 至少包含一个数字 + if (!RegExp(r'[0-9]').hasMatch(value)) { + return '密码必须包含数字'; + } + // 至少包含一个小写字母 + if (!RegExp(r'[a-z]').hasMatch(value)) { + return '密码必须包含小写字母'; + } + // 至少包含一个大写字母 + if (!RegExp(r'[A-Z]').hasMatch(value)) { + return '密码必须包含大写字母'; + } + // 至少包含一个特殊字符 + if (!RegExp(r'[!@#\$%^&*()_+\-=\[\]{};:"\\|,.<>\/?]').hasMatch(value)) { + return '密码必须包含特殊字符 (!@#\$%^&*等)'; + } + return null; + }, + ), + const SizedBox(height: 8), + // 密码强度提示 + Container( + padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 12), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + border: Border.all(color: Colors.grey[200]!), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '密码必须包含：', + style: AppTextStyles.bodySmall.copyWith( + fontWeight: FontWeight.w600, + color: Colors.grey[700], + ), + ), + const SizedBox(height: 8), + _buildPasswordRequirement('至少8个字符', _hasMinLength), + _buildPasswordRequirement('至少一个数字', _hasNumber), + _buildPasswordRequirement('至少一个小写字母', _hasLowerCase), + _buildPasswordRequirement('至少一个大写字母', _hasUpperCase), + _buildPasswordRequirement('至少一个特殊字符 (!@#\$%^&*等)', _hasSpecialChar), + ], + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 确认密码输入框 + CustomTextField( + controller: _confirmPasswordController, + labelText: '确认密码', + hintText: '请再次输入密码', + prefixIcon: Icons.lock_outline, + obscureText: _obscureConfirmPassword, + suffixIcon: IconButton( + icon: Icon( + _obscureConfirmPassword ? Icons.visibility_off : Icons.visibility, + color: AppColors.onSurfaceVariant, + ), + onPressed: () { + setState(() { + _obscureConfirmPassword = !_obscureConfirmPassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请确认密码'; + } + if (value != _passwordController.text) { + return '两次输入的密码不一致'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 同意条款 + Row( + children: [ + Checkbox( + value: _agreeToTerms, + onChanged: (value) { + setState(() { + _agreeToTerms = value ?? false; + }); + }, + activeColor: AppColors.primary, + ), + Expanded( + child: GestureDetector( + onTap: () { + setState(() { + _agreeToTerms = !_agreeToTerms; + }); + }, + child: RichText( + text: TextSpan( + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + children: [ + const TextSpan(text: '我已阅读并同意'), + TextSpan( + text: '《用户协议》', + style: TextStyle( + color: AppColors.primary, + decoration: TextDecoration.underline, + ), + ), + const TextSpan(text: '和'), + TextSpan( + text: '《隐私政策》', + style: TextStyle( + color: AppColors.primary, + decoration: TextDecoration.underline, + ), + ), + ], + ), + ), + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingLg), + + // 注册按钮 + CustomButton( + text: '注册', + onPressed: _agreeToTerms ? _handleRegister : null, + isLoading: _isLoading, + width: double.infinity, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 分割线 + Row( + children: [ + const Expanded(child: Divider(color: AppColors.divider)), + Padding( + padding: const EdgeInsets.symmetric(horizontal: AppDimensions.buttonPadding), + child: Text( + '或', + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ), + const Expanded(child: Divider(color: AppColors.divider)), + ], + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 第三方注册 + Row( + children: [ + Expanded( + child: CustomButton( + text: '微信注册', + onPressed: () => _handleSocialRegister('wechat'), + backgroundColor: const Color(0xFF07C160), + textColor: Colors.white, + icon: Icons.wechat, + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + Expanded( + child: CustomButton( + text: 'QQ注册', + onPressed: () => _handleSocialRegister('qq'), + backgroundColor: const Color(0xFF12B7F5), + textColor: Colors.white, + icon: Icons.chat, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingLg), + + // 登录链接 + Center( + child: GestureDetector( + onTap: () { + Navigator.of(context).pop(); + }, + child: RichText( + text: TextSpan( + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurfaceVariant, + ), + children: [ + const TextSpan(text: '已有账户？'), + TextSpan( + text: '立即登录', + style: TextStyle( + color: AppColors.primary, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + ), + ), + ), + ], + ), + ), + ), + ), + ); + } + + /// 构建密码要求项 + Widget _buildPasswordRequirement(String text, bool isMet) { + return Padding( + padding: const EdgeInsets.only(bottom: 4), + child: Row( + children: [ + Icon( + isMet ? Icons.check_circle : Icons.circle_outlined, + size: 16, + color: isMet ? AppColors.success : Colors.grey[400], + ), + const SizedBox(width: 8), + Text( + text, + style: AppTextStyles.bodySmall.copyWith( + color: isMet ? AppColors.success : Colors.grey[600], + fontSize: 13, + ), + ), + ], + ), + ); + } + + /// 处理注册 + Future _handleRegister() async { + if (!_formKey.currentState!.validate()) { + return; + } + + if (!_agreeToTerms) { + _showSnackBar('请先同意用户协议和隐私政策'); + return; + } + + setState(() { + _isLoading = true; + }); + + try { + await ref.read(authProvider.notifier).register( + username: _usernameController.text.trim(), + email: _emailController.text.trim(), + password: _passwordController.text, + nickname: _nicknameController.text.trim(), + ); + + if (mounted) { + _showSnackBar('注册成功，正在自动登录...', isSuccess: true); + + // 注册成功后自动登录 + try { + await ref.read(authProvider.notifier).login( + account: _usernameController.text.trim(), + password: _passwordController.text, + ); + + if (mounted) { + // 登录成功，跳转到首页 + Navigator.of(context).pushReplacementNamed(Routes.home); + } + } catch (loginError) { + if (mounted) { + // 自动登录失败，跳转到登录页 + _showSnackBar('注册成功，请登录', isSuccess: true); + Future.delayed(const Duration(milliseconds: 1500), () { + if (mounted) { + Navigator.of(context).pushReplacementNamed(Routes.login); + } + }); + } + } + } + } catch (e) { + if (mounted) { + _showSnackBar(e.toString()); + } + } finally { + if (mounted) { + setState(() { + _isLoading = false; + }); + } + } + } + + /// 处理第三方注册 + Future _handleSocialRegister(String provider) async { + try { + // TODO: 实现第三方注册逻辑 + _showSnackBar('第三方注册功能即将上线'); + } catch (e) { + _showSnackBar(e.toString()); + } + } + + /// 显示提示信息 + void _showSnackBar(String message, {bool isSuccess = false}) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text(message), + backgroundColor: isSuccess ? AppColors.success : AppColors.error, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8.0), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/auth/screens/reset_password_screen.dart b/client/lib/features/auth/screens/reset_password_screen.dart new file mode 100644 index 0000000..90318ad --- /dev/null +++ b/client/lib/features/auth/screens/reset_password_screen.dart @@ -0,0 +1,419 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/widgets/custom_button.dart'; +import '../../../core/widgets/custom_text_field.dart'; +import '../providers/auth_provider.dart'; + +/// 重置密码页面 +class ResetPasswordScreen extends StatefulWidget { + final String token; + final String email; + + const ResetPasswordScreen({ + super.key, + required this.token, + required this.email, + }); + + @override + State createState() => _ResetPasswordScreenState(); +} + +class _ResetPasswordScreenState extends State { + final _formKey = GlobalKey(); + final _passwordController = TextEditingController(); + final _confirmPasswordController = TextEditingController(); + + bool _isLoading = false; + bool _obscurePassword = true; + bool _obscureConfirmPassword = true; + bool _resetSuccess = false; + + @override + void dispose() { + _passwordController.dispose(); + _confirmPasswordController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.background, + appBar: AppBar( + backgroundColor: AppColors.surface, + elevation: 0, + title: Text( + '重置密码', + style: AppTextStyles.headlineSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + ), + body: SafeArea( + child: _resetSuccess ? _buildSuccessView() : _buildResetForm(), + ), + ); + } + + /// 构建重置密码表单 + Widget _buildResetForm() { + return SingleChildScrollView( + padding: const EdgeInsets.all(AppDimensions.spacingXl), + child: Form( + key: _formKey, + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题和说明 + Text( + '设置新密码', + style: AppTextStyles.headlineMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: AppDimensions.spacingSm), + Text( + '为您的账户 ${widget.email} 设置一个新的安全密码', + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + const SizedBox(height: AppDimensions.spacingXl), + + // 新密码输入框 + CustomTextField( + controller: _passwordController, + labelText: '新密码', + hintText: '请输入新密码', + prefixIcon: Icons.lock_outline, + obscureText: _obscurePassword, + suffixIcon: IconButton( + icon: Icon( + _obscurePassword ? Icons.visibility_off : Icons.visibility, + color: AppColors.onSurfaceVariant, + ), + onPressed: () { + setState(() { + _obscurePassword = !_obscurePassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入新密码'; + } + if (value.length < 8) { + return '密码至少8个字符'; + } + if (!RegExp(r'^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)').hasMatch(value)) { + return '密码必须包含大小写字母和数字'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 确认密码输入框 + CustomTextField( + controller: _confirmPasswordController, + labelText: '确认新密码', + hintText: '请再次输入新密码', + prefixIcon: Icons.lock_outline, + obscureText: _obscureConfirmPassword, + suffixIcon: IconButton( + icon: Icon( + _obscureConfirmPassword ? Icons.visibility_off : Icons.visibility, + color: AppColors.onSurfaceVariant, + ), + onPressed: () { + setState(() { + _obscureConfirmPassword = !_obscureConfirmPassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请确认新密码'; + } + if (value != _passwordController.text) { + return '两次输入的密码不一致'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 密码强度提示 + _buildPasswordStrengthIndicator(), + const SizedBox(height: AppDimensions.spacingXl), + + // 重置密码按钮 + CustomButton( + text: '重置密码', + onPressed: _handleResetPassword, + isLoading: _isLoading, + width: double.infinity, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 返回登录 + Center( + child: TextButton( + onPressed: () { + Navigator.of(context).pushNamedAndRemoveUntil( + '/login', + (route) => false, + ); + }, + child: Text( + '返回登录', + style: AppTextStyles.labelLarge.copyWith( + color: AppColors.primary, + ), + ), + ), + ), + ], + ), + ), + ); + } + + /// 构建成功视图 + Widget _buildSuccessView() { + return Padding( + padding: const EdgeInsets.all(AppDimensions.spacingXl), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + // 成功图标 + Container( + width: 120, + height: 120, + decoration: BoxDecoration( + color: AppColors.success.withOpacity(0.1), + shape: BoxShape.circle, + ), + child: Icon( + Icons.check_circle, + size: 80, + color: AppColors.success, + ), + ), + const SizedBox(height: AppDimensions.spacingXl), + + // 成功标题 + Text( + '密码重置成功', + style: AppTextStyles.headlineMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.bold, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 成功描述 + Text( + '您的密码已成功重置，现在可以使用新密码登录您的账户了。', + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurfaceVariant, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: AppDimensions.spacingXl), + + // 前往登录按钮 + CustomButton( + text: '前往登录', + onPressed: () { + Navigator.of(context).pushNamedAndRemoveUntil( + '/login', + (route) => false, + ); + }, + width: double.infinity, + ), + ], + ), + ); + } + + /// 构建密码强度指示器 + Widget _buildPasswordStrengthIndicator() { + final password = _passwordController.text; + final strength = _calculatePasswordStrength(password); + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '密码强度', + style: AppTextStyles.labelMedium.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + const SizedBox(height: AppDimensions.spacingXs), + + // 强度条 + Row( + children: List.generate(4, (index) { + Color color; + if (index < strength) { + switch (strength) { + case 1: + color = AppColors.error; + break; + case 2: + color = Colors.orange; + break; + case 3: + color = Colors.yellow; + break; + case 4: + color = AppColors.success; + break; + default: + color = AppColors.surfaceVariant; + } + } else { + color = AppColors.surfaceVariant; + } + + return Expanded( + child: Container( + height: 4, + margin: EdgeInsets.only( + right: index < 3 ? AppDimensions.spacingXs : 0, + ), + decoration: BoxDecoration( + color: color, + borderRadius: BorderRadius.circular(2), + ), + ), + ); + }), + ), + const SizedBox(height: AppDimensions.spacingXs), + + // 强度文本 + Text( + _getStrengthText(strength), + style: AppTextStyles.labelSmall.copyWith( + color: _getStrengthColor(strength), + ), + ), + ], + ); + } + + /// 计算密码强度 + int _calculatePasswordStrength(String password) { + if (password.isEmpty) return 0; + + int strength = 0; + + // 长度检查 + if (password.length >= 8) strength++; + + // 包含小写字母 + if (password.contains(RegExp(r'[a-z]'))) strength++; + + // 包含大写字母 + if (password.contains(RegExp(r'[A-Z]'))) strength++; + + // 包含数字或特殊字符 + if (password.contains(RegExp(r'[0-9!@#$%^&*(),.?":{}|<>]'))) strength++; + + return strength; + } + + /// 获取强度文本 + String _getStrengthText(int strength) { + switch (strength) { + case 0: + case 1: + return '弱'; + case 2: + return '一般'; + case 3: + return '良好'; + case 4: + return '强'; + default: + return ''; + } + } + + /// 获取强度颜色 + Color _getStrengthColor(int strength) { + switch (strength) { + case 0: + case 1: + return AppColors.error; + case 2: + return Colors.orange; + case 3: + return Colors.yellow; + case 4: + return AppColors.success; + default: + return AppColors.onSurfaceVariant; + } + } + + /// 处理重置密码 + Future _handleResetPassword() async { + if (!_formKey.currentState!.validate()) { + return; + } + + setState(() { + _isLoading = true; + }); + + try { + final authProvider = Provider.of(context, listen: false); + await authProvider.resetPassword( + token: widget.token, + newPassword: _passwordController.text, + ); + + if (mounted) { + setState(() { + _resetSuccess = true; + }); + } + } catch (e) { + if (mounted) { + _showSnackBar(e.toString()); + } + } finally { + if (mounted) { + setState(() { + _isLoading = false; + }); + } + } + } + + /// 显示提示信息 + void _showSnackBar(String message, {bool isSuccess = false}) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text(message), + backgroundColor: isSuccess ? AppColors.success : AppColors.error, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8.0), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/auth/screens/splash_screen.dart b/client/lib/features/auth/screens/splash_screen.dart new file mode 100644 index 0000000..19dd8e0 --- /dev/null +++ b/client/lib/features/auth/screens/splash_screen.dart @@ -0,0 +1,149 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; + +/// 启动页面 +class SplashScreen extends StatefulWidget { + const SplashScreen({super.key}); + + @override + State createState() => _SplashScreenState(); +} + +class _SplashScreenState extends State + with SingleTickerProviderStateMixin { + late AnimationController _animationController; + late Animation _fadeAnimation; + late Animation _scaleAnimation; + + @override + void initState() { + super.initState(); + _initAnimations(); + _navigateToNext(); + } + + void _initAnimations() { + _animationController = AnimationController( + duration: const Duration(milliseconds: 2000), + vsync: this, + ); + + _fadeAnimation = Tween( + begin: 0.0, + end: 1.0, + ).animate(CurvedAnimation( + parent: _animationController, + curve: const Interval(0.0, 0.6, curve: Curves.easeIn), + )); + + _scaleAnimation = Tween( + begin: 0.8, + end: 1.0, + ).animate(CurvedAnimation( + parent: _animationController, + curve: const Interval(0.2, 0.8, curve: Curves.elasticOut), + )); + + _animationController.forward(); + } + + Future _navigateToNext() async { + await Future.delayed(const Duration(seconds: 3)); + + if (mounted) { + // TODO: 检查用户登录状态，决定跳转到登录页还是主页 + Navigator.of(context).pushReplacementNamed('/login'); + } + } + + @override + void dispose() { + _animationController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.primary, + body: Center( + child: AnimatedBuilder( + animation: _animationController, + builder: (context, child) { + return FadeTransition( + opacity: _fadeAnimation, + child: ScaleTransition( + scale: _scaleAnimation, + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + // 应用图标 + Container( + width: AppDimensions.iconXxl * 2, + height: AppDimensions.iconXxl * 2, + decoration: BoxDecoration( + color: AppColors.onPrimary, + borderRadius: BorderRadius.circular( + AppDimensions.radiusXl, + ), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.3), + blurRadius: 20, + offset: const Offset(0, 10), + ), + ], + ), + child: Icon( + Icons.school, + size: AppDimensions.iconXxl, + color: AppColors.primary, + ), + ), + + SizedBox(height: AppDimensions.spacingXl), + + // 应用名称 + Text( + 'AI English Learning', + style: AppTextStyles.headlineLarge.copyWith( + color: AppColors.onPrimary, + fontWeight: FontWeight.bold, + ), + ), + + SizedBox(height: AppDimensions.spacingMd), + + // 副标题 + Text( + '智能英语学习助手', + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onPrimary.withOpacity(0.8), + ), + ), + + SizedBox(height: AppDimensions.spacingXxl), + + // 加载指示器 + SizedBox( + width: 40, + height: 40, + child: CircularProgressIndicator( + valueColor: AlwaysStoppedAnimation( + AppColors.onPrimary, + ), + strokeWidth: 3, + ), + ), + ], + ), + ), + ); + }, + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/comprehensive_test/data/test_static_data.dart b/client/lib/features/comprehensive_test/data/test_static_data.dart new file mode 100644 index 0000000..f55ad3d --- /dev/null +++ b/client/lib/features/comprehensive_test/data/test_static_data.dart @@ -0,0 +1,969 @@ +import '../models/test_models.dart'; + +/// 综合测试静态数据类 +class TestStaticData { + // 私有构造函数 + TestStaticData._(); + + /// 测试题目静态数据 + static final List _questions = [ + // 词汇题目 + TestQuestion( + id: 'vocab_001', + type: QuestionType.multipleChoice, + skillType: SkillType.vocabulary, + difficulty: DifficultyLevel.beginner, + content: 'What does "apple" mean?', + options: ['苹果', '香蕉', '橙子', '葡萄'], + correctAnswers: ['苹果'], + explanation: 'Apple means 苹果 in Chinese.', + points: 1, + timeLimit: 30, + ), + TestQuestion( + id: 'vocab_002', + type: QuestionType.multipleChoice, + skillType: SkillType.vocabulary, + difficulty: DifficultyLevel.elementary, + content: 'Choose the correct synonym for "happy":', + options: ['sad', 'joyful', 'angry', 'tired'], + correctAnswers: ['joyful'], + explanation: 'Joyful is a synonym for happy.', + points: 1, + timeLimit: 30, + ), + TestQuestion( + id: 'vocab_003', + type: QuestionType.multipleSelect, + skillType: SkillType.vocabulary, + difficulty: DifficultyLevel.intermediate, + content: 'Which of the following are adjectives?', + options: ['beautiful', 'quickly', 'run', 'intelligent', 'book'], + correctAnswers: ['beautiful', 'intelligent'], + explanation: 'Beautiful and intelligent are adjectives that describe nouns.', + points: 2, + timeLimit: 45, + ), + + // 语法题目 + TestQuestion( + id: 'grammar_001', + type: QuestionType.multipleChoice, + skillType: SkillType.grammar, + difficulty: DifficultyLevel.beginner, + content: 'Choose the correct form: "She ___ to school every day."', + options: ['go', 'goes', 'going', 'gone'], + correctAnswers: ['goes'], + explanation: 'Use "goes" for third person singular in present tense.', + points: 1, + timeLimit: 30, + ), + TestQuestion( + id: 'grammar_002', + type: QuestionType.fillInBlank, + skillType: SkillType.grammar, + difficulty: DifficultyLevel.elementary, + content: 'Fill in the blank: "I have ___ this book before."', + options: ['read', 'reading', 'reads', 'to read'], + correctAnswers: ['read'], + explanation: 'Use past participle "read" with present perfect tense.', + points: 1, + timeLimit: 45, + ), + TestQuestion( + id: 'grammar_003', + type: QuestionType.multipleChoice, + skillType: SkillType.grammar, + difficulty: DifficultyLevel.intermediate, + content: 'Which sentence is grammatically correct?', + options: [ + 'If I was you, I would study harder.', + 'If I were you, I would study harder.', + 'If I am you, I would study harder.', + 'If I will be you, I would study harder.' + ], + correctAnswers: ['If I were you, I would study harder.'], + explanation: 'Use subjunctive mood "were" in hypothetical conditions.', + points: 2, + timeLimit: 60, + ), + + // 阅读理解题目 + TestQuestion( + id: 'reading_001', + type: QuestionType.reading, + skillType: SkillType.reading, + difficulty: DifficultyLevel.elementary, + content: ''' +Read the passage and answer the question: + +"Tom is a student. He goes to school by bus every morning. His favorite subject is English. After school, he likes to play football with his friends." + +What is Tom's favorite subject? + ''', + options: ['Math', 'English', 'Science', 'History'], + correctAnswers: ['English'], + explanation: 'The passage clearly states that his favorite subject is English.', + points: 1, + timeLimit: 90, + ), + TestQuestion( + id: 'reading_002', + type: QuestionType.reading, + skillType: SkillType.reading, + difficulty: DifficultyLevel.intermediate, + content: ''' +Read the passage and answer the question: + +"Climate change is one of the most pressing issues of our time. Rising global temperatures are causing ice caps to melt, sea levels to rise, and weather patterns to become increasingly unpredictable. Scientists agree that immediate action is necessary to mitigate these effects." + +What is the main concern discussed in the passage? + ''', + options: [ + 'Economic development', + 'Climate change and its effects', + 'Scientific research methods', + 'Weather forecasting' + ], + correctAnswers: ['Climate change and its effects'], + explanation: 'The passage focuses on climate change as a pressing issue and its various effects.', + points: 2, + timeLimit: 120, + ), + + // 听力题目 + TestQuestion( + id: 'listening_001', + type: QuestionType.listening, + skillType: SkillType.listening, + difficulty: DifficultyLevel.beginner, + content: 'Listen to the audio and choose what you hear:', + options: ['Hello', 'Help', 'Hill', 'Hall'], + correctAnswers: ['Hello'], + audioUrl: 'assets/audio/hello.mp3', + explanation: 'The audio says "Hello".', + points: 1, + timeLimit: 30, + ), + TestQuestion( + id: 'listening_002', + type: QuestionType.listening, + skillType: SkillType.listening, + difficulty: DifficultyLevel.intermediate, + content: 'Listen to the conversation and answer: What time does the meeting start?', + options: ['9:00 AM', '10:00 AM', '11:00 AM', '2:00 PM'], + correctAnswers: ['10:00 AM'], + audioUrl: 'assets/audio/meeting_time.mp3', + explanation: 'The speaker mentions the meeting starts at 10:00 AM.', + points: 2, + timeLimit: 60, + ), + + // 口语题目 + TestQuestion( + id: 'speaking_001', + type: QuestionType.speaking, + skillType: SkillType.speaking, + difficulty: DifficultyLevel.beginner, + content: 'Introduce yourself in English. Include your name, age, and hobby.', + options: [], + correctAnswers: [], + explanation: 'A good introduction should include personal information clearly.', + points: 3, + timeLimit: 120, + ), + TestQuestion( + id: 'speaking_002', + type: QuestionType.speaking, + skillType: SkillType.speaking, + difficulty: DifficultyLevel.intermediate, + content: 'Describe your favorite place and explain why you like it.', + options: [], + correctAnswers: [], + explanation: 'Focus on descriptive language and clear reasoning.', + points: 4, + timeLimit: 180, + ), + + // 写作题目 + TestQuestion( + id: 'writing_001', + type: QuestionType.writing, + skillType: SkillType.writing, + difficulty: DifficultyLevel.elementary, + content: 'Write a short paragraph (50-80 words) about your daily routine.', + options: [], + correctAnswers: [], + explanation: 'Include time expressions and daily activities.', + points: 5, + timeLimit: 300, + ), + + // 更多词汇题目 + TestQuestion( + id: 'vocab_004', + type: QuestionType.multipleChoice, + skillType: SkillType.vocabulary, + difficulty: DifficultyLevel.intermediate, + content: 'What is the meaning of "procrastinate"?', + options: ['to delay or postpone', 'to work quickly', 'to organize', 'to celebrate'], + correctAnswers: ['to delay or postpone'], + explanation: 'Procrastinate means to delay or postpone action.', + points: 2, + timeLimit: 45, + ), + TestQuestion( + id: 'vocab_005', + type: QuestionType.fillInBlank, + skillType: SkillType.vocabulary, + difficulty: DifficultyLevel.upperIntermediate, + content: 'The company\'s success was _____ to their innovative approach.', + options: ['attributed', 'contributed', 'distributed', 'substituted'], + correctAnswers: ['attributed'], + explanation: 'Attributed means credited or ascribed to a particular cause.', + points: 3, + timeLimit: 60, + ), + TestQuestion( + id: 'vocab_006', + type: QuestionType.multipleSelect, + skillType: SkillType.vocabulary, + difficulty: DifficultyLevel.advanced, + content: 'Which words are synonyms for "meticulous"?', + options: ['careful', 'careless', 'thorough', 'precise', 'sloppy'], + correctAnswers: ['careful', 'thorough', 'precise'], + explanation: 'Meticulous means showing great attention to detail; very careful and precise.', + points: 4, + timeLimit: 90, + ), + + // 更多语法题目 + TestQuestion( + id: 'grammar_004', + type: QuestionType.multipleChoice, + skillType: SkillType.grammar, + difficulty: DifficultyLevel.intermediate, + content: 'Choose the correct passive voice: "The teacher explains the lesson."', + options: [ + 'The lesson is explained by the teacher.', + 'The lesson was explained by the teacher.', + 'The lesson will be explained by the teacher.', + 'The lesson has been explained by the teacher.' + ], + correctAnswers: ['The lesson is explained by the teacher.'], + explanation: 'Present simple active becomes present simple passive.', + points: 2, + timeLimit: 60, + ), + TestQuestion( + id: 'grammar_005', + type: QuestionType.fillInBlank, + skillType: SkillType.grammar, + difficulty: DifficultyLevel.upperIntermediate, + content: 'By the time you arrive, I _____ the report.', + options: ['will finish', 'will have finished', 'finish', 'finished'], + correctAnswers: ['will have finished'], + explanation: 'Use future perfect for actions completed before a future time.', + points: 3, + timeLimit: 75, + ), + TestQuestion( + id: 'grammar_006', + type: QuestionType.multipleChoice, + skillType: SkillType.grammar, + difficulty: DifficultyLevel.advanced, + content: 'Which sentence uses the subjunctive mood correctly?', + options: [ + 'I wish I was taller.', + 'I wish I were taller.', + 'I wish I am taller.', + 'I wish I will be taller.' + ], + correctAnswers: ['I wish I were taller.'], + explanation: 'Use "were" in subjunctive mood for hypothetical situations.', + points: 4, + timeLimit: 90, + ), + + // 更多阅读理解题目 + TestQuestion( + id: 'reading_003', + type: QuestionType.reading, + skillType: SkillType.reading, + difficulty: DifficultyLevel.upperIntermediate, + content: ''' +Read the passage and answer the question: + +"Artificial Intelligence has revolutionized numerous industries, from healthcare to finance. Machine learning algorithms can now diagnose diseases with remarkable accuracy, while automated trading systems execute millions of transactions per second. However, this technological advancement raises important ethical questions about job displacement and privacy concerns." + +What is the author's main point about AI? + ''', + options: [ + 'AI is only useful in healthcare', + 'AI has transformed industries but raises ethical concerns', + 'AI should be banned from trading', + 'AI is not accurate enough for medical use' + ], + correctAnswers: ['AI has transformed industries but raises ethical concerns'], + explanation: 'The passage discusses both AI\'s benefits and the ethical concerns it raises.', + points: 3, + timeLimit: 150, + ), + TestQuestion( + id: 'reading_004', + type: QuestionType.reading, + skillType: SkillType.reading, + difficulty: DifficultyLevel.advanced, + content: ''' +Read the passage and answer the question: + +"The concept of sustainable development emerged in the 1980s as a response to growing environmental concerns. It encompasses three pillars: economic growth, social equity, and environmental protection. Critics argue that these goals are inherently contradictory, as unlimited economic growth is incompatible with finite planetary resources." + +What criticism is mentioned regarding sustainable development? + ''', + options: [ + 'It focuses too much on the environment', + 'It ignores social equity', + 'Its three pillars are contradictory', + 'It was developed too recently' + ], + correctAnswers: ['Its three pillars are contradictory'], + explanation: 'Critics argue that unlimited economic growth contradicts environmental protection.', + points: 4, + timeLimit: 180, + ), + + // 更多听力题目 + TestQuestion( + id: 'listening_003', + type: QuestionType.listening, + skillType: SkillType.listening, + difficulty: DifficultyLevel.elementary, + content: 'Listen to the weather forecast and choose the correct information:', + options: ['Sunny, 25°C', 'Rainy, 18°C', 'Cloudy, 22°C', 'Snowy, 5°C'], + correctAnswers: ['Cloudy, 22°C'], + audioUrl: 'assets/audio/weather_forecast.mp3', + explanation: 'The forecast mentions cloudy weather with 22 degrees.', + points: 1, + timeLimit: 45, + ), + TestQuestion( + id: 'listening_004', + type: QuestionType.listening, + skillType: SkillType.listening, + difficulty: DifficultyLevel.upperIntermediate, + content: 'Listen to the academic lecture and identify the main topic:', + options: [ + 'Renewable energy sources', + 'Climate change effects', + 'Economic policy', + 'Educational reform' + ], + correctAnswers: ['Renewable energy sources'], + audioUrl: 'assets/audio/academic_lecture.mp3', + explanation: 'The lecture focuses on various renewable energy technologies.', + points: 3, + timeLimit: 120, + ), + + // 更多口语题目 + TestQuestion( + id: 'speaking_003', + type: QuestionType.speaking, + skillType: SkillType.speaking, + difficulty: DifficultyLevel.elementary, + content: 'Describe your hometown. Include information about its location, population, and main attractions.', + options: [], + correctAnswers: [], + explanation: 'Use descriptive adjectives and present tense. Organize your response logically.', + points: 3, + timeLimit: 150, + ), + TestQuestion( + id: 'speaking_004', + type: QuestionType.speaking, + skillType: SkillType.speaking, + difficulty: DifficultyLevel.upperIntermediate, + content: 'Express your opinion on remote work. Discuss both advantages and disadvantages.', + options: [], + correctAnswers: [], + explanation: 'Present balanced arguments and use appropriate linking words.', + points: 4, + timeLimit: 240, + ), + + // 更多写作题目 + TestQuestion( + id: 'writing_002', + type: QuestionType.writing, + skillType: SkillType.writing, + difficulty: DifficultyLevel.intermediate, + content: 'Write an email (100-150 words) to your friend describing a recent trip you took.', + options: [], + correctAnswers: [], + explanation: 'Use informal tone, past tense, and descriptive language.', + points: 6, + timeLimit: 450, + ), + TestQuestion( + id: 'writing_003', + type: QuestionType.writing, + skillType: SkillType.writing, + difficulty: DifficultyLevel.upperIntermediate, + content: 'Write an argumentative essay (200-250 words) about the benefits and drawbacks of social media.', + options: [], + correctAnswers: [], + explanation: 'Include introduction, body paragraphs with examples, and conclusion.', + points: 8, + timeLimit: 600, + ), + TestQuestion( + id: 'writing_002', + type: QuestionType.writing, + skillType: SkillType.writing, + difficulty: DifficultyLevel.intermediate, + content: 'Write an essay (150-200 words) about the advantages and disadvantages of social media.', + options: [], + correctAnswers: [], + explanation: 'Present balanced arguments with clear structure.', + points: 8, + timeLimit: 600, + ), + ]; + + /// 测试模板静态数据 + static final List _templates = [ + TestTemplate( + id: 'template_quick', + name: '快速测试', + description: '15分钟快速评估，包含基础词汇和语法题目', + type: TestType.quick, + duration: 15, + totalQuestions: 10, + skillDistribution: { + SkillType.vocabulary: 5, + SkillType.grammar: 3, + SkillType.reading: 2, + }, + difficultyDistribution: { + DifficultyLevel.beginner: 4, + DifficultyLevel.elementary: 4, + DifficultyLevel.intermediate: 2, + }, + questionIds: [ + 'vocab_001', 'vocab_002', 'grammar_001', 'grammar_002', + 'reading_001', 'vocab_003', 'grammar_003', 'reading_002', + 'listening_001', 'speaking_001' + ], + createdAt: DateTime.now().subtract(const Duration(days: 30)), + updatedAt: DateTime.now().subtract(const Duration(days: 1)), + ), + TestTemplate( + id: 'template_standard', + name: '标准测试', + description: '45分钟标准测试，全面评估英语水平', + type: TestType.standard, + duration: 45, + totalQuestions: 25, + skillDistribution: { + SkillType.vocabulary: 6, + SkillType.grammar: 6, + SkillType.reading: 5, + SkillType.listening: 4, + SkillType.speaking: 2, + SkillType.writing: 2, + }, + difficultyDistribution: { + DifficultyLevel.beginner: 5, + DifficultyLevel.elementary: 8, + DifficultyLevel.intermediate: 8, + DifficultyLevel.upperIntermediate: 3, + DifficultyLevel.advanced: 1, + }, + questionIds: [ + 'vocab_001', 'vocab_002', 'vocab_004', 'grammar_001', 'grammar_002', 'grammar_004', + 'reading_001', 'reading_003', 'listening_001', 'listening_003', + 'speaking_001', 'speaking_003', 'writing_001', 'writing_002', + 'vocab_003', 'vocab_005', 'grammar_003', 'grammar_005', + 'reading_002', 'reading_004', 'listening_002', 'listening_004', + 'speaking_002', 'speaking_004', 'writing_003' + ], + createdAt: DateTime.now().subtract(const Duration(days: 25)), + updatedAt: DateTime.now().subtract(const Duration(days: 2)), + ), + TestTemplate( + id: 'template_full', + name: '完整测试', + description: '90分钟完整测试，深度评估所有技能', + type: TestType.full, + duration: 90, + totalQuestions: 50, + skillDistribution: { + SkillType.vocabulary: 10, + SkillType.grammar: 10, + SkillType.reading: 10, + SkillType.listening: 8, + SkillType.speaking: 6, + SkillType.writing: 6, + }, + difficultyDistribution: { + DifficultyLevel.beginner: 8, + DifficultyLevel.elementary: 12, + DifficultyLevel.intermediate: 15, + DifficultyLevel.upperIntermediate: 10, + DifficultyLevel.advanced: 4, + DifficultyLevel.expert: 1, + }, + questionIds: List.generate(50, (index) => 'question_${index + 1}'), + createdAt: DateTime.now().subtract(const Duration(days: 20)), + updatedAt: DateTime.now().subtract(const Duration(days: 3)), + ), + TestTemplate( + id: 'template_mock', + name: '模拟考试', + description: '120分钟模拟真实考试环境', + type: TestType.mock, + duration: 120, + totalQuestions: 60, + skillDistribution: { + SkillType.vocabulary: 12, + SkillType.grammar: 12, + SkillType.reading: 12, + SkillType.listening: 10, + SkillType.speaking: 7, + SkillType.writing: 7, + }, + difficultyDistribution: { + DifficultyLevel.beginner: 5, + DifficultyLevel.elementary: 10, + DifficultyLevel.intermediate: 20, + DifficultyLevel.upperIntermediate: 15, + DifficultyLevel.advanced: 8, + DifficultyLevel.expert: 2, + }, + questionIds: [ + // 重复使用现有题目来达到60题的要求 + 'vocab_001', 'vocab_002', 'vocab_003', 'vocab_004', 'vocab_005', 'vocab_006', + 'grammar_001', 'grammar_002', 'grammar_003', 'grammar_004', 'grammar_005', 'grammar_006', + 'reading_001', 'reading_002', 'reading_003', 'reading_004', + 'listening_001', 'listening_002', 'listening_003', 'listening_004', + 'speaking_001', 'speaking_002', 'speaking_003', 'speaking_004', + 'writing_001', 'writing_002', 'writing_003', + // 重复一些题目 + 'vocab_001', 'vocab_002', 'vocab_003', 'vocab_004', 'vocab_005', 'vocab_006', + 'grammar_001', 'grammar_002', 'grammar_003', 'grammar_004', 'grammar_005', 'grammar_006', + 'reading_001', 'reading_002', 'reading_003', 'reading_004', + 'listening_001', 'listening_002', 'listening_003', 'listening_004', + 'speaking_001', 'speaking_002', 'speaking_003', 'speaking_004', + 'writing_001', 'writing_002', 'writing_003', + // 再次重复以达到60题 + 'vocab_001', 'vocab_002', 'vocab_003', 'vocab_004', 'vocab_005', 'vocab_006' + ], + createdAt: DateTime.now().subtract(const Duration(days: 15)), + updatedAt: DateTime.now().subtract(const Duration(days: 1)), + ), + // 添加专项测试模板 + TestTemplate( + id: 'template_vocabulary', + name: '词汇专项测试', + description: '30分钟专注词汇能力评估', + type: TestType.vocabulary, + duration: 30, + totalQuestions: 20, + skillDistribution: { + SkillType.vocabulary: 20, + }, + difficultyDistribution: { + DifficultyLevel.beginner: 5, + DifficultyLevel.elementary: 6, + DifficultyLevel.intermediate: 5, + DifficultyLevel.upperIntermediate: 3, + DifficultyLevel.advanced: 1, + }, + questionIds: [ + 'vocab_001', 'vocab_002', 'vocab_003', 'vocab_004', 'vocab_005', 'vocab_006', + 'vocab_001', 'vocab_002', 'vocab_003', 'vocab_004', 'vocab_005', 'vocab_006', + 'vocab_001', 'vocab_002', 'vocab_003', 'vocab_004', 'vocab_005', 'vocab_006', + 'vocab_001', 'vocab_002' + ], + createdAt: DateTime.now().subtract(const Duration(days: 10)), + updatedAt: DateTime.now().subtract(const Duration(hours: 12)), + ), + TestTemplate( + id: 'template_grammar', + name: '语法专项测试', + description: '30分钟专注语法能力评估', + type: TestType.grammar, + duration: 30, + totalQuestions: 20, + skillDistribution: { + SkillType.grammar: 20, + }, + difficultyDistribution: { + DifficultyLevel.beginner: 5, + DifficultyLevel.elementary: 6, + DifficultyLevel.intermediate: 5, + DifficultyLevel.upperIntermediate: 3, + DifficultyLevel.advanced: 1, + }, + questionIds: [ + 'grammar_001', 'grammar_002', 'grammar_003', 'grammar_004', 'grammar_005', 'grammar_006', + 'grammar_001', 'grammar_002', 'grammar_003', 'grammar_004', 'grammar_005', 'grammar_006', + 'grammar_001', 'grammar_002', 'grammar_003', 'grammar_004', 'grammar_005', 'grammar_006', + 'grammar_001', 'grammar_002' + ], + createdAt: DateTime.now().subtract(const Duration(days: 8)), + updatedAt: DateTime.now().subtract(const Duration(hours: 6)), + ), + TestTemplate( + id: 'template_reading', + name: '阅读理解专项测试', + description: '45分钟专注阅读理解能力评估', + type: TestType.reading, + duration: 45, + totalQuestions: 15, + skillDistribution: { + SkillType.reading: 15, + }, + difficultyDistribution: { + DifficultyLevel.elementary: 4, + DifficultyLevel.intermediate: 5, + DifficultyLevel.upperIntermediate: 4, + DifficultyLevel.advanced: 2, + }, + questionIds: [ + 'reading_001', 'reading_002', 'reading_003', 'reading_004', + 'reading_001', 'reading_002', 'reading_003', 'reading_004', + 'reading_001', 'reading_002', 'reading_003', 'reading_004', + 'reading_001', 'reading_002', 'reading_003' + ], + createdAt: DateTime.now().subtract(const Duration(days: 12)), + updatedAt: DateTime.now().subtract(const Duration(hours: 18)), + ), + ]; + + /// 测试结果静态数据 + static final List _results = [ + TestResult( + id: 'result_001', + testId: 'template_quick', + userId: 'user_001', + testType: TestType.quick, + totalScore: 8, + maxScore: 10, + percentage: 80.0, + overallLevel: DifficultyLevel.elementary, + skillScores: [ + SkillScore( + skillType: SkillType.vocabulary, + score: 4, + maxScore: 5, + percentage: 80.0, + level: DifficultyLevel.elementary, + feedback: '词汇掌握良好，建议继续扩充词汇量', + ), + SkillScore( + skillType: SkillType.grammar, + score: 2, + maxScore: 3, + percentage: 66.7, + level: DifficultyLevel.beginner, + feedback: '语法基础需要加强，多练习时态和句型', + ), + SkillScore( + skillType: SkillType.reading, + score: 2, + maxScore: 2, + percentage: 100.0, + level: DifficultyLevel.intermediate, + feedback: '阅读理解能力优秀', + ), + ], + answers: [], + startTime: DateTime.now().subtract(const Duration(days: 7, hours: 2)), + endTime: DateTime.now().subtract(const Duration(days: 7, hours: 1, minutes: 45)), + duration: 900, // 15分钟 + feedback: '总体表现良好，建议重点提升语法技能', + recommendations: { + 'nextLevel': 'elementary', + 'focusAreas': ['grammar', 'vocabulary'], + 'suggestedStudyTime': 30, + }, + ), + TestResult( + id: 'result_002', + testId: 'template_standard', + userId: 'user_001', + testType: TestType.standard, + totalScore: 18, + maxScore: 25, + percentage: 72.0, + overallLevel: DifficultyLevel.elementary, + skillScores: [ + SkillScore( + skillType: SkillType.vocabulary, + score: 5, + maxScore: 6, + percentage: 83.3, + level: DifficultyLevel.intermediate, + feedback: '词汇水平较好', + ), + SkillScore( + skillType: SkillType.grammar, + score: 4, + maxScore: 6, + percentage: 66.7, + level: DifficultyLevel.elementary, + feedback: '语法需要加强', + ), + SkillScore( + skillType: SkillType.reading, + score: 4, + maxScore: 5, + percentage: 80.0, + level: DifficultyLevel.elementary, + feedback: '阅读理解良好', + ), + SkillScore( + skillType: SkillType.listening, + score: 3, + maxScore: 4, + percentage: 75.0, + level: DifficultyLevel.elementary, + feedback: '听力理解不错', + ), + SkillScore( + skillType: SkillType.speaking, + score: 1, + maxScore: 2, + percentage: 50.0, + level: DifficultyLevel.beginner, + feedback: '口语表达需要大量练习', + ), + SkillScore( + skillType: SkillType.writing, + score: 1, + maxScore: 2, + percentage: 50.0, + level: DifficultyLevel.beginner, + feedback: '写作技能需要提升', + ), + ], + answers: [], + startTime: DateTime.now().subtract(const Duration(days: 3, hours: 1)), + endTime: DateTime.now().subtract(const Duration(days: 3, minutes: 15)), + duration: 2700, // 45分钟 + feedback: '整体水平为初级，建议加强语法、口语和写作练习', + recommendations: { + 'nextLevel': 'intermediate', + 'focusAreas': ['grammar', 'speaking', 'writing'], + 'suggestedStudyTime': 60, + }, + ), + TestResult( + id: 'result_003', + testId: 'template_quick', + userId: 'user_001', + testType: TestType.quick, + totalScore: 9, + maxScore: 10, + percentage: 90.0, + overallLevel: DifficultyLevel.intermediate, + skillScores: [ + SkillScore( + skillType: SkillType.vocabulary, + score: 5, + maxScore: 5, + percentage: 100.0, + level: DifficultyLevel.intermediate, + feedback: '词汇掌握优秀', + ), + SkillScore( + skillType: SkillType.grammar, + score: 3, + maxScore: 3, + percentage: 100.0, + level: DifficultyLevel.intermediate, + feedback: '语法掌握良好', + ), + SkillScore( + skillType: SkillType.reading, + score: 1, + maxScore: 2, + percentage: 50.0, + level: DifficultyLevel.elementary, + feedback: '阅读理解需要提升', + ), + ], + answers: [], + startTime: DateTime.now().subtract(const Duration(days: 1, hours: 2)), + endTime: DateTime.now().subtract(const Duration(days: 1, hours: 1, minutes: 45)), + duration: 900, // 15分钟 + feedback: '进步明显，继续保持', + recommendations: { + 'nextLevel': 'intermediate', + 'focusAreas': ['reading'], + 'suggestedStudyTime': 45, + }, + ), + ]; + + /// 获取所有测试模板 + static List getAllTemplates() { + return List.from(_templates); + } + + /// 根据类型获取测试模板 + static List getTemplatesByType(TestType type) { + return _templates.where((template) => template.type == type).toList(); + } + + /// 根据ID获取测试模板 + static TestTemplate? getTemplateById(String id) { + try { + return _templates.firstWhere((template) => template.id == id); + } catch (e) { + return null; + } + } + + /// 获取所有题目 + static List getAllQuestions() { + return List.from(_questions); + } + + /// 根据技能类型获取题目 + static List getQuestionsBySkill(SkillType skillType) { + return _questions.where((q) => q.skillType == skillType).toList(); + } + + /// 根据难度获取题目 + static List getQuestionsByDifficulty(DifficultyLevel difficulty) { + return _questions.where((q) => q.difficulty == difficulty).toList(); + } + + /// 根据ID列表获取题目 + static List getQuestionsByIds(List ids) { + return _questions.where((q) => ids.contains(q.id)).toList(); + } + + /// 根据ID获取单个题目 + static TestQuestion? getQuestionById(String id) { + try { + return _questions.firstWhere((q) => q.id == id); + } catch (e) { + return null; + } + } + + /// 获取用户测试结果 + static List getUserResults(String userId) { + return _results.where((result) => result.userId == userId).toList(); + } + + /// 获取最近的测试结果 + static List getRecentResults(String userId, {int limit = 5}) { + final userResults = getUserResults(userId); + userResults.sort((a, b) => b.endTime.compareTo(a.endTime)); + return userResults.take(limit).toList(); + } + + /// 根据ID获取测试结果 + static TestResult? getResultById(String id) { + try { + return _results.firstWhere((result) => result.id == id); + } catch (e) { + return null; + } + } + + /// 获取技能统计 + static Map getSkillStatistics(String userId) { + final userResults = getUserResults(userId); + if (userResults.isEmpty) return {}; + + final skillAverages = >{}; + + for (final result in userResults) { + for (final skillScore in result.skillScores) { + skillAverages.putIfAbsent(skillScore.skillType, () => []); + skillAverages[skillScore.skillType]!.add(skillScore.percentage); + } + } + + return skillAverages.map((skill, scores) { + final average = scores.reduce((a, b) => a + b) / scores.length; + return MapEntry(skill, average); + }); + } + + /// 获取难度分布统计 + static Map getDifficultyStatistics() { + final distribution = {}; + for (final question in _questions) { + distribution[question.difficulty] = + (distribution[question.difficulty] ?? 0) + 1; + } + return distribution; + } + + /// 获取技能分布统计 + static Map getSkillDistributionStatistics() { + final distribution = {}; + for (final question in _questions) { + distribution[question.skillType] = + (distribution[question.skillType] ?? 0) + 1; + } + return distribution; + } + + /// 创建新的测试会话 + static TestSession createTestSession({ + required String templateId, + required String userId, + }) { + final template = getTemplateById(templateId); + if (template == null) { + throw Exception('Template not found: $templateId'); + } + + final questions = getQuestionsByIds(template.questionIds); + + return TestSession( + id: 'session_${DateTime.now().millisecondsSinceEpoch}', + templateId: templateId, + userId: userId, + status: TestStatus.notStarted, + questions: questions, + answers: [], + currentQuestionIndex: 0, + startTime: DateTime.now(), + timeRemaining: template.duration * 60, // 转换为秒 + ); + } + + /// 添加测试结果 + static void addTestResult(TestResult result) { + _results.add(result); + } + + /// 更新测试结果 + static bool updateTestResult(String id, TestResult updatedResult) { + final index = _results.indexWhere((result) => result.id == id); + if (index != -1) { + _results[index] = updatedResult; + return true; + } + return false; + } + + /// 删除测试结果 + static bool deleteTestResult(String id) { + final index = _results.indexWhere((result) => result.id == id); + if (index != -1) { + _results.removeAt(index); + return true; + } + return false; + } +} \ No newline at end of file diff --git a/client/lib/features/comprehensive_test/models/test_models.dart b/client/lib/features/comprehensive_test/models/test_models.dart new file mode 100644 index 0000000..0e2b0f5 --- /dev/null +++ b/client/lib/features/comprehensive_test/models/test_models.dart @@ -0,0 +1,559 @@ +/// 测试类型枚举 +enum TestType { + quick, // 快速测试 + standard, // 标准测试 + full, // 完整测试 + mock, // 模拟考试 + vocabulary, // 词汇专项 + grammar, // 语法专项 + reading, // 阅读专项 + listening, // 听力专项 + speaking, // 口语专项 + writing, // 写作专项 +} + +/// 测试状态枚举 +enum TestStatus { + notStarted, // 未开始 + inProgress, // 进行中 + paused, // 暂停 + completed, // 已完成 + expired, // 已过期 +} + +/// 题目类型枚举 +enum QuestionType { + multipleChoice, // 单选题 + multipleSelect, // 多选题 + fillInBlank, // 填空题 + reading, // 阅读理解 + listening, // 听力理解 + speaking, // 口语题 + writing, // 写作题 +} + +/// 难度等级枚举 +enum DifficultyLevel { + beginner, // 初级 + elementary, // 基础 + intermediate, // 中级 + upperIntermediate, // 中高级 + advanced, // 高级 + expert, // 专家级 +} + +/// 技能类型枚举 +enum SkillType { + vocabulary, // 词汇 + grammar, // 语法 + reading, // 阅读 + listening, // 听力 + speaking, // 口语 + writing, // 写作 +} + +/// 测试题目模型 +class TestQuestion { + final String id; + final QuestionType type; + final SkillType skillType; + final DifficultyLevel difficulty; + final String content; + final List options; + final List correctAnswers; + final String? audioUrl; + final String? imageUrl; + final String? explanation; + final int points; + final int timeLimit; // 秒 + final Map? metadata; + + const TestQuestion({ + required this.id, + required this.type, + required this.skillType, + required this.difficulty, + required this.content, + this.options = const [], + this.correctAnswers = const [], + this.audioUrl, + this.imageUrl, + this.explanation, + this.points = 1, + this.timeLimit = 60, + this.metadata, + }); + + factory TestQuestion.fromJson(Map json) { + return TestQuestion( + id: json['id'] as String, + type: QuestionType.values.firstWhere( + (e) => e.name == json['type'], + orElse: () => QuestionType.multipleChoice, + ), + skillType: SkillType.values.firstWhere( + (e) => e.name == json['skillType'], + orElse: () => SkillType.vocabulary, + ), + difficulty: DifficultyLevel.values.firstWhere( + (e) => e.name == json['difficulty'], + orElse: () => DifficultyLevel.intermediate, + ), + content: json['content'] as String, + options: List.from(json['options'] ?? []), + correctAnswers: List.from(json['correctAnswers'] ?? []), + audioUrl: json['audioUrl'] as String?, + imageUrl: json['imageUrl'] as String?, + explanation: json['explanation'] as String?, + points: json['points'] as int? ?? 1, + timeLimit: json['timeLimit'] as int? ?? 60, + metadata: json['metadata'] as Map?, + ); + } + + Map toJson() { + return { + 'id': id, + 'type': type.name, + 'skillType': skillType.name, + 'difficulty': difficulty.name, + 'content': content, + 'options': options, + 'correctAnswers': correctAnswers, + 'audioUrl': audioUrl, + 'imageUrl': imageUrl, + 'explanation': explanation, + 'points': points, + 'timeLimit': timeLimit, + 'metadata': metadata, + }; + } +} + +/// 语言技能枚举 (用于UI显示) +enum LanguageSkill { + listening, // 听力 + reading, // 阅读 + speaking, // 口语 + writing, // 写作 + vocabulary, // 词汇 + grammar, // 语法 + pronunciation, // 发音 + comprehension, // 理解 +} + +/// 用户技能统计模型 +class UserSkillStatistics { + final SkillType skillType; + final double averageScore; + final int totalTests; + final int correctAnswers; + final int totalQuestions; + final DifficultyLevel strongestLevel; + final DifficultyLevel weakestLevel; + final DateTime lastTestDate; + + const UserSkillStatistics({ + required this.skillType, + required this.averageScore, + required this.totalTests, + required this.correctAnswers, + required this.totalQuestions, + required this.strongestLevel, + required this.weakestLevel, + required this.lastTestDate, + }); + + factory UserSkillStatistics.fromJson(Map json) { + return UserSkillStatistics( + skillType: SkillType.values.firstWhere( + (e) => e.toString().split('.').last == json['skillType'], + ), + averageScore: (json['averageScore'] as num).toDouble(), + totalTests: json['totalTests'] as int, + correctAnswers: json['correctAnswers'] as int, + totalQuestions: json['totalQuestions'] as int, + strongestLevel: DifficultyLevel.values.firstWhere( + (e) => e.toString().split('.').last == json['strongestLevel'], + ), + weakestLevel: DifficultyLevel.values.firstWhere( + (e) => e.toString().split('.').last == json['weakestLevel'], + ), + lastTestDate: DateTime.parse(json['lastTestDate']), + ); + } + + Map toJson() { + return { + 'skillType': skillType.toString().split('.').last, + 'averageScore': averageScore, + 'totalTests': totalTests, + 'correctAnswers': correctAnswers, + 'totalQuestions': totalQuestions, + 'strongestLevel': strongestLevel.toString().split('.').last, + 'weakestLevel': weakestLevel.toString().split('.').last, + 'lastTestDate': lastTestDate.toIso8601String(), + }; + } + + double get accuracy => totalQuestions > 0 ? correctAnswers / totalQuestions : 0.0; +} + +/// 用户答案模型 +class UserAnswer { + final String questionId; + final List selectedAnswers; + final String? textAnswer; + final String? audioUrl; + final DateTime answeredAt; + final int timeSpent; // 秒 + + const UserAnswer({ + required this.questionId, + this.selectedAnswers = const [], + this.textAnswer, + this.audioUrl, + required this.answeredAt, + required this.timeSpent, + }); + + factory UserAnswer.fromJson(Map json) { + return UserAnswer( + questionId: json['questionId'] as String, + selectedAnswers: List.from(json['selectedAnswers'] ?? []), + textAnswer: json['textAnswer'] as String?, + audioUrl: json['audioUrl'] as String?, + answeredAt: DateTime.parse(json['answeredAt'] as String), + timeSpent: json['timeSpent'] as int, + ); + } + + Map toJson() { + return { + 'questionId': questionId, + 'selectedAnswers': selectedAnswers, + 'textAnswer': textAnswer, + 'audioUrl': audioUrl, + 'answeredAt': answeredAt.toIso8601String(), + 'timeSpent': timeSpent, + }; + } +} + +/// 技能得分模型 +class SkillScore { + final SkillType skillType; + final int score; + final int maxScore; + final double percentage; + final DifficultyLevel level; + final String feedback; + + const SkillScore({ + required this.skillType, + required this.score, + required this.maxScore, + required this.percentage, + required this.level, + required this.feedback, + }); + + factory SkillScore.fromJson(Map json) { + return SkillScore( + skillType: SkillType.values.firstWhere( + (e) => e.name == json['skillType'], + orElse: () => SkillType.vocabulary, + ), + score: json['score'] as int, + maxScore: json['maxScore'] as int, + percentage: (json['percentage'] as num).toDouble(), + level: DifficultyLevel.values.firstWhere( + (e) => e.name == json['level'], + orElse: () => DifficultyLevel.intermediate, + ), + feedback: json['feedback'] as String, + ); + } + + Map toJson() { + return { + 'skillType': skillType.name, + 'score': score, + 'maxScore': maxScore, + 'percentage': percentage, + 'level': level.name, + 'feedback': feedback, + }; + } +} + +/// 测试结果模型 +class TestResult { + final String id; + final String testId; + final String userId; + final TestType testType; + final int totalScore; + final int maxScore; + final double percentage; + final DifficultyLevel overallLevel; + final List skillScores; + final List answers; + final DateTime startTime; + final DateTime endTime; + final int duration; // 秒 + final String feedback; + final Map? recommendations; + + const TestResult({ + required this.id, + required this.testId, + required this.userId, + required this.testType, + required this.totalScore, + required this.maxScore, + required this.percentage, + required this.overallLevel, + required this.skillScores, + required this.answers, + required this.startTime, + required this.endTime, + required this.duration, + required this.feedback, + this.recommendations, + }); + + factory TestResult.fromJson(Map json) { + return TestResult( + id: json['id'] as String, + testId: json['testId'] as String, + userId: json['userId'] as String, + testType: TestType.values.firstWhere( + (e) => e.name == json['testType'], + orElse: () => TestType.standard, + ), + totalScore: json['totalScore'] as int, + maxScore: json['maxScore'] as int, + percentage: (json['percentage'] as num).toDouble(), + overallLevel: DifficultyLevel.values.firstWhere( + (e) => e.name == json['overallLevel'], + orElse: () => DifficultyLevel.intermediate, + ), + skillScores: (json['skillScores'] as List) + .map((e) => SkillScore.fromJson(e as Map)) + .toList(), + answers: (json['answers'] as List) + .map((e) => UserAnswer.fromJson(e as Map)) + .toList(), + startTime: DateTime.parse(json['startTime'] as String), + endTime: DateTime.parse(json['endTime'] as String), + duration: json['duration'] as int, + feedback: json['feedback'] as String, + recommendations: json['recommendations'] as Map?, + ); + } + + Map toJson() { + return { + 'id': id, + 'testId': testId, + 'userId': userId, + 'testType': testType.name, + 'totalScore': totalScore, + 'maxScore': maxScore, + 'percentage': percentage, + 'overallLevel': overallLevel.name, + 'skillScores': skillScores.map((e) => e.toJson()).toList(), + 'answers': answers.map((e) => e.toJson()).toList(), + 'startTime': startTime.toIso8601String(), + 'endTime': endTime.toIso8601String(), + 'duration': duration, + 'feedback': feedback, + 'recommendations': recommendations, + }; + } +} + +/// 测试模板模型 +class TestTemplate { + final String id; + final String name; + final String description; + final TestType type; + final int duration; // 分钟 + final int totalQuestions; + final Map skillDistribution; + final Map difficultyDistribution; + final List questionIds; + final bool isActive; + final DateTime createdAt; + final DateTime updatedAt; + + const TestTemplate({ + required this.id, + required this.name, + required this.description, + required this.type, + required this.duration, + required this.totalQuestions, + required this.skillDistribution, + required this.difficultyDistribution, + required this.questionIds, + this.isActive = true, + required this.createdAt, + required this.updatedAt, + }); + + factory TestTemplate.fromJson(Map json) { + return TestTemplate( + id: json['id'] as String, + name: json['name'] as String, + description: json['description'] as String, + type: TestType.values.firstWhere( + (e) => e.name == json['type'], + orElse: () => TestType.standard, + ), + duration: json['duration'] as int, + totalQuestions: json['totalQuestions'] as int, + skillDistribution: Map.fromEntries( + (json['skillDistribution'] as Map).entries.map( + (e) => MapEntry( + SkillType.values.firstWhere((skill) => skill.name == e.key), + e.value as int, + ), + ), + ), + difficultyDistribution: Map.fromEntries( + (json['difficultyDistribution'] as Map).entries.map( + (e) => MapEntry( + DifficultyLevel.values.firstWhere((level) => level.name == e.key), + e.value as int, + ), + ), + ), + questionIds: List.from(json['questionIds']), + isActive: json['isActive'] as bool? ?? true, + createdAt: DateTime.parse(json['createdAt'] as String), + updatedAt: DateTime.parse(json['updatedAt'] as String), + ); + } + + Map toJson() { + return { + 'id': id, + 'name': name, + 'description': description, + 'type': type.name, + 'duration': duration, + 'totalQuestions': totalQuestions, + 'skillDistribution': skillDistribution.map( + (key, value) => MapEntry(key.name, value), + ), + 'difficultyDistribution': difficultyDistribution.map( + (key, value) => MapEntry(key.name, value), + ), + 'questionIds': questionIds, + 'isActive': isActive, + 'createdAt': createdAt.toIso8601String(), + 'updatedAt': updatedAt.toIso8601String(), + }; + } +} + +/// 测试会话模型 +class TestSession { + final String id; + final String templateId; + final String userId; + final TestStatus status; + final List questions; + final List answers; + final int currentQuestionIndex; + final DateTime startTime; + final DateTime? endTime; + final int timeRemaining; // 秒 + final Map? metadata; + + const TestSession({ + required this.id, + required this.templateId, + required this.userId, + required this.status, + required this.questions, + this.answers = const [], + this.currentQuestionIndex = 0, + required this.startTime, + this.endTime, + required this.timeRemaining, + this.metadata, + }); + + factory TestSession.fromJson(Map json) { + return TestSession( + id: json['id'] as String, + templateId: json['templateId'] as String, + userId: json['userId'] as String, + status: TestStatus.values.firstWhere( + (e) => e.name == json['status'], + orElse: () => TestStatus.notStarted, + ), + questions: (json['questions'] as List) + .map((e) => TestQuestion.fromJson(e as Map)) + .toList(), + answers: (json['answers'] as List?) + ?.map((e) => UserAnswer.fromJson(e as Map)) + .toList() ?? [], + currentQuestionIndex: json['currentQuestionIndex'] as int? ?? 0, + startTime: DateTime.parse(json['startTime'] as String), + endTime: json['endTime'] != null + ? DateTime.parse(json['endTime'] as String) + : null, + timeRemaining: json['timeRemaining'] as int, + metadata: json['metadata'] as Map?, + ); + } + + Map toJson() { + return { + 'id': id, + 'templateId': templateId, + 'userId': userId, + 'status': status.name, + 'questions': questions.map((e) => e.toJson()).toList(), + 'answers': answers.map((e) => e.toJson()).toList(), + 'currentQuestionIndex': currentQuestionIndex, + 'startTime': startTime.toIso8601String(), + 'endTime': endTime?.toIso8601String(), + 'timeRemaining': timeRemaining, + 'metadata': metadata, + }; + } + + TestSession copyWith({ + String? id, + String? templateId, + String? userId, + TestStatus? status, + List? questions, + List? answers, + int? currentQuestionIndex, + DateTime? startTime, + DateTime? endTime, + int? timeRemaining, + Map? metadata, + }) { + return TestSession( + id: id ?? this.id, + templateId: templateId ?? this.templateId, + userId: userId ?? this.userId, + status: status ?? this.status, + questions: questions ?? this.questions, + answers: answers ?? this.answers, + currentQuestionIndex: currentQuestionIndex ?? this.currentQuestionIndex, + startTime: startTime ?? this.startTime, + endTime: endTime ?? this.endTime, + timeRemaining: timeRemaining ?? this.timeRemaining, + metadata: metadata ?? this.metadata, + ); + } +} \ No newline at end of file diff --git a/client/lib/features/comprehensive_test/providers/test_provider.dart b/client/lib/features/comprehensive_test/providers/test_provider.dart new file mode 100644 index 0000000..f4545e8 --- /dev/null +++ b/client/lib/features/comprehensive_test/providers/test_provider.dart @@ -0,0 +1,591 @@ +import 'package:flutter/foundation.dart'; +import '../models/test_models.dart'; +import '../services/test_api_service.dart'; +import '../../../core/models/api_response.dart'; + +/// 综合测试状态管理类 +class TestProvider with ChangeNotifier { + final TestApiService _testService; + + TestProvider({TestApiService? testService}) + : _testService = testService ?? TestApiService(); + + // 加载状�? bool _isLoading = false; + bool get isLoading => _isLoading; + + // 错误信息 + String? _errorMessage; + String? get errorMessage => _errorMessage; + + // 测试模板 + List _templates = []; + List get templates => _templates; + + // 当前测试会话 + TestSession? _currentSession; + TestSession? get currentSession => _currentSession; + + // 当前题目 + TestQuestion? get currentQuestion { + if (_currentSession == null || + _currentSession!.currentQuestionIndex >= _currentSession!.questions.length) { + return null; + } + return _currentSession!.questions[_currentSession!.currentQuestionIndex]; + } + + // 测试结果 + List _testResults = []; + List get testResults => _testResults; + + TestResult? _currentResult; + TestResult? get currentResult => _currentResult; + + // 用户技能统�? Map _skillStatistics = {}; + Map get skillStatistics => _skillStatistics; + + // 题目统计 + Map _questionStatistics = {}; + Map get questionStatistics => _questionStatistics; + + // 计时器相�? int _timeRemaining = 0; + int get timeRemaining => _timeRemaining; + + bool _isTimerRunning = false; + bool get isTimerRunning => _isTimerRunning; + + /// 设置加载状�? void _setLoading(bool loading) { + _isLoading = loading; + notifyListeners(); + } + + /// 设置错误信息 + void _setError(String? error) { + _errorMessage = error; + notifyListeners(); + } + + /// 清除错误信息 + void clearError() { + _setError(null); + } + + /// 加载所有测试模�? Future loadTestTemplates() async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getTestTemplates(); + if (response.success && response.data != null) { + _templates = response.data!; + } else { + _setError(response.message); + } + } catch (e) { + _setError('加载测试模板失败: ${e.toString()}'); + } finally { + _setLoading(false); + } + } + + /// 根据类型加载测试模板 + Future loadTestTemplatesByType(TestType type) async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getTestTemplatesByType(type); + if (response.success && response.data != null) { + _templates = response.data!; + } else { + _setError(response.message); + } + } catch (e) { + _setError('加载测试模板失败: ${e.toString()}'); + } finally { + _setLoading(false); + } + } + + /// 创建测试会话 + Future createTestSession({ + required String templateId, + required String userId, + }) async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.createTestSession( + templateId: templateId, + userId: userId, + ); + + if (response.success && response.data != null) { + _currentSession = response.data!; + _timeRemaining = _currentSession!.timeRemaining; + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('创建测试会话失败: ${e.toString()}'); + return false; + } finally { + _setLoading(false); + } + } + + /// 开始测�? Future startTest() async { + if (_currentSession == null) { + _setError('没有活动的测试会�?); + return false; + } + + _setLoading(true); + _setError(null); + + try { + final response = await _testService.startTest(_currentSession!.id); + + if (response.success && response.data != null) { + _currentSession = response.data!; + _timeRemaining = _currentSession!.timeRemaining; + _startTimer(); + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('开始测试失�? ${e.toString()}'); + return false; + } finally { + _setLoading(false); + } + } + + /// 提交答案 + Future submitAnswer(UserAnswer answer) async { + if (_currentSession == null) { + _setError('没有活动的测试会�?); + return false; + } + + _setLoading(true); + _setError(null); + + try { + final response = await _testService.submitAnswer( + sessionId: _currentSession!.id, + answer: answer, + ); + + if (response.success && response.data != null) { + _currentSession = response.data!; + _timeRemaining = _currentSession!.timeRemaining; + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('提交答案失败: ${e.toString()}'); + return false; + } finally { + _setLoading(false); + } + } + + /// 下一�? void nextQuestion() { + if (_currentSession != null && + _currentSession!.currentQuestionIndex < _currentSession!.questions.length - 1) { + _currentSession = _currentSession!.copyWith( + currentQuestionIndex: _currentSession!.currentQuestionIndex + 1, + ); + notifyListeners(); + } + } + + /// 上一�? void previousQuestion() { + if (_currentSession != null && _currentSession!.currentQuestionIndex > 0) { + _currentSession = _currentSession!.copyWith( + currentQuestionIndex: _currentSession!.currentQuestionIndex - 1, + ); + notifyListeners(); + } + } + + /// 跳转到指定题�? void goToQuestion(int index) { + if (_currentSession != null && + index >= 0 && + index < _currentSession!.questions.length) { + _currentSession = _currentSession!.copyWith( + currentQuestionIndex: index, + ); + notifyListeners(); + } + } + + /// 暂停测试 + Future pauseTest() async { + if (_currentSession == null) { + _setError('没有活动的测试会�?); + return false; + } + + try { + final response = await _testService.pauseTest(_currentSession!.id); + + if (response.success && response.data != null) { + _currentSession = response.data!; + _pauseTimer(); + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('暂停测试失败: ${e.toString()}'); + return false; + } + } + + /// 恢复测试 + Future resumeTest() async { + if (_currentSession == null) { + _setError('没有活动的测试会�?); + return false; + } + + try { + final response = await _testService.resumeTest(_currentSession!.id); + + if (response.success && response.data != null) { + _currentSession = response.data!; + _startTimer(); + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('恢复测试失败: ${e.toString()}'); + return false; + } + } + + /// 完成测试 + Future completeTest() async { + if (_currentSession == null) { + _setError('没有活动的测试会话'); + return false; + } + + _setLoading(true); + _setError(null); + + try { + final response = await _testService.completeTest(_currentSession!.id); + + if (response.success && response.data != null) { + _currentResult = response.data!; + _stopTimer(); + _currentSession = _currentSession!.copyWith( + status: TestStatus.completed, + endTime: DateTime.now(), + ); + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('完成测试失败: ${e.toString()}'); + return false; + } finally { + _setLoading(false); + } + } + + /// 加载用户测试历史 + Future loadUserTestHistory(String userId, {int page = 1, int limit = 10}) async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getUserTestHistory( + page: page, + limit: limit, + ); + + if (response.success && response.data != null) { + if (page == 1) { + _testResults = response.data!; + } else { + _testResults.addAll(response.data!); + } + } else { + _setError(response.message); + } + } catch (e) { + _setError('加载测试历史失败: ${e.toString()}'); + } finally { + _setLoading(false); + } + } + + /// 加载最近的测试结果 + Future loadRecentTestResults(String userId, {int limit = 5}) async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getRecentTestResults( + userId, + limit: limit, + ); + + if (response.success && response.data != null) { + _testResults = response.data!; + } else { + _setError(response.message); + } + } catch (e) { + _setError('加载最近测试结果失�? ${e.toString()}'); + } finally { + _setLoading(false); + } + } + + /// 加载测试结果详情 + Future loadTestResultById(String resultId) async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getTestResultById(resultId); + + if (response.success && response.data != null) { + _currentResult = response.data!; + } else { + _setError(response.message); + } + } catch (e) { + _setError('加载测试结果失败: ${e.toString()}'); + } finally { + _setLoading(false); + } + } + + /// 加载用户技能统�? Future loadUserSkillStatistics(String userId) async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getUserSkillStatistics(userId); + + if (response.success && response.data != null) { + _skillStatistics = response.data!; + } else { + _setError(response.message); + } + } catch (e) { + _setError('加载技能统计失�? ${e.toString()}'); + } finally { + _setLoading(false); + } + } + + /// 加载题目统计 + Future loadQuestionStatistics() async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getQuestionStatistics(); + + if (response.success && response.data != null) { + _questionStatistics = response.data!; + } else { + _setError(response.message); + } + } catch (e) { + _setError('加载题目统计失败: ${e.toString()}'); + } finally { + _setLoading(false); + } + } + + /// 删除测试结果 + Future deleteTestResult(String resultId) async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.deleteTestResult(resultId); + + if (response.success) { + _testResults.removeWhere((result) => result.id == resultId); + notifyListeners(); + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('删除测试结果失败: ${e.toString()}'); + return false; + } finally { + _setLoading(false); + } + } + + /// 重置当前会话 + void resetCurrentSession() { + _currentSession = null; + _currentResult = null; + _stopTimer(); + notifyListeners(); + } + + /// 开始计时器 + void _startTimer() { + _isTimerRunning = true; + _updateTimer(); + } + + /// 暂停计时�? void _pauseTimer() { + _isTimerRunning = false; + } + + /// 停止计时�? void _stopTimer() { + _isTimerRunning = false; + _timeRemaining = 0; + } + + /// 更新计时�? void _updateTimer() { + if (_isTimerRunning && _timeRemaining > 0) { + Future.delayed(const Duration(seconds: 1), () { + if (_isTimerRunning) { + _timeRemaining--; + notifyListeners(); + + if (_timeRemaining <= 0) { + // 时间到，自动完成测试 + completeTest(); + } else { + _updateTimer(); + } + } + }); + } + } + + /// 格式化剩余时�? String getFormattedTimeRemaining() { + final hours = _timeRemaining ~/ 3600; + final minutes = (_timeRemaining % 3600) ~/ 60; + final seconds = _timeRemaining % 60; + + if (hours > 0) { + return '${hours.toString().padLeft(2, '0')}:${minutes.toString().padLeft(2, '0')}:${seconds.toString().padLeft(2, '0')}'; + } else { + return '${minutes.toString().padLeft(2, '0')}:${seconds.toString().padLeft(2, '0')}'; + } + } + + /// 获取测试进度百分�? double getTestProgress() { + if (_currentSession == null || _currentSession!.questions.isEmpty) { + return 0.0; + } + return (_currentSession!.currentQuestionIndex + 1) / _currentSession!.questions.length; + } + + /// 获取已回答题目数�? int getAnsweredQuestionsCount() { + return _currentSession?.answers.length ?? 0; + } + + /// 获取未回答题目数�? int getUnansweredQuestionsCount() { + if (_currentSession == null) return 0; + return _currentSession!.questions.length - _currentSession!.answers.length; + } + + /// 检查是否所有题目都已回�? bool areAllQuestionsAnswered() { + if (_currentSession == null) return false; + return _currentSession!.answers.length == _currentSession!.questions.length; + } + + /// 获取技能类型的中文名称 + String getSkillTypeName(SkillType skillType) { + switch (skillType) { + case SkillType.vocabulary: + return '词汇'; + case SkillType.grammar: + return '语法'; + case SkillType.reading: + return '阅读'; + case SkillType.listening: + return '听力'; + case SkillType.speaking: + return '口语'; + case SkillType.writing: + return '写作'; + } + } + + /// 获取难度等级的中文名�? String getDifficultyLevelName(DifficultyLevel level) { + switch (level) { + case DifficultyLevel.beginner: + return '初级'; + case DifficultyLevel.elementary: + return '基础'; + case DifficultyLevel.intermediate: + return '中级'; + case DifficultyLevel.upperIntermediate: + return '中高�?; + case DifficultyLevel.advanced: + return '高级'; + case DifficultyLevel.expert: + return '专家�?; + } + } + + /// 获取测试类型的中文名�? String getTestTypeName(TestType type) { + switch (type) { + case TestType.quick: + return '快速测�?; + case TestType.standard: + return '标准测试'; + case TestType.full: + return '完整测试'; + case TestType.mock: + return '模拟考试'; + } + } + + /// 加载最近的测试结果 + Future loadRecentResults({String? userId}) async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getRecentTestResults(userId); + if (response.success && response.data != null) { + _testResults = response.data!; + } else { + _setError(response.message); + } + } catch (e) { + _setError('加载测试结果失败: ${e.toString()}'); + } finally { + _setLoading(false); + } + } + + @override + void dispose() { + _stopTimer(); + super.dispose(); + } +} \ No newline at end of file diff --git a/client/lib/features/comprehensive_test/providers/test_riverpod_provider.dart b/client/lib/features/comprehensive_test/providers/test_riverpod_provider.dart new file mode 100644 index 0000000..8f86ace --- /dev/null +++ b/client/lib/features/comprehensive_test/providers/test_riverpod_provider.dart @@ -0,0 +1,459 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/test_models.dart'; +import '../services/test_service.dart'; +import '../services/test_service_impl.dart'; +import '../../../core/models/api_response.dart'; + +/// 测试服务提供者 +final testServiceProvider = Provider((ref) { + return TestServiceImpl(); +}); + +/// 测试状态类 +class TestState { + final bool isLoading; + final String? errorMessage; + final List templates; + final TestSession? currentSession; + final List testResults; + final TestResult? currentResult; + final Map skillStatistics; + final Map questionStatistics; + final int timeRemaining; + final bool isTimerRunning; + + const TestState({ + this.isLoading = false, + this.errorMessage, + this.templates = const [], + this.currentSession, + this.testResults = const [], + this.currentResult, + this.skillStatistics = const {}, + this.questionStatistics = const {}, + this.timeRemaining = 0, + this.isTimerRunning = false, + }); + + TestState copyWith({ + bool? isLoading, + String? errorMessage, + List? templates, + TestSession? currentSession, + List? testResults, + TestResult? currentResult, + Map? skillStatistics, + Map? questionStatistics, + int? timeRemaining, + bool? isTimerRunning, + }) { + return TestState( + isLoading: isLoading ?? this.isLoading, + errorMessage: errorMessage ?? this.errorMessage, + templates: templates ?? this.templates, + currentSession: currentSession ?? this.currentSession, + testResults: testResults ?? this.testResults, + currentResult: currentResult ?? this.currentResult, + skillStatistics: skillStatistics ?? this.skillStatistics, + questionStatistics: questionStatistics ?? this.questionStatistics, + timeRemaining: timeRemaining ?? this.timeRemaining, + isTimerRunning: isTimerRunning ?? this.isTimerRunning, + ); + } + + /// 获取当前题目 + TestQuestion? get currentQuestion { + if (currentSession == null || + currentSession!.currentQuestionIndex >= currentSession!.questions.length) { + return null; + } + return currentSession!.questions[currentSession!.currentQuestionIndex]; + } +} + +/// 测试状态管理器 +class TestNotifier extends StateNotifier { + final TestService _testService; + + TestNotifier(this._testService) : super(const TestState()); + + /// 设置加载状态 + void _setLoading(bool loading) { + state = state.copyWith(isLoading: loading); + } + + /// 设置错误信息 + void _setError(String? error) { + state = state.copyWith(errorMessage: error); + } + + /// 清除错误信息 + void clearError() { + _setError(null); + } + + /// 加载所有测试模板 + Future loadTestTemplates() async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getTestTemplates(); + if (response.success && response.data != null) { + state = state.copyWith(templates: response.data!, isLoading: false); + } else { + _setError(response.message); + _setLoading(false); + } + } catch (e) { + _setError('加载测试模板失败: ${e.toString()}'); + _setLoading(false); + } + } + + /// 加载指定类型的测试模板 + Future loadTestTemplatesByType(TestType type) async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getTestTemplatesByType(type); + if (response.success && response.data != null) { + state = state.copyWith(templates: response.data!, isLoading: false); + } else { + _setError(response.message); + _setLoading(false); + } + } catch (e) { + _setError('加载测试模板失败: ${e.toString()}'); + _setLoading(false); + } + } + + /// 加载最近的测试结果 + Future loadRecentResults({String? userId}) async { + if (userId == null) { + _setError('用户ID不能为空'); + return; + } + + _setLoading(true); + _setError(null); + + try { + final response = await _testService.getRecentTestResults(userId); + if (response.success && response.data != null) { + state = state.copyWith(testResults: response.data!, isLoading: false); + } else { + _setError(response.message); + _setLoading(false); + } + } catch (e) { + _setError('加载测试结果失败: ${e.toString()}'); + _setLoading(false); + } + } + + /// 创建测试会话 + Future createTestSession({ + required String templateId, + required String userId, + }) async { + _setLoading(true); + _setError(null); + + try { + final response = await _testService.createTestSession( + templateId: templateId, + userId: userId, + ); + + if (response.success && response.data != null) { + state = state.copyWith( + currentSession: response.data!, + timeRemaining: response.data!.timeRemaining, + isLoading: false, + ); + return true; + } else { + _setError(response.message); + _setLoading(false); + return false; + } + } catch (e) { + _setError('创建测试会话失败: ${e.toString()}'); + _setLoading(false); + return false; + } + } + + /// 开始测试 + Future startTest() async { + if (state.currentSession == null) { + _setError('没有活动的测试会话'); + return false; + } + + _setLoading(true); + _setError(null); + + try { + final response = await _testService.startTest(state.currentSession!.id); + + if (response.success && response.data != null) { + state = state.copyWith( + currentSession: response.data!, + isTimerRunning: true, + isLoading: false, + ); + return true; + } else { + _setError(response.message); + _setLoading(false); + return false; + } + } catch (e) { + _setError('开始测试失败: ${e.toString()}'); + _setLoading(false); + return false; + } + } + + /// 设置当前测试会话 + void setCurrentSession(TestSession session) { + state = state.copyWith( + currentSession: session, + timeRemaining: session.timeRemaining, + isTimerRunning: true, + ); + } + + /// 设置当前测试结果 + void setCurrentResult(TestResult result) { + state = state.copyWith( + currentResult: result, + isLoading: false, + ); + } + + /// 记录答案（本地记录，不提交到服务器） + void recordAnswer(UserAnswer answer) { + if (state.currentSession == null) { + _setError('没有活动的测试会话'); + return; + } + + final currentSession = state.currentSession!; + final updatedAnswers = List.from(currentSession.answers); + + // 移除该题目的旧答案 + updatedAnswers.removeWhere((a) => a.questionId == answer.questionId); + // 添加新答案 + updatedAnswers.add(answer); + + final updatedSession = currentSession.copyWith(answers: updatedAnswers); + state = state.copyWith(currentSession: updatedSession); + } + + /// 提交答案 + Future submitAnswer(UserAnswer answer) async { + if (state.currentSession == null) { + _setError('没有活动的测试会话'); + return false; + } + + try { + final response = await _testService.submitAnswer( + sessionId: state.currentSession!.id, + answer: answer, + ); + + if (response.success && response.data != null) { + state = state.copyWith(currentSession: response.data!); + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('提交答案失败: ${e.toString()}'); + return false; + } + } + + /// 完成测试 + Future completeTest() async { + if (state.currentSession == null) { + _setError('没有活动的测试会话'); + return null; + } + + _setLoading(true); + _setError(null); + + try { + final response = await _testService.completeTest( + sessionId: state.currentSession!.id, + answers: state.currentSession!.answers, + ); + + if (response.success && response.data != null) { + state = state.copyWith( + currentResult: response.data!, + currentSession: null, + isTimerRunning: false, + isLoading: false, + ); + return response.data!; + } else { + _setError(response.message); + _setLoading(false); + return null; + } + } catch (e) { + _setError('完成测试失败: ${e.toString()}'); + _setLoading(false); + return null; + } + } + + /// 下一题 + void nextQuestion() { + if (state.currentSession == null) { + _setError('没有活动的测试会话'); + return; + } + + final currentSession = state.currentSession!; + if (currentSession.currentQuestionIndex < currentSession.questions.length - 1) { + final updatedSession = TestSession( + id: currentSession.id, + userId: currentSession.userId, + templateId: currentSession.templateId, + questions: currentSession.questions, + answers: currentSession.answers, + startTime: currentSession.startTime, + endTime: currentSession.endTime, + status: currentSession.status, + timeRemaining: currentSession.timeRemaining, + currentQuestionIndex: currentSession.currentQuestionIndex + 1, + ); + + state = state.copyWith(currentSession: updatedSession); + } + } + + /// 上一题 + void previousQuestion() { + if (state.currentSession == null) { + _setError('没有活动的测试会话'); + return; + } + + final currentSession = state.currentSession!; + if (currentSession.currentQuestionIndex > 0) { + final updatedSession = TestSession( + id: currentSession.id, + userId: currentSession.userId, + templateId: currentSession.templateId, + questions: currentSession.questions, + answers: currentSession.answers, + startTime: currentSession.startTime, + endTime: currentSession.endTime, + status: currentSession.status, + timeRemaining: currentSession.timeRemaining, + currentQuestionIndex: currentSession.currentQuestionIndex - 1, + ); + + state = state.copyWith(currentSession: updatedSession); + } + } + + /// 获取测试类型的中文名称 + String getTestTypeName(TestType type) { + switch (type) { + case TestType.quick: + return '快速测试'; + case TestType.standard: + return '标准测试'; + case TestType.full: + return '完整测试'; + case TestType.mock: + return '模拟考试'; + case TestType.vocabulary: + return '词汇专项'; + case TestType.grammar: + return '语法专项'; + case TestType.reading: + return '阅读专项'; + case TestType.listening: + return '听力专项'; + case TestType.speaking: + return '口语专项'; + case TestType.writing: + return '写作专项'; + } + } + + /// 获取技能类型的中文名称 + String getSkillTypeName(SkillType skill) { + switch (skill) { + case SkillType.vocabulary: + return '词汇'; + case SkillType.grammar: + return '语法'; + case SkillType.reading: + return '阅读'; + case SkillType.listening: + return '听力'; + case SkillType.speaking: + return '口语'; + case SkillType.writing: + return '写作'; + } + } + + /// 获取难度等级的中文名称 + String getDifficultyLevelName(DifficultyLevel level) { + switch (level) { + case DifficultyLevel.beginner: + return '初级'; + case DifficultyLevel.elementary: + return '基础'; + case DifficultyLevel.intermediate: + return '中级'; + case DifficultyLevel.upperIntermediate: + return '中高级'; + case DifficultyLevel.advanced: + return '高级'; + case DifficultyLevel.expert: + return '专家级'; + } + } +} + +/// 测试状态提供者 +final testProvider = StateNotifierProvider((ref) { + final testService = ref.watch(testServiceProvider); + return TestNotifier(testService); +}); + +/// 当前测试会话提供者 +final currentTestSessionProvider = Provider((ref) { + return ref.watch(testProvider).currentSession; +}); + +/// 当前题目提供者 +final currentQuestionProvider = Provider((ref) { + return ref.watch(testProvider).currentQuestion; +}); + +/// 测试模板提供者 +final testTemplatesProvider = Provider>((ref) { + return ref.watch(testProvider).templates; +}); + +/// 测试结果提供者 +final testResultsProvider = Provider>((ref) { + return ref.watch(testProvider).testResults; +}); \ No newline at end of file diff --git a/client/lib/features/comprehensive_test/screens/comprehensive_test_screen.dart b/client/lib/features/comprehensive_test/screens/comprehensive_test_screen.dart new file mode 100644 index 0000000..3501443 --- /dev/null +++ b/client/lib/features/comprehensive_test/screens/comprehensive_test_screen.dart @@ -0,0 +1,726 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/test_models.dart'; +import '../providers/test_riverpod_provider.dart'; +import '../screens/test_execution_screen.dart'; +import '../../auth/providers/auth_provider.dart' as auth; + +/// 综合测试页面 +class ComprehensiveTestScreen extends ConsumerStatefulWidget { + const ComprehensiveTestScreen({super.key}); + + @override + ConsumerState createState() => _ComprehensiveTestScreenState(); +} + +class _ComprehensiveTestScreenState extends ConsumerState { + @override + void initState() { + super.initState(); + // 加载测试模板和最近结果 + WidgetsBinding.instance.addPostFrameCallback((_) { + ref.read(testProvider.notifier).loadTestTemplates(); + _loadRecentResults(); + }); + } + + void _loadRecentResults() async { + // 尝试获取认证状态，但不强制要求登录 + try { + final authState = ref.read(auth.authProvider); + final userId = authState.user?.id; + if (userId != null) { + ref.read(testProvider.notifier).loadRecentResults(userId: userId); + } else { + // 用户未登录时，显示模拟数据或空状态 + print('用户未登录，显示静态内容'); + } + } catch (e) { + // 认证服务出错时，继续显示静态内容 + print('认证服务错误: $e'); + } + } + + @override + Widget build(BuildContext context) { + final testState = ref.watch(testProvider); + + return Scaffold( + backgroundColor: Colors.grey[50], + appBar: AppBar( + title: const Text( + '综合测试', + style: TextStyle( + fontWeight: FontWeight.bold, + color: Colors.white, + ), + ), + backgroundColor: const Color(0xFF2196F3), + elevation: 0, + centerTitle: true, + ), + body: _buildBody(testState), + ); + } + + Widget _buildBody(TestState testState) { + // 如果正在加载，显示加载指示器 + if (testState.isLoading) { + return const Center(child: CircularProgressIndicator()); + } + + // 如果有错误，显示错误信息 + if (testState.errorMessage != null) { + return _buildErrorView(testState.errorMessage!); + } + + // 显示正常内容（静态展示，不强制登录） + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildWelcomeSection(), + const SizedBox(height: 24), + _buildTestTypes(testState), + const SizedBox(height: 32), + _buildRecentResults(testState), + ], + ), + ); + } + + Widget _buildErrorView(String errorMessage) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 64, + color: Colors.red[300], + ), + const SizedBox(height: 16), + Text( + errorMessage, + style: TextStyle( + fontSize: 16, + color: Colors.red[600], + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 16), + ElevatedButton( + onPressed: () { + ref.read(testProvider.notifier).loadTestTemplates(); + _loadRecentResults(); + }, + child: const Text('重试'), + ), + ], + ), + ); + } + + Widget _buildWelcomeSection() { + return Container( + width: double.infinity, + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + gradient: LinearGradient( + begin: Alignment.topLeft, + end: Alignment.bottomRight, + colors: [ + Colors.teal.withOpacity(0.1), + Colors.teal.withOpacity(0.05), + ], + ), + borderRadius: BorderRadius.circular(16), + border: Border.all(color: Colors.teal.withOpacity(0.2)), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.teal.withOpacity(0.2), + shape: BoxShape.circle, + ), + child: const Icon( + Icons.quiz, + color: Colors.teal, + size: 24, + ), + ), + const SizedBox(width: 16), + const Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '全面能力评估', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + SizedBox(height: 4), + Text( + '测试您的英语综合能力水平', + style: TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + ], + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildTestTypes(TestState testState) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '测试类型', + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + const SizedBox(height: 16), + if (testState.templates.isEmpty) + const Center( + child: Text( + '暂无可用的测试模板', + style: TextStyle( + fontSize: 16, + color: Colors.grey, + ), + ), + ) + else + GridView.builder( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount( + crossAxisCount: 2, + crossAxisSpacing: 16, + mainAxisSpacing: 16, + childAspectRatio: 1.2, + ), + itemCount: testState.templates.length, + itemBuilder: (context, index) { + final template = testState.templates[index]; + return _buildTestCard( + template: template, + onTap: () => _startTest(template), + ); + }, + ), + ], + ); + } + + Widget _buildTestCard({ + required TestTemplate template, + required VoidCallback onTap, + }) { + final color = _getColorForTestType(template.type); + final icon = _getIconForTestType(template.type); + + return Card( + elevation: 4, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(16), + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(16), + gradient: LinearGradient( + begin: Alignment.topLeft, + end: Alignment.bottomRight, + colors: [ + color.withOpacity(0.1), + color.withOpacity(0.05), + ], + ), + ), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: color.withOpacity(0.2), + shape: BoxShape.circle, + ), + child: Icon( + icon, + size: 24, + color: color, + ), + ), + const SizedBox(height: 12), + Text( + template.name, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + textAlign: TextAlign.center, + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 4), + Text( + '${template.duration}分钟', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + textAlign: TextAlign.center, + ), + if (template.totalQuestions > 0) + Text( + '${template.totalQuestions}题', + style: TextStyle( + fontSize: 10, + color: Colors.grey[500], + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ), + ); + } + + Widget _buildRecentResults(TestState testState) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '最近测试结果', + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + const SizedBox(height: 16), + if (testState.testResults.isEmpty) + Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: const Padding( + padding: EdgeInsets.all(32), + child: Center( + child: Column( + children: [ + Icon( + Icons.quiz_outlined, + size: 48, + color: Colors.grey, + ), + SizedBox(height: 16), + Text( + '暂无测试记录', + style: TextStyle( + fontSize: 16, + color: Colors.grey, + ), + ), + SizedBox(height: 8), + Text( + '完成第一次测试后，结果将显示在这里', + style: TextStyle( + fontSize: 14, + color: Colors.grey, + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ), + ) + else + Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + children: testState.testResults + .asMap() + .entries + .map((entry) { + final index = entry.key; + final result = entry.value; + return Column( + children: [ + if (index > 0) const Divider(), + _buildResultItem(result: result), + ], + ); + }).toList(), + ), + ), + ), + ], + ); + } + + Widget _buildResultItem({ + required TestResult result, + }) { + final template = ref.read(testProvider) + .templates + .firstWhere( + (t) => t.id == result.testId, + orElse: () => TestTemplate( + id: result.testId, + name: '未知测试', + description: '', + type: TestType.standard, + duration: 0, + totalQuestions: 0, + skillDistribution: {}, + difficultyDistribution: {}, + questionIds: [], + isActive: true, + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ), + ); + + return InkWell( + onTap: () => _showResultDetails(result), + borderRadius: BorderRadius.circular(8), + child: Padding( + padding: const EdgeInsets.symmetric(vertical: 8), + child: Row( + children: [ + Container( + padding: const EdgeInsets.all(8), + decoration: BoxDecoration( + color: Colors.teal.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: const Icon( + Icons.quiz, + color: Colors.teal, + size: 20, + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + template.name, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + color: Colors.black87, + ), + ), + Text( + _formatDate(result.endTime), + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ), + Column( + crossAxisAlignment: CrossAxisAlignment.end, + children: [ + Text( + '${result.totalScore.toStringAsFixed(0)}分', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: _getScoreColor(result.totalScore.toDouble()), + ), + ), + Text( + _getScoreLevel(result.totalScore.toDouble()), + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + const SizedBox(width: 8), + Icon( + Icons.chevron_right, + color: Colors.grey[400], + size: 20, + ), + ], + ), + ), + ); + } + + void _startTest(TestTemplate template) { + // 显示测试开始确认对话框 + showDialog( + context: context, + builder: (BuildContext context) { + return AlertDialog( + title: const Text('开始测试'), + content: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text('确定要开始「${template.name}」吗？'), + const SizedBox(height: 16), + if (template.description.isNotEmpty) ...[ + Text( + template.description, + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 12), + ], + Row( + children: [ + Icon(Icons.timer, size: 16, color: Colors.grey[600]), + const SizedBox(width: 4), + Text( + '${template.duration}分钟', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const SizedBox(width: 16), + Icon(Icons.quiz, size: 16, color: Colors.grey[600]), + const SizedBox(width: 4), + Text( + '${template.totalQuestions}题', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ), + ], + ), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(), + child: const Text('取消'), + ), + ElevatedButton( + onPressed: () { + Navigator.of(context).pop(); + _navigateToTest(template); + }, + style: ElevatedButton.styleFrom( + backgroundColor: Colors.teal, + foregroundColor: Colors.white, + ), + child: const Text('开始'), + ), + ], + ); + }, + ); + } + + void _navigateToTest(TestTemplate template) { + // 导航到测试执行页面 + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => TestExecutionScreen(template: template), + ), + ); + } + + void _showResultDetails(TestResult result) { + // 显示测试结果详情 + showDialog( + context: context, + builder: (BuildContext context) { + return AlertDialog( + title: const Text('测试结果详情'), + content: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text('总分：${result.totalScore.toStringAsFixed(1)}'), + const SizedBox(height: 8), + Text('完成时间：${_formatDate(result.endTime)}'), + const SizedBox(height: 8), + Text('用时：${result.duration}秒'), + if (result.skillScores.isNotEmpty) ...[ + const SizedBox(height: 16), + const Text( + '各项技能得分：', + style: TextStyle(fontWeight: FontWeight.bold), + ), + const SizedBox(height: 8), + ...result.skillScores.map( + (skillScore) => Padding( + padding: const EdgeInsets.symmetric(vertical: 2), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text(_getSkillTypeName(skillScore.skillType)), + Text('${skillScore.score}/${skillScore.maxScore}分'), + ], + ), + ), + ), + ], + ], + ), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(), + child: const Text('关闭'), + ), + ], + ); + }, + ); + } + + Color _getColorForTestType(TestType type) { + switch (type) { + case TestType.quick: + return Colors.blue; + case TestType.standard: + return Colors.green; + case TestType.full: + return Colors.orange; + case TestType.mock: + return Colors.purple; + case TestType.vocabulary: + return Colors.teal; + case TestType.grammar: + return Colors.indigo; + case TestType.reading: + return Colors.brown; + case TestType.listening: + return Colors.cyan; + case TestType.speaking: + return Colors.pink; + case TestType.writing: + return Colors.amber; + } + } + + IconData _getIconForTestType(TestType type) { + switch (type) { + case TestType.quick: + return Icons.flash_on; + case TestType.standard: + return Icons.school; + case TestType.full: + return Icons.quiz; + case TestType.mock: + return Icons.assignment; + case TestType.vocabulary: + return Icons.book; + case TestType.grammar: + return Icons.text_fields; + case TestType.reading: + return Icons.menu_book; + case TestType.listening: + return Icons.headphones; + case TestType.speaking: + return Icons.mic; + case TestType.writing: + return Icons.edit; + } + } + + String _formatDate(DateTime date) { + return '${date.year}-${date.month.toString().padLeft(2, '0')}-${date.day.toString().padLeft(2, '0')}'; + } + + Color _getScoreColor(double score) { + if (score >= 90) return Colors.green; + if (score >= 80) return Colors.blue; + if (score >= 70) return Colors.orange; + return Colors.red; + } + + String _getScoreLevel(double score) { + if (score >= 90) return '优秀'; + if (score >= 80) return '良好'; + if (score >= 70) return '中等'; + if (score >= 60) return '及格'; + return '不及格'; + } + + String _getSkillName(LanguageSkill skill) { + switch (skill) { + case LanguageSkill.listening: + return '听力'; + case LanguageSkill.reading: + return '阅读'; + case LanguageSkill.speaking: + return '口语'; + case LanguageSkill.writing: + return '写作'; + case LanguageSkill.vocabulary: + return '词汇'; + case LanguageSkill.grammar: + return '语法'; + case LanguageSkill.pronunciation: + return '发音'; + case LanguageSkill.comprehension: + return '理解'; + } + } + + String _getSkillTypeName(SkillType skillType) { + switch (skillType) { + case SkillType.vocabulary: + return '词汇'; + case SkillType.grammar: + return '语法'; + case SkillType.listening: + return '听力'; + case SkillType.reading: + return '阅读'; + case SkillType.speaking: + return '口语'; + case SkillType.writing: + return '写作'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/comprehensive_test/screens/test_execution_screen.dart b/client/lib/features/comprehensive_test/screens/test_execution_screen.dart new file mode 100644 index 0000000..a5d3e63 --- /dev/null +++ b/client/lib/features/comprehensive_test/screens/test_execution_screen.dart @@ -0,0 +1,698 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import 'dart:async'; +import '../models/test_models.dart'; +import '../providers/test_riverpod_provider.dart'; +import '../data/test_static_data.dart'; +import '../widgets/question_widgets.dart'; +import 'test_result_screen.dart'; + +/// 测试执行页面 +class TestExecutionScreen extends ConsumerStatefulWidget { + final TestTemplate template; + + const TestExecutionScreen({ + super.key, + required this.template, + }); + + @override + ConsumerState createState() => _TestExecutionScreenState(); +} + +class _TestExecutionScreenState extends ConsumerState { + Timer? _timer; + int _timeRemaining = 0; + bool _isTestStarted = false; + bool _isTestCompleted = false; + Map _userAnswers = {}; + + @override + void initState() { + super.initState(); + _timeRemaining = widget.template.duration * 60; // 转换为秒 + WidgetsBinding.instance.addPostFrameCallback((_) { + _startTest(); + }); + } + + @override + void dispose() { + _timer?.cancel(); + super.dispose(); + } + + void _startTest() async { + setState(() { + _isTestStarted = true; + }); + + // 创建测试会话（使用静态数据） + final questions = TestStaticData.getAllQuestions().take(10).toList(); // 取前10题作为测试 + final session = TestSession( + id: 'test_session_${DateTime.now().millisecondsSinceEpoch}', + templateId: widget.template.id, + userId: 'current_user', + status: TestStatus.inProgress, + questions: questions, + answers: [], + currentQuestionIndex: 0, + startTime: DateTime.now(), + timeRemaining: _timeRemaining, + metadata: {}, + ); + + // 更新provider状态 + ref.read(testProvider.notifier).setCurrentSession(session); + + // 启动计时器 + _startTimer(); + } + + void _startTimer() { + _timer = Timer.periodic(const Duration(seconds: 1), (timer) { + setState(() { + if (_timeRemaining > 0) { + _timeRemaining--; + } else { + _submitTest(); + } + }); + }); + } + + void _submitTest() async { + if (_isTestCompleted) return; + + _timer?.cancel(); + setState(() { + _isTestCompleted = true; + }); + + // 获取当前会话和答案 + final currentSession = ref.read(testProvider).currentSession; + if (currentSession == null) return; + + // 创建测试结果 + final testResult = _createTestResult(currentSession); + + // 更新provider状态 + ref.read(testProvider.notifier).setCurrentResult(testResult); + + // 导航到结果页面 + if (mounted) { + Navigator.of(context).pushReplacement( + MaterialPageRoute( + builder: (context) => TestResultScreen( + testResult: testResult, + ), + ), + ); + } + } + + TestResult _createTestResult(TestSession session) { + final answers = session.answers; + int totalScore = 0; + int maxScore = 0; + Map> skillScores = {}; + + // 计算得分 + for (final question in session.questions) { + maxScore += question.points; + final userAnswer = answers.where((a) => a.questionId == question.id).firstOrNull; + + if (userAnswer != null) { + // 简单的评分逻辑 + bool isCorrect = false; + if (question.type == QuestionType.multipleChoice) { + isCorrect = userAnswer.selectedAnswers.isNotEmpty && + question.correctAnswers.contains(userAnswer.selectedAnswers.first); + } else if (question.type == QuestionType.fillInBlank) { + isCorrect = userAnswer.textAnswer?.toLowerCase().trim() != null && + question.correctAnswers.any((correct) => + correct.toLowerCase().trim() == userAnswer.textAnswer!.toLowerCase().trim()); + } + + if (isCorrect) { + totalScore += question.points; + } + + // 记录技能得分 + final skill = question.skillType; + if (!skillScores.containsKey(skill)) { + skillScores[skill] = []; + } + skillScores[skill]!.add(isCorrect ? question.points : 0); + } + } + + // 计算技能得分 + final skillScoresList = skillScores.entries.map((entry) { + final skill = entry.key; + final scores = entry.value; + final skillTotal = scores.reduce((a, b) => a + b); + final skillMax = scores.length * 10; // 假设每题10分 + final percentage = skillMax > 0 ? (skillTotal / skillMax * 100) : 0.0; + + return SkillScore( + skillType: skill, + score: skillTotal, + maxScore: skillMax, + percentage: percentage, + level: _getSkillLevel(percentage), + feedback: _getSkillFeedback(skill, percentage), + ); + }).toList(); + + final overallPercentage = maxScore > 0 ? (totalScore / maxScore * 100) : 0.0; + + return TestResult( + id: 'result_${DateTime.now().millisecondsSinceEpoch}', + testId: session.id, + userId: session.userId, + testType: TestType.standard, + totalScore: totalScore, + maxScore: maxScore, + percentage: overallPercentage, + overallLevel: _getSkillLevel(overallPercentage), + skillScores: skillScoresList, + answers: answers, + startTime: session.startTime!, + endTime: DateTime.now(), + duration: DateTime.now().difference(session.startTime!).inSeconds, + feedback: _getOverallFeedback(totalScore, maxScore), + recommendations: _getRecommendations(skillScoresList), + ); + } + + LanguageSkill _convertSkillType(SkillType skillType) { + switch (skillType) { + case SkillType.vocabulary: + return LanguageSkill.vocabulary; + case SkillType.grammar: + return LanguageSkill.grammar; + case SkillType.reading: + return LanguageSkill.reading; + case SkillType.listening: + return LanguageSkill.listening; + case SkillType.speaking: + return LanguageSkill.speaking; + case SkillType.writing: + return LanguageSkill.writing; + } + } + + DifficultyLevel _getSkillLevel(double percentage) { + if (percentage >= 90) return DifficultyLevel.expert; + if (percentage >= 80) return DifficultyLevel.advanced; + if (percentage >= 70) return DifficultyLevel.upperIntermediate; + if (percentage >= 60) return DifficultyLevel.intermediate; + if (percentage >= 50) return DifficultyLevel.elementary; + return DifficultyLevel.beginner; + } + + String _getSkillTypeName(SkillType skillType) { + switch (skillType) { + case SkillType.vocabulary: + return '词汇'; + case SkillType.grammar: + return '语法'; + case SkillType.reading: + return '阅读'; + case SkillType.listening: + return '听力'; + case SkillType.speaking: + return '口语'; + case SkillType.writing: + return '写作'; + } + } + + String _getSkillFeedback(SkillType skillType, double percentage) { + final skillName = _getSkillTypeName(skillType); + if (percentage >= 80) { + return '$skillName 掌握得很好，继续保持！'; + } else if (percentage >= 60) { + return '$skillName 基础不错，还有提升空间。'; + } else { + return '$skillName 需要加强练习。'; + } + } + + String _getSkillName(SkillType skillType) { + switch (skillType) { + case SkillType.vocabulary: + return '词汇'; + case SkillType.grammar: + return '语法'; + case SkillType.reading: + return '阅读'; + case SkillType.listening: + return '听力'; + case SkillType.speaking: + return '口语'; + case SkillType.writing: + return '写作'; + } + } + + String _getOverallFeedback(int totalScore, int maxScore) { + final percentage = (totalScore / maxScore * 100).round(); + if (percentage >= 90) { + return '恭喜！您的表现非常出色，各项技能都达到了很高的水平。'; + } else if (percentage >= 80) { + return '您的表现很好！大部分技能都掌握得不错，但还有一些提升空间。'; + } else if (percentage >= 70) { + return '您的基础还不错，但需要在某些技能上加强练习。'; + } else if (percentage >= 60) { + return '您已经掌握了一些基础知识，但还需要更多的练习和学习。'; + } else { + return '建议您从基础开始系统性地学习，多做练习。'; + } + } + + Map _getRecommendations(List skillScores) { + final weakSkills = skillScores + .where((skill) => skill.percentage < 70) + .map((skill) => _getSkillTypeName(skill.skillType)) + .toList(); + + List recommendations = []; + + if (weakSkills.isNotEmpty) { + recommendations.add('重点加强${weakSkills.join('、')}方面的练习'); + } + + recommendations.addAll([ + '每天坚持30分钟的英语学习', + '多做相关类型的练习题', + '建议参加更多的模拟测试', + ]); + + return { + 'general': recommendations, + 'weakSkills': weakSkills, + }; + } + + void _onAnswerChanged(String questionId, UserAnswer answer) { + setState(() { + _userAnswers[questionId] = answer; + }); + } + + void _nextQuestion() { + ref.read(testProvider.notifier).nextQuestion(); + } + + void _previousQuestion() { + ref.read(testProvider.notifier).previousQuestion(); + } + + String _formatTime(int seconds) { + final minutes = seconds ~/ 60; + final remainingSeconds = seconds % 60; + return '${minutes.toString().padLeft(2, '0')}:${remainingSeconds.toString().padLeft(2, '0')}'; + } + + @override + Widget build(BuildContext context) { + final testState = ref.watch(testProvider); + final currentQuestion = testState.currentQuestion; + final currentSession = testState.currentSession; + + if (!_isTestStarted || currentSession == null) { + return _buildLoadingScreen(); + } + + if (currentQuestion == null) { + return _buildCompletionScreen(); + } + + return Scaffold( + backgroundColor: Colors.grey[50], + appBar: AppBar( + title: Text(widget.template.name), + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + elevation: 0, + actions: [ + Container( + padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8), + margin: const EdgeInsets.only(right: 16), + decoration: BoxDecoration( + color: _timeRemaining < 300 ? Colors.red : Colors.white.withOpacity(0.2), + borderRadius: BorderRadius.circular(20), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + Icons.timer, + size: 16, + color: _timeRemaining < 300 ? Colors.white : Colors.white, + ), + const SizedBox(width: 4), + Text( + _formatTime(_timeRemaining), + style: TextStyle( + fontWeight: FontWeight.bold, + color: _timeRemaining < 300 ? Colors.white : Colors.white, + ), + ), + ], + ), + ), + ], + ), + body: Column( + children: [ + _buildProgressBar(currentSession), + Expanded( + child: SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildQuestionHeader(currentQuestion, currentSession), + const SizedBox(height: 24), + _buildQuestionContent(), + ], + ), + ), + ), + _buildNavigationBar(currentSession), + ], + ), + ); + } + + Widget _buildLoadingScreen() { + return Scaffold( + backgroundColor: Colors.grey[50], + body: const Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + CircularProgressIndicator(), + SizedBox(height: 16), + Text( + '正在准备测试...', + style: TextStyle(fontSize: 16), + ), + ], + ), + ), + ); + } + + Widget _buildCompletionScreen() { + return Scaffold( + backgroundColor: Colors.grey[50], + body: Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + const Icon( + Icons.check_circle, + size: 64, + color: Colors.green, + ), + const SizedBox(height: 16), + const Text( + '测试已完成！', + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + const Text( + '正在计算结果...', + style: TextStyle(fontSize: 16), + ), + const SizedBox(height: 24), + ElevatedButton( + onPressed: _submitTest, + style: ElevatedButton.styleFrom( + backgroundColor: Colors.green, + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(horizontal: 32, vertical: 12), + ), + child: const Text('查看结果'), + ), + ], + ), + ), + ); + } + + Widget _buildProgressBar(TestSession session) { + final progress = (session.currentQuestionIndex + 1) / session.questions.length; + + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '题目 ${session.currentQuestionIndex + 1} / ${session.questions.length}', + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + Text( + '${(progress * 100).toInt()}% 完成', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ), + const SizedBox(height: 8), + LinearProgressIndicator( + value: progress, + backgroundColor: Colors.grey[200], + valueColor: const AlwaysStoppedAnimation(Color(0xFF2196F3)), + ), + ], + ), + ); + } + + Widget _buildQuestionHeader(TestQuestion question, TestSession session) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: _getSkillColor(question.skillType).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + _getSkillName(question.skillType), + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.w600, + color: _getSkillColor(question.skillType), + ), + ), + ), + const SizedBox(width: 8), + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: _getDifficultyColor(question.difficulty).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + _getDifficultyName(question.difficulty), + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.w600, + color: _getDifficultyColor(question.difficulty), + ), + ), + ), + const Spacer(), + Row( + children: [ + Icon( + Icons.star, + size: 16, + color: Colors.amber[600], + ), + const SizedBox(width: 4), + Text( + '${question.points} 分', + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.w600, + color: Colors.grey[600], + ), + ), + ], + ), + ], + ), + ], + ), + ); + } + + Widget _buildQuestionContent() { + final testState = ref.watch(testProvider); + final currentQuestion = testState.currentQuestion; + + if (currentQuestion == null) { + return const Center( + child: Text( + '没有找到题目', + style: TextStyle(fontSize: 16, color: Colors.grey), + ), + ); + } + + final userAnswer = testState.currentSession?.answers + .where((answer) => answer.questionId == currentQuestion.id) + .firstOrNull; + + return QuestionWidget( + question: currentQuestion, + userAnswer: userAnswer, + onAnswerChanged: (answer) { + ref.read(testProvider.notifier).recordAnswer(answer); + }, + ); + } + + Widget _buildNavigationBar(TestSession session) { + final canGoPrevious = session.currentQuestionIndex > 0; + final canGoNext = session.currentQuestionIndex < session.questions.length - 1; + final isLastQuestion = session.currentQuestionIndex == session.questions.length - 1; + + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + blurRadius: 4, + offset: const Offset(0, -2), + ), + ], + ), + child: Row( + children: [ + Expanded( + child: ElevatedButton( + onPressed: canGoPrevious ? _previousQuestion : null, + style: ElevatedButton.styleFrom( + backgroundColor: Colors.grey[300], + foregroundColor: Colors.grey[700], + padding: const EdgeInsets.symmetric(vertical: 12), + ), + child: const Text('上一题'), + ), + ), + const SizedBox(width: 16), + Expanded( + flex: 2, + child: ElevatedButton( + onPressed: isLastQuestion ? _submitTest : (canGoNext ? _nextQuestion : null), + style: ElevatedButton.styleFrom( + backgroundColor: isLastQuestion ? Colors.green : const Color(0xFF2196F3), + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(vertical: 12), + ), + child: Text(isLastQuestion ? '提交测试' : '下一题'), + ), + ), + ], + ), + ); + } + + Color _getSkillColor(SkillType skillType) { + switch (skillType) { + case SkillType.vocabulary: + return Colors.blue; + case SkillType.grammar: + return Colors.green; + case SkillType.reading: + return Colors.orange; + case SkillType.listening: + return Colors.purple; + case SkillType.speaking: + return Colors.red; + case SkillType.writing: + return Colors.teal; + } + } + + Color _getDifficultyColor(DifficultyLevel difficulty) { + switch (difficulty) { + case DifficultyLevel.beginner: + return Colors.green; + case DifficultyLevel.elementary: + return Colors.lightGreen; + case DifficultyLevel.intermediate: + return Colors.orange; + case DifficultyLevel.upperIntermediate: + return Colors.deepOrange; + case DifficultyLevel.advanced: + return Colors.red; + case DifficultyLevel.expert: + return Colors.purple; + } + } + + String _getDifficultyName(DifficultyLevel difficulty) { + switch (difficulty) { + case DifficultyLevel.beginner: + return '初级'; + case DifficultyLevel.elementary: + return '基础'; + case DifficultyLevel.intermediate: + return '中级'; + case DifficultyLevel.upperIntermediate: + return '中高级'; + case DifficultyLevel.advanced: + return '高级'; + case DifficultyLevel.expert: + return '专家级'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/comprehensive_test/screens/test_result_screen.dart b/client/lib/features/comprehensive_test/screens/test_result_screen.dart new file mode 100644 index 0000000..34453a8 --- /dev/null +++ b/client/lib/features/comprehensive_test/screens/test_result_screen.dart @@ -0,0 +1,560 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/test_models.dart'; +import '../providers/test_riverpod_provider.dart'; + +/// 测试结果页面 +class TestResultScreen extends ConsumerWidget { + final TestResult testResult; + + const TestResultScreen({ + super.key, + required this.testResult, + }); + + @override + Widget build(BuildContext context, WidgetRef ref) { + return Scaffold( + backgroundColor: Colors.grey[50], + appBar: AppBar( + title: const Text('测试结果'), + backgroundColor: Colors.white, + foregroundColor: Colors.black87, + elevation: 0, + actions: [ + IconButton( + onPressed: () => _shareResult(context), + icon: const Icon(Icons.share), + ), + ], + ), + body: SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildOverallScore(), + const SizedBox(height: 24), + _buildSkillBreakdown(), + const SizedBox(height: 24), + _buildPerformanceAnalysis(), + const SizedBox(height: 24), + _buildRecommendations(), + const SizedBox(height: 24), + _buildActionButtons(context), + ], + ), + ), + ); + } + + Widget _buildOverallScore() { + final percentage = (testResult.totalScore / testResult.maxScore * 100).round(); + final level = _getScoreLevel(percentage); + final color = _getScoreColor(percentage); + + return Container( + padding: const EdgeInsets.all(24), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + children: [ + Row( + children: [ + Icon( + Icons.emoji_events, + size: 32, + color: color, + ), + const SizedBox(width: 12), + const Expanded( + child: Text( + '总体成绩', + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + const SizedBox(height: 20), + Row( + mainAxisAlignment: MainAxisAlignment.center, + crossAxisAlignment: CrossAxisAlignment.baseline, + textBaseline: TextBaseline.alphabetic, + children: [ + Text( + '$percentage', + style: TextStyle( + fontSize: 48, + fontWeight: FontWeight.bold, + color: color, + ), + ), + Text( + '%', + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.w600, + color: color, + ), + ), + ], + ), + const SizedBox(height: 8), + Text( + level, + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.w600, + color: color, + ), + ), + const SizedBox(height: 16), + Row( + mainAxisAlignment: MainAxisAlignment.spaceAround, + children: [ + _buildScoreDetail('得分', '${testResult.totalScore}'), + _buildScoreDetail('满分', '${testResult.maxScore}'), + _buildScoreDetail('用时', _formatDuration(testResult.duration)), + ], + ), + ], + ), + ); + } + + Widget _buildScoreDetail(String label, String value) { + return Column( + children: [ + Text( + value, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + label, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ); + } + + Widget _buildSkillBreakdown() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Row( + children: [ + Icon( + Icons.analytics, + size: 24, + color: Colors.blue, + ), + SizedBox(width: 8), + Text( + '技能分析', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 20), + ...testResult.skillScores.map((skillScore) => _buildSkillItem(skillScore)), + ], + ), + ); + } + + Widget _buildSkillItem(SkillScore skillScore) { + final color = _getSkillColor(skillScore.skillType); + final percentage = skillScore.percentage; + + return Container( + margin: const EdgeInsets.only(bottom: 16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + _getSkillName(skillScore.skillType), + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + Text( + '${percentage.round()}%', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: color, + ), + ), + ], + ), + const SizedBox(height: 8), + LinearProgressIndicator( + value: percentage / 100, + backgroundColor: Colors.grey[200], + valueColor: AlwaysStoppedAnimation(color), + ), + const SizedBox(height: 4), + Text( + _getDifficultyName(skillScore.level), + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ); + } + + Widget _buildPerformanceAnalysis() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Row( + children: [ + Icon( + Icons.insights, + size: 24, + color: Colors.green, + ), + SizedBox(width: 8), + Text( + '表现分析', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 16), + if (testResult.feedback != null) ...[ + Text( + testResult.feedback!, + style: const TextStyle( + fontSize: 14, + height: 1.5, + ), + ), + ] else ...[ + _buildDefaultAnalysis(), + ], + ], + ), + ); + } + + Widget _buildDefaultAnalysis() { + final percentage = (testResult.totalScore / testResult.maxScore * 100).round(); + String analysis; + + if (percentage >= 90) { + analysis = '恭喜！您的表现非常出色，各项技能都达到了很高的水平。继续保持这种学习状态，可以尝试更高难度的挑战。'; + } else if (percentage >= 80) { + analysis = '您的表现很好！大部分技能都掌握得不错，但还有一些提升空间。建议重点关注得分较低的技能领域。'; + } else if (percentage >= 70) { + analysis = '您的基础还不错，但需要在某些技能上加强练习。建议制定针对性的学习计划，逐步提升薄弱环节。'; + } else if (percentage >= 60) { + analysis = '您已经掌握了一些基础知识，但还需要更多的练习和学习。建议从基础开始，循序渐进地提升各项技能。'; + } else { + analysis = '建议您从基础开始系统性地学习，多做练习，不要着急，学习是一个循序渐进的过程。'; + } + + return Text( + analysis, + style: const TextStyle( + fontSize: 14, + height: 1.5, + ), + ); + } + + Widget _buildRecommendations() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Row( + children: [ + Icon( + Icons.lightbulb, + size: 24, + color: Colors.orange, + ), + SizedBox(width: 8), + Text( + '学习建议', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 16), + if (testResult.recommendations != null && testResult.recommendations!.isNotEmpty) ...[ + ...testResult.recommendations!.values.where((v) => v is String).map((recommendation) => _buildRecommendationItem(recommendation as String)), + ] else ...[ + ..._getDefaultRecommendations().map((recommendation) => _buildRecommendationItem(recommendation)), + ], + ], + ), + ); + } + + Widget _buildRecommendationItem(String recommendation) { + return Container( + margin: const EdgeInsets.only(bottom: 12), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Container( + width: 6, + height: 6, + margin: const EdgeInsets.only(top: 6), + decoration: const BoxDecoration( + color: Colors.orange, + shape: BoxShape.circle, + ), + ), + const SizedBox(width: 12), + Expanded( + child: Text( + recommendation, + style: const TextStyle( + fontSize: 14, + height: 1.4, + ), + ), + ), + ], + ), + ); + } + + List _getDefaultRecommendations() { + final weakSkills = testResult.skillScores + .where((skill) => skill.percentage < 70) + .map((skill) => _getSkillName(skill.skillType)) + .toList(); + + List recommendations = []; + + if (weakSkills.isNotEmpty) { + recommendations.add('重点加强${weakSkills.join('、')}方面的练习'); + } + + recommendations.addAll([ + '每天坚持30分钟的英语学习', + '多做相关类型的练习题', + '建议参加更多的模拟测试', + '可以寻求老师或同学的帮助', + ]); + + return recommendations; + } + + Widget _buildActionButtons(BuildContext context) { + return Column( + children: [ + SizedBox( + width: double.infinity, + child: ElevatedButton( + onPressed: () => _retakeTest(context), + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(vertical: 16), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: const Text( + '重新测试', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + ), + ), + const SizedBox(height: 12), + SizedBox( + width: double.infinity, + child: OutlinedButton( + onPressed: () => _backToHome(context), + style: OutlinedButton.styleFrom( + foregroundColor: const Color(0xFF2196F3), + padding: const EdgeInsets.symmetric(vertical: 16), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: const Text( + '返回首页', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + ), + ), + ], + ); + } + + void _shareResult(BuildContext context) { + // 这里应该实现分享功能 + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('分享功能正在开发中...'), + backgroundColor: Colors.blue, + ), + ); + } + + void _retakeTest(BuildContext context) { + Navigator.of(context).popUntil((route) => route.isFirst); + } + + void _backToHome(BuildContext context) { + Navigator.of(context).popUntil((route) => route.isFirst); + } + + String _formatDuration(int seconds) { + final minutes = seconds ~/ 60; + final remainingSeconds = seconds % 60; + return '${minutes}分${remainingSeconds}秒'; + } + + String _getScoreLevel(int percentage) { + if (percentage >= 90) return '优秀'; + if (percentage >= 80) return '良好'; + if (percentage >= 70) return '中等'; + if (percentage >= 60) return '及格'; + return '需要努力'; + } + + Color _getScoreColor(int percentage) { + if (percentage >= 90) return Colors.green; + if (percentage >= 80) return Colors.blue; + if (percentage >= 70) return Colors.orange; + if (percentage >= 60) return Colors.amber; + return Colors.red; + } + + Color _getSkillColor(SkillType skill) { + switch (skill) { + case SkillType.vocabulary: + return Colors.blue; + case SkillType.grammar: + return Colors.green; + case SkillType.reading: + return Colors.orange; + case SkillType.listening: + return Colors.purple; + case SkillType.speaking: + return Colors.red; + case SkillType.writing: + return Colors.teal; + } + } + + String _getSkillName(SkillType skill) { + switch (skill) { + case SkillType.vocabulary: + return '词汇'; + case SkillType.grammar: + return '语法'; + case SkillType.reading: + return '阅读'; + case SkillType.listening: + return '听力'; + case SkillType.speaking: + return '口语'; + case SkillType.writing: + return '写作'; + } + } + + String _getDifficultyName(DifficultyLevel difficulty) { + switch (difficulty) { + case DifficultyLevel.beginner: + return '初级'; + case DifficultyLevel.elementary: + return '基础'; + case DifficultyLevel.intermediate: + return '中级'; + case DifficultyLevel.upperIntermediate: + return '中高级'; + case DifficultyLevel.advanced: + return '高级'; + case DifficultyLevel.expert: + return '专家级'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/comprehensive_test/services/test_api_service.dart b/client/lib/features/comprehensive_test/services/test_api_service.dart new file mode 100644 index 0000000..1d6acc7 --- /dev/null +++ b/client/lib/features/comprehensive_test/services/test_api_service.dart @@ -0,0 +1,416 @@ +import '../../../core/models/api_response.dart'; +import '../../../core/services/enhanced_api_service.dart'; +import '../models/test_models.dart'; + +/// 综合测试API服务类 +/// 使用后端API替代静态数据 +class TestApiService { + static final TestApiService _instance = TestApiService._internal(); + factory TestApiService() => _instance; + TestApiService._internal(); + + final EnhancedApiService _enhancedApiService = EnhancedApiService(); + + // 缓存时长配置 + static const Duration _shortCacheDuration = Duration(minutes: 5); + static const Duration _longCacheDuration = Duration(hours: 1); + + /// 获取所有测试模板 + Future>> getTestTemplates() async { + try { + final response = await _enhancedApiService.get>( + '/tests/templates', + cacheDuration: _longCacheDuration, + fromJson: (data) { + final templates = data['templates'] as List?; + if (templates == null) return []; + return templates.map((json) => TestTemplate.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '获取测试模板成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取测试模板失败: $e'); + } + } + + /// 根据类型获取测试模板 + Future>> getTestTemplatesByType( + TestType type, + ) async { + try { + final response = await _enhancedApiService.get>( + '/tests/templates', + queryParameters: { + 'type': type.toString().split('.').last, + }, + cacheDuration: _longCacheDuration, + fromJson: (data) { + final templates = data['templates'] as List?; + if (templates == null) return []; + return templates.map((json) => TestTemplate.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '获取测试模板成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取测试模板失败: $e'); + } + } + + /// 根据ID获取测试模板 + Future> getTestTemplateById(String id) async { + try { + final response = await _enhancedApiService.get( + '/tests/templates/$id', + cacheDuration: _longCacheDuration, + fromJson: (data) => TestTemplate.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '获取测试模板成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取测试模板失败: $e'); + } + } + + /// 创建测试会话 + Future> createTestSession({ + required String templateId, + required String userId, + }) async { + try { + final response = await _enhancedApiService.post( + '/tests/sessions', + data: { + 'template_id': templateId, + 'user_id': userId, + }, + fromJson: (data) => TestSession.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '创建测试会话成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '创建测试会话失败: $e'); + } + } + + /// 开始测试 + Future> startTest(String sessionId) async { + try { + final response = await _enhancedApiService.put( + '/tests/sessions/$sessionId/start', + fromJson: (data) => TestSession.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '开始测试成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '开始测试失败: $e'); + } + } + + /// 提交答案 + Future> submitAnswer({ + required String sessionId, + required UserAnswer answer, + }) async { + try { + final response = await _enhancedApiService.post( + '/tests/sessions/$sessionId/answers', + data: { + 'question_id': answer.questionId, + 'answer': answer.answer, + }, + fromJson: (data) => TestSession.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '提交答案成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '提交答案失败: $e'); + } + } + + /// 暂停测试 + Future> pauseTest(String sessionId) async { + try { + final response = await _enhancedApiService.put( + '/tests/sessions/$sessionId/pause', + fromJson: (data) => TestSession.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '测试已暂停'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '暂停测试失败: $e'); + } + } + + /// 恢复测试 + Future> resumeTest(String sessionId) async { + try { + final response = await _enhancedApiService.put( + '/tests/sessions/$sessionId/resume', + fromJson: (data) => TestSession.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '测试已恢复'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '恢复测试失败: $e'); + } + } + + /// 完成测试 + Future> completeTest(String sessionId) async { + try { + final response = await _enhancedApiService.put( + '/tests/sessions/$sessionId/complete', + fromJson: (data) => TestResult.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '完成测试成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '完成测试失败: $e'); + } + } + + /// 获取测试结果 + Future> getTestResult(String sessionId) async { + try { + final response = await _enhancedApiService.get( + '/tests/sessions/$sessionId/result', + cacheDuration: _shortCacheDuration, + fromJson: (data) => TestResult.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '获取测试结果成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取测试结果失败: $e'); + } + } + + /// 获取用户测试历史 + Future>> getUserTestHistory({ + int page = 1, + int limit = 20, + }) async { + try { + final response = await _enhancedApiService.get>( + '/tests/sessions', + queryParameters: { + 'page': page, + 'limit': limit, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final sessions = data['sessions'] as List?; + if (sessions == null) return []; + return sessions.map((json) => TestSession.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '获取测试历史成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取测试历史失败: $e'); + } + } + + /// 获取用户测试统计 + Future>> getUserTestStats() async { + try { + final response = await _enhancedApiService.get>( + '/tests/stats', + cacheDuration: _shortCacheDuration, + fromJson: (data) => data, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '获取测试统计成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取测试统计失败: $e'); + } + } + + /// 获取最近的测试结果 + Future>> getRecentTestResults( + String? userId, { + int limit = 5, + }) async { + try { + final response = await _enhancedApiService.get>( + '/tests/sessions/recent', + queryParameters: { + if (userId != null) 'user_id': userId, + 'limit': limit, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final sessions = data['sessions'] as List?; + if (sessions == null) return []; + return sessions.map((json) => TestResult.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '获取最近测试结果成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取最近测试结果失败: $e'); + } + } + + /// 获取测试结果详情 + Future> getTestResultById(String resultId) async { + try { + final response = await _enhancedApiService.get( + '/tests/results/$resultId', + cacheDuration: _shortCacheDuration, + fromJson: (data) => TestResult.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '获取测试结果成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取测试结果失败: $e'); + } + } + + /// 获取用户技能统计 + Future>> getUserSkillStatistics( + String userId, + ) async { + try { + final response = await _enhancedApiService.get>( + '/tests/users/$userId/skills', + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final skillsData = data['skills'] as Map?; + if (skillsData == null) return {}; + + final result = {}; + skillsData.forEach((key, value) { + final skillType = _parseSkillType(key); + if (skillType != null) { + result[skillType] = (value as num).toDouble(); + } + }); + return result; + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '获取技能统计成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取技能统计失败: $e'); + } + } + + /// 获取题目统计 + Future>> getQuestionStatistics() async { + try { + final response = await _enhancedApiService.get>( + '/tests/questions/statistics', + cacheDuration: _longCacheDuration, + fromJson: (data) => data, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(data: response.data!, message: '获取题目统计成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取题目统计失败: $e'); + } + } + + /// 删除测试结果 + Future> deleteTestResult(String resultId) async { + try { + final response = await _enhancedApiService.delete( + '/tests/results/$resultId', + fromJson: (data) => null, + ); + + if (response.success) { + return ApiResponse.success(message: '删除测试结果成功'); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '删除测试结果失败: $e'); + } + } + + /// 解析技能类型 + SkillType? _parseSkillType(String key) { + switch (key.toLowerCase()) { + case 'vocabulary': + return SkillType.vocabulary; + case 'grammar': + return SkillType.grammar; + case 'reading': + return SkillType.reading; + case 'listening': + return SkillType.listening; + case 'speaking': + return SkillType.speaking; + case 'writing': + return SkillType.writing; + default: + return null; + } + } +} diff --git a/client/lib/features/comprehensive_test/services/test_service.dart b/client/lib/features/comprehensive_test/services/test_service.dart new file mode 100644 index 0000000..f95faa2 --- /dev/null +++ b/client/lib/features/comprehensive_test/services/test_service.dart @@ -0,0 +1,468 @@ +import '../models/test_models.dart'; +import '../data/test_static_data.dart'; +import '../../../core/models/api_response.dart'; + +/// 综合测试服务类 +class TestService { + // 单例模式 + static final TestService _instance = TestService._internal(); + factory TestService() => _instance; + TestService._internal(); + + /// 获取所有测试模板 + Future>> getTestTemplates() async { + try { + // 模拟网络延迟 + await Future.delayed(const Duration(milliseconds: 500)); + + final templates = TestStaticData.getAllTemplates(); + return ApiResponse.success( + data: templates, + message: '获取测试模板成功', + ); + } catch (e) { + return ApiResponse.error( + message: '获取测试模板失败: ${e.toString()}', + ); + } + } + + /// 根据类型获取测试模板 + Future>> getTestTemplatesByType( + TestType type, + ) async { + try { + await Future.delayed(const Duration(milliseconds: 300)); + + final templates = TestStaticData.getTemplatesByType(type); + return ApiResponse.success( + data: templates, + message: '获取${_getTestTypeName(type)}模板成功', + ); + } catch (e) { + return ApiResponse.error( + message: '获取测试模板失败: ${e.toString()}', + ); + } + } + + /// 根据ID获取测试模板 + Future> getTestTemplateById(String id) async { + try { + await Future.delayed(const Duration(milliseconds: 200)); + + final template = TestStaticData.getTemplateById(id); + if (template == null) { + return ApiResponse.error(message: '测试模板不存在'); + } + + return ApiResponse.success( + data: template, + message: '获取测试模板成功', + ); + } catch (e) { + return ApiResponse.error( + message: '获取测试模板失败: ${e.toString()}', + ); + } + } + + /// 创建测试会话 + Future> createTestSession({ + required String templateId, + required String userId, + }) async { + try { + await Future.delayed(const Duration(milliseconds: 800)); + + final session = TestStaticData.createTestSession( + templateId: templateId, + userId: userId, + ); + + return ApiResponse.success( + data: session, + message: '创建测试会话成功', + ); + } catch (e) { + return ApiResponse.error( + message: '创建测试会话失败: ${e.toString()}', + ); + } + } + + /// 开始测试 + Future> startTest(String sessionId) async { + try { + await Future.delayed(const Duration(milliseconds: 300)); + + // 模拟开始测试，实际应用中会更新数据库中的会话状态 + // 这里返回一个模拟的已开始的会话 + return ApiResponse.success( + data: TestSession( + id: sessionId, + templateId: 'template_quick', + userId: 'user_001', + status: TestStatus.inProgress, + questions: TestStaticData.getQuestionsByIds(['vocab_001', 'grammar_001']), + answers: [], + currentQuestionIndex: 0, + startTime: DateTime.now(), + timeRemaining: 900, // 15分钟 + ), + message: '测试已开始', + ); + } catch (e) { + return ApiResponse.error( + message: '开始测试失败: ${e.toString()}', + ); + } + } + + /// 提交答案 + Future> submitAnswer({ + required String sessionId, + required UserAnswer answer, + }) async { + try { + await Future.delayed(const Duration(milliseconds: 400)); + + // 模拟提交答案并返回更新后的会话 + return ApiResponse.success( + data: TestSession( + id: sessionId, + templateId: 'template_quick', + userId: 'user_001', + status: TestStatus.inProgress, + questions: TestStaticData.getQuestionsByIds(['vocab_001', 'grammar_001']), + answers: [answer], + currentQuestionIndex: 1, + startTime: DateTime.now().subtract(const Duration(minutes: 5)), + timeRemaining: 600, // 剩余10分钟 + ), + message: '答案提交成功', + ); + } catch (e) { + return ApiResponse.error( + message: '提交答案失败: ${e.toString()}', + ); + } + } + + /// 暂停测试 + Future> pauseTest(String sessionId) async { + try { + await Future.delayed(const Duration(milliseconds: 200)); + + return ApiResponse.success( + data: TestSession( + id: sessionId, + templateId: 'template_quick', + userId: 'user_001', + status: TestStatus.paused, + questions: TestStaticData.getQuestionsByIds(['vocab_001', 'grammar_001']), + answers: [], + currentQuestionIndex: 0, + startTime: DateTime.now().subtract(const Duration(minutes: 5)), + timeRemaining: 600, + ), + message: '测试已暂停', + ); + } catch (e) { + return ApiResponse.error( + message: '暂停测试失败: ${e.toString()}', + ); + } + } + + /// 恢复测试 + Future> resumeTest(String sessionId) async { + try { + await Future.delayed(const Duration(milliseconds: 200)); + + return ApiResponse.success( + data: TestSession( + id: sessionId, + templateId: 'template_quick', + userId: 'user_001', + status: TestStatus.inProgress, + questions: TestStaticData.getQuestionsByIds(['vocab_001', 'grammar_001']), + answers: [], + currentQuestionIndex: 0, + startTime: DateTime.now().subtract(const Duration(minutes: 5)), + timeRemaining: 600, + ), + message: '测试已恢复', + ); + } catch (e) { + return ApiResponse.error( + message: '恢复测试失败: ${e.toString()}', + ); + } + } + + /// 完成测试 + Future> completeTest({ + required String sessionId, + required List answers, + }) async { + try { + await Future.delayed(const Duration(milliseconds: 1000)); + + // 模拟计算测试结果 + final result = _calculateTestResult(sessionId, answers); + + // 保存结果到静态数据 + TestStaticData.addTestResult(result); + + return ApiResponse.success( + data: result, + message: '测试完成，结果已保存', + ); + } catch (e) { + return ApiResponse.error( + message: '完成测试失败: ${e.toString()}', + ); + } + } + + /// 获取用户测试历史 + Future>> getUserTestHistory( + String userId, { + int page = 1, + int limit = 10, + }) async { + try { + await Future.delayed(const Duration(milliseconds: 600)); + + final allResults = TestStaticData.getUserResults(userId); + final startIndex = (page - 1) * limit; + final endIndex = startIndex + limit; + + final results = allResults.length > startIndex + ? allResults.sublist( + startIndex, + endIndex > allResults.length ? allResults.length : endIndex, + ) + : []; + + return ApiResponse.success( + data: results, + message: '获取测试历史成功', + ); + } catch (e) { + return ApiResponse.error( + message: '获取测试历史失败: ${e.toString()}', + ); + } + } + + /// 获取最近的测试结果 + Future>> getRecentTestResults( + String userId, { + int limit = 5, + }) async { + try { + await Future.delayed(const Duration(milliseconds: 400)); + + final results = TestStaticData.getRecentResults(userId, limit: limit); + return ApiResponse.success( + data: results, + message: '获取最近测试结果成功', + ); + } catch (e) { + return ApiResponse.error( + message: '获取最近测试结果失败: ${e.toString()}', + ); + } + } + + /// 获取测试结果详情 + Future> getTestResultById(String resultId) async { + try { + await Future.delayed(const Duration(milliseconds: 300)); + + final result = TestStaticData.getResultById(resultId); + if (result == null) { + return ApiResponse.error(message: '测试结果不存在'); + } + + return ApiResponse.success( + data: result, + message: '获取测试结果成功', + ); + } catch (e) { + return ApiResponse.error( + message: '获取测试结果失败: ${e.toString()}', + ); + } + } + + /// 获取用户技能统计 + Future>> getUserSkillStatistics( + String userId, + ) async { + try { + await Future.delayed(const Duration(milliseconds: 500)); + + final statistics = TestStaticData.getSkillStatistics(userId); + return ApiResponse.success( + data: statistics, + message: '获取技能统计成功', + ); + } catch (e) { + return ApiResponse.error( + message: '获取技能统计失败: ${e.toString()}', + ); + } + } + + /// 获取题目统计 + Future>> getQuestionStatistics() async { + try { + await Future.delayed(const Duration(milliseconds: 300)); + + final difficultyStats = TestStaticData.getDifficultyStatistics(); + final skillStats = TestStaticData.getSkillDistributionStatistics(); + + return ApiResponse.success( + data: { + 'difficultyDistribution': difficultyStats, + 'skillDistribution': skillStats, + 'totalQuestions': TestStaticData.getAllQuestions().length, + }, + message: '获取题目统计成功', + ); + } catch (e) { + return ApiResponse.error( + message: '获取题目统计失败: ${e.toString()}', + ); + } + } + + /// 删除测试结果 + Future> deleteTestResult(String resultId) async { + try { + await Future.delayed(const Duration(milliseconds: 300)); + + final success = TestStaticData.deleteTestResult(resultId); + if (success) { + return ApiResponse.success( + data: true, + message: '删除测试结果成功', + ); + } else { + return ApiResponse.error(message: '测试结果不存在'); + } + } catch (e) { + return ApiResponse.error( + message: '删除测试结果失败: ${e.toString()}', + ); + } + } + + /// 获取测试类型名称 + String _getTestTypeName(TestType type) { + switch (type) { + case TestType.quick: + return '快速测试'; + case TestType.standard: + return '标准测试'; + case TestType.full: + return '完整测试'; + case TestType.mock: + return '模拟考试'; + case TestType.vocabulary: + return '词汇专项'; + case TestType.grammar: + return '语法专项'; + case TestType.reading: + return '阅读专项'; + case TestType.listening: + return '听力专项'; + case TestType.speaking: + return '口语专项'; + case TestType.writing: + return '写作专项'; + } + } + + /// 计算测试结果（模拟） + TestResult _calculateTestResult(String sessionId, List answers) { + // 这里是一个简化的计算逻辑，实际应用中会更复杂 + final totalQuestions = answers.length; + final correctAnswers = (totalQuestions * 0.8).round(); // 模拟80%正确率 + final totalScore = correctAnswers; + final maxScore = totalQuestions; + final percentage = (totalScore / maxScore) * 100; + + return TestResult( + id: 'result_${DateTime.now().millisecondsSinceEpoch}', + testId: 'template_quick', + userId: 'user_001', + testType: TestType.quick, + totalScore: totalScore, + maxScore: maxScore, + percentage: percentage, + overallLevel: _calculateOverallLevel(percentage), + skillScores: _calculateSkillScores(answers), + answers: answers, + startTime: DateTime.now().subtract(const Duration(minutes: 15)), + endTime: DateTime.now(), + duration: 900, + feedback: _generateFeedback(percentage), + recommendations: { + 'nextLevel': 'intermediate', + 'focusAreas': ['grammar', 'vocabulary'], + 'suggestedStudyTime': 45, + }, + ); + } + + /// 计算整体水平 + DifficultyLevel _calculateOverallLevel(double percentage) { + if (percentage >= 90) return DifficultyLevel.advanced; + if (percentage >= 80) return DifficultyLevel.upperIntermediate; + if (percentage >= 70) return DifficultyLevel.intermediate; + if (percentage >= 60) return DifficultyLevel.elementary; + return DifficultyLevel.beginner; + } + + /// 计算技能得分 + List _calculateSkillScores(List answers) { + // 简化的技能得分计算 + return [ + SkillScore( + skillType: SkillType.vocabulary, + score: 4, + maxScore: 5, + percentage: 80.0, + level: DifficultyLevel.elementary, + feedback: '词汇掌握良好', + ), + SkillScore( + skillType: SkillType.grammar, + score: 3, + maxScore: 4, + percentage: 75.0, + level: DifficultyLevel.elementary, + feedback: '语法基础扎实', + ), + ]; + } + + /// 生成反馈 + String _generateFeedback(double percentage) { + if (percentage >= 90) { + return '优秀！您的英语水平很高，继续保持。'; + } else if (percentage >= 80) { + return '良好！您的英语基础扎实，可以尝试更高难度的内容。'; + } else if (percentage >= 70) { + return '不错！您的英语水平中等，建议加强薄弱环节的练习。'; + } else if (percentage >= 60) { + return '及格！您的英语基础还需要加强，建议多练习基础知识。'; + } else { + return '需要努力！建议从基础开始，系统性地学习英语。'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/comprehensive_test/services/test_service_impl.dart b/client/lib/features/comprehensive_test/services/test_service_impl.dart new file mode 100644 index 0000000..666d903 --- /dev/null +++ b/client/lib/features/comprehensive_test/services/test_service_impl.dart @@ -0,0 +1,329 @@ +import '../models/test_models.dart'; +import 'test_service.dart'; +import '../../../core/models/api_response.dart'; +import '../../../core/network/api_client.dart'; +import '../../../core/network/api_endpoints.dart'; + +/// 测试服务实现类（HTTP，使用后端真实API） +class TestServiceImpl implements TestService { + final ApiClient _apiClient = ApiClient.instance; + + @override + Future>> getTestTemplates() async { + try { + final response = await _apiClient.get('${ApiEndpoints.baseUrl}/tests/templates'); + if (response.statusCode == 200) { + final root = response.data['data']; + List list = const []; + if (root is List) { + list = root; + } else if (root is Map) { + final v = root['templates']; + if (v is List) list = v; + } + final templates = list.map((e) => TestTemplate.fromJson(e)).toList(); + return ApiResponse.success(message: '获取测试模板成功', data: templates); + } + return ApiResponse.error(message: '加载测试模板失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '获取测试模板失败: $e'); + } + } + + @override + Future>> getTestTemplatesByType( + TestType type, { + bool? isActive, + }) async { + try { + final response = await _apiClient.get( + '${ApiEndpoints.baseUrl}/tests/templates', + queryParameters: { + 'type': type.name, + if (isActive != null) 'active': isActive, + }, + ); + if (response.statusCode == 200) { + final root = response.data['data']; + List list = const []; + if (root is List) { + list = root; + } else if (root is Map) { + final v = root['templates']; + if (v is List) list = v; + } + final templates = list.map((e) => TestTemplate.fromJson(e)).toList(); + return ApiResponse.success(message: '获取测试模板成功', data: templates); + } + return ApiResponse.error(message: '加载测试模板失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '获取测试模板失败: $e'); + } + } + + @override + Future> getTestTemplateById(String id) async { + try { + final response = await _apiClient.get('${ApiEndpoints.baseUrl}/tests/templates/$id'); + if (response.statusCode == 200) { + return ApiResponse.success( + message: '获取测试模板成功', + data: TestTemplate.fromJson(response.data['data']), + ); + } + return ApiResponse.error(message: '模板不存在', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '获取测试模板失败: $e'); + } + } + + @override + Future> createTestSession({ + required String templateId, + required String userId, + Map? metadata, + }) async { + try { + final response = await _apiClient.post( + '${ApiEndpoints.baseUrl}/tests/sessions', + data: { + 'template_id': templateId, + 'user_id': userId, + 'metadata': metadata ?? {}, + }, + ); + if (response.statusCode == 200) { + return ApiResponse.success( + message: '创建测试会话成功', + data: TestSession.fromJson(response.data['data']), + ); + } + return ApiResponse.error(message: '创建测试会话失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '创建测试会话失败: $e'); + } + } + + @override + Future> startTest(String sessionId) async { + try { + final response = await _apiClient.put('${ApiEndpoints.baseUrl}/tests/sessions/$sessionId/start'); + if (response.statusCode == 200) { + return ApiResponse.success( + message: '测试已开始', + data: TestSession.fromJson(response.data['data']), + ); + } + return ApiResponse.error(message: '开始测试失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '开始测试失败: $e'); + } + } + + @override + Future> submitAnswer({ + required String sessionId, + required UserAnswer answer, + }) async { + try { + final response = await _apiClient.post( + '${ApiEndpoints.baseUrl}/tests/sessions/$sessionId/answers', + data: answer.toJson(), + ); + if (response.statusCode == 200) { + return ApiResponse.success( + message: '答案提交成功', + data: TestSession.fromJson(response.data['data']), + ); + } + return ApiResponse.error(message: '提交答案失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '提交答案失败: $e'); + } + } + + @override + Future> pauseTest(String sessionId) async { + try { + final response = await _apiClient.put('${ApiEndpoints.baseUrl}/tests/sessions/$sessionId/pause'); + if (response.statusCode == 200) { + return ApiResponse.success( + message: '测试已暂停', + data: TestSession.fromJson(response.data['data']), + ); + } + return ApiResponse.error(message: '暂停测试失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '暂停测试失败: $e'); + } + } + + @override + Future> resumeTest(String sessionId) async { + try { + final response = await _apiClient.put('${ApiEndpoints.baseUrl}/tests/sessions/$sessionId/resume'); + if (response.statusCode == 200) { + return ApiResponse.success( + message: '测试已恢复', + data: TestSession.fromJson(response.data['data']), + ); + } + return ApiResponse.error(message: '恢复测试失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '恢复测试失败: $e'); + } + } + + @override + Future> completeTest({ + required String sessionId, + required List answers, + }) async { + try { + final response = await _apiClient.put( + '${ApiEndpoints.baseUrl}/tests/sessions/$sessionId/complete', + data: { + 'answers': answers.map((a) => a.toJson()).toList(), + }, + ); + if (response.statusCode == 200) { + return ApiResponse.success( + message: '提交测试成功', + data: TestResult.fromJson(response.data['data']), + ); + } + return ApiResponse.error(message: '完成测试失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '完成测试失败: $e'); + } + } + + @override + Future>> getUserTestHistory( + String userId, { + int page = 1, + int limit = 10, + }) async { + try { + final response = await _apiClient.get( + '${ApiEndpoints.baseUrl}/tests/sessions', + queryParameters: { + 'page': page, + 'limit': limit, + }, + ); + if (response.statusCode == 200) { + final root = response.data['data']; + List list = const []; + if (root is List) { + list = root; + } else if (root is Map) { + final v = root['sessions']; + if (v is List) list = v; + } + final results = list.map((e) => TestResult.fromJson(e)).toList(); + return ApiResponse.success(message: '获取测试历史成功', data: results); + } + return ApiResponse.error(message: '获取测试历史失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '获取测试历史失败: $e'); + } + } + + @override + Future>> getRecentTestResults( + String userId, { + int limit = 10, + }) async { + try { + final response = await _apiClient.get( + '${ApiEndpoints.baseUrl}/tests/sessions', + queryParameters: { + 'limit': limit, + }, + ); + if (response.statusCode == 200) { + final root = response.data['data']; + List list = const []; + if (root is List) { + list = root; + } else if (root is Map) { + final v = root['sessions']; + if (v is List) list = v; + } + final results = list.map((e) => TestResult.fromJson(e)).toList(); + return ApiResponse.success(message: '获取最近测试结果成功', data: results); + } + return ApiResponse.error(message: '获取最近测试结果失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '获取最近测试结果失败: $e'); + } + } + + @override + Future> getTestResultById(String resultId) async { + try { + final response = await _apiClient.get('${ApiEndpoints.baseUrl}/tests/results/$resultId'); + if (response.statusCode == 200) { + return ApiResponse.success( + message: '获取测试结果成功', + data: TestResult.fromJson(response.data['data']), + ); + } + return ApiResponse.error(message: '测试结果不存在', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '获取测试结果失败: $e'); + } + } + + @override + Future>> getUserSkillStatistics( + String userId, { + int? daysPeriod, + }) async { + try { + final response = await _apiClient.get('${ApiEndpoints.baseUrl}/tests/stats'); + if (response.statusCode == 200) { + final Map data = response.data['data'] ?? {}; + final Map stats = {}; + data.forEach((k, v) { + final skill = SkillType.values.firstWhere((s) => s.name == k, orElse: () => SkillType.reading); + stats[skill] = (v as num).toDouble(); + }); + return ApiResponse.success(message: '获取技能统计成功', data: stats); + } + return ApiResponse.error(message: '获取技能统计失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '获取技能统计失败: $e'); + } + } + + @override + Future>> getQuestionStatistics() async { + try { + final response = await _apiClient.get('${ApiEndpoints.baseUrl}/tests/stats'); + if (response.statusCode == 200) { + return ApiResponse.success( + message: '获取题目统计成功', + data: response.data['data'] ?? {}, + ); + } + return ApiResponse.error(message: '获取题目统计失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '获取题目统计失败: $e'); + } + } + + @override + Future> deleteTestResult(String resultId) async { + try { + final response = await _apiClient.delete('${ApiEndpoints.baseUrl}/tests/results/$resultId'); + if (response.statusCode == 200) { + return ApiResponse.success(message: '删除测试结果成功', data: true); + } + return ApiResponse.error(message: '删除测试结果失败', code: response.statusCode); + } catch (e) { + return ApiResponse.error(message: '删除测试结果失败: $e'); + } + } +} \ No newline at end of file diff --git a/client/lib/features/comprehensive_test/widgets/question_widgets.dart b/client/lib/features/comprehensive_test/widgets/question_widgets.dart new file mode 100644 index 0000000..302b60f --- /dev/null +++ b/client/lib/features/comprehensive_test/widgets/question_widgets.dart @@ -0,0 +1,630 @@ +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import 'dart:async'; +import '../models/test_models.dart'; + +/// 题目展示组件 +class QuestionWidget extends StatefulWidget { + final TestQuestion question; + final UserAnswer? userAnswer; + final Function(UserAnswer) onAnswerChanged; + + const QuestionWidget({ + super.key, + required this.question, + this.userAnswer, + required this.onAnswerChanged, + }); + + @override + State createState() => _QuestionWidgetState(); +} + +class _QuestionWidgetState extends State { + late List _selectedAnswers; + late TextEditingController _textController; + Timer? _debounceTimer; + + @override + void initState() { + super.initState(); + _selectedAnswers = widget.userAnswer?.selectedAnswers ?? []; + _textController = TextEditingController(text: widget.userAnswer?.textAnswer ?? ''); + } + + @override + void dispose() { + _textController.dispose(); + _debounceTimer?.cancel(); + super.dispose(); + } + + void _updateAnswer() { + final answer = UserAnswer( + questionId: widget.question.id, + selectedAnswers: _selectedAnswers, + textAnswer: _textController.text.isNotEmpty ? _textController.text : null, + answeredAt: DateTime.now(), + timeSpent: 0, // 这里应该计算实际用时 + ); + widget.onAnswerChanged(answer); + } + + void _onTextChanged(String text) { + _debounceTimer?.cancel(); + _debounceTimer = Timer(const Duration(milliseconds: 500), () { + _updateAnswer(); + }); + } + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildQuestionContent(), + const SizedBox(height: 24), + _buildAnswerSection(), + if (widget.question.explanation != null && widget.userAnswer != null) ...[ + const SizedBox(height: 16), + _buildExplanation(), + ], + ], + ), + ); + } + + Widget _buildQuestionContent() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + widget.question.content, + style: const TextStyle( + fontSize: 18, + fontWeight: FontWeight.w600, + height: 1.4, + ), + ), + if (widget.question.imageUrl != null) ...[ + const SizedBox(height: 16), + ClipRRect( + borderRadius: BorderRadius.circular(8), + child: Image.network( + widget.question.imageUrl!, + width: double.infinity, + height: 200, + fit: BoxFit.cover, + errorBuilder: (context, error, stackTrace) { + return Container( + width: double.infinity, + height: 200, + color: Colors.grey[200], + child: const Icon( + Icons.image_not_supported, + size: 48, + color: Colors.grey, + ), + ); + }, + ), + ), + ], + if (widget.question.audioUrl != null) ...[ + const SizedBox(height: 16), + _buildAudioPlayer(), + ], + ], + ); + } + + Widget _buildAudioPlayer() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: Colors.blue.withOpacity(0.3)), + ), + child: Row( + children: [ + Icon( + Icons.headphones, + color: Colors.blue[700], + size: 24, + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '音频材料', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + color: Colors.blue[700], + ), + ), + Text( + '点击播放按钮收听音频', + style: TextStyle( + fontSize: 12, + color: Colors.blue[600], + ), + ), + ], + ), + ), + IconButton( + onPressed: () { + // 这里应该实现音频播放功能 + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('音频播放功能正在开发中...'), + backgroundColor: Colors.blue, + ), + ); + }, + icon: Icon( + Icons.play_circle_filled, + color: Colors.blue[700], + size: 32, + ), + ), + ], + ), + ); + } + + Widget _buildAnswerSection() { + switch (widget.question.type) { + case QuestionType.multipleChoice: + return _buildMultipleChoice(); + case QuestionType.multipleSelect: + return _buildMultipleSelect(); + case QuestionType.fillInBlank: + return _buildFillInBlank(); + case QuestionType.reading: + return _buildMultipleChoice(); // 阅读理解通常是选择题 + case QuestionType.listening: + return _buildMultipleChoice(); // 听力理解通常是选择题 + case QuestionType.speaking: + return _buildSpeaking(); + case QuestionType.writing: + return _buildWriting(); + } + } + + Widget _buildMultipleChoice() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '请选择正确答案：', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 12), + ...widget.question.options.asMap().entries.map((entry) { + final index = entry.key; + final option = entry.value; + final optionLabel = String.fromCharCode(65 + index); // A, B, C, D + final isSelected = _selectedAnswers.contains(option); + + return Container( + margin: const EdgeInsets.only(bottom: 8), + child: InkWell( + onTap: () { + setState(() { + _selectedAnswers = [option]; + }); + _updateAnswer(); + }, + borderRadius: BorderRadius.circular(12), + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: isSelected ? Colors.blue.withOpacity(0.1) : Colors.grey[50], + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: isSelected ? Colors.blue : Colors.grey[300]!, + width: isSelected ? 2 : 1, + ), + ), + child: Row( + children: [ + Container( + width: 24, + height: 24, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: isSelected ? Colors.blue : Colors.transparent, + border: Border.all( + color: isSelected ? Colors.blue : Colors.grey[400]!, + width: 2, + ), + ), + child: isSelected + ? const Icon( + Icons.check, + size: 16, + color: Colors.white, + ) + : null, + ), + const SizedBox(width: 12), + Text( + '$optionLabel.', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + color: isSelected ? Colors.blue : Colors.grey[600], + ), + ), + const SizedBox(width: 8), + Expanded( + child: Text( + option, + style: TextStyle( + fontSize: 16, + color: isSelected ? Colors.blue[700] : Colors.black87, + ), + ), + ), + ], + ), + ), + ), + ); + }).toList(), + ], + ); + } + + Widget _buildMultipleSelect() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '请选择所有正确答案：', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 12), + ...widget.question.options.asMap().entries.map((entry) { + final index = entry.key; + final option = entry.value; + final optionLabel = String.fromCharCode(65 + index); // A, B, C, D + final isSelected = _selectedAnswers.contains(option); + + return Container( + margin: const EdgeInsets.only(bottom: 8), + child: InkWell( + onTap: () { + setState(() { + if (isSelected) { + _selectedAnswers.remove(option); + } else { + _selectedAnswers.add(option); + } + }); + _updateAnswer(); + }, + borderRadius: BorderRadius.circular(12), + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: isSelected ? Colors.green.withOpacity(0.1) : Colors.grey[50], + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: isSelected ? Colors.green : Colors.grey[300]!, + width: isSelected ? 2 : 1, + ), + ), + child: Row( + children: [ + Container( + width: 24, + height: 24, + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(4), + color: isSelected ? Colors.green : Colors.transparent, + border: Border.all( + color: isSelected ? Colors.green : Colors.grey[400]!, + width: 2, + ), + ), + child: isSelected + ? const Icon( + Icons.check, + size: 16, + color: Colors.white, + ) + : null, + ), + const SizedBox(width: 12), + Text( + '$optionLabel.', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + color: isSelected ? Colors.green : Colors.grey[600], + ), + ), + const SizedBox(width: 8), + Expanded( + child: Text( + option, + style: TextStyle( + fontSize: 16, + color: isSelected ? Colors.green[700] : Colors.black87, + ), + ), + ), + ], + ), + ), + ), + ); + }).toList(), + ], + ); + } + + Widget _buildFillInBlank() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '请填入正确答案：', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 12), + TextField( + controller: _textController, + onChanged: _onTextChanged, + decoration: InputDecoration( + hintText: '请输入答案...', + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(12), + borderSide: BorderSide(color: Colors.grey[300]!), + ), + focusedBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(12), + borderSide: const BorderSide(color: Colors.blue, width: 2), + ), + contentPadding: const EdgeInsets.all(16), + ), + style: const TextStyle(fontSize: 16), + ), + if (widget.question.options.isNotEmpty) ...[ + const SizedBox(height: 12), + const Text( + '提示选项：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + color: Colors.grey, + ), + ), + const SizedBox(height: 8), + Wrap( + spacing: 8, + runSpacing: 8, + children: widget.question.options.map((option) { + return InkWell( + onTap: () { + _textController.text = option; + _updateAnswer(); + }, + child: Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 6), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(16), + border: Border.all(color: Colors.grey[300]!), + ), + child: Text( + option, + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + ), + ), + ); + }).toList(), + ), + ], + ], + ); + } + + Widget _buildSpeaking() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '口语回答：', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 12), + Container( + width: double.infinity, + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.red.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: Colors.red.withOpacity(0.3)), + ), + child: Column( + children: [ + Icon( + Icons.mic, + size: 48, + color: Colors.red[600], + ), + const SizedBox(height: 12), + Text( + '点击开始录音', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + color: Colors.red[700], + ), + ), + const SizedBox(height: 8), + Text( + '建议录音时长：${widget.question.timeLimit}秒', + style: TextStyle( + fontSize: 14, + color: Colors.red[600], + ), + ), + const SizedBox(height: 16), + ElevatedButton.icon( + onPressed: () { + // 这里应该实现录音功能 + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('录音功能正在开发中...'), + backgroundColor: Colors.red, + ), + ); + }, + icon: const Icon(Icons.fiber_manual_record), + label: const Text('开始录音'), + style: ElevatedButton.styleFrom( + backgroundColor: Colors.red, + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 12), + ), + ), + ], + ), + ), + ], + ); + } + + Widget _buildWriting() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '请写出您的答案：', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 12), + TextField( + controller: _textController, + onChanged: _onTextChanged, + maxLines: 8, + decoration: InputDecoration( + hintText: '请在此输入您的答案...', + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(12), + borderSide: BorderSide(color: Colors.grey[300]!), + ), + focusedBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(12), + borderSide: const BorderSide(color: Colors.teal, width: 2), + ), + contentPadding: const EdgeInsets.all(16), + ), + style: const TextStyle(fontSize: 16, height: 1.5), + ), + const SizedBox(height: 8), + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '字数：${_textController.text.length}', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + Text( + '建议时长：${widget.question.timeLimit ~/ 60}分钟', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ], + ); + } + + Widget _buildExplanation() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.05), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: Colors.blue.withOpacity(0.2)), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.lightbulb_outline, + color: Colors.blue[600], + size: 20, + ), + const SizedBox(width: 8), + Text( + '解析', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + color: Colors.blue[700], + ), + ), + ], + ), + const SizedBox(height: 8), + Text( + widget.question.explanation!, + style: TextStyle( + fontSize: 14, + color: Colors.blue[700], + height: 1.4, + ), + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/home/models/learning_progress_model.dart b/client/lib/features/home/models/learning_progress_model.dart new file mode 100644 index 0000000..2e9873b --- /dev/null +++ b/client/lib/features/home/models/learning_progress_model.dart @@ -0,0 +1,48 @@ +/// 学习进度模型 +class LearningProgress { + final String id; + final String title; + final String category; + final int totalWords; + final int learnedWords; + final double progress; + final DateTime? lastStudyDate; + + LearningProgress({ + required this.id, + required this.title, + required this.category, + required this.totalWords, + required this.learnedWords, + required this.progress, + this.lastStudyDate, + }); + + factory LearningProgress.fromJson(Map json) { + return LearningProgress( + id: json['id'] as String? ?? '', + title: json['title'] as String? ?? '', + category: json['category'] as String? ?? '', + totalWords: json['total_words'] as int? ?? 0, + learnedWords: json['learned_words'] as int? ?? 0, + progress: (json['progress'] as num?)?.toDouble() ?? 0.0, + lastStudyDate: json['last_study_date'] != null + ? DateTime.tryParse(json['last_study_date'] as String) + : null, + ); + } + + Map toJson() { + return { + 'id': id, + 'title': title, + 'category': category, + 'total_words': totalWords, + 'learned_words': learnedWords, + 'progress': progress, + 'last_study_date': lastStudyDate?.toIso8601String(), + }; + } + + String get progressPercentage => '${(progress * 100).toInt()}%'; +} diff --git a/client/lib/features/home/providers/learning_progress_provider.dart b/client/lib/features/home/providers/learning_progress_provider.dart new file mode 100644 index 0000000..a7dafda --- /dev/null +++ b/client/lib/features/home/providers/learning_progress_provider.dart @@ -0,0 +1,106 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/learning_progress_model.dart'; +import '../services/learning_progress_service.dart'; + +/// 学习进度状态 +class LearningProgressState { + final List progressList; + final bool isLoading; + final String? error; + + LearningProgressState({ + this.progressList = const [], + this.isLoading = false, + this.error, + }); + + LearningProgressState copyWith({ + List? progressList, + bool? isLoading, + String? error, + }) { + return LearningProgressState( + progressList: progressList ?? this.progressList, + isLoading: isLoading ?? this.isLoading, + error: error, + ); + } +} + +/// 学习进度Notifier +class LearningProgressNotifier extends StateNotifier { + final LearningProgressService _service = LearningProgressService(); + + LearningProgressNotifier() : super(LearningProgressState()); + + /// 加载学习进度 + Future loadLearningProgress() async { + state = state.copyWith(isLoading: true, error: null); + + try { + final response = await _service.getUserLearningProgress(); + + if (response.success && response.data != null) { + state = state.copyWith( + progressList: response.data!, + isLoading: false, + ); + } else { + state = state.copyWith( + isLoading: false, + error: response.message, + ); + } + } catch (e) { + state = state.copyWith( + isLoading: false, + error: '加载学习进度失败: $e', + ); + } + } + + /// 刷新学习进度（强制重新加载，不使用缓存） + Future refreshLearningProgress() async { + state = state.copyWith(isLoading: true, error: null); + + try { + // 强制重新加载，传入不同的时间戳来绕过缓存 + final response = await _service.getUserLearningProgress(); + + if (response.success && response.data != null) { + print('=== 刷新学习进度成功 ==='); + print('数据条数: ${response.data!.length}'); + state = state.copyWith( + progressList: response.data!, + isLoading: false, + ); + } else { + state = state.copyWith( + isLoading: false, + error: response.message, + ); + } + } catch (e) { + print('刷新学习进度失败: $e'); + state = state.copyWith( + isLoading: false, + error: '刷新学习进度失败: $e', + ); + } + } +} + +/// 学习进度Provider +final learningProgressProvider = StateNotifierProvider( + (ref) => LearningProgressNotifier(), +); + +/// 学习进度列表Provider（便捷访问） +final learningProgressListProvider = Provider>((ref) { + return ref.watch(learningProgressProvider).progressList; +}); + +/// 学习进度加载状态Provider +final learningProgressLoadingProvider = Provider((ref) { + return ref.watch(learningProgressProvider).isLoading; +}); diff --git a/client/lib/features/home/screens/home_screen.dart b/client/lib/features/home/screens/home_screen.dart new file mode 100644 index 0000000..d23d39f --- /dev/null +++ b/client/lib/features/home/screens/home_screen.dart @@ -0,0 +1,800 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/routes/app_routes.dart'; +import '../../vocabulary/providers/vocabulary_provider.dart'; +import '../../vocabulary/models/word_model.dart'; +import '../../auth/providers/auth_provider.dart'; +import '../../../shared/providers/notification_provider.dart'; +import '../../../core/services/tts_service.dart'; + +/// 首页界面 +class HomeScreen extends ConsumerStatefulWidget { + const HomeScreen({super.key}); + + @override + ConsumerState createState() => _HomeScreenState(); +} + +class _HomeScreenState extends ConsumerState { + final TTSService _ttsService = TTSService(); + + @override + void initState() { + super.initState(); + // 初始化TTS服务 + _ttsService.initialize(); + + // 页面首帧后触发数据加载（今日单词与统计） + WidgetsBinding.instance.addPostFrameCallback((_) async { + print('=== HomeScreen: 开始加载数据 ==='); + final user = ref.read(currentUserProvider); + print('当前用户: ${user?.username}, ID: ${user?.id}'); + + try { + // 加载未读通知数量 + ref.read(notificationProvider.notifier).loadUnreadCount(); + + // 直接调用 Notifier 的方法 + final notifier = ref.read(vocabularyProvider.notifier); + + print('开始加载今日单词...'); + await notifier.loadTodayStudyWords(userId: user?.id); + print('今日单词加载完成，数量: ${ref.read(todayWordsProvider).length}'); + + print('开始加载统计数据...'); + await notifier.loadUserVocabularyOverallStats(); + await notifier.loadWeeklyStudyStats(); + print('统计数据加载完成'); + } catch (e, stack) { + print('数据加载失败: $e'); + print('堆栈: $stack'); + } + print('=== HomeScreen: 数据加载结束 ==='); + }); + } + + @override + void dispose() { + // 释放TTS资源 + _ttsService.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + body: SafeArea( + child: SingleChildScrollView( + physics: const BouncingScrollPhysics(parent: AlwaysScrollableScrollPhysics()), + child: Column( + children: [ + _buildHeader(), + const SizedBox(height: 20), + _buildQuickActions(context), + const SizedBox(height: 20), + _buildLearningStats(context), + const SizedBox(height: 20), + _buildTodayWords(), + const SizedBox(height: 20), + _buildAIRecommendation(context), + const SizedBox(height: 100), // 底部导航栏空间 + ], + ), + ), + ), + ); + } + + Widget _buildHeader() { + // 直接使用StateNotifierProvider获取认证状态 + final authState = ref.watch(authProvider); + final user = authState.user; + final isAuthenticated = authState.isAuthenticated; + final unreadCount = ref.watch(unreadCountProvider); + final avatarUrl = user?.profile?.avatar ?? user?.avatar; + final displayName = user?.profile?.realName ?? user?.username ?? '未登录用户'; + final motto = user?.profile?.bio ?? '欢迎来到AI英语学习'; + + return GestureDetector( + onTap: () { + // 点击头部跳转：未登录->登录页，已登录->个人中心 + if (isAuthenticated) { + Navigator.pushNamed(context, Routes.profile); + } else { + Navigator.pushNamed(context, Routes.login); + } + }, + child: Container( + padding: const EdgeInsets.all(16), + decoration: const BoxDecoration( + gradient: LinearGradient( + begin: Alignment.topLeft, + end: Alignment.bottomRight, + colors: [Color(0xFF2196F3), Color(0xFF1976D2)], + ), + ), + child: Row( + children: [ + CircleAvatar( + radius: 25, + backgroundColor: Colors.white, + backgroundImage: avatarUrl != null && avatarUrl.isNotEmpty + ? NetworkImage(avatarUrl) + : null, + child: (avatarUrl == null || avatarUrl.isEmpty) + ? Icon( + Icons.person, + color: isAuthenticated ? const Color(0xFF2196F3) : Colors.grey, + size: 24, + ) + : null, + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + displayName, + style: const TextStyle( + color: Colors.white, + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + Text( + motto, + style: const TextStyle( + color: Colors.white70, + fontSize: 14, + ), + ), + ], + ), + ), + Stack( + children: [ + IconButton( + onPressed: () { + // TODO: 跳转到通知页面 + Navigator.pushNamed(context, '/notifications'); + }, + icon: const Icon( + Icons.notifications_outlined, + color: Colors.white, + size: 28, + ), + ), + if (unreadCount > 0) + Positioned( + right: 8, + top: 8, + child: Container( + padding: const EdgeInsets.all(4), + decoration: const BoxDecoration( + color: Colors.red, + shape: BoxShape.circle, + ), + constraints: const BoxConstraints( + minWidth: 18, + minHeight: 18, + ), + child: Text( + unreadCount > 99 ? '99+' : unreadCount.toString(), + style: const TextStyle( + color: Colors.white, + fontSize: 10, + fontWeight: FontWeight.bold, + ), + textAlign: TextAlign.center, + ), + ), + ), + ], + ), + ], + ), + ), + ); + } + + + Widget _buildQuickActions(BuildContext context) { + return Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Padding( + padding: EdgeInsets.only(left: 4, bottom: 12), + child: Text( + '快速功能', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Color(0xFF333333), + ), + ), + ), + Row( + children: [ + Expanded( + child: _buildQuickActionCard( + context, + '智能复习', + '基于记忆曲线', + Icons.psychology, + const Color(0xFF4CAF50), + () => Navigator.pushNamed(context, '/vocabulary/smart-review'), + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildQuickActionCard( + context, + '词汇测试', + '检测学习效果', + Icons.quiz, + const Color(0xFFFF9800), + () => Navigator.pushNamed(context, '/vocabulary/test'), + ), + ), + ], + ), + const SizedBox(height: 12), + Row( + children: [ + Expanded( + child: _buildQuickActionCard( + context, + '生词本', + '收藏重要单词', + Icons.bookmark, + const Color(0xFF9C27B0), + () => Navigator.pushNamed(context, '/vocabulary/word-book'), + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildQuickActionCard( + context, + '学习计划', + '制定学习目标', + Icons.schedule, + const Color(0xFF2196F3), + () => Navigator.pushNamed(context, '/vocabulary/study-plan'), + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildQuickActionCard( + BuildContext context, + String title, + String subtitle, + IconData icon, + Color color, + VoidCallback onTap, + ) { + return GestureDetector( + onTap: onTap, + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + Container( + width: 48, + height: 48, + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(24), + ), + child: Icon( + icon, + color: color, + size: 24, + ), + ), + const SizedBox(height: 12), + Text( + title, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: Color(0xFF333333), + ), + ), + const SizedBox(height: 4), + Text( + subtitle, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ); + } + + Widget _buildLearningStats(BuildContext context) { + final statistics = ref.watch(todayStatisticsProvider); + final dailyStats = ref.watch(dailyVocabularyStatsProvider); + final weeklyStudied = ref.watch(weeklyWordsStudiedProvider); + final overallStats = ref.watch(overallVocabularyStatsProvider) ?? {}; + final user = ref.watch(currentUserProvider); + final todayStudied = dailyStats?.wordsLearned ?? statistics?.wordsStudied ?? 0; + final totalStudied = (overallStats['total_studied'] as int?) ?? 0; + final weeklyGoal = ((user?.settings?.dailyWordGoal ?? 20) * 7); + final progress = weeklyGoal > 0 ? (weeklyStudied / weeklyGoal).clamp(0.0, 1.0) : 0.0; + final progressPercentText = '${(progress * 100).toInt()}%'; + return Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Padding( + padding: const EdgeInsets.only(left: 4, bottom: 12), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '学习统计', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Color(0xFF333333), + ), + ), + GestureDetector( + onTap: () { + Navigator.of(context).pushNamed(Routes.learningStatsDetail); + }, + child: const Text( + '查看详情', + style: TextStyle( + fontSize: 14, + color: Color(0xFF2196F3), + fontWeight: FontWeight.w500, + ), + ), + ), + ], + ), + ), + Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + Row( + children: [ + Expanded( + child: _buildStatCard(todayStudied.toString(), '今日学习', Icons.today, const Color(0xFF4CAF50)), + ), + const SizedBox(width: 12), + Expanded( + child: _buildStatCard(weeklyStudied.toString(), '本周学习', Icons.date_range, const Color(0xFF2196F3)), + ), + const SizedBox(width: 12), + Expanded( + child: _buildStatCard(totalStudied.toString(), '总词汇量', Icons.library_books, const Color(0xFFFF9800)), + ), + ], + ), + const SizedBox(height: 16), + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Row( + children: [ + const Icon( + Icons.trending_up, + color: Color(0xFF2196F3), + size: 24, + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '本周学习进度', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: Color(0xFF333333), + ), + ), + Text( + progressPercentText, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + ], + ), + ), + Container( + width: 60, + height: 6, + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(3), + ), + child: FractionallySizedBox( + alignment: Alignment.centerLeft, + widthFactor: progress, + child: Container( + decoration: BoxDecoration( + color: const Color(0xFF2196F3), + borderRadius: BorderRadius.circular(3), + ), + ), + ), + ), + ], + ), + ), + ], + ), + ), + ], + ), + ); + } + + Widget _buildStatCard(String value, String label, IconData icon, Color color) { + return Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Column( + children: [ + Icon( + icon, + color: color, + size: 20, + ), + const SizedBox(height: 8), + Text( + value, + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: color, + ), + ), + const SizedBox(height: 4), + Text( + label, + style: const TextStyle( + fontSize: 11, + color: Colors.grey, + ), + textAlign: TextAlign.center, + ), + ], + ), + ); + } + + Widget _buildTodayWords() { + final words = ref.watch(todayWordsProvider); + + return Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '今日单词', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + TextButton( + onPressed: () { + Navigator.pushNamed(context, Routes.dailyWords); + }, + child: const Text('查看更多'), + ), + ], + ), + const SizedBox(height: 16), + words.isEmpty + ? Center( + child: Padding( + padding: const EdgeInsets.symmetric(vertical: 20.0), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.book_outlined, + size: 48, + color: Colors.grey[400], + ), + const SizedBox(height: 12), + Text( + '暂无今日单词', + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 8), + TextButton( + onPressed: () async { + // 触发加载今日单词 + final notifier = ref.read(vocabularyProvider.notifier); + final user = ref.read(currentUserProvider); + await notifier.loadTodayStudyWords(userId: user?.id); + }, + child: const Text('加载今日单词'), + ), + ], + ), + ), + ) + : Column( + children: [ + _buildWordItem(words[0]), + if (words.length > 1) ...[ + const SizedBox(height: 12), + _buildWordItem(words[1]), + ], + ], + ), + ], + ), + ); + } + + Widget _buildTodayWordsOld() { + final vocabAsync = ref.watch(vocabularyProvider); + + return Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '今日单词', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + TextButton( + onPressed: () { + Navigator.pushNamed(context, Routes.dailyWords); + }, + child: const Text('查看更多'), + ), + ], + ), + const SizedBox(height: 16), + Builder( + builder: (context) { + final state = ref.watch(vocabularyProvider); + final words = state.todayWords; + if (words.isEmpty) { + return Column( + children: [ + const Icon( + Icons.book_outlined, + size: 48, + color: Colors.grey, + ), + const SizedBox(height: 8), + const Text( + '暂无今日单词', + style: TextStyle(fontSize: 14, color: Colors.grey), + ), + const SizedBox(height: 8), + TextButton( + onPressed: () async { + final user = ref.read(currentUserProvider); + final notifier = ref.read(vocabularyProvider.notifier); + await notifier.loadTodayStudyWords(userId: user?.id); + }, + child: const Text('刷新'), + ), + ], + ); + } + return Column( + children: [ + _buildWordItem(words[0]), + if (words.length > 1) ...[ + const SizedBox(height: 12), + _buildWordItem(words[1]), + ], + ], + ); + }, + ), + ], + ), + ); + } + + Widget _buildWordItem(Word word) { + final meaning = word.definitions.isNotEmpty ? word.definitions.first.definition : ''; + return Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + word.word, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + meaning, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ], + ), + ), + IconButton( + onPressed: () async { + // 播放单词发音 + await _ttsService.speak(word.word); + }, + icon: const Icon( + Icons.volume_up, + color: Color(0xFF2196F3), + size: 24, + ), + ), + ], + ); + } + + Widget _buildAIRecommendation(BuildContext context) { + return GestureDetector( + onTap: () { + Navigator.pushNamed(context, '/ai'); + }, + child: Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Row( + children: [ + Container( + width: 48, + height: 48, + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(24), + ), + child: const Icon( + Icons.smart_toy, + color: Color(0xFF2196F3), + size: 24, + ), + ), + const SizedBox(width: 16), + const Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + 'AI 智能助手', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + SizedBox(height: 4), + Text( + '写作批改 • 口语评估 • 智能推荐\n点击体验AI学习助手', + style: TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + ], + ), + ), + const Icon( + Icons.arrow_forward_ios, + color: Colors.grey, + size: 16, + ), + ], + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/home/screens/learning_stats_detail_screen.dart b/client/lib/features/home/screens/learning_stats_detail_screen.dart new file mode 100644 index 0000000..61a889d --- /dev/null +++ b/client/lib/features/home/screens/learning_stats_detail_screen.dart @@ -0,0 +1,722 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import 'package:fl_chart/fl_chart.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../shared/widgets/custom_app_bar.dart'; +import '../../../shared/widgets/custom_card.dart'; +import '../../vocabulary/models/learning_stats_model.dart'; +import '../../vocabulary/services/learning_stats_service.dart'; +import '../../../core/services/storage_service.dart'; +import '../../../core/network/api_client.dart'; + +/// 学习统计详情页面 +class LearningStatsDetailScreen extends ConsumerStatefulWidget { + const LearningStatsDetailScreen({super.key}); + + @override + ConsumerState createState() => _LearningStatsDetailScreenState(); +} + +class _LearningStatsDetailScreenState extends ConsumerState + with SingleTickerProviderStateMixin { + late TabController _tabController; + LearningStats? _stats; + bool _isLoading = true; + String? _error; + + @override + void initState() { + super.initState(); + _tabController = TabController(length: 3, vsync: this); + _loadStats(); + } + + @override + void dispose() { + _tabController.dispose(); + super.dispose(); + } + + Future _loadStats() async { + try { + setState(() { + _isLoading = true; + _error = null; + }); + + final storageService = await StorageService.getInstance(); + final apiClient = ApiClient.instance; + + final statsService = LearningStatsService( + apiClient: apiClient, + storageService: storageService, + ); + + // 从本地存储加载统计数据 + final stats = await statsService.getUserStats(); + + setState(() { + _stats = stats; + _isLoading = false; + }); + } catch (e) { + print('❌ 加载学习统计失败: $e'); + setState(() { + _error = e.toString(); + _isLoading = false; + }); + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.background, + appBar: CustomAppBar( + title: '学习统计详情', + automaticallyImplyLeading: true, + ), + body: _isLoading + ? const Center(child: CircularProgressIndicator()) + : _error != null + ? _buildErrorWidget() + : _buildContent(), + ); + } + + Widget _buildErrorWidget() { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 64, + color: AppColors.error, + ), + const SizedBox(height: 16), + Text( + '加载失败', + style: Theme.of(context).textTheme.headlineSmall, + ), + const SizedBox(height: 8), + Text( + _error ?? '未知错误', + style: Theme.of(context).textTheme.bodyMedium?.copyWith( + color: AppColors.onSurfaceVariant, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 24), + ElevatedButton( + onPressed: _loadStats, + child: const Text('重试'), + ), + ], + ), + ); + } + + Widget _buildContent() { + if (_stats == null) return const SizedBox.shrink(); + + return Column( + children: [ + _buildOverviewCard(), + const SizedBox(height: 16), + _buildTabBar(), + Expanded( + child: TabBarView( + controller: _tabController, + children: [ + _buildDailyTab(), + _buildWeeklyTab(), + _buildMonthlyTab(), + ], + ), + ), + ], + ); + } + + Widget _buildOverviewCard() { + return Container( + margin: const EdgeInsets.all(16), + child: CustomCard( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '总体统计', + style: Theme.of(context).textTheme.titleLarge?.copyWith( + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 20), + Row( + children: [ + Expanded( + child: _buildOverviewItem( + '学习天数', + '${_stats!.totalStudyDays}', + '天', + Icons.calendar_today, + AppColors.primary, + ), + ), + Expanded( + child: _buildOverviewItem( + '连续学习', + '${_stats!.currentStreak}', + '天', + Icons.local_fire_department, + AppColors.warning, + ), + ), + ], + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildOverviewItem( + '学习单词', + '${_stats!.totalWordsLearned}', + '个', + Icons.school, + AppColors.success, + ), + ), + Expanded( + child: _buildOverviewItem( + '学习时长', + '${_stats!.totalStudyHours.toStringAsFixed(1)}', + '小时', + Icons.access_time, + AppColors.info, + ), + ), + ], + ), + const SizedBox(height: 20), + _buildProgressBar(), + ], + ), + ), + ); + } + + Widget _buildOverviewItem(String title, String value, String unit, IconData icon, Color color) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon(icon, color: color, size: 20), + const SizedBox(width: 8), + Text( + title, + style: Theme.of(context).textTheme.bodySmall?.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + const SizedBox(height: 8), + RichText( + text: TextSpan( + children: [ + TextSpan( + text: value, + style: Theme.of(context).textTheme.headlineSmall?.copyWith( + fontWeight: FontWeight.bold, + color: color, + ), + ), + TextSpan( + text: ' $unit', + style: Theme.of(context).textTheme.bodyMedium?.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ), + ], + ), + ); + } + + Widget _buildProgressBar() { + final progress = _stats!.progressPercentage; + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '本周学习进度', + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.w600, + ), + ), + Text( + '${(progress * 100).toInt()}%', + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + color: AppColors.primary, + ), + ), + ], + ), + const SizedBox(height: 8), + LinearProgressIndicator( + value: progress, + backgroundColor: AppColors.surfaceVariant, + valueColor: AlwaysStoppedAnimation(AppColors.primary), + minHeight: 8, + ), + ], + ); + } + + Widget _buildTabBar() { + return Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + decoration: BoxDecoration( + color: AppColors.surfaceVariant, + borderRadius: BorderRadius.circular(12), + ), + child: TabBar( + controller: _tabController, + indicator: BoxDecoration( + color: AppColors.primary, + borderRadius: BorderRadius.circular(12), + ), + labelColor: Colors.white, + unselectedLabelColor: AppColors.onSurfaceVariant, + tabs: const [ + Tab(text: '每日'), + Tab(text: '每周'), + Tab(text: '每月'), + ], + ), + ); + } + + Widget _buildDailyTab() { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + children: [ + _buildDailyChart(), + const SizedBox(height: 16), + _buildDailyStats(), + ], + ), + ); + } + + Widget _buildWeeklyTab() { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + children: [ + _buildWeeklyChart(), + const SizedBox(height: 16), + _buildWeeklyStats(), + ], + ), + ); + } + + Widget _buildMonthlyTab() { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + children: [ + _buildMonthlyChart(), + const SizedBox(height: 16), + _buildMonthlyStats(), + ], + ), + ); + } + + Widget _buildDailyChart() { + return CustomCard( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '每日学习趋势', + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 20), + SizedBox( + height: 200, + child: LineChart( + LineChartData( + gridData: FlGridData(show: false), + titlesData: FlTitlesData( + leftTitles: AxisTitles( + sideTitles: SideTitles(showTitles: false), + ), + rightTitles: AxisTitles( + sideTitles: SideTitles(showTitles: false), + ), + topTitles: AxisTitles( + sideTitles: SideTitles(showTitles: false), + ), + bottomTitles: AxisTitles( + sideTitles: SideTitles( + showTitles: true, + interval: 1, + getTitlesWidget: (value, meta) { + const days = ['周一', '周二', '周三', '周四', '周五', '周六', '周日']; + final index = value.toInt(); + if (index >= 0 && index < days.length) { + return Padding( + padding: const EdgeInsets.only(top: 8), + child: Text( + days[index], + style: Theme.of(context).textTheme.bodySmall, + ), + ); + } + return const Text(''); + }, + ), + ), + ), + borderData: FlBorderData(show: false), + lineBarsData: [ + LineChartBarData( + spots: _generateDailySpots(), + isCurved: true, + color: AppColors.primary, + barWidth: 3, + dotData: FlDotData(show: true), + belowBarData: BarAreaData( + show: true, + color: AppColors.primary.withOpacity(0.1), + ), + ), + ], + ), + ), + ), + ], + ), + ); + } + + Widget _buildWeeklyChart() { + // 计算最大值，用于设置柱状图的y轴范围 + double maxY = 100; + if (_stats != null && _stats!.monthlyStats.weeklyRecords.isNotEmpty) { + final maxWords = _stats!.monthlyStats.weeklyRecords + .map((r) => r.wordsLearned) + .reduce((a, b) => a > b ? a : b); + maxY = (maxWords * 1.2).ceilToDouble(); // 留有20%的上边距 + if (maxY < 10) maxY = 10; // 最小值10 + } + + return CustomCard( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '每周学习统计', + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 20), + SizedBox( + height: 200, + child: BarChart( + BarChartData( + alignment: BarChartAlignment.spaceAround, + maxY: maxY, + barTouchData: BarTouchData(enabled: false), + titlesData: FlTitlesData( + show: true, + bottomTitles: AxisTitles( + sideTitles: SideTitles( + showTitles: true, + getTitlesWidget: (value, meta) { + const weeks = ['第1周', '第2周', '第3周', '第4周']; + if (value.toInt() >= 0 && value.toInt() < weeks.length) { + return Text( + weeks[value.toInt()], + style: Theme.of(context).textTheme.bodySmall, + ); + } + return const Text(''); + }, + ), + ), + leftTitles: AxisTitles( + sideTitles: SideTitles(showTitles: false), + ), + topTitles: AxisTitles( + sideTitles: SideTitles(showTitles: false), + ), + rightTitles: AxisTitles( + sideTitles: SideTitles(showTitles: false), + ), + ), + borderData: FlBorderData(show: false), + barGroups: _generateWeeklyBars(), + ), + ), + ), + ], + ), + ); + } + + Widget _buildMonthlyChart() { + return CustomCard( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '月度学习分析', + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 20), + SizedBox( + height: 200, + child: PieChart( + PieChartData( + sections: _generatePieChartSections(), + centerSpaceRadius: 40, + sectionsSpace: 2, + ), + ), + ), + ], + ), + ); + } + + Widget _buildDailyStats() { + return CustomCard( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '今日详情', + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + _buildStatRow('学习单词', '${_stats!.weeklyStats.wordsLearned ~/ 7}', '个'), + _buildStatRow('复习单词', '${_stats!.weeklyStats.wordsReviewed ~/ 7}', '个'), + _buildStatRow('学习时长', '${(_stats!.weeklyStats.studyHours / 7).toStringAsFixed(1)}', '小时'), + _buildStatRow('准确率', '${(_stats!.weeklyStats.accuracyRate * 100).toInt()}', '%'), + ], + ), + ); + } + + Widget _buildWeeklyStats() { + return CustomCard( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '本周详情', + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + _buildStatRow('学习天数', '${_stats!.weeklyStats.studyDays}', '天'), + _buildStatRow('学习单词', '${_stats!.weeklyStats.wordsLearned}', '个'), + _buildStatRow('复习单词', '${_stats!.weeklyStats.wordsReviewed}', '个'), + _buildStatRow('学习时长', '${_stats!.weeklyStats.studyHours.toStringAsFixed(1)}', '小时'), + _buildStatRow('准确率', '${(_stats!.weeklyStats.accuracyRate * 100).toInt()}', '%'), + ], + ), + ); + } + + Widget _buildMonthlyStats() { + return CustomCard( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '本月详情', + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + _buildStatRow('学习天数', '${_stats!.monthlyStats.studyDays}', '天'), + _buildStatRow('学习单词', '${_stats!.monthlyStats.wordsLearned}', '个'), + _buildStatRow('复习单词', '${_stats!.monthlyStats.wordsReviewed}', '个'), + _buildStatRow('学习时长', '${(_stats!.monthlyStats.studyTimeMinutes / 60).toStringAsFixed(1)}', '小时'), + _buildStatRow('准确率', '${(_stats!.monthlyStats.accuracyRate * 100).toInt()}', '%'), + _buildStatRow('完成词汇书', '${_stats!.monthlyStats.completedBooks}', '本'), + ], + ), + ); + } + + Widget _buildStatRow(String label, String value, String unit) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 8), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + label, + style: Theme.of(context).textTheme.bodyMedium?.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + RichText( + text: TextSpan( + children: [ + TextSpan( + text: value, + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + color: AppColors.onSurface, + ), + ), + TextSpan( + text: ' $unit', + style: Theme.of(context).textTheme.bodyMedium?.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ), + ], + ), + ); + } + + List _generateDailySpots() { + if (_stats == null || _stats!.weeklyStats.dailyRecords.isEmpty) { + // 如果没有数据，返回空数组 + return []; + } + + // 使用最近7天的真实数据 + final dailyRecords = _stats!.weeklyStats.dailyRecords; + final spots = []; + + // 获取最近7天的记录 + final now = DateTime.now(); + for (int i = 6; i >= 0; i--) { + final targetDate = now.subtract(Duration(days: i)); + final dateStr = '${targetDate.year}-${targetDate.month.toString().padLeft(2, '0')}-${targetDate.day.toString().padLeft(2, '0')}'; + + // 查找该日期的记录 + final record = dailyRecords.where((r) { + final recordDateStr = '${r.date.year}-${r.date.month.toString().padLeft(2, '0')}-${r.date.day.toString().padLeft(2, '0')}'; + return recordDateStr == dateStr; + }).firstOrNull; + + // 添加数据点（x轴：0-6表示周一到周日，y轴：学习单词数） + final wordsCount = record?.wordsLearned.toDouble() ?? 0.0; + spots.add(FlSpot((6 - i).toDouble(), wordsCount)); + } + + return spots; + } + + List _generateWeeklyBars() { + if (_stats == null || _stats!.monthlyStats.weeklyRecords.isEmpty) { + // 如果没有数据，返回空数组 + return []; + } + + // 使用月度统计中的周记录 + final weeklyRecords = _stats!.monthlyStats.weeklyRecords; + final bars = []; + + // 最多显示4周的数据 + for (int i = 0; i < weeklyRecords.length && i < 4; i++) { + final record = weeklyRecords[i]; + bars.add( + BarChartGroupData( + x: i, + barRods: [ + BarChartRodData( + toY: record.wordsLearned.toDouble(), + color: AppColors.primary, + width: 20, + ), + ], + ), + ); + } + + return bars; + } + + List _generatePieChartSections() { + if (_stats == null) { + return []; + } + + // 使用月度统计数据计算比例 + final monthlyStats = _stats!.monthlyStats; + final totalWords = monthlyStats.wordsLearned + monthlyStats.wordsReviewed; + + if (totalWords == 0) { + // 如果没有数据，显示默认状态 + return [ + PieChartSectionData( + color: AppColors.surfaceVariant, + value: 100, + title: '暂无数据', + radius: 60, + titleStyle: const TextStyle(fontSize: 12, fontWeight: FontWeight.bold, color: Colors.white), + ), + ]; + } + + // 计算新学单词和复习单词的比例 + final newWordsPercent = (monthlyStats.wordsLearned / totalWords * 100).toInt(); + final reviewWordsPercent = (monthlyStats.wordsReviewed / totalWords * 100).toInt(); + + return [ + PieChartSectionData( + color: AppColors.primary, + value: monthlyStats.wordsLearned.toDouble(), + title: '新学\n$newWordsPercent%', + radius: 60, + titleStyle: const TextStyle(fontSize: 12, fontWeight: FontWeight.bold, color: Colors.white), + ), + PieChartSectionData( + color: AppColors.success, + value: monthlyStats.wordsReviewed.toDouble(), + title: '复习\n$reviewWordsPercent%', + radius: 60, + titleStyle: const TextStyle(fontSize: 12, fontWeight: FontWeight.bold, color: Colors.white), + ), + ]; + } +} + diff --git a/client/lib/features/home/screens/simple_home_screen.dart b/client/lib/features/home/screens/simple_home_screen.dart new file mode 100644 index 0000000..f805337 --- /dev/null +++ b/client/lib/features/home/screens/simple_home_screen.dart @@ -0,0 +1,54 @@ +import 'package:flutter/material.dart'; + +/// 简化版主页面 - 用于测试应用启动 +class SimpleHomeScreen extends StatelessWidget { + const SimpleHomeScreen({super.key}); + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('AI英语学习平台'), + backgroundColor: Colors.blue, + foregroundColor: Colors.white, + ), + body: const Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.school, + size: 100, + color: Colors.blue, + ), + SizedBox(height: 24), + Text( + '欢迎使用AI英语学习平台', + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + ), + ), + SizedBox(height: 16), + Text( + '智能化英语学习体验', + style: TextStyle( + fontSize: 16, + color: Colors.grey, + ), + ), + SizedBox(height: 32), + Text( + '应用启动成功！', + style: TextStyle( + fontSize: 14, + color: Colors.green, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/home/services/learning_progress_service.dart b/client/lib/features/home/services/learning_progress_service.dart new file mode 100644 index 0000000..cb4c3ce --- /dev/null +++ b/client/lib/features/home/services/learning_progress_service.dart @@ -0,0 +1,88 @@ +import '../../../core/models/api_response.dart'; +import '../../../core/services/enhanced_api_service.dart'; +import '../models/learning_progress_model.dart'; + +/// 学习进度服务 +class LearningProgressService { + static final LearningProgressService _instance = LearningProgressService._internal(); + factory LearningProgressService() => _instance; + LearningProgressService._internal(); + + final EnhancedApiService _enhancedApiService = EnhancedApiService(); + + // 缓存时长配置 + static const Duration _shortCacheDuration = Duration(minutes: 5); + + /// 获取用户学习进度列表 + Future>> getUserLearningProgress({ + int page = 1, + int limit = 20, + }) async { + try { + final response = await _enhancedApiService.get>( + '/user/learning-progress', + queryParameters: { + 'page': page, + 'limit': limit, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final progressList = data['progress'] as List?; + print('=== 学习进度数据解析 ==='); + print('progress字段: $progressList'); + print('数据条数: ${progressList?.length ?? 0}'); + if (progressList == null || progressList.isEmpty) { + // 返回空列表，不使用默认数据 + print('后端返回空数据，显示空状态'); + return []; + } + final result = progressList.map((json) => LearningProgress.fromJson(json)).toList(); + print('解析后的数据条数: ${result.length}'); + return result; + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(message: '获取成功', data: response.data!); + } else { + // 如果API失败，返回空列表 + return ApiResponse.success( + message: '获取失败', + data: [], + ); + } + } catch (e) { + // 出错时返回空列表 + print('获取学习进度异常: $e'); + return ApiResponse.success( + message: '获取失败', + data: [], + ); + } + } + + + /// 获取用户学习统计 + Future>> getUserStats({ + String timeRange = 'all', + }) async { + try { + final response = await _enhancedApiService.get>( + '/user/stats', + queryParameters: { + 'time_range': timeRange, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) => data, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(message: '获取成功', data: response.data!); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取统计数据失败: $e'); + } + } +} diff --git a/client/lib/features/home/widgets/daily_goal_card.dart b/client/lib/features/home/widgets/daily_goal_card.dart new file mode 100644 index 0000000..fd81404 --- /dev/null +++ b/client/lib/features/home/widgets/daily_goal_card.dart @@ -0,0 +1,261 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; + +/// 每日目标卡片组件 +class DailyGoalCard extends StatelessWidget { + const DailyGoalCard({super.key}); + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.track_changes, + color: AppColors.primary, + size: 24, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + '今日目标进度', + style: AppTextStyles.titleMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 单词学习目标 + _buildGoalItem( + icon: Icons.book, + title: '单词学习', + current: 15, + target: 20, + unit: '个', + color: AppColors.primary, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 学习时长目标 + _buildGoalItem( + icon: Icons.timer, + title: '学习时长', + current: 25, + target: 30, + unit: '分钟', + color: AppColors.secondary, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 练习题目标 + _buildGoalItem( + icon: Icons.quiz, + title: '练习题', + current: 8, + target: 10, + unit: '道', + color: AppColors.tertiary, + ), + const SizedBox(height: AppDimensions.spacingLg), + + // 总体进度 + _buildOverallProgress(), + ], + ), + ); + } + + /// 构建目标项 + Widget _buildGoalItem({ + required IconData icon, + required String title, + required int current, + required int target, + required String unit, + required Color color, + }) { + final progress = current / target; + final isCompleted = current >= target; + + return Row( + children: [ + Container( + width: 32, + height: 32, + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Icon( + icon, + color: color, + size: 18, + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + title, + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w500, + ), + ), + Row( + children: [ + Text( + '$current/$target $unit', + style: AppTextStyles.bodySmall.copyWith( + color: isCompleted ? AppColors.success : AppColors.onSurfaceVariant, + fontWeight: FontWeight.w500, + ), + ), + if (isCompleted) ...[ + const SizedBox(width: AppDimensions.spacingXs), + Icon( + Icons.check_circle, + color: AppColors.success, + size: 16, + ), + ] + ], + ), + ], + ), + const SizedBox(height: AppDimensions.spacingXs), + + // 进度条 + Container( + height: 6, + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(3), + ), + child: FractionallySizedBox( + alignment: Alignment.centerLeft, + widthFactor: progress.clamp(0.0, 1.0), + child: Container( + decoration: BoxDecoration( + color: isCompleted ? AppColors.success : color, + borderRadius: BorderRadius.circular(3), + ), + ), + ), + ), + ], + ), + ), + ], + ); + } + + /// 构建总体进度 + Widget _buildOverallProgress() { + const totalProgress = 0.75; // 75% 完成 + + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + gradient: LinearGradient( + begin: Alignment.topLeft, + end: Alignment.bottomRight, + colors: [ + AppColors.primary.withOpacity(0.1), + AppColors.secondary.withOpacity(0.1), + ], + ), + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + border: Border.all( + color: AppColors.primary.withOpacity(0.2), + width: 1, + ), + ), + child: Column( + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '今日完成度', + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.w600, + ), + ), + Text( + '${(totalProgress * 100).toInt()}%', + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.w700, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingSm), + + // 总体进度条 + Container( + height: 8, + decoration: BoxDecoration( + color: AppColors.primary.withOpacity(0.1), + borderRadius: BorderRadius.circular(4), + ), + child: FractionallySizedBox( + alignment: Alignment.centerLeft, + widthFactor: totalProgress, + child: Container( + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [ + AppColors.primary, + AppColors.secondary, + ], + ), + borderRadius: BorderRadius.circular(4), + ), + ), + ), + ), + const SizedBox(height: AppDimensions.spacingSm), + + Text( + totalProgress >= 1.0 + ? '🎉 恭喜！今日目标已完成！' + : '继续加油，距离完成目标还有一点点！', + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + fontStyle: FontStyle.italic, + ), + textAlign: TextAlign.center, + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/home/widgets/learning_stats_card.dart b/client/lib/features/home/widgets/learning_stats_card.dart new file mode 100644 index 0000000..235b20d --- /dev/null +++ b/client/lib/features/home/widgets/learning_stats_card.dart @@ -0,0 +1,352 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; + +/// 学习统计卡片组件 +class LearningStatsCard extends StatelessWidget { + const LearningStatsCard({super.key}); + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.analytics_outlined, + color: AppColors.primary, + size: 24, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + '本周学习数据', + style: AppTextStyles.titleMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingLg), + + // 统计数据网格 + Row( + children: [ + Expanded( + child: _buildStatItem( + title: '学习天数', + value: '5', + unit: '天', + icon: Icons.calendar_today, + color: AppColors.primary, + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + Expanded( + child: _buildStatItem( + title: '学习时长', + value: '2.5', + unit: '小时', + icon: Icons.access_time, + color: AppColors.secondary, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingMd), + + Row( + children: [ + Expanded( + child: _buildStatItem( + title: '掌握单词', + value: '128', + unit: '个', + icon: Icons.psychology, + color: AppColors.success, + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + Expanded( + child: _buildStatItem( + title: '练习题目', + value: '45', + unit: '道', + icon: Icons.quiz, + color: AppColors.warning, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingLg), + + // 学习排名 + _buildRankingSection(), + const SizedBox(height: AppDimensions.spacingLg), + + // 成就徽章 + _buildAchievementSection(), + ], + ), + ); + } + + /// 构建统计项 + Widget _buildStatItem({ + required String title, + required String value, + required String unit, + required IconData icon, + required Color color, + }) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: color.withOpacity(0.05), + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + border: Border.all( + color: color.withOpacity(0.1), + width: 1, + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + icon, + color: color, + size: 20, + ), + const Spacer(), + Container( + padding: const EdgeInsets.symmetric( + horizontal: 6, + vertical: 2, + ), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Text( + '+12%', + style: AppTextStyles.labelSmall.copyWith( + color: color, + fontWeight: FontWeight.w600, + ), + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingSm), + + RichText( + text: TextSpan( + children: [ + TextSpan( + text: value, + style: AppTextStyles.headlineSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w700, + ), + ), + TextSpan( + text: ' $unit', + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ), + const SizedBox(height: AppDimensions.spacingXs), + + Text( + title, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ); + } + + /// 构建排名部分 + Widget _buildRankingSection() { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + gradient: LinearGradient( + begin: Alignment.topLeft, + end: Alignment.bottomRight, + colors: [ + AppColors.primary.withOpacity(0.1), + AppColors.secondary.withOpacity(0.1), + ], + ), + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + border: Border.all( + color: AppColors.primary.withOpacity(0.2), + width: 1, + ), + ), + child: Row( + children: [ + Container( + width: 40, + height: 40, + decoration: BoxDecoration( + color: AppColors.primary, + shape: BoxShape.circle, + ), + child: Icon( + Icons.emoji_events, + color: AppColors.onPrimary, + size: 24, + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '学习排名', + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 2), + Text( + '本周排名第 8 位，超越了 76% 的用户', + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ), + + Text( + '#8', + style: AppTextStyles.headlineSmall.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.w700, + ), + ), + ], + ), + ); + } + + /// 构建成就部分 + Widget _buildAchievementSection() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '最新成就', + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: AppDimensions.spacingSm), + + Row( + children: [ + _buildAchievementBadge( + icon: Icons.local_fire_department, + title: '连续学习', + subtitle: '5天', + color: AppColors.error, + ), + const SizedBox(width: AppDimensions.spacingSm), + _buildAchievementBadge( + icon: Icons.speed, + title: '快速学习', + subtitle: '今日', + color: AppColors.success, + ), + const SizedBox(width: AppDimensions.spacingSm), + _buildAchievementBadge( + icon: Icons.star, + title: '完美答题', + subtitle: '昨日', + color: AppColors.warning, + ), + ], + ), + ], + ); + } + + /// 构建成就徽章 + Widget _buildAchievementBadge({ + required IconData icon, + required String title, + required String subtitle, + required Color color, + }) { + return Expanded( + child: Container( + padding: const EdgeInsets.all(AppDimensions.spacingSm), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusXs), + border: Border.all( + color: color.withOpacity(0.2), + width: 1, + ), + ), + child: Column( + children: [ + Icon( + icon, + color: color, + size: 20, + ), + const SizedBox(height: AppDimensions.spacingXs), + Text( + title, + style: AppTextStyles.labelSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w500, + ), + textAlign: TextAlign.center, + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + Text( + subtitle, + style: AppTextStyles.labelSmall.copyWith( + color: AppColors.onSurfaceVariant, + fontSize: 10, + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/home/widgets/learning_trend_chart.dart b/client/lib/features/home/widgets/learning_trend_chart.dart new file mode 100644 index 0000000..5296041 --- /dev/null +++ b/client/lib/features/home/widgets/learning_trend_chart.dart @@ -0,0 +1,156 @@ +import 'package:flutter/material.dart'; +import 'package:fl_chart/fl_chart.dart'; + +/// 学习趋势图表 +class LearningTrendChart extends StatelessWidget { + final List> weeklyData; + + const LearningTrendChart({ + super.key, + required this.weeklyData, + }); + + @override + Widget build(BuildContext context) { + if (weeklyData.isEmpty) { + return const Center( + child: Text( + '暂无学习数据', + style: TextStyle(color: Colors.grey), + ), + ); + } + + return Container( + height: 200, + padding: const EdgeInsets.all(16), + child: LineChart( + LineChartData( + gridData: FlGridData( + show: true, + drawVerticalLine: false, + horizontalInterval: 20, + getDrawingHorizontalLine: (value) { + return FlLine( + color: Colors.grey.withOpacity(0.1), + strokeWidth: 1, + ); + }, + ), + titlesData: FlTitlesData( + show: true, + rightTitles: const AxisTitles( + sideTitles: SideTitles(showTitles: false), + ), + topTitles: const AxisTitles( + sideTitles: SideTitles(showTitles: false), + ), + bottomTitles: AxisTitles( + sideTitles: SideTitles( + showTitles: true, + reservedSize: 30, + interval: 1, + getTitlesWidget: (value, meta) { + final index = value.toInt(); + if (index < 0 || index >= weeklyData.length) { + return const Text(''); + } + + final date = DateTime.parse(weeklyData[index]['date']); + final dayLabel = ['周一', '周二', '周三', '周四', '周五', '周六', '周日'][date.weekday - 1]; + + return Text( + dayLabel, + style: const TextStyle( + color: Colors.grey, + fontSize: 10, + ), + ); + }, + ), + ), + leftTitles: AxisTitles( + sideTitles: SideTitles( + showTitles: true, + interval: 20, + reservedSize: 35, + getTitlesWidget: (value, meta) { + return Text( + value.toInt().toString(), + style: const TextStyle( + color: Colors.grey, + fontSize: 10, + ), + ); + }, + ), + ), + ), + borderData: FlBorderData( + show: true, + border: Border( + bottom: BorderSide(color: Colors.grey.withOpacity(0.2)), + left: BorderSide(color: Colors.grey.withOpacity(0.2)), + ), + ), + minX: 0, + maxX: (weeklyData.length - 1).toDouble(), + minY: 0, + maxY: _getMaxY(), + lineBarsData: [ + LineChartBarData( + spots: _generateSpots(), + isCurved: true, + gradient: const LinearGradient( + colors: [Color(0xFF2196F3), Color(0xFF1976D2)], + ), + barWidth: 3, + isStrokeCapRound: true, + dotData: FlDotData( + show: true, + getDotPainter: (spot, percent, barData, index) { + return FlDotCirclePainter( + radius: 4, + color: Colors.white, + strokeWidth: 2, + strokeColor: const Color(0xFF2196F3), + ); + }, + ), + belowBarData: BarAreaData( + show: true, + gradient: LinearGradient( + colors: [ + const Color(0xFF2196F3).withOpacity(0.2), + const Color(0xFF2196F3).withOpacity(0.05), + ], + begin: Alignment.topCenter, + end: Alignment.bottomCenter, + ), + ), + ), + ], + ), + ), + ); + } + + List _generateSpots() { + return List.generate( + weeklyData.length, + (index) { + final wordsStudied = (weeklyData[index]['words_studied'] ?? 0) as int; + return FlSpot(index.toDouble(), wordsStudied.toDouble()); + }, + ); + } + + double _getMaxY() { + if (weeklyData.isEmpty) return 100; + + final maxWords = weeklyData.map((data) => (data['words_studied'] ?? 0) as int).reduce((a, b) => a > b ? a : b); + + // 向上取整到最近的10的倍数，并加20作为上边距 + return ((maxWords / 10).ceil() * 10 + 20).toDouble(); + } +} diff --git a/client/lib/features/home/widgets/progress_chart.dart b/client/lib/features/home/widgets/progress_chart.dart new file mode 100644 index 0000000..254bbaa --- /dev/null +++ b/client/lib/features/home/widgets/progress_chart.dart @@ -0,0 +1,387 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; + +/// 进度图表组件 +class ProgressChart extends StatefulWidget { + const ProgressChart({super.key}); + + @override + State createState() => _ProgressChartState(); +} + +class _ProgressChartState extends State + with TickerProviderStateMixin { + late AnimationController _animationController; + late Animation _animation; + + // 模拟数据 + final List _weeklyData = [ + ChartData('周一', 45, AppColors.primary), + ChartData('周二', 60, AppColors.secondary), + ChartData('周三', 30, AppColors.tertiary), + ChartData('周四', 80, AppColors.success), + ChartData('周五', 55, AppColors.warning), + ChartData('周六', 70, AppColors.info), + ChartData('周日', 40, AppColors.error), + ]; + + @override + void initState() { + super.initState(); + _animationController = AnimationController( + duration: const Duration(milliseconds: 1500), + vsync: this, + ); + + _animation = Tween( + begin: 0.0, + end: 1.0, + ).animate(CurvedAnimation( + parent: _animationController, + curve: Curves.easeInOutCubic, + )); + + _animationController.forward(); + } + + @override + void dispose() { + _animationController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Row( + children: [ + Icon( + Icons.trending_up, + color: AppColors.primary, + size: 24, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + '本周学习时长', + style: AppTextStyles.titleMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + + // 时间选择器 + Container( + padding: const EdgeInsets.symmetric( + horizontal: AppDimensions.spacingSm, + vertical: AppDimensions.spacingXs, + ), + decoration: BoxDecoration( + color: AppColors.primary.withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusXs), + ), + child: Text( + '本周', + style: AppTextStyles.labelMedium.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.w500, + ), + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingLg), + + // 总计信息 + _buildSummaryInfo(), + const SizedBox(height: AppDimensions.spacingLg), + + // 图表 + SizedBox( + height: 200, + child: AnimatedBuilder( + animation: _animation, + builder: (context, child) { + return CustomPaint( + size: const Size(double.infinity, 200), + painter: BarChartPainter( + data: _weeklyData, + animationValue: _animation.value, + ), + ); + }, + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 图例 + _buildLegend(), + ], + ), + ); + } + + /// 构建总计信息 + Widget _buildSummaryInfo() { + final totalMinutes = _weeklyData.fold(0, (sum, data) => sum + data.value); + final avgMinutes = totalMinutes / _weeklyData.length; + + return Row( + children: [ + Expanded( + child: _buildSummaryItem( + title: '总时长', + value: '${(totalMinutes / 60).toStringAsFixed(1)}', + unit: '小时', + color: AppColors.primary, + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + Expanded( + child: _buildSummaryItem( + title: '日均时长', + value: avgMinutes.toStringAsFixed(0), + unit: '分钟', + color: AppColors.secondary, + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + Expanded( + child: _buildSummaryItem( + title: '最长单日', + value: _weeklyData.map((e) => e.value).reduce((a, b) => a > b ? a : b).toString(), + unit: '分钟', + color: AppColors.success, + ), + ), + ], + ); + } + + /// 构建总计项 + Widget _buildSummaryItem({ + required String title, + required String value, + required String unit, + required Color color, + }) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingSm), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusXs), + border: Border.all( + color: color.withOpacity(0.2), + width: 1, + ), + ), + child: Column( + children: [ + RichText( + text: TextSpan( + children: [ + TextSpan( + text: value, + style: AppTextStyles.titleLarge.copyWith( + color: color, + fontWeight: FontWeight.w700, + ), + ), + TextSpan( + text: unit, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ), + const SizedBox(height: AppDimensions.spacingXs), + Text( + title, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + textAlign: TextAlign.center, + ), + ], + ), + ); + } + + /// 构建图例 + Widget _buildLegend() { + return Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + _buildLegendItem( + color: AppColors.primary, + label: '目标: 60分钟/天', + ), + const SizedBox(width: AppDimensions.spacingMd), + _buildLegendItem( + color: AppColors.success, + label: '已完成', + ), + ], + ); + } + + /// 构建图例项 + Widget _buildLegendItem({ + required Color color, + required String label, + }) { + return Row( + mainAxisSize: MainAxisSize.min, + children: [ + Container( + width: 12, + height: 12, + decoration: BoxDecoration( + color: color, + borderRadius: BorderRadius.circular(2), + ), + ), + const SizedBox(width: AppDimensions.spacingXs), + Text( + label, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ); + } +} + +/// 图表数据模型 +class ChartData { + final String label; + final int value; + final Color color; + + ChartData(this.label, this.value, this.color); +} + +/// 柱状图绘制器 +class BarChartPainter extends CustomPainter { + final List data; + final double animationValue; + + BarChartPainter({ + required this.data, + required this.animationValue, + }); + + @override + void paint(Canvas canvas, Size size) { + final paint = Paint(); + final maxValue = data.map((e) => e.value).reduce((a, b) => a > b ? a : b).toDouble(); + final barWidth = (size.width - (data.length + 1) * 16) / data.length; + final chartHeight = size.height - 40; // 留出底部标签空间 + + // 绘制网格线 + _drawGridLines(canvas, size, chartHeight); + + // 绘制柱状图 + for (int i = 0; i < data.length; i++) { + final item = data[i]; + final x = 16 + i * (barWidth + 16); + final barHeight = (item.value / maxValue) * chartHeight * animationValue; + final y = chartHeight - barHeight; + + // 绘制柱子 + paint.color = item.color.withOpacity(0.8); + final rect = RRect.fromRectAndRadius( + Rect.fromLTWH(x, y, barWidth, barHeight), + const Radius.circular(4), + ); + canvas.drawRRect(rect, paint); + + // 绘制数值标签 + if (animationValue > 0.8) { + final textPainter = TextPainter( + text: TextSpan( + text: '${item.value}', + style: AppTextStyles.labelSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w500, + ), + ), + textDirection: TextDirection.ltr, + ); + textPainter.layout(); + textPainter.paint( + canvas, + Offset( + x + (barWidth - textPainter.width) / 2, + y - textPainter.height - 4, + ), + ); + } + + // 绘制底部标签 + final labelPainter = TextPainter( + text: TextSpan( + text: item.label, + style: AppTextStyles.labelSmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + textDirection: TextDirection.ltr, + ); + labelPainter.layout(); + labelPainter.paint( + canvas, + Offset( + x + (barWidth - labelPainter.width) / 2, + chartHeight + 8, + ), + ); + } + } + + /// 绘制网格线 + void _drawGridLines(Canvas canvas, Size size, double chartHeight) { + final paint = Paint() + ..color = AppColors.outline.withOpacity(0.1) + ..strokeWidth = 1; + + // 绘制水平网格线 + for (int i = 0; i <= 4; i++) { + final y = chartHeight * i / 4; + canvas.drawLine( + Offset(0, y), + Offset(size.width, y), + paint, + ); + } + } + + @override + bool shouldRepaint(covariant CustomPainter oldDelegate) { + return true; + } +} \ No newline at end of file diff --git a/client/lib/features/home/widgets/quick_actions_grid.dart b/client/lib/features/home/widgets/quick_actions_grid.dart new file mode 100644 index 0000000..3a55e67 --- /dev/null +++ b/client/lib/features/home/widgets/quick_actions_grid.dart @@ -0,0 +1,152 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; + +/// 快捷操作网格组件 +class QuickActionsGrid extends StatelessWidget { + const QuickActionsGrid({super.key}); + + @override + Widget build(BuildContext context) { + return GridView.count( + crossAxisCount: 2, + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + crossAxisSpacing: AppDimensions.spacingMd, + mainAxisSpacing: AppDimensions.spacingMd, + childAspectRatio: 1.2, + children: [ + _buildActionCard( + context: context, + icon: Icons.book_outlined, + title: '单词学习', + subtitle: '智能背词', + color: AppColors.primary, + onTap: () => Navigator.pushNamed(context, '/vocabulary'), + ), + _buildActionCard( + context: context, + icon: Icons.headphones_outlined, + title: '听力训练', + subtitle: '提升听力', + color: AppColors.secondary, + onTap: () => Navigator.pushNamed(context, '/listening'), + ), + _buildActionCard( + context: context, + icon: Icons.article_outlined, + title: '阅读理解', + subtitle: '分级阅读', + color: AppColors.tertiary, + onTap: () => Navigator.pushNamed(context, '/reading'), + ), + _buildActionCard( + context: context, + icon: Icons.edit_outlined, + title: '写作练习', + subtitle: 'AI批改', + color: AppColors.success, + onTap: () => Navigator.pushNamed(context, '/writing'), + ), + _buildActionCard( + context: context, + icon: Icons.mic_outlined, + title: '口语练习', + subtitle: '发音评估', + color: AppColors.warning, + onTap: () => Navigator.pushNamed(context, '/speaking'), + ), + _buildActionCard( + context: context, + icon: Icons.quiz_outlined, + title: '模拟考试', + subtitle: '综合测试', + color: AppColors.info, + onTap: () => Navigator.pushNamed(context, '/exam'), + ), + ], + ); + } + + /// 构建操作卡片 + Widget _buildActionCard({ + required BuildContext context, + required IconData icon, + required String title, + required String subtitle, + required Color color, + required VoidCallback onTap, + }) { + return GestureDetector( + onTap: onTap, + child: Container( + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + border: Border.all( + color: color.withOpacity(0.1), + width: 1, + ), + ), + child: Material( + color: Colors.transparent, + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + child: Padding( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + // 图标容器 + Container( + width: 48, + height: 48, + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + ), + child: Icon( + icon, + color: color, + size: 28, + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 标题 + Text( + title, + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: AppDimensions.spacingXs), + + // 副标题 + Text( + subtitle, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/home/widgets/recent_activities_card.dart b/client/lib/features/home/widgets/recent_activities_card.dart new file mode 100644 index 0000000..6b6018c --- /dev/null +++ b/client/lib/features/home/widgets/recent_activities_card.dart @@ -0,0 +1,250 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; + +/// 最近活动卡片组件 +class RecentActivitiesCard extends StatelessWidget { + const RecentActivitiesCard({super.key}); + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.history, + color: AppColors.primary, + size: 24, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + '最近活动', + style: AppTextStyles.titleMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 活动列表 + ..._buildActivityList(), + ], + ), + ); + } + + /// 构建活动列表 + List _buildActivityList() { + final activities = [ + ActivityItem( + icon: Icons.book_outlined, + title: '完成单词学习', + subtitle: '学习了20个新单词', + time: '2小时前', + color: AppColors.primary, + score: 95, + ), + ActivityItem( + icon: Icons.headphones_outlined, + title: '听力练习', + subtitle: '完成日常英语对话练习', + time: '4小时前', + color: AppColors.secondary, + score: 88, + ), + ActivityItem( + icon: Icons.quiz_outlined, + title: '语法测试', + subtitle: '时态练习测试', + time: '昨天', + color: AppColors.success, + score: 92, + ), + ActivityItem( + icon: Icons.article_outlined, + title: '阅读理解', + subtitle: '科技类文章阅读', + time: '昨天', + color: AppColors.tertiary, + score: 85, + ), + ActivityItem( + icon: Icons.mic_outlined, + title: '口语练习', + subtitle: '日常对话场景训练', + time: '2天前', + color: AppColors.warning, + score: 90, + ), + ]; + + return activities.asMap().entries.map((entry) { + final index = entry.key; + final activity = entry.value; + + return Column( + children: [ + _buildActivityItem(activity), + if (index < activities.length - 1) + const SizedBox(height: AppDimensions.spacingMd), + ], + ); + }).toList(); + } + + /// 构建活动项 + Widget _buildActivityItem(ActivityItem activity) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: activity.color.withOpacity(0.05), + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + border: Border.all( + color: activity.color.withOpacity(0.1), + width: 1, + ), + ), + child: Row( + children: [ + // 图标容器 + Container( + width: 40, + height: 40, + decoration: BoxDecoration( + color: activity.color.withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusXs), + ), + child: Icon( + activity.icon, + color: activity.color, + size: 20, + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + + // 活动信息 + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + activity.title, + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + if (activity.score != null) + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 2, + ), + decoration: BoxDecoration( + color: _getScoreColor(activity.score!).withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusXs), + ), + child: Text( + '${activity.score}分', + style: AppTextStyles.labelSmall.copyWith( + color: _getScoreColor(activity.score!), + fontWeight: FontWeight.w600, + ), + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingXs), + + Text( + activity.subtitle, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + const SizedBox(height: AppDimensions.spacingXs), + + Row( + children: [ + Icon( + Icons.access_time, + color: AppColors.onSurfaceVariant, + size: 14, + ), + const SizedBox(width: AppDimensions.spacingXs), + Text( + activity.time, + style: AppTextStyles.labelSmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ], + ), + ), + + // 箭头图标 + Icon( + Icons.chevron_right, + color: AppColors.onSurfaceVariant, + size: 20, + ), + ], + ), + ); + } + + /// 获取分数颜色 + Color _getScoreColor(int score) { + if (score >= 90) { + return AppColors.success; + } else if (score >= 80) { + return AppColors.warning; + } else if (score >= 70) { + return AppColors.info; + } else { + return AppColors.error; + } + } +} + +/// 活动项数据模型 +class ActivityItem { + final IconData icon; + final String title; + final String subtitle; + final String time; + final Color color; + final int? score; + + ActivityItem({ + required this.icon, + required this.title, + required this.subtitle, + required this.time, + required this.color, + this.score, + }); +} \ No newline at end of file diff --git a/client/lib/features/learning/screens/learning_home_screen.dart b/client/lib/features/learning/screens/learning_home_screen.dart new file mode 100644 index 0000000..0db46c2 --- /dev/null +++ b/client/lib/features/learning/screens/learning_home_screen.dart @@ -0,0 +1,173 @@ +import 'package:flutter/material.dart'; +import '../../../core/routes/app_routes.dart'; + +class LearningHomeScreen extends StatelessWidget { + const LearningHomeScreen({super.key}); + + @override + Widget build(BuildContext context) { + return Scaffold( + body: SafeArea( + child: Padding( + padding: const EdgeInsets.all(16.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 页面标题 + const Text( + '选择学习模块', + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + const SizedBox(height: 8), + const Text( + '选择你想要学习的内容', + style: TextStyle( + fontSize: 16, + color: Colors.grey, + ), + ), + const SizedBox(height: 24), + + // 学习模块网格 + Expanded( + child: GridView.count( + crossAxisCount: 2, + crossAxisSpacing: 16, + mainAxisSpacing: 16, + childAspectRatio: 1.1, + children: [ + _buildModuleCard( + context, + title: '词汇学习', + subtitle: '扩展词汇量', + icon: Icons.book, + color: Colors.blue, + route: Routes.vocabularyHome, + ), + _buildModuleCard( + context, + title: '听力训练', + subtitle: '提升听力技能', + icon: Icons.headphones, + color: Colors.green, + route: Routes.listeningHome, + ), + _buildModuleCard( + context, + title: '阅读理解', + subtitle: '增强阅读能力', + icon: Icons.menu_book, + color: Colors.orange, + route: Routes.readingHome, + ), + _buildModuleCard( + context, + title: '写作练习', + subtitle: '提高写作水平', + icon: Icons.edit, + color: Colors.purple, + route: Routes.writingHome, + ), + _buildModuleCard( + context, + title: '口语练习', + subtitle: '锻炼口语表达', + icon: Icons.mic, + color: Colors.red, + route: Routes.speakingHome, + ), + _buildModuleCard( + context, + title: '综合测试', + subtitle: '全面能力评估', + icon: Icons.quiz, + color: Colors.teal, + route: Routes.comprehensiveTest, + ), + ], + ), + ), + ], + ), + ), + ), + ); + } + + Widget _buildModuleCard( + BuildContext context, { + required String title, + required String subtitle, + required IconData icon, + required Color color, + required String route, + }) { + return Card( + elevation: 4, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: InkWell( + onTap: () { + // 使用根导航器来确保路由正确工作 + Navigator.of(context, rootNavigator: true).pushNamed(route); + }, + borderRadius: BorderRadius.circular(16), + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(16), + gradient: LinearGradient( + begin: Alignment.topLeft, + end: Alignment.bottomRight, + colors: [ + color.withOpacity(0.1), + color.withOpacity(0.05), + ], + ), + ), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: color.withOpacity(0.2), + shape: BoxShape.circle, + ), + child: Icon( + icon, + size: 32, + color: color, + ), + ), + const SizedBox(height: 12), + Text( + title, + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 4), + Text( + subtitle, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/listening/data/listening_static_data.dart b/client/lib/features/listening/data/listening_static_data.dart new file mode 100644 index 0000000..8a9f185 --- /dev/null +++ b/client/lib/features/listening/data/listening_static_data.dart @@ -0,0 +1,447 @@ +import 'package:flutter/material.dart'; +import '../models/listening_exercise_model.dart'; + +/// 听力训练静态数据 +class ListeningStaticData { + /// 获取所有听力练习 + static List getAllExercises() { + return [ + // 日常对话类 + ListeningExercise( + id: 'daily_001', + title: 'At the Restaurant', + description: '在餐厅点餐的日常对话练习', + type: ListeningExerciseType.conversation, + difficulty: ListeningDifficulty.beginner, + audioUrl: 'assets/audio/daily_restaurant.mp3', + duration: 180, + transcript: ''' +A: Good evening! Welcome to our restaurant. How many people are in your party? +B: Good evening! There are four of us. +A: Perfect! Right this way, please. Here's your table. +B: Thank you. Could we see the menu, please? +A: Of course! Here are your menus. Can I start you off with something to drink? +B: I'll have a glass of water, please. +A: And for the others? +C: I'd like a coffee, please. +D: Orange juice for me. +E: I'll have tea, thank you. +A: Excellent! I'll be right back with your drinks. +''', + questions: [ + ListeningQuestion( + id: 'q1', + type: ListeningQuestionType.multipleChoice, + question: 'How many people are in the party?', + options: ['Two', 'Three', 'Four', 'Five'], + correctAnswer: 'Four', + explanation: '对话中明确提到"There are four of us"', + timeStart: 5, + timeEnd: 15, + points: 10, + ), + ListeningQuestion( + id: 'q2', + type: ListeningQuestionType.multipleChoice, + question: 'What does the first customer order to drink?', + options: ['Coffee', 'Water', 'Orange juice', 'Tea'], + correctAnswer: 'Water', + explanation: '第一位顾客说"I\'ll have a glass of water, please"', + timeStart: 45, + timeEnd: 55, + points: 10, + ), + ], + tags: ['日常对话', '餐厅', '点餐'], + thumbnailUrl: 'assets/images/restaurant.jpg', + totalPoints: 20, + passingScore: 0.7, + creatorId: 'system', + creatorName: 'AI英语学习', + isPublic: true, + playCount: 1250, + rating: 4.5, + reviewCount: 89, + createdAt: DateTime.now().subtract(const Duration(days: 30)), + updatedAt: DateTime.now().subtract(const Duration(days: 5)), + ), + + ListeningExercise( + id: 'daily_002', + title: 'Shopping for Clothes', + description: '购买衣服时的对话练习', + type: ListeningExerciseType.dialogue, + difficulty: ListeningDifficulty.elementary, + audioUrl: 'assets/audio/shopping_clothes.mp3', + duration: 240, + transcript: ''' +A: Can I help you find anything today? +B: Yes, I'm looking for a winter coat. +A: What size are you looking for? +B: I think I'm a medium, but I'm not sure. +A: Let me show you our selection. These are very popular this season. +B: I like this blue one. Can I try it on? +A: Of course! The fitting rooms are right over there. +B: Thank you. How much does this cost? +A: That one is \$89.99, but it's on sale for \$69.99. +B: That's a great price! I'll take it. +''', + questions: [ + ListeningQuestion( + id: 'q1', + type: ListeningQuestionType.multipleChoice, + question: 'What is the customer looking for?', + options: ['Summer dress', 'Winter coat', 'Spring jacket', 'Fall sweater'], + correctAnswer: 'Winter coat', + explanation: '顾客说"I\'m looking for a winter coat"', + timeStart: 8, + timeEnd: 18, + points: 10, + ), + ListeningQuestion( + id: 'q2', + type: ListeningQuestionType.fillBlank, + question: 'The coat costs _____ but it\'s on sale for _____.', + options: ['\$89.99', '\$69.99'], + correctAnswer: '\$89.99, \$69.99', + explanation: '店员说原价\$89.99，现在特价\$69.99', + timeStart: 55, + timeEnd: 65, + points: 15, + ), + ], + tags: ['购物', '衣服', '价格'], + thumbnailUrl: 'assets/images/shopping.jpg', + totalPoints: 25, + passingScore: 0.7, + creatorId: 'system', + creatorName: 'AI英语学习', + isPublic: true, + playCount: 980, + rating: 4.3, + reviewCount: 67, + createdAt: DateTime.now().subtract(const Duration(days: 25)), + updatedAt: DateTime.now().subtract(const Duration(days: 3)), + ), + + // 新闻播报类 + ListeningExercise( + id: 'news_001', + title: 'Technology News Update', + description: 'BBC科技新闻播报练习', + type: ListeningExerciseType.news, + difficulty: ListeningDifficulty.intermediate, + audioUrl: 'assets/audio/tech_news.mp3', + duration: 300, + transcript: ''' +Good morning, this is BBC Technology News. Today's top story: +Apple has announced its latest iPhone model, featuring advanced AI capabilities and improved battery life. The new device, expected to launch next month, includes a revolutionary camera system that can automatically adjust settings based on lighting conditions. + +In other tech news, researchers at MIT have developed a new type of solar panel that is 40% more efficient than current models. This breakthrough could significantly reduce the cost of renewable energy and help combat climate change. + +Finally, the European Union has announced new regulations for artificial intelligence, requiring companies to ensure their AI systems are transparent and accountable. The regulations will take effect next year and could impact major tech companies worldwide. + +That's all for today's technology update. I'm Sarah Johnson, BBC News. +''', + questions: [ + ListeningQuestion( + id: 'q1', + type: ListeningQuestionType.multipleChoice, + question: 'What is the main feature of Apple\'s new iPhone?', + options: ['Longer battery life', 'Advanced AI capabilities', 'Better camera', 'All of the above'], + correctAnswer: 'All of the above', + explanation: '新闻中提到了AI功能、电池续航和相机系统的改进', + timeStart: 15, + timeEnd: 35, + points: 15, + ), + ListeningQuestion( + id: 'q2', + type: ListeningQuestionType.multipleChoice, + question: 'How much more efficient are the new solar panels?', + options: ['30%', '40%', '50%', '60%'], + correctAnswer: '40%', + explanation: '新闻中明确提到"40% more efficient"', + timeStart: 60, + timeEnd: 80, + points: 10, + ), + ListeningQuestion( + id: 'q3', + type: ListeningQuestionType.trueFalse, + question: 'The EU AI regulations will take effect immediately.', + options: ['True', 'False'], + correctAnswer: 'False', + explanation: '新闻中说"will take effect next year"，不是立即生效', + timeStart: 120, + timeEnd: 140, + points: 10, + ), + ], + tags: ['新闻', '科技', 'BBC'], + thumbnailUrl: 'assets/images/tech_news.jpg', + totalPoints: 35, + passingScore: 0.75, + creatorId: 'system', + creatorName: 'AI英语学习', + isPublic: true, + playCount: 2100, + rating: 4.7, + reviewCount: 156, + createdAt: DateTime.now().subtract(const Duration(days: 15)), + updatedAt: DateTime.now().subtract(const Duration(days: 1)), + ), + + // 商务英语类 + ListeningExercise( + id: 'business_001', + title: 'Business Meeting Discussion', + description: '商务会议讨论练习', + type: ListeningExerciseType.interview, + difficulty: ListeningDifficulty.advanced, + audioUrl: 'assets/audio/business_meeting.mp3', + duration: 420, + transcript: ''' +Chair: Good morning, everyone. Let's begin today's quarterly review meeting. First, I'd like to hear from Sarah about our sales performance. + +Sarah: Thank you, John. I'm pleased to report that our Q3 sales exceeded expectations by 15%. We've seen particularly strong growth in the Asian markets, with a 25% increase compared to last quarter. + +Chair: That's excellent news. What factors contributed to this growth? + +Sarah: Several factors played a role. Our new product line launched successfully, and our digital marketing campaign reached a wider audience than anticipated. Additionally, the partnership with local distributors in Asia has been very effective. + +Chair: Great work, Sarah. Now, let's discuss our budget allocation for Q4. Michael, could you present the financial projections? + +Michael: Certainly. Based on current trends, we're projecting a 12% revenue increase for Q4. However, we need to consider increased marketing costs and potential supply chain challenges. +''', + questions: [ + ListeningQuestion( + id: 'q1', + type: ListeningQuestionType.multipleChoice, + question: 'By how much did Q3 sales exceed expectations?', + options: ['10%', '15%', '20%', '25%'], + correctAnswer: '15%', + explanation: 'Sarah说"exceeded expectations by 15%"', + timeStart: 25, + timeEnd: 35, + points: 15, + ), + ListeningQuestion( + id: 'q2', + type: ListeningQuestionType.multipleChoice, + question: 'What was the growth rate in Asian markets?', + options: ['15%', '20%', '25%', '30%'], + correctAnswer: '25%', + explanation: 'Sarah提到亚洲市场"25% increase compared to last quarter"', + timeStart: 40, + timeEnd: 50, + points: 15, + ), + ListeningQuestion( + id: 'q3', + type: ListeningQuestionType.shortAnswer, + question: 'What are the three factors that contributed to the sales growth?', + options: [], + correctAnswer: 'New product line, digital marketing campaign, partnership with local distributors', + explanation: 'Sarah提到了三个因素：新产品线、数字营销活动、与当地分销商的合作', + timeStart: 70, + timeEnd: 100, + points: 20, + ), + ], + tags: ['商务', '会议', '销售', '财务'], + thumbnailUrl: 'assets/images/business_meeting.jpg', + totalPoints: 50, + passingScore: 0.8, + creatorId: 'system', + creatorName: 'AI英语学习', + isPublic: true, + playCount: 1560, + rating: 4.6, + reviewCount: 98, + createdAt: DateTime.now().subtract(const Duration(days: 20)), + updatedAt: DateTime.now().subtract(const Duration(days: 2)), + ), + + // 学术讲座类 + ListeningExercise( + id: 'academic_001', + title: 'Climate Change Lecture', + description: '气候变化学术讲座', + type: ListeningExerciseType.lecture, + difficulty: ListeningDifficulty.expert, + audioUrl: 'assets/audio/climate_lecture.mp3', + duration: 600, + transcript: ''' +Professor: Good afternoon, class. Today we'll be discussing the impact of climate change on global ecosystems. As you know, climate change refers to long-term shifts in global temperatures and weather patterns. + +The primary driver of recent climate change is human activity, particularly the emission of greenhouse gases such as carbon dioxide, methane, and nitrous oxide. These gases trap heat in the Earth's atmosphere, leading to what we call the greenhouse effect. + +The consequences of climate change are far-reaching. We're seeing rising sea levels, more frequent extreme weather events, and significant changes in precipitation patterns. These changes affect biodiversity, agriculture, and human settlements worldwide. + +One of the most concerning aspects is the feedback loops that accelerate climate change. For example, as Arctic ice melts, less sunlight is reflected back to space, causing further warming. This is known as the albedo effect. + +To address climate change, we need both mitigation and adaptation strategies. Mitigation involves reducing greenhouse gas emissions, while adaptation means adjusting to the changes that are already occurring. +''', + questions: [ + ListeningQuestion( + id: 'q1', + type: ListeningQuestionType.multipleChoice, + question: 'What is the primary driver of recent climate change?', + options: ['Natural variations', 'Solar activity', 'Human activity', 'Volcanic eruptions'], + correctAnswer: 'Human activity', + explanation: '教授明确说"The primary driver of recent climate change is human activity"', + timeStart: 30, + timeEnd: 45, + points: 15, + ), + ListeningQuestion( + id: 'q2', + type: ListeningQuestionType.multipleChoice, + question: 'What is the albedo effect?', + options: [ + 'Greenhouse gas emissions', + 'Rising sea levels', + 'Reflection of sunlight by ice', + 'Extreme weather events' + ], + correctAnswer: 'Reflection of sunlight by ice', + explanation: '教授解释了当北极冰融化时，反射回太空的阳光减少，这就是反照率效应', + timeStart: 180, + timeEnd: 200, + points: 20, + ), + ListeningQuestion( + id: 'q3', + type: ListeningQuestionType.matching, + question: 'Match the strategies with their definitions:', + options: ['Mitigation', 'Adaptation'], + correctAnswer: 'Mitigation: reducing greenhouse gas emissions; Adaptation: adjusting to changes', + explanation: '教授解释了缓解是减少温室气体排放，适应是调整以应对已经发生的变化', + timeStart: 240, + timeEnd: 260, + points: 25, + ), + ], + tags: ['学术', '气候变化', '环境', '科学'], + thumbnailUrl: 'assets/images/climate_lecture.jpg', + totalPoints: 60, + passingScore: 0.85, + creatorId: 'system', + creatorName: 'AI英语学习', + isPublic: true, + playCount: 890, + rating: 4.8, + reviewCount: 45, + createdAt: DateTime.now().subtract(const Duration(days: 10)), + updatedAt: DateTime.now().subtract(const Duration(days: 1)), + ), + ]; + } + + /// 根据类型获取听力练习 + static List getExercisesByType(ListeningExerciseType type) { + return getAllExercises().where((exercise) => exercise.type == type).toList(); + } + + /// 根据难度获取听力练习 + static List getExercisesByDifficulty(ListeningDifficulty difficulty) { + return getAllExercises().where((exercise) => exercise.difficulty == difficulty).toList(); + } + + /// 获取推荐的听力练习 + static List getRecommendedExercises() { + final allExercises = getAllExercises(); + allExercises.sort((a, b) => b.rating.compareTo(a.rating)); + return allExercises.take(3).toList(); + } + + /// 获取听力材料分类 + static List getCategories() { + return [ + ListeningCategory( + id: 'daily', + name: '日常对话', + description: '日常生活中的对话练习', + icon: Icons.chat, + exerciseCount: getExercisesByType(ListeningExerciseType.conversation).length + + getExercisesByType(ListeningExerciseType.dialogue).length, + type: ListeningExerciseType.conversation, + ), + ListeningCategory( + id: 'news', + name: '新闻播报', + description: '新闻广播和报道练习', + icon: Icons.newspaper, + exerciseCount: getExercisesByType(ListeningExerciseType.news).length, + type: ListeningExerciseType.news, + ), + ListeningCategory( + id: 'business', + name: '商务英语', + description: '商务场景对话练习', + icon: Icons.business, + exerciseCount: getExercisesByType(ListeningExerciseType.interview).length, + type: ListeningExerciseType.interview, + ), + ListeningCategory( + id: 'academic', + name: '学术讲座', + description: '学术讲座和演讲练习', + icon: Icons.school, + exerciseCount: getExercisesByType(ListeningExerciseType.lecture).length, + type: ListeningExerciseType.lecture, + ), + ]; + } + + /// 获取用户统计数据（模拟数据） + static ListeningStatistics getUserStatistics() { + return ListeningStatistics( + userId: 'user_001', + totalExercises: 50, + completedExercises: 25, + totalQuestions: 150, + correctAnswers: 128, + averageScore: 85.3, + totalTimeSpent: 7200, // 2小时 + totalPlayCount: 89, + streakDays: 7, // 连续学习7天 + difficultyStats: { + ListeningDifficulty.beginner: 8, + ListeningDifficulty.elementary: 10, + ListeningDifficulty.intermediate: 5, + ListeningDifficulty.advanced: 2, + ListeningDifficulty.expert: 0, + }, + typeStats: { + ListeningExerciseType.conversation: 12, + ListeningExerciseType.dialogue: 6, + ListeningExerciseType.news: 4, + ListeningExerciseType.interview: 2, + ListeningExerciseType.lecture: 1, + ListeningExerciseType.story: 0, + }, + lastUpdated: DateTime.now(), + ); + } +} + +/// 听力材料分类 +class ListeningCategory { + final String id; + final String name; + final String description; + final IconData icon; + final int exerciseCount; + final ListeningExerciseType type; + + const ListeningCategory({ + required this.id, + required this.name, + required this.description, + required this.icon, + required this.exerciseCount, + required this.type, + }); +} \ No newline at end of file diff --git a/client/lib/features/listening/models/listening_exercise_model.dart b/client/lib/features/listening/models/listening_exercise_model.dart new file mode 100644 index 0000000..7d348f5 --- /dev/null +++ b/client/lib/features/listening/models/listening_exercise_model.dart @@ -0,0 +1,214 @@ +import 'package:json_annotation/json_annotation.dart'; + +part 'listening_exercise_model.g.dart'; + +/// 听力练习类型 +enum ListeningExerciseType { + @JsonValue('conversation') + conversation, + @JsonValue('lecture') + lecture, + @JsonValue('news') + news, + @JsonValue('story') + story, + @JsonValue('interview') + interview, + @JsonValue('dialogue') + dialogue, +} + +/// 听力难度等级 +enum ListeningDifficulty { + @JsonValue('beginner') + beginner, + @JsonValue('elementary') + elementary, + @JsonValue('intermediate') + intermediate, + @JsonValue('advanced') + advanced, + @JsonValue('expert') + expert, +} + +/// 听力问题类型 +enum ListeningQuestionType { + @JsonValue('multiple_choice') + multipleChoice, + @JsonValue('true_false') + trueFalse, + @JsonValue('fill_blank') + fillBlank, + @JsonValue('short_answer') + shortAnswer, + @JsonValue('matching') + matching, +} + +/// 听力练习问题 +@JsonSerializable() +class ListeningQuestion { + final String id; + final ListeningQuestionType type; + final String question; + final List options; + final String correctAnswer; + final String explanation; + final int timeStart; // 音频开始时间（秒） + final int timeEnd; // 音频结束时间（秒） + final int points; + + const ListeningQuestion({ + required this.id, + required this.type, + required this.question, + required this.options, + required this.correctAnswer, + required this.explanation, + required this.timeStart, + required this.timeEnd, + required this.points, + }); + + factory ListeningQuestion.fromJson(Map json) => + _$ListeningQuestionFromJson(json); + + Map toJson() => _$ListeningQuestionToJson(this); +} + +/// 听力练习 +@JsonSerializable() +class ListeningExercise { + final String id; + final String title; + final String description; + final ListeningExerciseType type; + final ListeningDifficulty difficulty; + final String audioUrl; + final int duration; // 音频时长（秒） + final String transcript; + final List questions; + final List tags; + final String thumbnailUrl; + final int totalPoints; + final double passingScore; + final String creatorId; + final String creatorName; + final bool isPublic; + final int playCount; + final double rating; + final int reviewCount; + final DateTime createdAt; + final DateTime updatedAt; + + const ListeningExercise({ + required this.id, + required this.title, + required this.description, + required this.type, + required this.difficulty, + required this.audioUrl, + required this.duration, + required this.transcript, + required this.questions, + required this.tags, + required this.thumbnailUrl, + required this.totalPoints, + required this.passingScore, + required this.creatorId, + required this.creatorName, + required this.isPublic, + required this.playCount, + required this.rating, + required this.reviewCount, + required this.createdAt, + required this.updatedAt, + }); + + factory ListeningExercise.fromJson(Map json) => + _$ListeningExerciseFromJson(json); + + Map toJson() => _$ListeningExerciseToJson(this); +} + +/// 听力练习结果 +@JsonSerializable() +class ListeningExerciseResult { + final String id; + final String exerciseId; + final String userId; + final List userAnswers; + final List correctAnswers; + final int totalQuestions; + final int correctCount; + final double score; + final int timeSpent; // 用时（秒） + final int playCount; // 播放次数 + final bool isPassed; + final DateTime completedAt; + + const ListeningExerciseResult({ + required this.id, + required this.exerciseId, + required this.userId, + required this.userAnswers, + required this.correctAnswers, + required this.totalQuestions, + required this.correctCount, + required this.score, + required this.timeSpent, + required this.playCount, + required this.isPassed, + required this.completedAt, + }); + + factory ListeningExerciseResult.fromJson(Map json) => + _$ListeningExerciseResultFromJson(json); + + Map toJson() => _$ListeningExerciseResultToJson(this); + + double get accuracy => totalQuestions > 0 ? correctCount / totalQuestions : 0.0; +} + +/// 听力学习统计 +@JsonSerializable() +class ListeningStatistics { + final String userId; + final int totalExercises; + final int completedExercises; + final int totalQuestions; + final int correctAnswers; + final double averageScore; + final int totalTimeSpent; // 总用时（秒） + final int totalPlayCount; + final int streakDays; // 连续学习天数 + final Map difficultyStats; + final Map typeStats; + final DateTime lastUpdated; + + const ListeningStatistics({ + required this.userId, + required this.totalExercises, + required this.completedExercises, + required this.totalQuestions, + required this.correctAnswers, + required this.averageScore, + required this.totalTimeSpent, + required this.totalPlayCount, + required this.streakDays, + required this.difficultyStats, + required this.typeStats, + required this.lastUpdated, + }); + + factory ListeningStatistics.fromJson(Map json) => + _$ListeningStatisticsFromJson(json); + + Map toJson() => _$ListeningStatisticsToJson(this); + + double get completionRate => totalExercises > 0 ? completedExercises / totalExercises : 0.0; + double get accuracy => totalQuestions > 0 ? correctAnswers / totalQuestions : 0.0; + double get averageTimePerExercise => completedExercises > 0 ? totalTimeSpent / completedExercises : 0.0; + int get totalStudyTime => (totalTimeSpent / 60).round(); // 转换为分钟 +} \ No newline at end of file diff --git a/client/lib/features/listening/models/listening_exercise_model.g.dart b/client/lib/features/listening/models/listening_exercise_model.g.dart new file mode 100644 index 0000000..1cd8949 --- /dev/null +++ b/client/lib/features/listening/models/listening_exercise_model.g.dart @@ -0,0 +1,190 @@ +// GENERATED CODE - DO NOT MODIFY BY HAND + +part of 'listening_exercise_model.dart'; + +// ************************************************************************** +// JsonSerializableGenerator +// ************************************************************************** + +ListeningQuestion _$ListeningQuestionFromJson(Map json) => + ListeningQuestion( + id: json['id'] as String, + type: $enumDecode(_$ListeningQuestionTypeEnumMap, json['type']), + question: json['question'] as String, + options: + (json['options'] as List).map((e) => e as String).toList(), + correctAnswer: json['correctAnswer'] as String, + explanation: json['explanation'] as String, + timeStart: (json['timeStart'] as num).toInt(), + timeEnd: (json['timeEnd'] as num).toInt(), + points: (json['points'] as num).toInt(), + ); + +Map _$ListeningQuestionToJson(ListeningQuestion instance) => + { + 'id': instance.id, + 'type': _$ListeningQuestionTypeEnumMap[instance.type]!, + 'question': instance.question, + 'options': instance.options, + 'correctAnswer': instance.correctAnswer, + 'explanation': instance.explanation, + 'timeStart': instance.timeStart, + 'timeEnd': instance.timeEnd, + 'points': instance.points, + }; + +const _$ListeningQuestionTypeEnumMap = { + ListeningQuestionType.multipleChoice: 'multiple_choice', + ListeningQuestionType.trueFalse: 'true_false', + ListeningQuestionType.fillBlank: 'fill_blank', + ListeningQuestionType.shortAnswer: 'short_answer', + ListeningQuestionType.matching: 'matching', +}; + +ListeningExercise _$ListeningExerciseFromJson(Map json) => + ListeningExercise( + id: json['id'] as String, + title: json['title'] as String, + description: json['description'] as String, + type: $enumDecode(_$ListeningExerciseTypeEnumMap, json['type']), + difficulty: $enumDecode(_$ListeningDifficultyEnumMap, json['difficulty']), + audioUrl: json['audioUrl'] as String, + duration: (json['duration'] as num).toInt(), + transcript: json['transcript'] as String, + questions: (json['questions'] as List) + .map((e) => ListeningQuestion.fromJson(e as Map)) + .toList(), + tags: (json['tags'] as List).map((e) => e as String).toList(), + thumbnailUrl: json['thumbnailUrl'] as String, + totalPoints: (json['totalPoints'] as num).toInt(), + passingScore: (json['passingScore'] as num).toDouble(), + creatorId: json['creatorId'] as String, + creatorName: json['creatorName'] as String, + isPublic: json['isPublic'] as bool, + playCount: (json['playCount'] as num).toInt(), + rating: (json['rating'] as num).toDouble(), + reviewCount: (json['reviewCount'] as num).toInt(), + createdAt: DateTime.parse(json['createdAt'] as String), + updatedAt: DateTime.parse(json['updatedAt'] as String), + ); + +Map _$ListeningExerciseToJson(ListeningExercise instance) => + { + 'id': instance.id, + 'title': instance.title, + 'description': instance.description, + 'type': _$ListeningExerciseTypeEnumMap[instance.type]!, + 'difficulty': _$ListeningDifficultyEnumMap[instance.difficulty]!, + 'audioUrl': instance.audioUrl, + 'duration': instance.duration, + 'transcript': instance.transcript, + 'questions': instance.questions, + 'tags': instance.tags, + 'thumbnailUrl': instance.thumbnailUrl, + 'totalPoints': instance.totalPoints, + 'passingScore': instance.passingScore, + 'creatorId': instance.creatorId, + 'creatorName': instance.creatorName, + 'isPublic': instance.isPublic, + 'playCount': instance.playCount, + 'rating': instance.rating, + 'reviewCount': instance.reviewCount, + 'createdAt': instance.createdAt.toIso8601String(), + 'updatedAt': instance.updatedAt.toIso8601String(), + }; + +const _$ListeningExerciseTypeEnumMap = { + ListeningExerciseType.conversation: 'conversation', + ListeningExerciseType.lecture: 'lecture', + ListeningExerciseType.news: 'news', + ListeningExerciseType.story: 'story', + ListeningExerciseType.interview: 'interview', + ListeningExerciseType.dialogue: 'dialogue', +}; + +const _$ListeningDifficultyEnumMap = { + ListeningDifficulty.beginner: 'beginner', + ListeningDifficulty.elementary: 'elementary', + ListeningDifficulty.intermediate: 'intermediate', + ListeningDifficulty.advanced: 'advanced', + ListeningDifficulty.expert: 'expert', +}; + +ListeningExerciseResult _$ListeningExerciseResultFromJson( + Map json) => + ListeningExerciseResult( + id: json['id'] as String, + exerciseId: json['exerciseId'] as String, + userId: json['userId'] as String, + userAnswers: (json['userAnswers'] as List) + .map((e) => e as String) + .toList(), + correctAnswers: (json['correctAnswers'] as List) + .map((e) => e as bool) + .toList(), + totalQuestions: (json['totalQuestions'] as num).toInt(), + correctCount: (json['correctCount'] as num).toInt(), + score: (json['score'] as num).toDouble(), + timeSpent: (json['timeSpent'] as num).toInt(), + playCount: (json['playCount'] as num).toInt(), + isPassed: json['isPassed'] as bool, + completedAt: DateTime.parse(json['completedAt'] as String), + ); + +Map _$ListeningExerciseResultToJson( + ListeningExerciseResult instance) => + { + 'id': instance.id, + 'exerciseId': instance.exerciseId, + 'userId': instance.userId, + 'userAnswers': instance.userAnswers, + 'correctAnswers': instance.correctAnswers, + 'totalQuestions': instance.totalQuestions, + 'correctCount': instance.correctCount, + 'score': instance.score, + 'timeSpent': instance.timeSpent, + 'playCount': instance.playCount, + 'isPassed': instance.isPassed, + 'completedAt': instance.completedAt.toIso8601String(), + }; + +ListeningStatistics _$ListeningStatisticsFromJson(Map json) => + ListeningStatistics( + userId: json['userId'] as String, + totalExercises: (json['totalExercises'] as num).toInt(), + completedExercises: (json['completedExercises'] as num).toInt(), + totalQuestions: (json['totalQuestions'] as num).toInt(), + correctAnswers: (json['correctAnswers'] as num).toInt(), + averageScore: (json['averageScore'] as num).toDouble(), + totalTimeSpent: (json['totalTimeSpent'] as num).toInt(), + totalPlayCount: (json['totalPlayCount'] as num).toInt(), + streakDays: (json['streakDays'] as num).toInt(), + difficultyStats: (json['difficultyStats'] as Map).map( + (k, e) => MapEntry( + $enumDecode(_$ListeningDifficultyEnumMap, k), (e as num).toInt()), + ), + typeStats: (json['typeStats'] as Map).map( + (k, e) => MapEntry( + $enumDecode(_$ListeningExerciseTypeEnumMap, k), (e as num).toInt()), + ), + lastUpdated: DateTime.parse(json['lastUpdated'] as String), + ); + +Map _$ListeningStatisticsToJson( + ListeningStatistics instance) => + { + 'userId': instance.userId, + 'totalExercises': instance.totalExercises, + 'completedExercises': instance.completedExercises, + 'totalQuestions': instance.totalQuestions, + 'correctAnswers': instance.correctAnswers, + 'averageScore': instance.averageScore, + 'totalTimeSpent': instance.totalTimeSpent, + 'totalPlayCount': instance.totalPlayCount, + 'streakDays': instance.streakDays, + 'difficultyStats': instance.difficultyStats + .map((k, e) => MapEntry(_$ListeningDifficultyEnumMap[k]!, e)), + 'typeStats': instance.typeStats + .map((k, e) => MapEntry(_$ListeningExerciseTypeEnumMap[k]!, e)), + 'lastUpdated': instance.lastUpdated.toIso8601String(), + }; diff --git a/client/lib/features/listening/providers/listening_provider.dart b/client/lib/features/listening/providers/listening_provider.dart new file mode 100644 index 0000000..4108f1b --- /dev/null +++ b/client/lib/features/listening/providers/listening_provider.dart @@ -0,0 +1,306 @@ +import 'package:flutter/foundation.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/listening_exercise_model.dart'; +import '../services/listening_service.dart'; + +/// 听力训练状态管理提供者 +class ListeningProvider with ChangeNotifier { + final ListeningService _listeningService = ListeningService(); + + // 状态变量 + bool _isLoading = false; + String? _error; + List _exercises = []; + ListeningExercise? _currentExercise; + List _currentQuestions = []; + int _currentQuestionIndex = 0; + Map _userAnswers = {}; + ListeningExerciseResult? _currentResult; + ListeningStatistics? _statistics; + bool _exercisesRequested = false; + bool _statisticsRequested = false; + bool _isPlaying = false; + double _playbackPosition = 0.0; + double _playbackSpeed = 1.0; + bool _showTranscript = false; + + // Getters + bool get isLoading => _isLoading; + String? get error => _error; + List get exercises => _exercises; + ListeningExercise? get currentExercise => _currentExercise; + List get currentQuestions => _currentQuestions; + int get currentQuestionIndex => _currentQuestionIndex; + Map get userAnswers => _userAnswers; + ListeningExerciseResult? get currentResult => _currentResult; + ListeningStatistics? get statistics => _statistics; + bool get isPlaying => _isPlaying; + double get playbackPosition => _playbackPosition; + double get playbackSpeed => _playbackSpeed; + bool get showTranscript => _showTranscript; + bool get exercisesRequested => _exercisesRequested; + bool get statisticsRequested => _statisticsRequested; + + ListeningQuestion? get currentQuestion { + if (_currentQuestionIndex < _currentQuestions.length) { + return _currentQuestions[_currentQuestionIndex]; + } + return null; + } + + bool get hasNextQuestion => _currentQuestionIndex < _currentQuestions.length - 1; + bool get hasPreviousQuestion => _currentQuestionIndex > 0; + bool get isLastQuestion => _currentQuestionIndex == _currentQuestions.length - 1; + + /// 获取听力练习列表 + Future fetchExercises({ + ListeningExerciseType? type, + ListeningDifficulty? difficulty, + int page = 1, + int limit = 20, + bool forceRefresh = false, + }) async { + try { + _exercisesRequested = true; + _setLoading(true); + _clearError(); + + final exercises = await _listeningService.getListeningExercises( + type: type, + difficulty: difficulty, + page: page, + limit: limit, + forceRefresh: forceRefresh, + ); + + if (page == 1) { + _exercises = exercises; + } else { + _exercises.addAll(exercises); + } + + notifyListeners(); + } catch (e) { + _setError('获取听力练习失败: $e'); + } finally { + _setLoading(false); + } + } + + /// 开始听力练习 + Future startExercise(String exerciseId) async { + try { + _setLoading(true); + _clearError(); + + final exercise = await _listeningService.getListeningExercise(exerciseId); + _currentExercise = exercise; + _currentQuestions = exercise.questions; + _currentQuestionIndex = 0; + _userAnswers.clear(); + _currentResult = null; + _playbackPosition = 0.0; + _playbackSpeed = 1.0; + _showTranscript = false; + + notifyListeners(); + } catch (e) { + _setError('加载听力练习失败: $e'); + } finally { + _setLoading(false); + } + } + + /// 回答问题 + void answerQuestion(String questionId, dynamic answer) { + _userAnswers[questionId] = answer; + notifyListeners(); + } + + /// 下一题 + void nextQuestion() { + if (hasNextQuestion) { + _currentQuestionIndex++; + notifyListeners(); + } + } + + /// 上一题 + void previousQuestion() { + if (hasPreviousQuestion) { + _currentQuestionIndex--; + notifyListeners(); + } + } + + /// 跳转到指定题目 + void goToQuestion(int index) { + if (index >= 0 && index < _currentQuestions.length) { + _currentQuestionIndex = index; + notifyListeners(); + } + } + + /// 提交答案 + Future submitAnswers() async { + if (_currentExercise == null) return; + + try { + _setLoading(true); + _clearError(); + + // 需要用户ID和其他参数，这里使用模拟数据 + final result = await _listeningService.submitListeningExercise( + exerciseId: _currentExercise!.id, + userId: 'current_user_id', // 应该从认证状态获取 + userAnswers: _userAnswers.values.map((e) => e.toString()).toList(), + timeSpent: 0, // 应该计算实际时间 + playCount: 1, // 应该记录实际播放次数 + ); + + _currentResult = result; + notifyListeners(); + } catch (e) { + _setError('提交答案失败: $e'); + } finally { + _setLoading(false); + } + } + + /// 获取用户统计数据 + Future fetchStatistics({bool forceRefresh = false}) async { + try { + _statisticsRequested = true; + _setLoading(true); + _clearError(); + + final stats = forceRefresh + ? await _listeningService.getUserListeningStatisticsNoCache() + : await _listeningService.getUserListeningStatistics(); + _statistics = stats; + notifyListeners(); + } catch (e) { + _setError('获取统计数据失败: $e'); + } finally { + _setLoading(false); + } + } + + /// 音频播放控制 + void togglePlayback() { + _isPlaying = !_isPlaying; + notifyListeners(); + } + + void pausePlayback() { + _isPlaying = false; + notifyListeners(); + } + + void resumePlayback() { + _isPlaying = true; + notifyListeners(); + } + + void updatePlaybackPosition(double position) { + _playbackPosition = position; + notifyListeners(); + } + + void setPlaybackSpeed(double speed) { + _playbackSpeed = speed; + notifyListeners(); + } + + void seekTo(double position) { + _playbackPosition = position; + notifyListeners(); + } + + /// 显示/隐藏听力文本 + void toggleTranscript() { + _showTranscript = !_showTranscript; + notifyListeners(); + } + + /// 重置练习 + void resetExercise() { + _currentQuestionIndex = 0; + _userAnswers.clear(); + _currentResult = null; + _playbackPosition = 0.0; + _isPlaying = false; + _showTranscript = false; + notifyListeners(); + } + + /// 清除当前练习 + void clearCurrentExercise() { + _currentExercise = null; + _currentQuestions.clear(); + _currentQuestionIndex = 0; + _userAnswers.clear(); + _currentResult = null; + _playbackPosition = 0.0; + _isPlaying = false; + _showTranscript = false; + notifyListeners(); + } + + /// 搜索练习 + Future searchExercises(String query) async { + try { + _setLoading(true); + _clearError(); + + final exercises = await _listeningService.searchListeningExercises(query: query); + _exercises = exercises; + notifyListeners(); + } catch (e) { + _setError('搜索失败: $e'); + } finally { + _setLoading(false); + } + } + + /// 获取推荐练习 + Future fetchRecommendedExercises() async { + try { + _setLoading(true); + _clearError(); + + final exercises = await _listeningService.getRecommendedListeningExercises(limit: 10); + _exercises = exercises; + notifyListeners(); + } catch (e) { + _setError('获取推荐练习失败: $e'); + } finally { + _setLoading(false); + } + } + + /// 私有方法 + void _setLoading(bool loading) { + _isLoading = loading; + notifyListeners(); + } + + void _setError(String error) { + _error = error; + notifyListeners(); + } + + void _clearError() { + _error = null; + } + + @override + void dispose() { + // 清理资源 + super.dispose(); + } +} + +final listeningProvider = ChangeNotifierProvider((ref) { + return ListeningProvider(); +}); \ No newline at end of file diff --git a/client/lib/features/listening/screens/listening_category_screen.dart b/client/lib/features/listening/screens/listening_category_screen.dart new file mode 100644 index 0000000..031d23a --- /dev/null +++ b/client/lib/features/listening/screens/listening_category_screen.dart @@ -0,0 +1,554 @@ +import 'package:flutter/material.dart'; +import '../../../core/routes/app_routes.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../providers/listening_provider.dart'; +import '../models/listening_exercise_model.dart'; + +class ListeningCategory { + final String id; + final String name; + final String description; + final IconData icon; + final int exerciseCount; + final ListeningExerciseType type; + + const ListeningCategory({ + required this.id, + required this.name, + required this.description, + required this.icon, + required this.exerciseCount, + required this.type, + }); +} + +/// 听力材料分类页面 +class ListeningCategoryScreen extends ConsumerStatefulWidget { + final ListeningCategory category; + + const ListeningCategoryScreen({ + super.key, + required this.category, + }); + + @override + ConsumerState createState() => _ListeningCategoryScreenState(); +} + +class _ListeningCategoryScreenState extends ConsumerState { + String selectedFilter = '全部'; + List filteredExercises = []; + bool _requested = false; + + @override + void initState() { + super.initState(); + _initializeExercises(); + WidgetsBinding.instance.addPostFrameCallback((_) { + if (!_requested) { + _requested = true; + ref.read(listeningProvider).fetchExercises( + type: widget.category.type, + page: 1, + limit: 50, + ); + } + }); + } + + void _initializeExercises() { + setState(() { + filteredExercises = []; + }); + } + + void _applyFilter(String filter) { + setState(() { + selectedFilter = filter; + final allExercises = filteredExercises; + + switch (filter) { + case '全部': + filteredExercises = allExercises; + break; + case '入门': + filteredExercises = allExercises.where((e) => e.difficulty == ListeningDifficulty.beginner).toList(); + break; + case '初级': + filteredExercises = allExercises.where((e) => e.difficulty == ListeningDifficulty.elementary).toList(); + break; + case '中级': + filteredExercises = allExercises.where((e) => e.difficulty == ListeningDifficulty.intermediate).toList(); + break; + case '高级': + filteredExercises = allExercises.where((e) => e.difficulty == ListeningDifficulty.advanced).toList(); + break; + case '专家': + filteredExercises = allExercises.where((e) => e.difficulty == ListeningDifficulty.expert).toList(); + break; + case '最新': + filteredExercises = List.from(allExercises)..sort((a, b) => b.id.compareTo(a.id)); + break; + case '热门': + filteredExercises = List.from(allExercises)..sort((a, b) => b.playCount.compareTo(a.playCount)); + break; + default: + filteredExercises = allExercises; + } + }); + } + + @override + Widget build(BuildContext context) { + + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + backgroundColor: Colors.transparent, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back, color: Colors.black87), + onPressed: () => Navigator.of(context).pop(), + ), + title: Text( + widget.category.name, + style: const TextStyle( + color: Colors.black87, + fontSize: 18, + fontWeight: FontWeight.w600, + ), + ), + centerTitle: true, + ), + body: SingleChildScrollView( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildCategoryHeader(), + const SizedBox(height: 20), + _buildFilterSection(), + const SizedBox(height: 20), + Consumer( + builder: (context, ref, _) { + final lp = ref.watch(listeningProvider); + final all = lp.exercises.where((e) => e.type == widget.category.type).toList(); + final exercises = _applyCurrentFilter(all); + filteredExercises = exercises; + return _buildExercisesList( + context, + exercises, + onRefresh: () async { + await ref.read(listeningProvider).fetchExercises( + type: widget.category.type, + page: 1, + limit: 50, + forceRefresh: true, + ); + }, + ); + }, + ), + const SizedBox(height: 100), // 底部导航栏空间 + ], + ), + ), + ), + ); + } + + Widget _buildCategoryHeader() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Row( + children: [ + Container( + width: 60, + height: 60, + decoration: BoxDecoration( + color: _getTypeColor(widget.category.type).withOpacity(0.1), + borderRadius: BorderRadius.circular(30), + ), + child: Icon( + widget.category.icon, + color: _getTypeColor(widget.category.type), + size: 30, + ), + ), + const SizedBox(width: 16), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + widget.category.name, + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + widget.category.description, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + const SizedBox(height: 8), + Text( + '${filteredExercises.length} 个练习', + style: TextStyle( + fontSize: 12, + color: _getTypeColor(widget.category.type), + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ), + ], + ), + ); + } + + Widget _buildFilterSection() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '筛选条件', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildFilterChip('全部', selectedFilter == '全部'), + ), + const SizedBox(width: 8), + Expanded( + child: _buildFilterChip('入门', selectedFilter == '入门'), + ), + const SizedBox(width: 8), + Expanded( + child: _buildFilterChip('初级', selectedFilter == '初级'), + ), + const SizedBox(width: 8), + Expanded( + child: _buildFilterChip('中级', selectedFilter == '中级'), + ), + ], + ), + const SizedBox(height: 8), + Row( + children: [ + Expanded( + child: _buildFilterChip('高级', selectedFilter == '高级'), + ), + const SizedBox(width: 8), + Expanded( + child: _buildFilterChip('专家', selectedFilter == '专家'), + ), + const SizedBox(width: 8), + Expanded( + child: _buildFilterChip('最新', selectedFilter == '最新'), + ), + const SizedBox(width: 8), + Expanded( + child: _buildFilterChip('热门', selectedFilter == '热门'), + ), + ], + ), + ], + ), + ); + } + + Widget _buildFilterChip(String label, bool isSelected) { + return GestureDetector( + onTap: () => _applyFilter(label), + child: Container( + padding: const EdgeInsets.symmetric(vertical: 8, horizontal: 12), + decoration: BoxDecoration( + color: isSelected ? _getTypeColor(widget.category.type) : Colors.grey[100], + borderRadius: BorderRadius.circular(20), + border: isSelected + ? Border.all( + color: _getTypeColor(widget.category.type), + width: 2, + ) + : null, + ), + child: Text( + label, + textAlign: TextAlign.center, + style: TextStyle( + fontSize: 12, + color: isSelected ? Colors.white : Colors.grey[600], + fontWeight: isSelected ? FontWeight.w500 : FontWeight.normal, + ), + ), + ), + ); + } + + Widget _buildExercisesList(BuildContext context, List exercises, {Future Function()? onRefresh}) { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '练习列表 (${exercises.length})', + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + if (exercises.isEmpty) + Center( + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + const Icon(Icons.inbox, size: 36, color: Colors.grey), + const SizedBox(height: 8), + const Text( + '暂无练习', + style: TextStyle(fontSize: 14, color: Colors.grey), + ), + const SizedBox(height: 12), + ElevatedButton.icon( + onPressed: onRefresh, + icon: const Icon(Icons.refresh, size: 16), + label: const Text('刷新'), + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 10), + ), + ), + ], + ), + ) + else + ...exercises.map((exercise) => _buildExerciseItem(context, exercise)).toList(), + ], + ), + ); + } + + Widget _buildExerciseItem(BuildContext context, ListeningExercise exercise) { + return Container( + margin: const EdgeInsets.only(bottom: 12), + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(12), + border: Border.all(color: Colors.grey[200]!), + ), + child: InkWell( + onTap: () { + Navigator.of(context).pushNamed( + Routes.listeningExerciseDetail, + arguments: {'exerciseId': exercise.id}, + ); + }, + child: Row( + children: [ + Container( + width: 50, + height: 50, + decoration: BoxDecoration( + color: _getTypeColor(widget.category.type).withOpacity(0.1), + borderRadius: BorderRadius.circular(25), + ), + child: const Icon( + Icons.play_arrow, + color: Color(0xFF2196F3), + size: 24, + ), + ), + const SizedBox(width: 16), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + exercise.title, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + exercise.description, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 8), + Row( + children: [ + _buildTag(_getDifficultyText(exercise.difficulty)), + const SizedBox(width: 8), + _buildTag('${exercise.duration ~/ 60}分钟'), + const SizedBox(width: 8), + _buildTag('${exercise.questions.length}题'), + ], + ), + ], + ), + ), + Column( + children: [ + Row( + children: [ + const Icon( + Icons.star, + color: Colors.amber, + size: 16, + ), + const SizedBox(width: 4), + Text( + exercise.rating.toStringAsFixed(1), + style: const TextStyle( + fontSize: 12, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + const SizedBox(height: 4), + Text( + '${exercise.playCount}次播放', + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + ), + ], + ), + ], + ), + ), + ); + } + + Widget _buildTag(String text) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 6, vertical: 2), + decoration: BoxDecoration( + color: _getTypeColor(widget.category.type).withOpacity(0.1), + borderRadius: BorderRadius.circular(4), + ), + child: Text( + text, + style: TextStyle( + fontSize: 10, + color: _getTypeColor(widget.category.type), + fontWeight: FontWeight.w500, + ), + ), + ); + } + + List _applyCurrentFilter(List allExercises) { + switch (selectedFilter) { + case '全部': + return allExercises; + case '入门': + return allExercises.where((e) => e.difficulty == ListeningDifficulty.beginner).toList(); + case '初级': + return allExercises.where((e) => e.difficulty == ListeningDifficulty.elementary).toList(); + case '中级': + return allExercises.where((e) => e.difficulty == ListeningDifficulty.intermediate).toList(); + case '高级': + return allExercises.where((e) => e.difficulty == ListeningDifficulty.advanced).toList(); + case '专家': + return allExercises.where((e) => e.difficulty == ListeningDifficulty.expert).toList(); + case '最新': + return List.from(allExercises)..sort((a, b) => b.updatedAt.compareTo(a.updatedAt)); + case '热门': + return List.from(allExercises)..sort((a, b) => b.playCount.compareTo(a.playCount)); + default: + return allExercises; + } + } + + String _getDifficultyText(ListeningDifficulty difficulty) { + switch (difficulty) { + case ListeningDifficulty.beginner: + return '入门'; + case ListeningDifficulty.elementary: + return '初级'; + case ListeningDifficulty.intermediate: + return '中级'; + case ListeningDifficulty.advanced: + return '高级'; + case ListeningDifficulty.expert: + return '专家'; + } + } + + Color _getTypeColor(ListeningExerciseType type) { + switch (type) { + case ListeningExerciseType.conversation: + return Colors.blue; + case ListeningExerciseType.news: + return Colors.orange; + case ListeningExerciseType.lecture: + return Colors.green; + case ListeningExerciseType.story: + return Colors.purple; + case ListeningExerciseType.interview: + return Colors.red; + case ListeningExerciseType.dialogue: + return Colors.teal; + } + } +} \ No newline at end of file diff --git a/client/lib/features/listening/screens/listening_difficulty_screen.dart b/client/lib/features/listening/screens/listening_difficulty_screen.dart new file mode 100644 index 0000000..839ff09 --- /dev/null +++ b/client/lib/features/listening/screens/listening_difficulty_screen.dart @@ -0,0 +1,361 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/listening_exercise_model.dart'; +// 改为使用后端真实数据，移除静态数据依赖 +import '../../../core/routes/app_routes.dart'; +import '../providers/listening_provider.dart'; + +class ListeningDifficultyScreen extends ConsumerStatefulWidget { + const ListeningDifficultyScreen({Key? key}) : super(key: key); + + @override + ConsumerState createState() => _ListeningDifficultyScreenState(); +} + +class _ListeningDifficultyScreenState extends ConsumerState { + ListeningDifficulty? selectedDifficulty; + + final Map> difficultyInfo = { + ListeningDifficulty.beginner: { + 'title': '初级 (A1-A2)', + 'description': '适合英语初学者，语速较慢，词汇简单', + 'features': ['语速慢', '词汇基础', '发音清晰', '内容简单'], + 'color': Colors.green, + 'icon': Icons.sentiment_very_satisfied, + 'level': 'A1-A2', + }, + ListeningDifficulty.intermediate: { + 'title': '中级 (B1)', + 'description': '适合有一定基础的学习者，语速适中', + 'features': ['语速适中', '词汇丰富', '语法复杂', '话题多样'], + 'color': Colors.orange, + 'icon': Icons.sentiment_satisfied, + 'level': 'B1', + }, + ListeningDifficulty.advanced: { + 'title': '高级 (B2)', + 'description': '适合英语水平较高的学习者，接近自然语速', + 'features': ['语速较快', '词汇高级', '语法复杂', '专业话题'], + 'color': Colors.red, + 'icon': Icons.sentiment_neutral, + 'level': 'B2', + }, + ListeningDifficulty.expert: { + 'title': '专家级 (C1-C2)', + 'description': '适合英语高手，自然语速，复杂内容', + 'features': ['自然语速', '专业词汇', '复杂语法', '学术内容'], + 'color': Colors.purple, + 'icon': Icons.psychology, + 'level': 'C1-C2', + }, + }; + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('选择难度等级'), + backgroundColor: Colors.blue[50], + elevation: 0, + ), + body: Column( + children: [ + // 头部说明 + Container( + width: double.infinity, + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.blue[50], + borderRadius: const BorderRadius.only( + bottomLeft: Radius.circular(20), + bottomRight: Radius.circular(20), + ), + ), + child: Column( + children: [ + Icon( + Icons.tune, + size: 48, + color: Colors.blue[600], + ), + const SizedBox(height: 12), + Text( + '根据你的英语水平选择合适的难度', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.w600, + color: Colors.blue[700], + ), + ), + const SizedBox(height: 8), + Text( + '基于欧洲共同语言参考标准 (CEFR)', + style: TextStyle( + fontSize: 14, + color: Colors.blue[600], + ), + ), + ], + ), + ), + + // 难度选择列表 + Expanded( + child: ListView( + padding: const EdgeInsets.all(16), + children: difficultyInfo.entries.map((entry) { + final difficulty = entry.key; + final info = entry.value; + final isSelected = selectedDifficulty == difficulty; + final exerciseCount = null; + + return Container( + margin: const EdgeInsets.only(bottom: 16), + child: InkWell( + onTap: () { + setState(() { + selectedDifficulty = difficulty; + }); + }, + borderRadius: BorderRadius.circular(16), + child: Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(16), + border: Border.all( + color: isSelected ? info['color'] : Colors.grey[300]!, + width: isSelected ? 2 : 1, + ), + color: isSelected ? info['color'].withOpacity(0.1) : Colors.white, + boxShadow: isSelected + ? [ + BoxShadow( + color: info['color'].withOpacity(0.3), + spreadRadius: 2, + blurRadius: 8, + offset: const Offset(0, 4), + ), + ] + : [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + spreadRadius: 1, + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: info['color'].withOpacity(0.2), + borderRadius: BorderRadius.circular(12), + ), + child: Icon( + info['icon'], + color: info['color'], + size: 24, + ), + ), + const SizedBox(width: 16), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Text( + info['title'], + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: isSelected ? info['color'] : Colors.black87, + ), + ), + const SizedBox(width: 8), + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: info['color'].withOpacity(0.2), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + info['level'], + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.w600, + color: info['color'], + ), + ), + ), + ], + ), + const SizedBox(height: 4), + Text( + '练习数量将基于后端加载', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ), + if (isSelected) + Container( + padding: const EdgeInsets.all(4), + decoration: BoxDecoration( + color: info['color'], + shape: BoxShape.circle, + ), + child: const Icon( + Icons.check, + color: Colors.white, + size: 16, + ), + ), + ], + ), + + const SizedBox(height: 16), + + Text( + info['description'], + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + height: 1.4, + ), + ), + + const SizedBox(height: 16), + + // 特点标签 + Wrap( + spacing: 8, + runSpacing: 8, + children: (info['features'] as List).map((feature) { + return Container( + padding: const EdgeInsets.symmetric( + horizontal: 12, + vertical: 6, + ), + decoration: BoxDecoration( + color: isSelected + ? info['color'].withOpacity(0.2) + : Colors.grey[100], + borderRadius: BorderRadius.circular(16), + border: Border.all( + color: isSelected + ? info['color'].withOpacity(0.3) + : Colors.grey[300]!, + ), + ), + child: Text( + feature, + style: TextStyle( + fontSize: 12, + color: isSelected ? info['color'] : Colors.grey[600], + fontWeight: FontWeight.w500, + ), + ), + ); + }).toList(), + ), + ], + ), + ), + ), + ); + }).toList(), + ), + ), + + // 底部按钮 + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.2), + spreadRadius: 1, + blurRadius: 4, + offset: const Offset(0, -2), + ), + ], + ), + child: Row( + children: [ + Expanded( + child: OutlinedButton( + onPressed: () => Navigator.pop(context), + style: OutlinedButton.styleFrom( + padding: const EdgeInsets.symmetric(vertical: 16), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: const Text('取消'), + ), + ), + const SizedBox(width: 16), + Expanded( + child: ElevatedButton( + onPressed: selectedDifficulty != null + ? () async { + final lp = ref.read(listeningProvider); + await lp.fetchExercises( + difficulty: selectedDifficulty, + page: 1, + limit: 1, + forceRefresh: true, + ); + if (lp.exercises.isNotEmpty) { + final first = lp.exercises.first; + Navigator.pushNamed( + context, + Routes.listeningExerciseDetail, + arguments: {'exerciseId': first.id}, + ); + } else { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('该难度暂无练习材料')), + ); + } + } + : null, + style: ElevatedButton.styleFrom( + padding: const EdgeInsets.symmetric(vertical: 16), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + backgroundColor: selectedDifficulty != null + ? difficultyInfo[selectedDifficulty]!['color'] + : null, + ), + child: const Text( + '开始练习', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + ), + ), + ], + ), + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/listening/screens/listening_exercise_detail_screen.dart b/client/lib/features/listening/screens/listening_exercise_detail_screen.dart new file mode 100644 index 0000000..98c56c5 --- /dev/null +++ b/client/lib/features/listening/screens/listening_exercise_detail_screen.dart @@ -0,0 +1,572 @@ +import 'package:flutter/material.dart'; +import 'package:just_audio/just_audio.dart'; +import '../../../core/routes/app_routes.dart'; +import '../services/listening_service.dart'; +import '../models/listening_exercise_model.dart'; + +class ListeningExerciseDetailScreen extends StatefulWidget { + final String exerciseId; + + const ListeningExerciseDetailScreen({ + Key? key, + required this.exerciseId, + }) : super(key: key); + + @override + State createState() => _ListeningExerciseDetailScreenState(); +} + +class _ListeningExerciseDetailScreenState extends State { + late ListeningExercise exercise; + late AudioPlayer audioPlayer; + bool isPlaying = false; + bool isLoading = true; + Duration currentPosition = Duration.zero; + Duration totalDuration = Duration.zero; + + Map userAnswers = {}; + bool showResults = false; + bool showTranscript = false; + int currentQuestionIndex = 0; + + @override + void initState() { + super.initState(); + audioPlayer = AudioPlayer(); + _loadExercise(); + _setupAudioPlayer(); + } + + void _loadExercise() { + final service = ListeningService(); + service.getListeningExercise(widget.exerciseId).then((ex) { + setState(() { + exercise = ex; + isLoading = false; + }); + }).catchError((e) { + setState(() { + isLoading = false; + }); + }); + } + + void _setupAudioPlayer() { + audioPlayer.playerStateStream.listen((state) { + setState(() { + isPlaying = state.playing; + }); + }); + + audioPlayer.durationStream.listen((duration) { + if (duration != null) { + setState(() { + totalDuration = duration; + }); + } + }); + + audioPlayer.positionStream.listen((position) { + setState(() { + currentPosition = position; + }); + }); + } + + @override + void dispose() { + audioPlayer.dispose(); + super.dispose(); + } + + Future _playPause() async { + if (isPlaying) { + await audioPlayer.pause(); + } else { + try { + await audioPlayer.setUrl(exercise.audioUrl); + await audioPlayer.play(); + } catch (e) { + print('播放音频失败: $e'); + } + } + } + + Future _seekTo(Duration position) async { + await audioPlayer.seek(position); + } + + void _selectAnswer(String questionId, String answer) { + setState(() { + userAnswers[questionId] = answer; + }); + } + + void _submitAnswers() { + final service = ListeningService(); + final answers = exercise.questions.map((q) => userAnswers[q.id] ?? '').toList(); + service.submitListeningExercise( + exerciseId: exercise.id, + userId: 'current_user_id', + userAnswers: answers, + timeSpent: totalDuration.inSeconds, + playCount: 1, + ).then((_) { + setState(() { + showResults = true; + }); + }).catchError((_) { + setState(() { + showResults = true; + }); + }); + } + + void _resetExercise() { + setState(() { + userAnswers.clear(); + showResults = false; + currentQuestionIndex = 0; + showTranscript = false; + }); + audioPlayer.stop(); + } + + int _getScore() { + int correct = 0; + for (var question in exercise.questions) { + if (userAnswers[question.id] == question.correctAnswer) { + correct++; + } + } + return (correct / exercise.questions.length * 100).round(); + } + + String _formatDuration(Duration duration) { + String twoDigits(int n) => n.toString().padLeft(2, '0'); + final minutes = twoDigits(duration.inMinutes.remainder(60)); + final seconds = twoDigits(duration.inSeconds.remainder(60)); + return '$minutes:$seconds'; + } + + @override + Widget build(BuildContext context) { + if (isLoading) { + return const Scaffold( + body: Center(child: CircularProgressIndicator()), + ); + } + + return Scaffold( + appBar: AppBar( + title: Text(exercise.title), + backgroundColor: Colors.blue[50], + elevation: 0, + actions: [ + IconButton( + icon: Icon(showTranscript ? Icons.visibility_off : Icons.visibility), + onPressed: () { + setState(() { + showTranscript = !showTranscript; + }); + }, + tooltip: showTranscript ? '隐藏原文' : '显示原文', + ), + ], + ), + body: Column( + children: [ + // 音频播放器 + _buildAudioPlayer(), + + // 原文显示（可选） + if (showTranscript) _buildTranscript(), + + // 题目区域 + Expanded( + child: showResults ? _buildResults() : _buildQuestions(), + ), + + // 底部操作按钮 + _buildBottomActions(), + ], + ), + ); + } + + Widget _buildAudioPlayer() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.blue[50], + borderRadius: const BorderRadius.only( + bottomLeft: Radius.circular(20), + bottomRight: Radius.circular(20), + ), + ), + child: Column( + children: [ + // 播放控制 + Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + IconButton( + icon: const Icon(Icons.replay_10), + onPressed: () { + final newPosition = currentPosition - const Duration(seconds: 10); + _seekTo(newPosition < Duration.zero ? Duration.zero : newPosition); + }, + ), + IconButton( + icon: Icon(isPlaying ? Icons.pause_circle_filled : Icons.play_circle_filled), + iconSize: 64, + onPressed: _playPause, + ), + IconButton( + icon: const Icon(Icons.forward_10), + onPressed: () { + final newPosition = currentPosition + const Duration(seconds: 10); + _seekTo(newPosition > totalDuration ? totalDuration : newPosition); + }, + ), + ], + ), + + // 进度条 + Column( + children: [ + Slider( + value: currentPosition.inSeconds.toDouble(), + max: totalDuration.inSeconds.toDouble(), + onChanged: (value) { + _seekTo(Duration(seconds: value.toInt())); + }, + ), + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text(_formatDuration(currentPosition)), + Text(_formatDuration(totalDuration)), + ], + ), + ], + ), + ], + ), + ); + } + + Widget _buildTranscript() { + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(12), + border: Border.all(color: Colors.grey[300]!), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon(Icons.text_snippet, color: Colors.blue[600]), + const SizedBox(width: 8), + Text( + '听力原文', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.blue[600], + ), + ), + ], + ), + const SizedBox(height: 12), + Text( + exercise.transcript, + style: const TextStyle( + fontSize: 14, + height: 1.5, + color: Colors.black87, + ), + ), + ], + ), + ); + } + + Widget _buildQuestions() { + return ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: exercise.questions.length, + itemBuilder: (context, index) { + final question = exercise.questions[index]; + return Card( + margin: const EdgeInsets.only(bottom: 16), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '第${index + 1}题', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 8), + Text( + question.question, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 16), + ...question.options.map((option) { + final isSelected = userAnswers[question.id] == option; + return Container( + margin: const EdgeInsets.only(bottom: 8), + child: InkWell( + onTap: () => _selectAnswer(question.id, option), + borderRadius: BorderRadius.circular(8), + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: isSelected ? Colors.blue : Colors.grey[300]!, + width: isSelected ? 2 : 1, + ), + color: isSelected ? Colors.blue[50] : Colors.white, + ), + child: Row( + children: [ + Container( + width: 20, + height: 20, + decoration: BoxDecoration( + shape: BoxShape.circle, + border: Border.all( + color: isSelected ? Colors.blue : Colors.grey[400]!, + width: 2, + ), + color: isSelected ? Colors.blue : Colors.white, + ), + child: isSelected + ? const Icon( + Icons.check, + size: 14, + color: Colors.white, + ) + : null, + ), + const SizedBox(width: 12), + Expanded( + child: Text( + option, + style: TextStyle( + color: isSelected ? Colors.blue[700] : Colors.black87, + fontWeight: isSelected ? FontWeight.w500 : FontWeight.normal, + ), + ), + ), + ], + ), + ), + ), + ); + }).toList(), + ], + ), + ), + ); + }, + ); + } + + Widget _buildResults() { + final score = _getScore(); + return Padding( + padding: const EdgeInsets.all(16), + child: Column( + children: [ + // 分数显示 + Container( + padding: const EdgeInsets.all(24), + decoration: BoxDecoration( + color: score >= 80 ? Colors.green[50] : score >= 60 ? Colors.orange[50] : Colors.red[50], + borderRadius: BorderRadius.circular(16), + border: Border.all( + color: score >= 80 ? Colors.green[200]! : score >= 60 ? Colors.orange[200]! : Colors.red[200]!, + ), + ), + child: Column( + children: [ + Icon( + score >= 80 ? Icons.emoji_events : score >= 60 ? Icons.thumb_up : Icons.refresh, + size: 48, + color: score >= 80 ? Colors.green[600] : score >= 60 ? Colors.orange[600] : Colors.red[600], + ), + const SizedBox(height: 16), + Text( + '得分: $score分', + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + color: score >= 80 ? Colors.green[700] : score >= 60 ? Colors.orange[700] : Colors.red[700], + ), + ), + const SizedBox(height: 8), + Text( + '正确率: ${userAnswers.length > 0 ? (userAnswers.values.where((answer) => exercise.questions.any((q) => q.correctAnswer == answer)).length / exercise.questions.length * 100).round() : 0}%', + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + ), + ), + ], + ), + ), + + const SizedBox(height: 24), + + // 答题详情 + Expanded( + child: ListView.builder( + itemCount: exercise.questions.length, + itemBuilder: (context, index) { + final question = exercise.questions[index]; + final userAnswer = userAnswers[question.id]; + final isCorrect = userAnswer == question.correctAnswer; + + return Card( + margin: const EdgeInsets.only(bottom: 12), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + isCorrect ? Icons.check_circle : Icons.cancel, + color: isCorrect ? Colors.green : Colors.red, + size: 20, + ), + const SizedBox(width: 8), + Text( + '第${index + 1}题', + style: const TextStyle( + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 8), + Text(question.question), + const SizedBox(height: 12), + if (userAnswer != null) ...[ + Text( + '你的答案: $userAnswer', + style: TextStyle( + color: isCorrect ? Colors.green[700] : Colors.red[700], + fontWeight: FontWeight.w500, + ), + ), + if (!isCorrect) ...[ + const SizedBox(height: 4), + Text( + '正确答案: ${question.correctAnswer}', + style: TextStyle( + color: Colors.green[700], + fontWeight: FontWeight.w500, + ), + ), + ], + ] else ...[ + Text( + '未作答', + style: TextStyle( + color: Colors.grey[600], + fontStyle: FontStyle.italic, + ), + ), + const SizedBox(height: 4), + Text( + '正确答案: ${question.correctAnswer}', + style: TextStyle( + color: Colors.green[700], + fontWeight: FontWeight.w500, + ), + ), + ], + ], + ), + ), + ); + }, + ), + ), + ], + ), + ); + } + + Widget _buildBottomActions() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.2), + spreadRadius: 1, + blurRadius: 4, + offset: const Offset(0, -2), + ), + ], + ), + child: showResults + ? Row( + children: [ + Expanded( + child: OutlinedButton( + onPressed: _resetExercise, + child: const Text('重新练习'), + ), + ), + const SizedBox(width: 16), + Expanded( + child: ElevatedButton( + onPressed: () => Navigator.pop(context), + child: const Text('返回'), + ), + ), + ], + ) + : Row( + children: [ + Expanded( + child: OutlinedButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + ), + const SizedBox(width: 16), + Expanded( + child: ElevatedButton( + onPressed: userAnswers.length == exercise.questions.length + ? _submitAnswers + : null, + child: const Text('提交答案'), + ), + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/listening/screens/listening_exercise_screen.dart b/client/lib/features/listening/screens/listening_exercise_screen.dart new file mode 100644 index 0000000..398a397 --- /dev/null +++ b/client/lib/features/listening/screens/listening_exercise_screen.dart @@ -0,0 +1,773 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../models/listening_exercise_model.dart'; +import '../providers/listening_provider.dart'; +import '../../../shared/widgets/loading_widget.dart'; + +/// 听力练习详情页面 +class ListeningExerciseScreen extends StatefulWidget { + final String exerciseId; + + const ListeningExerciseScreen({ + super.key, + required this.exerciseId, + }); + + @override + State createState() => _ListeningExerciseScreenState(); +} + +class _ListeningExerciseScreenState extends State { + bool _showTranscript = false; + bool _isSubmitted = false; + + @override + void initState() { + super.initState(); + WidgetsBinding.instance.addPostFrameCallback((_) { + context.read().startExercise(widget.exerciseId); + }); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('听力练习'), + backgroundColor: Theme.of(context).colorScheme.primary, + foregroundColor: Theme.of(context).colorScheme.onPrimary, + actions: [ + Consumer( + builder: (context, provider, child) { + if (provider.currentExercise == null) return const SizedBox(); + return IconButton( + icon: Icon(_showTranscript ? Icons.visibility_off : Icons.visibility), + onPressed: () { + setState(() { + _showTranscript = !_showTranscript; + }); + }, + tooltip: _showTranscript ? '隐藏文本' : '显示文本', + ); + }, + ), + ], + ), + body: Consumer( + builder: (context, provider, child) { + if (provider.isLoading && provider.currentExercise == null) { + return const LoadingWidget(message: '加载练习中...'); + } + + if (provider.error != null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 64, + color: Colors.red[300], + ), + const SizedBox(height: 16), + Text( + '加载失败', + style: Theme.of(context).textTheme.headlineSmall, + ), + const SizedBox(height: 8), + Text( + provider.error!, + textAlign: TextAlign.center, + style: const TextStyle(color: Colors.grey), + ), + const SizedBox(height: 24), + ElevatedButton( + onPressed: () { + provider.startExercise(widget.exerciseId); + }, + child: const Text('重试'), + ), + ], + ), + ); + } + + final exercise = provider.currentExercise; + if (exercise == null) { + return const Center( + child: Text('练习不存在'), + ); + } + + if (provider.currentResult != null && _isSubmitted) { + return _buildResultView(provider.currentResult!); + } + + return Column( + children: [ + _buildExerciseHeader(exercise), + _buildAudioPlayer(provider), + if (_showTranscript) _buildTranscript(exercise), + Expanded( + child: _buildQuestionView(provider), + ), + _buildBottomControls(provider), + ], + ); + }, + ), + ); + } + + Widget _buildExerciseHeader(ListeningExercise exercise) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Theme.of(context).colorScheme.primaryContainer, + borderRadius: const BorderRadius.only( + bottomLeft: Radius.circular(16), + bottomRight: Radius.circular(16), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + exercise.title, + style: Theme.of(context).textTheme.headlineSmall?.copyWith( + color: Theme.of(context).colorScheme.onPrimaryContainer, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + Row( + children: [ + _buildInfoChip( + _getDifficultyDisplayName(exercise.difficulty), + _getDifficultyColor(exercise.difficulty), + ), + const SizedBox(width: 8), + _buildInfoChip( + _getTypeDisplayName(exercise.type), + Theme.of(context).colorScheme.secondary, + ), + const SizedBox(width: 8), + _buildInfoChip( + '${exercise.duration}s', + Colors.grey[600]!, + ), + ], + ), + if (exercise.description.isNotEmpty) ...[ + const SizedBox(height: 12), + Text( + exercise.description, + style: TextStyle( + color: Theme.of(context).colorScheme.onPrimaryContainer.withOpacity(0.8), + ), + ), + ], + ], + ), + ); + } + + Widget _buildInfoChip(String label, Color color) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.2), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: color.withOpacity(0.5)), + ), + child: Text( + label, + style: TextStyle( + color: color, + fontSize: 12, + fontWeight: FontWeight.w500, + ), + ), + ); + } + + Widget _buildAudioPlayer(ListeningProvider provider) { + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Theme.of(context).colorScheme.surface, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.1), + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + IconButton( + onPressed: () { + // TODO: 实现后退15秒 + }, + icon: const Icon(Icons.replay_10), + iconSize: 32, + ), + const SizedBox(width: 16), + IconButton( + onPressed: () { + provider.togglePlayback(); + }, + icon: Icon( + provider.isPlaying ? Icons.pause_circle_filled : Icons.play_circle_filled, + size: 64, + ), + color: Theme.of(context).colorScheme.primary, + ), + const SizedBox(width: 16), + IconButton( + onPressed: () { + // TODO: 实现前进15秒 + }, + icon: const Icon(Icons.forward_10), + iconSize: 32, + ), + ], + ), + const SizedBox(height: 16), + Row( + children: [ + Text( + _formatDuration(provider.playbackPosition), + style: const TextStyle(fontSize: 12), + ), + Expanded( + child: Slider( + value: provider.playbackPosition, + max: provider.currentExercise?.duration.toDouble() ?? 100.0, + onChanged: (value) { + provider.seekTo(value); + }, + ), + ), + Text( + _formatDuration(provider.currentExercise?.duration.toDouble() ?? 0), + style: const TextStyle(fontSize: 12), + ), + ], + ), + const SizedBox(height: 8), + Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + const Text('播放速度: '), + DropdownButton( + value: provider.playbackSpeed, + items: const [ + DropdownMenuItem(value: 0.5, child: Text('0.5x')), + DropdownMenuItem(value: 0.75, child: Text('0.75x')), + DropdownMenuItem(value: 1.0, child: Text('1.0x')), + DropdownMenuItem(value: 1.25, child: Text('1.25x')), + DropdownMenuItem(value: 1.5, child: Text('1.5x')), + ], + onChanged: (value) { + if (value != null) { + provider.setPlaybackSpeed(value); + } + }, + ), + ], + ), + ], + ), + ); + } + + Widget _buildTranscript(ListeningExercise exercise) { + return Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Theme.of(context).colorScheme.surfaceVariant.withOpacity(0.5), + borderRadius: BorderRadius.circular(12), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.text_snippet, + color: Theme.of(context).colorScheme.primary, + ), + const SizedBox(width: 8), + Text( + '听力文本', + style: TextStyle( + fontWeight: FontWeight.bold, + color: Theme.of(context).colorScheme.primary, + ), + ), + ], + ), + const SizedBox(height: 12), + Text( + exercise.transcript, + style: const TextStyle( + fontSize: 16, + height: 1.5, + ), + ), + ], + ), + ); + } + + Widget _buildQuestionView(ListeningProvider provider) { + final question = provider.currentQuestion; + if (question == null) { + return const Center( + child: Text('没有问题'), + ); + } + + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildQuestionProgress(provider), + const SizedBox(height: 24), + _buildQuestionContent(question, provider), + ], + ), + ); + } + + Widget _buildQuestionProgress(ListeningProvider provider) { + final current = provider.currentQuestionIndex + 1; + final total = provider.currentQuestions.length; + final progress = current / total; + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '问题 $current / $total', + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.w500, + ), + ), + Text( + '${(progress * 100).toInt()}%', + style: TextStyle( + color: Theme.of(context).colorScheme.primary, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 8), + LinearProgressIndicator( + value: progress, + backgroundColor: Colors.grey[300], + valueColor: AlwaysStoppedAnimation( + Theme.of(context).colorScheme.primary, + ), + ), + ], + ); + } + + Widget _buildQuestionContent(ListeningQuestion question, ListeningProvider provider) { + return Card( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + question.question, + style: const TextStyle( + fontSize: 18, + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 16), + _buildAnswerOptions(question, provider), + ], + ), + ), + ); + } + + Widget _buildAnswerOptions(ListeningQuestion question, ListeningProvider provider) { + final userAnswer = provider.userAnswers[question.id]; + + switch (question.type) { + case ListeningQuestionType.multipleChoice: + return Column( + children: question.options.asMap().entries.map((entry) { + final index = entry.key; + final option = entry.value; + final isSelected = userAnswer == index; + + return Padding( + padding: const EdgeInsets.only(bottom: 8), + child: InkWell( + onTap: () { + provider.answerQuestion(question.id, index); + }, + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + border: Border.all( + color: isSelected + ? Theme.of(context).colorScheme.primary + : Colors.grey[300]!, + width: isSelected ? 2 : 1, + ), + borderRadius: BorderRadius.circular(8), + color: isSelected + ? Theme.of(context).colorScheme.primary.withOpacity(0.1) + : null, + ), + child: Row( + children: [ + Container( + width: 24, + height: 24, + decoration: BoxDecoration( + shape: BoxShape.circle, + border: Border.all( + color: isSelected + ? Theme.of(context).colorScheme.primary + : Colors.grey[400]!, + ), + color: isSelected + ? Theme.of(context).colorScheme.primary + : null, + ), + child: isSelected + ? Icon( + Icons.check, + size: 16, + color: Theme.of(context).colorScheme.onPrimary, + ) + : null, + ), + const SizedBox(width: 12), + Expanded( + child: Text( + '${String.fromCharCode(65 + index)}. $option', + style: TextStyle( + color: isSelected + ? Theme.of(context).colorScheme.primary + : null, + fontWeight: isSelected ? FontWeight.w500 : null, + ), + ), + ), + ], + ), + ), + ), + ); + }).toList(), + ); + + case ListeningQuestionType.trueFalse: + return Row( + children: [ + Expanded( + child: _buildTrueFalseOption('正确', true, userAnswer, provider, question.id), + ), + const SizedBox(width: 16), + Expanded( + child: _buildTrueFalseOption('错误', false, userAnswer, provider, question.id), + ), + ], + ); + + case ListeningQuestionType.fillBlank: + return TextField( + decoration: const InputDecoration( + hintText: '请输入答案...', + border: OutlineInputBorder(), + ), + onChanged: (value) { + provider.answerQuestion(question.id, value); + }, + ); + + case ListeningQuestionType.shortAnswer: + return TextField( + maxLines: 3, + decoration: const InputDecoration( + hintText: '请输入您的答案...', + border: OutlineInputBorder(), + ), + onChanged: (value) { + provider.answerQuestion(question.id, value); + }, + ); + + case ListeningQuestionType.matching: + // TODO: 实现匹配题 + return const Text('匹配题功能开发中...'); + } + } + + Widget _buildTrueFalseOption( + String label, + bool value, + dynamic userAnswer, + ListeningProvider provider, + String questionId, + ) { + final isSelected = userAnswer == value; + + return InkWell( + onTap: () { + provider.answerQuestion(questionId, value); + }, + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + border: Border.all( + color: isSelected + ? Theme.of(context).colorScheme.primary + : Colors.grey[300]!, + width: isSelected ? 2 : 1, + ), + borderRadius: BorderRadius.circular(8), + color: isSelected + ? Theme.of(context).colorScheme.primary.withOpacity(0.1) + : null, + ), + child: Center( + child: Text( + label, + style: TextStyle( + color: isSelected + ? Theme.of(context).colorScheme.primary + : null, + fontWeight: isSelected ? FontWeight.bold : null, + ), + ), + ), + ), + ); + } + + Widget _buildBottomControls(ListeningProvider provider) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Theme.of(context).colorScheme.surface, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.1), + blurRadius: 4, + offset: const Offset(0, -2), + ), + ], + ), + child: Row( + children: [ + if (provider.hasPreviousQuestion) + Expanded( + child: OutlinedButton( + onPressed: () { + provider.previousQuestion(); + }, + child: const Text('上一题'), + ), + ), + if (provider.hasPreviousQuestion && provider.hasNextQuestion) + const SizedBox(width: 16), + if (provider.hasNextQuestion) + Expanded( + child: ElevatedButton( + onPressed: () { + provider.nextQuestion(); + }, + child: const Text('下一题'), + ), + ), + if (provider.isLastQuestion) + Expanded( + child: ElevatedButton( + onPressed: provider.isLoading + ? null + : () async { + await provider.submitAnswers(); + setState(() { + _isSubmitted = true; + }); + }, + child: provider.isLoading + ? const SizedBox( + width: 20, + height: 20, + child: CircularProgressIndicator(strokeWidth: 2), + ) + : const Text('提交答案'), + ), + ), + ], + ), + ); + } + + Widget _buildResultView(ListeningExerciseResult result) { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + children: [ + Card( + child: Padding( + padding: const EdgeInsets.all(24), + child: Column( + children: [ + Icon( + result.isPassed ? Icons.check_circle : Icons.cancel, + size: 64, + color: result.isPassed ? Colors.green : Colors.red, + ), + const SizedBox(height: 16), + Text( + result.isPassed ? '恭喜通过!' : '继续努力!', + style: Theme.of(context).textTheme.headlineSmall?.copyWith( + color: result.isPassed ? Colors.green : Colors.red, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 24), + _buildResultItem('得分', '${result.score.toStringAsFixed(1)}%'), + _buildResultItem('正确题数', '${result.correctCount}/${result.totalQuestions}'), + _buildResultItem('用时', '${result.timeSpent} 秒'), + _buildResultItem('播放次数', '${result.playCount} 次'), + ], + ), + ), + ), + const SizedBox(height: 24), + Row( + children: [ + Expanded( + child: OutlinedButton( + onPressed: () { + context.read().resetExercise(); + setState(() { + _isSubmitted = false; + }); + }, + child: const Text('重新练习'), + ), + ), + const SizedBox(width: 16), + Expanded( + child: ElevatedButton( + onPressed: () { + Navigator.pop(context); + }, + child: const Text('返回'), + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildResultItem(String label, String value) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 8), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + label, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.w500, + ), + ), + Text( + value, + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Theme.of(context).colorScheme.primary, + ), + ), + ], + ), + ); + } + + String _formatDuration(double seconds) { + final duration = Duration(seconds: seconds.toInt()); + final minutes = duration.inMinutes; + final remainingSeconds = duration.inSeconds % 60; + return '${minutes.toString().padLeft(2, '0')}:${remainingSeconds.toString().padLeft(2, '0')}'; + } + + String _getDifficultyDisplayName(ListeningDifficulty difficulty) { + switch (difficulty) { + case ListeningDifficulty.beginner: + return '初级'; + case ListeningDifficulty.elementary: + return '基础'; + case ListeningDifficulty.intermediate: + return '中级'; + case ListeningDifficulty.advanced: + return '高级'; + case ListeningDifficulty.expert: + return '专家'; + } + } + + String _getTypeDisplayName(ListeningExerciseType type) { + switch (type) { + case ListeningExerciseType.conversation: + return '对话'; + case ListeningExerciseType.lecture: + return '讲座'; + case ListeningExerciseType.news: + return '新闻'; + case ListeningExerciseType.story: + return '故事'; + case ListeningExerciseType.interview: + return '访谈'; + case ListeningExerciseType.dialogue: + return '对话'; + } + } + + Color _getDifficultyColor(ListeningDifficulty difficulty) { + switch (difficulty) { + case ListeningDifficulty.beginner: + return Colors.green; + case ListeningDifficulty.elementary: + return Colors.lightGreen; + case ListeningDifficulty.intermediate: + return Colors.orange; + case ListeningDifficulty.advanced: + return Colors.red; + case ListeningDifficulty.expert: + return Colors.purple; + } + } +} \ No newline at end of file diff --git a/client/lib/features/listening/screens/listening_home_screen.dart b/client/lib/features/listening/screens/listening_home_screen.dart new file mode 100644 index 0000000..418db0a --- /dev/null +++ b/client/lib/features/listening/screens/listening_home_screen.dart @@ -0,0 +1,547 @@ +import 'package:flutter/material.dart'; +import '../../../core/routes/app_routes.dart'; +import '../models/listening_exercise_model.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../providers/listening_provider.dart'; + +/// 听力训练主页面 +class ListeningHomeScreen extends ConsumerStatefulWidget { + const ListeningHomeScreen({super.key}); + + @override + ConsumerState createState() => _ListeningHomeScreenState(); +} + +class _ListeningHomeScreenState extends ConsumerState { + @override + void initState() { + super.initState(); + WidgetsBinding.instance.addPostFrameCallback((_) { + final lp = ref.read(listeningProvider); + lp.fetchExercises(page: 1, limit: 6); + lp.fetchStatistics(); + }); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + backgroundColor: Colors.transparent, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back, color: Colors.black87), + onPressed: () => Navigator.of(context).pop(), + ), + title: const Text( + '听力训练', + style: TextStyle( + color: Colors.black87, + fontSize: 18, + fontWeight: FontWeight.w600, + ), + ), + centerTitle: true, + ), + body: RefreshIndicator( + onRefresh: () async { + final lp = ref.read(listeningProvider); + await lp.fetchExercises(page: 1, limit: 6, forceRefresh: true); + await lp.fetchStatistics(forceRefresh: true); + }, + child: ListView( + physics: const AlwaysScrollableScrollPhysics(), + padding: const EdgeInsets.all(16), + children: [ + _buildLevelSelection(context), + const SizedBox(height: 20), + _buildMaterialCategories(context), + const SizedBox(height: 20), + _buildRecommendedMaterials(context), + const SizedBox(height: 20), + _buildProgressSection(context), + const SizedBox(height: 100), + ], + ), + ), + ); + } + + Widget _buildLevelSelection(BuildContext context) { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '选择难度级别', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildLevelCard(context, '入门级', 'A1-A2', '120-140词/分钟', Colors.green, 'beginner'), + ), + const SizedBox(width: 12), + Expanded( + child: _buildLevelCard(context, '初级', 'B1', '140-160词/分钟', Colors.blue, 'intermediate'), + ), + ], + ), + const SizedBox(height: 12), + Row( + children: [ + Expanded( + child: _buildLevelCard(context, '中级', 'B2', '160-180词/分钟', Colors.orange, 'advanced'), + ), + const SizedBox(width: 12), + Expanded( + child: _buildLevelCard(context, '高级', 'C1-C2', '180-200词/分钟', Colors.red, 'expert'), + ), + ], + ), + ], + ), + ); + } + + Widget _buildLevelCard(BuildContext context, String level, String cefr, String speed, Color color, String difficulty) { + return GestureDetector( + onTap: () { + Navigator.pushNamed( + context, + Routes.listeningDifficulty, + arguments: {'difficulty': difficulty}, + ); + }, + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + border: Border.all(color: color.withOpacity(0.3)), + ), + child: Column( + children: [ + Text( + level, + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: color, + ), + ), + const SizedBox(height: 4), + Text( + cefr, + style: TextStyle( + fontSize: 12, + color: color, + ), + ), + const SizedBox(height: 4), + Text( + speed, + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + ), + ], + ), + ), + ); + } + + Widget _buildMaterialCategories(BuildContext context) { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '听力材料分类', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + GridView.count( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + crossAxisCount: 2, + crossAxisSpacing: 12, + mainAxisSpacing: 12, + childAspectRatio: 2.5, + children: [ + _buildCategoryCard(context, '日常对话', Icons.chat, Colors.blue, ListeningExerciseType.conversation), + _buildCategoryCard(context, '新闻播报', Icons.newspaper, Colors.red, ListeningExerciseType.news), + _buildCategoryCard(context, '商务英语', Icons.business, Colors.green, ListeningExerciseType.interview), + _buildCategoryCard(context, '学术讲座', Icons.school, Colors.purple, ListeningExerciseType.lecture), + ], + ), + ], + ), + ); + } + + Widget _buildCategoryCard(BuildContext context, String title, IconData icon, Color color, ListeningExerciseType type) { + return GestureDetector( + onTap: () { + Navigator.pushNamed( + context, + Routes.listeningCategory, + arguments: { + 'type': type, + 'title': title, + }, + ); + }, + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Icon( + icon, + color: color, + size: 24, + ), + const SizedBox(width: 8), + Expanded( + child: Text( + title, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: color, + ), + ), + ), + ], + ), + ), + ); + } + + Widget _buildRecommendedMaterials(BuildContext context) { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Consumer( + builder: (context, ref, _) { + final lp = ref.watch(listeningProvider); + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '推荐材料', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + IconButton( + icon: const Icon(Icons.refresh, color: Colors.grey), + tooltip: '刷新', + onPressed: () async { + await ref.read(listeningProvider).fetchExercises(page: 1, limit: 6, forceRefresh: true); + await ref.read(listeningProvider).fetchStatistics(forceRefresh: true); + }, + ), + ], + ), + const SizedBox(height: 16), + lp.isLoading + ? const Center(child: CircularProgressIndicator()) + : (lp.exercises.isEmpty + ? _buildEmptyMaterialsPlaceholder(context) + : Column( + children: lp.exercises.map((e) => Padding( + padding: const EdgeInsets.only(bottom: 12), + child: _buildMaterialItem( + context, + e.title, + e.description, + '${e.duration ~/ 60}分钟', + _difficultyLabel(e.difficulty), + e.id, + ), + )).toList(), + )), + ], + ); + }, + ), + ); + } + + Widget _buildEmptyMaterialsPlaceholder(BuildContext context) { + return Center( + child: Container( + padding: const EdgeInsets.all(24), + alignment: Alignment.center, + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + ), + child: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.center, + mainAxisAlignment: MainAxisAlignment.center, + children: [ + const Icon(Icons.inbox, size: 36, color: Colors.grey), + const SizedBox(height: 8), + const Text( + '暂无推荐材料', + style: TextStyle(fontSize: 14, color: Colors.grey), + ), + const SizedBox(height: 12), + ElevatedButton.icon( + onPressed: () async { + await ref.read(listeningProvider).fetchExercises(page: 1, limit: 6, forceRefresh: true); + await ref.read(listeningProvider).fetchStatistics(forceRefresh: true); + }, + icon: const Icon(Icons.refresh, size: 16), + label: const Text('刷新'), + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 10), + ), + ), + ], + ), + ), + ); + } + + Widget _buildMaterialItem(BuildContext context, String title, String subtitle, String duration, String level, String exerciseId) { + return GestureDetector( + onTap: () { + Navigator.pushNamed( + context, + Routes.listeningExerciseDetail, + arguments: {'exerciseId': exerciseId}, + ); + }, + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Container( + width: 40, + height: 40, + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(20), + ), + child: const Icon( + Icons.play_arrow, + color: Color(0xFF2196F3), + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + title, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + ), + ), + Text( + subtitle, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ), + ), + Column( + children: [ + Text( + duration, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + Container( + padding: const EdgeInsets.symmetric(horizontal: 6, vertical: 2), + decoration: BoxDecoration( + color: const Color(0xFF2196F3), + borderRadius: BorderRadius.circular(4), + ), + child: Text( + level, + style: const TextStyle( + fontSize: 10, + color: Colors.white, + ), + ), + ), + ], + ), + ], + ), + ), + ); + } + + Widget _buildProgressSection(BuildContext context) { + return GestureDetector( + onTap: () { + Navigator.pushNamed(context, Routes.listeningStats); + }, + child: Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '学习进度', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const Icon( + Icons.arrow_forward_ios, + size: 16, + color: Colors.grey, + ), + ], + ), + const SizedBox(height: 16), + Consumer( + builder: (context, ref, _) { + final lp = ref.watch(listeningProvider); + final stats = lp.statistics; + return Row( + mainAxisAlignment: MainAxisAlignment.spaceAround, + children: [ + _buildProgressItem('${stats?.completedExercises ?? 0}', '已完成', Icons.check_circle), + _buildProgressItem('${(((stats?.accuracy ?? 0.0) * 100)).toStringAsFixed(0)}%', '正确率', Icons.trending_up), + _buildProgressItem('${stats?.totalStudyTime ?? 0}', '总时长(分)', Icons.access_time), + ], + ); + }, + ), + ], + ), + ), + ); + } + + Widget _buildProgressItem(String value, String label, IconData icon) { + return Column( + children: [ + Icon( + icon, + color: const Color(0xFF2196F3), + size: 24, + ), + const SizedBox(height: 8), + Text( + value, + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + const SizedBox(height: 4), + Text( + label, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ); + } + + String _difficultyLabel(ListeningDifficulty difficulty) { + switch (difficulty) { + case ListeningDifficulty.beginner: + return 'A1'; + case ListeningDifficulty.elementary: + return 'A2'; + case ListeningDifficulty.intermediate: + return 'B1'; + case ListeningDifficulty.advanced: + return 'B2'; + case ListeningDifficulty.expert: + return 'C1-C2'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/listening/screens/listening_stats_screen.dart b/client/lib/features/listening/screens/listening_stats_screen.dart new file mode 100644 index 0000000..76decec --- /dev/null +++ b/client/lib/features/listening/screens/listening_stats_screen.dart @@ -0,0 +1,714 @@ +import 'package:flutter/material.dart'; +import 'package:fl_chart/fl_chart.dart'; +import '../models/listening_exercise_model.dart'; +import '../data/listening_static_data.dart'; + +class ListeningStatsScreen extends StatefulWidget { + const ListeningStatsScreen({Key? key}) : super(key: key); + + @override + State createState() => _ListeningStatsScreenState(); +} + +class _ListeningStatsScreenState extends State { + late ListeningStatistics stats; + String selectedPeriod = '本周'; + + final List periods = ['今天', '本周', '本月', '全部']; + + @override + void initState() { + super.initState(); + stats = ListeningStaticData.getUserStatistics(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('听力统计'), + backgroundColor: Colors.blue[50], + elevation: 0, + actions: [ + PopupMenuButton( + icon: const Icon(Icons.date_range), + onSelected: (value) { + setState(() { + selectedPeriod = value; + }); + }, + itemBuilder: (context) => periods.map((period) { + return PopupMenuItem( + value: period, + child: Text(period), + ); + }).toList(), + ), + ], + ), + body: SingleChildScrollView( + child: Column( + children: [ + // 头部概览 + _buildOverviewSection(), + + // 学习进度 + _buildProgressSection(), + + // 难度分布 + _buildDifficultyDistribution(), + + // 正确率趋势 + _buildAccuracyTrend(), + + // 学习时长统计 + _buildTimeStats(), + + // 最近练习 + _buildRecentExercises(), + ], + ), + ), + ); + } + + Widget _buildOverviewSection() { + return Container( + width: double.infinity, + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.blue[50], + borderRadius: const BorderRadius.only( + bottomLeft: Radius.circular(20), + bottomRight: Radius.circular(20), + ), + ), + child: Column( + children: [ + Text( + selectedPeriod, + style: TextStyle( + fontSize: 16, + color: Colors.blue[600], + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildStatCard( + '总练习', + '${stats.totalExercises}', + Icons.quiz, + Colors.blue, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildStatCard( + '已完成', + '${stats.completedExercises}', + Icons.check_circle, + Colors.green, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildStatCard( + '平均分', + '${stats.averageScore}%', + Icons.trending_up, + Colors.orange, + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildStatCard(String title, String value, IconData icon, Color color) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + spreadRadius: 1, + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + Icon(icon, color: color, size: 24), + const SizedBox(height: 8), + Text( + value, + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: color, + ), + ), + const SizedBox(height: 4), + Text( + title, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ); + } + + Widget _buildProgressSection() { + final progress = stats.completedExercises / stats.totalExercises; + + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + spreadRadius: 1, + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon(Icons.timeline, color: Colors.blue[600]), + const SizedBox(width: 8), + Text( + '学习进度', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Colors.blue[600], + ), + ), + ], + ), + const SizedBox(height: 20), + + // 进度条 + Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '总体进度', + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + ), + Text( + '${(progress * 100).round()}%', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: Colors.blue[600], + ), + ), + ], + ), + const SizedBox(height: 8), + LinearProgressIndicator( + value: progress, + backgroundColor: Colors.grey[200], + valueColor: AlwaysStoppedAnimation(Colors.blue[600]!), + minHeight: 8, + ), + const SizedBox(height: 16), + + // 连续学习天数 + Row( + children: [ + Icon(Icons.local_fire_department, color: Colors.orange[600], size: 20), + const SizedBox(width: 8), + Text( + '连续学习 ${stats.streakDays} 天', + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + ), + ], + ), + const SizedBox(height: 8), + Row( + children: [ + Icon(Icons.access_time, color: Colors.green[600], size: 20), + const SizedBox(width: 8), + Text( + '总学习时长 ${stats.totalStudyTime} 分钟', + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + ), + ], + ), + ], + ), + ], + ), + ); + } + + Widget _buildDifficultyDistribution() { + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + spreadRadius: 1, + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon(Icons.bar_chart, color: Colors.purple[600]), + const SizedBox(width: 8), + Text( + '难度分布', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Colors.purple[600], + ), + ), + ], + ), + const SizedBox(height: 20), + + SizedBox( + height: 200, + child: PieChart( + PieChartData( + sections: _buildPieChartSections(), + centerSpaceRadius: 40, + sectionsSpace: 2, + ), + ), + ), + + const SizedBox(height: 16), + + // 图例 + Wrap( + spacing: 16, + runSpacing: 8, + children: stats.difficultyStats.entries.map((entry) { + final difficulty = entry.key; + final count = entry.value; + final color = _getDifficultyColor(difficulty); + + return Row( + mainAxisSize: MainAxisSize.min, + children: [ + Container( + width: 12, + height: 12, + decoration: BoxDecoration( + color: color, + shape: BoxShape.circle, + ), + ), + const SizedBox(width: 6), + Text( + '${_getDifficultyName(difficulty)} ($count)', + style: const TextStyle(fontSize: 12), + ), + ], + ); + }).toList(), + ), + ], + ), + ); + } + + List _buildPieChartSections() { + final total = stats.difficultyStats.values.fold(0, (sum, count) => sum + count); + + return stats.difficultyStats.entries.map((entry) { + final difficulty = entry.key; + final count = entry.value; + final percentage = count / total * 100; + + return PieChartSectionData( + color: _getDifficultyColor(difficulty), + value: count.toDouble(), + title: '${percentage.round()}%', + radius: 60, + titleStyle: const TextStyle( + fontSize: 12, + fontWeight: FontWeight.bold, + color: Colors.white, + ), + ); + }).toList(); + } + + Color _getDifficultyColor(ListeningDifficulty difficulty) { + switch (difficulty) { + case ListeningDifficulty.beginner: + return Colors.green; + case ListeningDifficulty.elementary: + return Colors.lightGreen; + case ListeningDifficulty.intermediate: + return Colors.orange; + case ListeningDifficulty.advanced: + return Colors.red; + case ListeningDifficulty.expert: + return Colors.purple; + } + } + + String _getDifficultyName(ListeningDifficulty difficulty) { + switch (difficulty) { + case ListeningDifficulty.beginner: + return '初级'; + case ListeningDifficulty.elementary: + return '基础'; + case ListeningDifficulty.intermediate: + return '中级'; + case ListeningDifficulty.advanced: + return '高级'; + case ListeningDifficulty.expert: + return '专家'; + } + } + + Widget _buildAccuracyTrend() { + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + spreadRadius: 1, + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon(Icons.trending_up, color: Colors.green[600]), + const SizedBox(width: 8), + Text( + '正确率趋势', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Colors.green[600], + ), + ), + ], + ), + const SizedBox(height: 20), + + SizedBox( + height: 200, + child: LineChart( + LineChartData( + gridData: FlGridData(show: true), + titlesData: FlTitlesData( + leftTitles: AxisTitles( + sideTitles: SideTitles( + showTitles: true, + reservedSize: 40, + getTitlesWidget: (value, meta) { + return Text('${value.toInt()}%'); + }, + ), + ), + bottomTitles: AxisTitles( + sideTitles: SideTitles( + showTitles: true, + getTitlesWidget: (value, meta) { + final days = ['周一', '周二', '周三', '周四', '周五', '周六', '周日']; + if (value.toInt() < days.length) { + return Text(days[value.toInt()]); + } + return const Text(''); + }, + ), + ), + topTitles: AxisTitles(sideTitles: SideTitles(showTitles: false)), + rightTitles: AxisTitles(sideTitles: SideTitles(showTitles: false)), + ), + borderData: FlBorderData(show: true), + lineBarsData: [ + LineChartBarData( + spots: [ + const FlSpot(0, 75), + const FlSpot(1, 80), + const FlSpot(2, 78), + const FlSpot(3, 85), + const FlSpot(4, 88), + const FlSpot(5, 92), + const FlSpot(6, 90), + ], + isCurved: true, + color: Colors.green[600], + barWidth: 3, + dotData: FlDotData(show: true), + ), + ], + ), + ), + ), + ], + ), + ); + } + + Widget _buildTimeStats() { + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + spreadRadius: 1, + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon(Icons.schedule, color: Colors.indigo[600]), + const SizedBox(width: 8), + Text( + '学习时长统计', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Colors.indigo[600], + ), + ), + ], + ), + const SizedBox(height: 20), + + Row( + children: [ + Expanded( + child: _buildTimeStatItem( + '今日', + '25 分钟', + Icons.today, + Colors.blue, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildTimeStatItem( + '本周', + '180 分钟', + Icons.date_range, + Colors.green, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildTimeStatItem( + '本月', + '720 分钟', + Icons.calendar_month, + Colors.orange, + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildTimeStatItem(String period, String time, IconData icon, Color color) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: color.withOpacity(0.3)), + ), + child: Column( + children: [ + Icon(icon, color: color, size: 24), + const SizedBox(height: 8), + Text( + time, + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: color, + ), + ), + const SizedBox(height: 4), + Text( + period, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ); + } + + Widget _buildRecentExercises() { + final recentExercises = ListeningStaticData.getAllExercises().take(5).toList(); + + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + spreadRadius: 1, + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon(Icons.history, color: Colors.grey[600]), + const SizedBox(width: 8), + Text( + '最近练习', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Colors.grey[700], + ), + ), + ], + ), + const SizedBox(height: 16), + + ...recentExercises.map((exercise) { + return Container( + margin: const EdgeInsets.only(bottom: 12), + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + border: Border.all(color: Colors.grey[200]!), + ), + child: Row( + children: [ + Container( + padding: const EdgeInsets.all(8), + decoration: BoxDecoration( + color: _getDifficultyColor(exercise.difficulty).withOpacity(0.2), + borderRadius: BorderRadius.circular(8), + ), + child: Icon( + Icons.headphones, + color: _getDifficultyColor(exercise.difficulty), + size: 20, + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + exercise.title, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 4), + Text( + _getDifficultyName(exercise.difficulty), + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ), + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: Colors.green.withOpacity(0.2), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + '85%', + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.w600, + color: Colors.green[700], + ), + ), + ), + ], + ), + ); + }).toList(), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/listening/services/listening_service.dart b/client/lib/features/listening/services/listening_service.dart new file mode 100644 index 0000000..6f3154a --- /dev/null +++ b/client/lib/features/listening/services/listening_service.dart @@ -0,0 +1,349 @@ +import '../models/listening_exercise_model.dart'; +import '../../../core/network/api_client.dart'; +import '../../../core/services/enhanced_api_service.dart'; +import '../../../core/models/api_response.dart'; +import '../../../core/network/api_endpoints.dart'; +import 'dart:convert'; + +/// 听力训练服务 +class ListeningService { + final EnhancedApiService _enhancedApiService = EnhancedApiService(); + + // 缓存时长配置 + static const Duration _shortCacheDuration = Duration(minutes: 5); + static const Duration _longCacheDuration = Duration(hours: 1); + + /// 获取听力材料列表 + Future> getListeningExercises({ + ListeningExerciseType? type, + ListeningDifficulty? difficulty, + int page = 1, + int limit = 20, + bool forceRefresh = false, + }) async { + try { + final response = await _enhancedApiService.get>( + ApiEndpoints.listeningMaterials, + queryParameters: { + 'page': page, + 'page_size': limit, + if (type != null) 'type': type.name, + if (difficulty != null) 'level': _levelFromDifficulty(difficulty), + }, + useCache: !forceRefresh, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final List list = (data['data']?['materials'] ?? []) as List; + return list.map((json) => _materialToExercise(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取听力练习失败: $e'); + } + } + + /// 获取单个听力材料详情 + Future getListeningExercise(String exerciseId) async { + try { + final response = await _enhancedApiService.get( + '${ApiEndpoints.listeningMaterials}/$exerciseId', + cacheDuration: _longCacheDuration, + fromJson: (data) => _materialToExercise(data['data']), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取听力练习详情失败: $e'); + } + } + + /// 提交听力练习答案 + Future submitListeningExercise({ + required String exerciseId, + required String userId, + required List userAnswers, + required int timeSpent, + required int playCount, + }) async { + try { + final response = await _enhancedApiService.post( + ApiEndpoints.listeningRecords, + data: { + 'material_id': exerciseId, + 'user_answers': userAnswers, + 'time_spent': timeSpent, + 'play_count': playCount, + }, + fromJson: (data) => _recordToResult(data['record']), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('提交听力练习失败: $e'); + } + } + + /// 获取用户听力练习历史 + Future> getUserListeningHistory({ + required String userId, + int page = 1, + int limit = 20, + }) async { + try { + final response = await _enhancedApiService.get>( + ApiEndpoints.listeningRecords, + queryParameters: { + 'page': page, + 'page_size': limit, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final List list = (data['data']?['records'] ?? []) as List; + return list.map((json) => _recordToResult(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取听力练习历史失败: $e'); + } + } + + /// 获取用户听力学习统计 + Future getUserListeningStatistics() async { + try { + final response = await _enhancedApiService.get( + ApiEndpoints.listeningStats, + useCache: true, + cacheDuration: _shortCacheDuration, + fromJson: (data) => _statsToModel(data['data']), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取听力学习统计失败: $e'); + } + } + + Future getUserListeningStatisticsNoCache() async { + try { + final response = await _enhancedApiService.get( + ApiEndpoints.listeningStats, + useCache: false, + fromJson: (data) => _statsToModel(data['data']), + ); + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取听力学习统计失败: $e'); + } + } + + /// 搜索听力材料 + Future> searchListeningExercises({ + required String query, + ListeningExerciseType? type, + ListeningDifficulty? difficulty, + int page = 1, + int limit = 20, + }) async { + try { + final response = await _enhancedApiService.get>( + '${ApiEndpoints.listeningMaterials}/search', + queryParameters: { + 'q': query, + 'page': page, + 'page_size': limit, + if (type != null) 'type': type.name, + if (difficulty != null) 'difficulty': difficulty.name, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final List list = (data['data']?['materials'] ?? []) as List; + return list.map((json) => _materialToExercise(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('搜索听力练习失败: $e'); + } + } + + /// 获取推荐的听力练习 + /// 后端暂未提供推荐接口，返回空列表 + Future> getRecommendedListeningExercises({ + int limit = 10, + }) async { + return []; + } + + ListeningExercise _materialToExercise(Map m) { + final desc = (m['description'] ?? '') as String?; + final transcript = (m['transcript'] ?? '') as String?; + final tagsStr = (m['tags'] ?? '') as String?; + final tags = []; + if (tagsStr != null && tagsStr.isNotEmpty) { + try { + final parsed = json.decode(tagsStr); + if (parsed is List) { + tags.addAll(parsed.map((e) => e.toString())); + } + } catch (_) {} + } + final levelStr = (m['level'] ?? 'beginner') as String; + final categoryStr = (m['category'] ?? 'conversation') as String; + final createdAtStr = (m['created_at'] ?? DateTime.now().toIso8601String()).toString(); + final updatedAtStr = (m['updated_at'] ?? DateTime.now().toIso8601String()).toString(); + return ListeningExercise( + id: m['id'].toString(), + title: m['title'] ?? '', + description: desc ?? '', + type: _typeFromCategory(categoryStr), + difficulty: _difficultyFromLevel(levelStr), + audioUrl: m['audio_url'] ?? '', + duration: (m['duration'] ?? 0) as int, + transcript: transcript ?? '', + questions: const [], + tags: tags, + thumbnailUrl: '', + totalPoints: 0, + passingScore: 0.6, + creatorId: '', + creatorName: '', + isPublic: true, + playCount: 0, + rating: 0, + reviewCount: 0, + createdAt: DateTime.tryParse(createdAtStr) ?? DateTime.now(), + updatedAt: DateTime.tryParse(updatedAtStr) ?? DateTime.now(), + ); + } + + ListeningExerciseResult _recordToResult(Map r) { + final completedAtStr = (r['completed_at'] ?? DateTime.now().toIso8601String()).toString(); + final score = (r['score'] ?? 0.0); + final accuracy = (r['accuracy'] ?? 0.0); + final totalQ = 100; + final correct = (accuracy is num ? (accuracy * totalQ).round() : 0); + return ListeningExerciseResult( + id: r['id'].toString(), + exerciseId: r['material_id'].toString(), + userId: r['user_id'].toString(), + userAnswers: const [], + correctAnswers: List.filled(totalQ, false), + totalQuestions: totalQ, + correctCount: correct, + score: (score is num ? score.toDouble() : 0.0), + timeSpent: (r['time_spent'] ?? 0) as int, + playCount: (r['play_count'] ?? 1) as int, + isPassed: (score is num ? score >= 60 : false), + completedAt: DateTime.tryParse(completedAtStr) ?? DateTime.now(), + ); + } + + ListeningStatistics _statsToModel(Map s) { + final avgAcc = (s['average_accuracy'] ?? 0.0); + final totalRecords = (s['total_records'] ?? 0) as int; + final completedRecords = (s['completed_records'] ?? 0) as int; + final totalTimeMinutes = (s['total_time_spent'] ?? 0) as int; + final difficultyStatsMap = {}; + final typeStatsMap = {}; + final levelStats = s['level_stats'] as Map?; + levelStats?.forEach((k, v) { + difficultyStatsMap[_difficultyFromLevel(k)] = (v as num).toInt(); + }); + return ListeningStatistics( + userId: '', + totalExercises: totalRecords, + completedExercises: completedRecords, + totalQuestions: 100, + correctAnswers: (avgAcc is num ? (avgAcc * 100).round() : 0), + averageScore: (s['average_score'] is num ? (s['average_score'] as num).toDouble() : 0.0), + totalTimeSpent: totalTimeMinutes * 60, + totalPlayCount: 0, + streakDays: (s['continuous_days'] ?? 0) as int, + difficultyStats: difficultyStatsMap, + typeStats: typeStatsMap, + lastUpdated: DateTime.now(), + ); + } + + ListeningDifficulty _difficultyFromLevel(String level) { + switch (level) { + case 'beginner': + return ListeningDifficulty.beginner; + case 'intermediate': + return ListeningDifficulty.intermediate; + case 'advanced': + return ListeningDifficulty.advanced; + case 'elementary': + return ListeningDifficulty.elementary; + case 'expert': + return ListeningDifficulty.expert; + default: + return ListeningDifficulty.beginner; + } + } + + ListeningExerciseType _typeFromCategory(String category) { + switch (category) { + case 'lecture': + return ListeningExerciseType.lecture; + case 'news': + return ListeningExerciseType.news; + case 'story': + return ListeningExerciseType.story; + case 'interview': + return ListeningExerciseType.interview; + case 'dialogue': + return ListeningExerciseType.dialogue; + case 'conversation': + default: + return ListeningExerciseType.conversation; + } + } +} + String _levelFromDifficulty(ListeningDifficulty d) { + switch (d) { + case ListeningDifficulty.beginner: + return 'beginner'; + case ListeningDifficulty.elementary: + return 'beginner'; + case ListeningDifficulty.intermediate: + return 'intermediate'; + case ListeningDifficulty.advanced: + return 'advanced'; + case ListeningDifficulty.expert: + return 'advanced'; + } + } \ No newline at end of file diff --git a/client/lib/features/listening/widgets/listening_exercise_card.dart b/client/lib/features/listening/widgets/listening_exercise_card.dart new file mode 100644 index 0000000..5746fcd --- /dev/null +++ b/client/lib/features/listening/widgets/listening_exercise_card.dart @@ -0,0 +1,237 @@ +import 'package:flutter/material.dart'; +import '../models/listening_exercise_model.dart'; + +/// 听力练习卡片组件 +class ListeningExerciseCard extends StatelessWidget { + final ListeningExercise exercise; + final VoidCallback? onTap; + final bool showProgress; + final double? progress; + + const ListeningExerciseCard({ + super.key, + required this.exercise, + this.onTap, + this.showProgress = false, + this.progress, + }); + + @override + Widget build(BuildContext context) { + return Card( + margin: const EdgeInsets.symmetric(horizontal: 16, vertical: 8), + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + exercise.title, + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ), + const SizedBox(width: 8), + _buildDifficultyChip(context), + ], + ), + if (exercise.description.isNotEmpty) ...[ + const SizedBox(height: 8), + Text( + exercise.description, + style: Theme.of(context).textTheme.bodyMedium?.copyWith( + color: Colors.grey[600], + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ], + const SizedBox(height: 12), + Row( + children: [ + _buildInfoChip( + context, + Icons.access_time, + '${exercise.duration}s', + ), + const SizedBox(width: 8), + _buildInfoChip( + context, + Icons.quiz, + '${exercise.questions.length}题', + ), + const SizedBox(width: 8), + _buildInfoChip( + context, + _getTypeIcon(exercise.type), + _getTypeDisplayName(exercise.type), + ), + ], + ), + if (showProgress && progress != null) ...[ + const SizedBox(height: 12), + _buildProgressBar(context), + ], + ], + ), + ), + ), + ); + } + + Widget _buildDifficultyChip(BuildContext context) { + final color = _getDifficultyColor(exercise.difficulty); + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: color.withOpacity(0.3)), + ), + child: Text( + _getDifficultyDisplayName(exercise.difficulty), + style: TextStyle( + color: color, + fontSize: 12, + fontWeight: FontWeight.w500, + ), + ), + ); + } + + Widget _buildInfoChip(BuildContext context, IconData icon, String text) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(8), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + icon, + size: 14, + color: Colors.grey[600], + ), + const SizedBox(width: 4), + Text( + text, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ); + } + + Widget _buildProgressBar(BuildContext context) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '进度', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + Text( + '${(progress! * 100).toInt()}%', + style: TextStyle( + fontSize: 12, + color: Theme.of(context).colorScheme.primary, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + const SizedBox(height: 4), + LinearProgressIndicator( + value: progress, + backgroundColor: Colors.grey[300], + valueColor: AlwaysStoppedAnimation( + Theme.of(context).colorScheme.primary, + ), + ), + ], + ); + } + + String _getDifficultyDisplayName(ListeningDifficulty difficulty) { + switch (difficulty) { + case ListeningDifficulty.beginner: + return '初级'; + case ListeningDifficulty.elementary: + return '基础'; + case ListeningDifficulty.intermediate: + return '中级'; + case ListeningDifficulty.advanced: + return '高级'; + case ListeningDifficulty.expert: + return '专家'; + } + } + + String _getTypeDisplayName(ListeningExerciseType type) { + switch (type) { + case ListeningExerciseType.conversation: + return '对话'; + case ListeningExerciseType.lecture: + return '讲座'; + case ListeningExerciseType.news: + return '新闻'; + case ListeningExerciseType.story: + return '故事'; + case ListeningExerciseType.interview: + return '访谈'; + case ListeningExerciseType.dialogue: + return '对话'; + } + } + + Color _getDifficultyColor(ListeningDifficulty difficulty) { + switch (difficulty) { + case ListeningDifficulty.beginner: + return Colors.green; + case ListeningDifficulty.elementary: + return Colors.lightGreen; + case ListeningDifficulty.intermediate: + return Colors.orange; + case ListeningDifficulty.advanced: + return Colors.red; + case ListeningDifficulty.expert: + return Colors.purple; + } + } + + IconData _getTypeIcon(ListeningExerciseType type) { + switch (type) { + case ListeningExerciseType.conversation: + case ListeningExerciseType.dialogue: + return Icons.chat; + case ListeningExerciseType.lecture: + return Icons.school; + case ListeningExerciseType.news: + return Icons.newspaper; + case ListeningExerciseType.story: + return Icons.book; + case ListeningExerciseType.interview: + return Icons.mic; + } + } +} \ No newline at end of file diff --git a/client/lib/features/main/screens/main_app_screen.dart b/client/lib/features/main/screens/main_app_screen.dart new file mode 100644 index 0000000..944fb47 --- /dev/null +++ b/client/lib/features/main/screens/main_app_screen.dart @@ -0,0 +1,108 @@ +import 'package:flutter/material.dart'; +import '../../home/screens/home_screen.dart'; +import '../../learning/screens/learning_home_screen.dart'; +import '../../profile/screens/profile_home_screen.dart'; + +/// 主应用界面，包含底部导航栏 +class MainAppScreen extends StatefulWidget { + const MainAppScreen({super.key}); + + @override + State createState() => _MainAppScreenState(); +} + +class _MainAppScreenState extends State { + int _currentIndex = 0; + + final List _pages = [ + const HomeScreen(), + const LearningHomeScreen(), + const ProfileHomeScreen(), + ]; + + @override + Widget build(BuildContext context) { + return Scaffold( + body: IndexedStack( + index: _currentIndex, + children: _pages, + ), + bottomNavigationBar: Container( + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.1), + blurRadius: 10, + offset: const Offset(0, -2), + ), + ], + ), + child: SafeArea( + child: Padding( + padding: const EdgeInsets.symmetric(horizontal: 8.0, vertical: 8.0), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceAround, + children: [ + _buildNavItem( + icon: Icons.home, + label: '首页', + index: 0, + ), + _buildNavItem( + icon: Icons.school, + label: '学习', + index: 1, + ), + _buildNavItem( + icon: Icons.person, + label: '我的', + index: 2, + ), + ], + ), + ), + ), + ), + ); + } + + Widget _buildNavItem({ + required IconData icon, + required String label, + required int index, + }) { + final isSelected = _currentIndex == index; + final color = isSelected ? const Color(0xFF2196F3) : Colors.grey; + + return GestureDetector( + onTap: () { + setState(() { + _currentIndex = index; + }); + }, + child: Container( + padding: const EdgeInsets.symmetric(vertical: 4, horizontal: 8), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + icon, + color: color, + size: 24, + ), + const SizedBox(height: 2), + Text( + label, + style: TextStyle( + color: color, + fontSize: 12, + fontWeight: isSelected ? FontWeight.w600 : FontWeight.normal, + ), + ), + ], + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/notification/screens/notification_list_screen.dart b/client/lib/features/notification/screens/notification_list_screen.dart new file mode 100644 index 0000000..c92ae06 --- /dev/null +++ b/client/lib/features/notification/screens/notification_list_screen.dart @@ -0,0 +1,233 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../shared/providers/notification_provider.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../shared/widgets/custom_card.dart'; + +/// 通知列表页面 +class NotificationListScreen extends ConsumerStatefulWidget { + const NotificationListScreen({super.key}); + + @override + ConsumerState createState() => _NotificationListScreenState(); +} + +class _NotificationListScreenState extends ConsumerState { + @override + void initState() { + super.initState(); + // 加载通知列表 + Future.microtask(() { + ref.read(notificationProvider.notifier).loadNotifications(); + }); + } + + @override + Widget build(BuildContext context) { + final notificationState = ref.watch(notificationProvider); + final notifications = notificationState.notifications; + + return Scaffold( + appBar: AppBar( + title: const Text('消息通知'), + actions: [ + // 标记全部已读 + if (notifications.any((n) => !n.isRead)) + TextButton( + onPressed: () { + ref.read(notificationProvider.notifier).markAllAsRead(); + }, + child: const Text( + '全部已读', + style: TextStyle(color: Colors.white), + ), + ), + ], + ), + body: notificationState.isLoading + ? const Center(child: CircularProgressIndicator()) + : notifications.isEmpty + ? _buildEmptyState() + : RefreshIndicator( + onRefresh: () async { + await ref.read(notificationProvider.notifier).loadNotifications(); + }, + child: ListView.separated( + padding: const EdgeInsets.all(16), + itemCount: notifications.length, + separatorBuilder: (context, index) => const SizedBox(height: 12), + itemBuilder: (context, index) { + final notification = notifications[index]; + return _buildNotificationItem(notification); + }, + ), + ), + ); + } + + /// 构建空状态 + Widget _buildEmptyState() { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.notifications_none, + size: 100, + color: AppColors.onSurfaceVariant.withOpacity(0.3), + ), + const SizedBox(height: 16), + Text( + '暂无消息', + style: Theme.of(context).textTheme.titleMedium?.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + const SizedBox(height: 8), + Text( + '您目前没有任何通知消息', + style: Theme.of(context).textTheme.bodyMedium?.copyWith( + color: AppColors.onSurfaceVariant.withOpacity(0.7), + ), + ), + ], + ), + ); + } + + /// 构建通知项 + Widget _buildNotificationItem(notification) { + final isUnread = !notification.isRead; + + return CustomCard( + child: InkWell( + onTap: () { + // 标记为已读 + if (isUnread) { + ref.read(notificationProvider.notifier).markAsRead(notification.id); + } + // TODO: 根据通知类型跳转到对应页面 + }, + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: const EdgeInsets.all(16), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 图标 + Container( + width: 48, + height: 48, + decoration: BoxDecoration( + color: _getNotificationColor(notification.type).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Icon( + _getNotificationIcon(notification.type), + color: _getNotificationColor(notification.type), + size: 24, + ), + ), + const SizedBox(width: 12), + // 内容 + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + notification.title, + style: Theme.of(context).textTheme.titleSmall?.copyWith( + fontWeight: isUnread ? FontWeight.bold : FontWeight.normal, + ), + ), + ), + if (isUnread) + Container( + width: 8, + height: 8, + decoration: BoxDecoration( + color: AppColors.error, + shape: BoxShape.circle, + ), + ), + ], + ), + const SizedBox(height: 4), + Text( + notification.content, + style: Theme.of(context).textTheme.bodyMedium?.copyWith( + color: AppColors.onSurfaceVariant, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 8), + Text( + _formatTime(notification.createdAt), + style: Theme.of(context).textTheme.bodySmall?.copyWith( + color: AppColors.onSurfaceVariant.withOpacity(0.6), + ), + ), + ], + ), + ), + ], + ), + ), + ), + ); + } + + /// 获取通知图标 + IconData _getNotificationIcon(String type) { + switch (type) { + case 'system': + return Icons.info_outline; + case 'learning': + return Icons.school_outlined; + case 'achievement': + return Icons.emoji_events_outlined; + case 'reminder': + return Icons.notifications_active_outlined; + default: + return Icons.notifications_outlined; + } + } + + /// 获取通知颜色 + Color _getNotificationColor(String type) { + switch (type) { + case 'system': + return AppColors.primary; + case 'learning': + return AppColors.success; + case 'achievement': + return AppColors.warning; + case 'reminder': + return AppColors.info; + default: + return AppColors.primary; + } + } + + /// 格式化时间 + String _formatTime(DateTime dateTime) { + final now = DateTime.now(); + final difference = now.difference(dateTime); + + if (difference.inMinutes < 1) { + return '刚刚'; + } else if (difference.inHours < 1) { + return '${difference.inMinutes}分钟前'; + } else if (difference.inDays < 1) { + return '${difference.inHours}小时前'; + } else if (difference.inDays < 7) { + return '${difference.inDays}天前'; + } else { + return '${dateTime.month}月${dateTime.day}日'; + } + } +} diff --git a/client/lib/features/profile/screens/change_password_screen.dart b/client/lib/features/profile/screens/change_password_screen.dart new file mode 100644 index 0000000..82536a6 --- /dev/null +++ b/client/lib/features/profile/screens/change_password_screen.dart @@ -0,0 +1,501 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/widgets/custom_button.dart'; +import '../../../core/widgets/custom_text_field.dart'; +import '../../auth/providers/auth_provider.dart'; + +/// 修改密码屏幕 +class ChangePasswordScreen extends StatefulWidget { + const ChangePasswordScreen({super.key}); + + @override + State createState() => _ChangePasswordScreenState(); +} + +class _ChangePasswordScreenState extends State { + final _formKey = GlobalKey(); + final _currentPasswordController = TextEditingController(); + final _newPasswordController = TextEditingController(); + final _confirmPasswordController = TextEditingController(); + + bool _isLoading = false; + bool _obscureCurrentPassword = true; + bool _obscureNewPassword = true; + bool _obscureConfirmPassword = true; + + @override + void dispose() { + _currentPasswordController.dispose(); + _newPasswordController.dispose(); + _confirmPasswordController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.background, + appBar: _buildAppBar(), + body: SafeArea( + child: SingleChildScrollView( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + child: Form( + key: _formKey, + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题和说明 + _buildHeader(), + const SizedBox(height: AppDimensions.spacingXl), + + // 密码输入表单 + _buildPasswordForm(), + const SizedBox(height: AppDimensions.spacingXl), + + // 密码强度提示 + _buildPasswordStrengthTips(), + const SizedBox(height: AppDimensions.spacingXl), + + // 提交按钮 + _buildSubmitButton(), + ], + ), + ), + ), + ), + ); + } + + /// 构建应用栏 + PreferredSizeWidget _buildAppBar() { + return AppBar( + backgroundColor: AppColors.surface, + foregroundColor: AppColors.onSurface, + elevation: 0, + title: Text( + '修改密码', + style: AppTextStyles.titleLarge.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + ); + } + + /// 构建头部 + Widget _buildHeader() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.primary.withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + border: Border.all( + color: AppColors.primary.withOpacity(0.2), + width: 1, + ), + ), + child: Row( + children: [ + Icon( + Icons.security, + color: AppColors.primary, + size: 24, + ), + const SizedBox(width: AppDimensions.spacingSm), + + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '安全提示', + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: AppDimensions.spacingXs), + + Text( + '为了您的账户安全，建议定期更换密码，并使用包含字母、数字和特殊字符的强密码。', + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ), + ], + ), + ), + ], + ); + } + + /// 构建密码表单 + Widget _buildPasswordForm() { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.05), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + // 当前密码 + CustomTextField( + controller: _currentPasswordController, + labelText: '当前密码', + hintText: '请输入当前密码', + obscureText: _obscureCurrentPassword, + prefixIcon: Icons.lock_outline, + suffixIcon: IconButton( + icon: Icon( + _obscureCurrentPassword ? Icons.visibility : Icons.visibility_off, + color: AppColors.onSurfaceVariant, + ), + onPressed: () { + setState(() { + _obscureCurrentPassword = !_obscureCurrentPassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入当前密码'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 新密码 + CustomTextField( + controller: _newPasswordController, + labelText: '新密码', + hintText: '请输入新密码', + obscureText: _obscureNewPassword, + prefixIcon: Icons.lock, + suffixIcon: IconButton( + icon: Icon( + _obscureNewPassword ? Icons.visibility : Icons.visibility_off, + color: AppColors.onSurfaceVariant, + ), + onPressed: () { + setState(() { + _obscureNewPassword = !_obscureNewPassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入新密码'; + } + if (value.length < 8) { + return '密码长度至少8位'; + } + if (!RegExp(r'^(?=.*[a-zA-Z])(?=.*\d)').hasMatch(value)) { + return '密码必须包含字母和数字'; + } + if (value == _currentPasswordController.text) { + return '新密码不能与当前密码相同'; + } + return null; + }, + onChanged: (value) { + setState(() {}); // 触发密码强度更新 + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 确认新密码 + CustomTextField( + controller: _confirmPasswordController, + labelText: '确认新密码', + hintText: '请再次输入新密码', + obscureText: _obscureConfirmPassword, + prefixIcon: Icons.lock_clock, + suffixIcon: IconButton( + icon: Icon( + _obscureConfirmPassword ? Icons.visibility : Icons.visibility_off, + color: AppColors.onSurfaceVariant, + ), + onPressed: () { + setState(() { + _obscureConfirmPassword = !_obscureConfirmPassword; + }); + }, + ), + validator: (value) { + if (value == null || value.isEmpty) { + return '请确认新密码'; + } + if (value != _newPasswordController.text) { + return '两次输入的密码不一致'; + } + return null; + }, + ), + + // 密码强度指示器 + if (_newPasswordController.text.isNotEmpty) ...[ + const SizedBox(height: AppDimensions.spacingMd), + _buildPasswordStrengthIndicator(), + ], + ], + ), + ); + } + + /// 构建密码强度指示器 + Widget _buildPasswordStrengthIndicator() { + final password = _newPasswordController.text; + final strength = _calculatePasswordStrength(password); + + Color strengthColor; + String strengthText; + + switch (strength) { + case 0: + case 1: + strengthColor = AppColors.error; + strengthText = '弱'; + break; + case 2: + strengthColor = AppColors.warning; + strengthText = '中'; + break; + case 3: + case 4: + strengthColor = AppColors.success; + strengthText = '强'; + break; + default: + strengthColor = AppColors.onSurfaceVariant; + strengthText = '未知'; + } + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '密码强度', + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + Text( + strengthText, + style: AppTextStyles.bodySmall.copyWith( + color: strengthColor, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingXs), + + // 强度条 + Row( + children: List.generate(4, (index) { + return Expanded( + child: Container( + height: 4, + margin: EdgeInsets.only( + right: index < 3 ? AppDimensions.spacingXs : 0, + ), + decoration: BoxDecoration( + color: index < strength + ? strengthColor + : AppColors.onSurfaceVariant.withOpacity(0.2), + borderRadius: BorderRadius.circular(2), + ), + ), + ); + }), + ), + ], + ); + } + + /// 构建密码强度提示 + Widget _buildPasswordStrengthTips() { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + border: Border.all( + color: AppColors.onSurfaceVariant.withOpacity(0.2), + width: 1, + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '密码要求', + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: AppDimensions.spacingSm), + + ..._getPasswordRequirements().map((requirement) { + final isValid = _checkPasswordRequirement( + _newPasswordController.text, + requirement['type'], + ); + + return Padding( + padding: const EdgeInsets.only(bottom: AppDimensions.spacingXs), + child: Row( + children: [ + Icon( + isValid ? Icons.check_circle : Icons.radio_button_unchecked, + color: isValid ? AppColors.success : AppColors.onSurfaceVariant, + size: 16, + ), + const SizedBox(width: AppDimensions.spacingSm), + + Expanded( + child: Text( + requirement['text'], + style: AppTextStyles.bodySmall.copyWith( + color: isValid ? AppColors.success : AppColors.onSurfaceVariant, + ), + ), + ), + ], + ), + ); + }).toList(), + ], + ), + ); + } + + /// 构建提交按钮 + Widget _buildSubmitButton() { + return CustomButton( + text: '修改密码', + onPressed: _isLoading ? null : _changePassword, + isLoading: _isLoading, + width: double.infinity, + ); + } + + /// 计算密码强度 + int _calculatePasswordStrength(String password) { + if (password.isEmpty) return 0; + + int strength = 0; + + // 长度检查 + if (password.length >= 8) strength++; + + // 包含小写字母 + if (RegExp(r'[a-z]').hasMatch(password)) strength++; + + // 包含大写字母或数字 + if (RegExp(r'[A-Z0-9]').hasMatch(password)) strength++; + + // 包含特殊字符 + if (RegExp(r'[!@#$%^&*(),.?":{}|<>]').hasMatch(password)) strength++; + + return strength; + } + + /// 获取密码要求列表 + List> _getPasswordRequirements() { + return [ + {'type': 'length', 'text': '至少8个字符'}, + {'type': 'letter', 'text': '包含字母'}, + {'type': 'number', 'text': '包含数字'}, + {'type': 'special', 'text': '包含特殊字符（推荐）'}, + ]; + } + + /// 检查密码要求 + bool _checkPasswordRequirement(String password, String type) { + switch (type) { + case 'length': + return password.length >= 8; + case 'letter': + return RegExp(r'[a-zA-Z]').hasMatch(password); + case 'number': + return RegExp(r'\d').hasMatch(password); + case 'special': + return RegExp(r'[!@#$%^&*(),.?":{}|<>]').hasMatch(password); + default: + return false; + } + } + + /// 修改密码 + Future _changePassword() async { + if (!_formKey.currentState!.validate()) { + return; + } + + setState(() => _isLoading = true); + + try { + final authProvider = Provider.of(context, listen: false); + + await authProvider.changePassword( + currentPassword: _currentPasswordController.text, + newPassword: _newPasswordController.text, + ); + + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: const Text('密码修改成功'), + backgroundColor: AppColors.success, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8.0), + ), + ), + ); + + Navigator.pop(context); + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('密码修改失败: $e'), + backgroundColor: AppColors.error, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8.0), + ), + ), + ); + } + } finally { + if (mounted) { + setState(() => _isLoading = false); + } + } + } +} \ No newline at end of file diff --git a/client/lib/features/profile/screens/help_feedback_screen.dart b/client/lib/features/profile/screens/help_feedback_screen.dart new file mode 100644 index 0000000..dc6207b --- /dev/null +++ b/client/lib/features/profile/screens/help_feedback_screen.dart @@ -0,0 +1,708 @@ +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../shared/widgets/custom_app_bar.dart'; + +/// 帮助与反馈页面 +class HelpFeedbackScreen extends StatefulWidget { + const HelpFeedbackScreen({super.key}); + + @override + State createState() => _HelpFeedbackScreenState(); +} + +class _HelpFeedbackScreenState extends State + with SingleTickerProviderStateMixin { + late TabController _tabController; + final TextEditingController _feedbackController = TextEditingController(); + String _selectedFeedbackType = '功能建议'; + String _contactEmail = ''; + bool _isSubmitting = false; + + final List _feedbackTypes = [ + '功能建议', + '问题反馈', + '内容错误', + '性能问题', + '其他' + ]; + + final List> _faqList = [ + { + 'question': '如何开始学习？', + 'answer': '点击首页的"开始学习"按钮，选择适合您的学习模式。我们提供单词学习、语法练习、听力训练等多种学习方式。', + 'category': '学习指导' + }, + { + 'question': '如何设置学习目标？', + 'answer': '进入个人中心 > 设置 > 学习设置，您可以设置每日单词目标和学习时长目标。系统会根据您的目标提供个性化的学习计划。', + 'category': '学习指导' + }, + { + 'question': '如何查看学习进度？', + 'answer': '在个人中心可以查看详细的学习统计，包括学习天数、掌握单词数、学习时长等数据。', + 'category': '学习指导' + }, + { + 'question': '忘记密码怎么办？', + 'answer': '在登录页面点击"忘记密码"，输入您的邮箱地址，我们会发送重置密码的链接到您的邮箱。', + 'category': '账户问题' + }, + { + 'question': '如何修改个人信息？', + 'answer': '进入个人中心 > 个人信息，您可以修改头像、用户名、邮箱等个人信息。', + 'category': '账户问题' + }, + { + 'question': '如何开启/关闭通知？', + 'answer': '进入个人中心 > 设置 > 通知设置，您可以自定义各种通知的开启状态和提醒时间。', + 'category': '设置问题' + }, + { + 'question': '音频播放不了怎么办？', + 'answer': '请检查网络连接和设备音量设置。如果问题持续存在，可以尝试重启应用或清除缓存。', + 'category': '技术问题' + }, + { + 'question': '应用运行缓慢怎么办？', + 'answer': '建议清除应用缓存，关闭其他后台应用，确保设备有足够的存储空间。如果问题持续，请联系客服。', + 'category': '技术问题' + }, + { + 'question': '学习数据会丢失吗？', + 'answer': '您的学习数据会自动同步到云端，即使更换设备也不会丢失。建议保持网络连接以确保数据及时同步。', + 'category': '数据安全' + }, + { + 'question': '如何导出学习记录？', + 'answer': '目前暂不支持导出功能，但您可以在学习统计页面查看详细的学习数据和进度图表。', + 'category': '数据安全' + }, + ]; + + @override + void initState() { + super.initState(); + _tabController = TabController(length: 2, vsync: this); + } + + @override + void dispose() { + _tabController.dispose(); + _feedbackController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.surface, + appBar: CustomAppBar( + title: '帮助与反馈', + bottom: TabBar( + controller: _tabController, + labelColor: AppColors.primary, + unselectedLabelColor: AppColors.onSurfaceVariant, + indicatorColor: AppColors.primary, + tabs: const [ + Tab(text: '常见问题'), + Tab(text: '意见反馈'), + ], + ), + ), + body: TabBarView( + controller: _tabController, + children: [ + _buildFAQTab(), + _buildFeedbackTab(), + ], + ), + ); + } + + /// 构建常见问题标签页 + Widget _buildFAQTab() { + final categories = _faqList.map((faq) => faq['category'] as String).toSet().toList(); + + return SingleChildScrollView( + child: Column( + children: [ + // 搜索框 + Container( + margin: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: TextField( + decoration: InputDecoration( + hintText: '搜索问题...', + prefixIcon: Icon(Icons.search, color: AppColors.onSurfaceVariant), + border: InputBorder.none, + contentPadding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 12, + ), + ), + onChanged: (value) { + // TODO: 实现搜索功能 + }, + ), + ), + + // 快速入口 + Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '快速入口', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 12), + Row( + children: [ + Expanded( + child: _buildQuickActionCard( + icon: Icons.school, + title: '学习指南', + subtitle: '新手入门教程', + onTap: () => _showLearningGuide(), + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildQuickActionCard( + icon: Icons.contact_support, + title: '在线客服', + subtitle: '实时帮助支持', + onTap: () => _contactCustomerService(), + ), + ), + ], + ), + ], + ), + ), + + const SizedBox(height: 24), + + // 分类问题列表 + ...categories.map((category) => _buildFAQCategory(category)), + + const SizedBox(height: 32), + ], + ), + ); + } + + /// 构建意见反馈标签页 + Widget _buildFeedbackTab() { + return SingleChildScrollView( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 反馈类型选择 + Text( + '反馈类型', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 12), + Container( + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: DropdownButtonFormField( + value: _selectedFeedbackType, + decoration: const InputDecoration( + border: InputBorder.none, + contentPadding: EdgeInsets.symmetric( + horizontal: 16, + vertical: 12, + ), + ), + items: _feedbackTypes.map((type) { + return DropdownMenuItem( + value: type, + child: Text(type), + ); + }).toList(), + onChanged: (value) { + setState(() { + _selectedFeedbackType = value!; + }); + }, + ), + ), + + const SizedBox(height: 24), + + // 反馈内容 + Text( + '反馈内容', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 12), + Container( + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: TextField( + controller: _feedbackController, + maxLines: 6, + decoration: const InputDecoration( + hintText: '请详细描述您遇到的问题或建议...', + border: InputBorder.none, + contentPadding: EdgeInsets.all(16), + ), + ), + ), + + const SizedBox(height: 24), + + // 联系邮箱 + Text( + '联系邮箱（可选）', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 12), + Container( + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: TextField( + onChanged: (value) { + _contactEmail = value; + }, + decoration: const InputDecoration( + hintText: '请输入您的邮箱地址', + border: InputBorder.none, + contentPadding: EdgeInsets.symmetric( + horizontal: 16, + vertical: 12, + ), + ), + ), + ), + + const SizedBox(height: 32), + + // 提交按钮 + SizedBox( + width: double.infinity, + child: ElevatedButton( + onPressed: _isSubmitting ? null : _submitFeedback, + style: ElevatedButton.styleFrom( + backgroundColor: AppColors.primary, + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(vertical: 16), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: _isSubmitting + ? const SizedBox( + height: 20, + width: 20, + child: CircularProgressIndicator( + strokeWidth: 2, + valueColor: AlwaysStoppedAnimation(Colors.white), + ), + ) + : const Text( + '提交反馈', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + ), + ), + + const SizedBox(height: 16), + + // 提示信息 + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: AppColors.primary.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Row( + children: [ + Icon( + Icons.info_outline, + color: AppColors.primary, + size: 20, + ), + const SizedBox(width: 12), + Expanded( + child: Text( + '我们会认真对待每一条反馈，并在24小时内回复您的问题。', + style: TextStyle( + fontSize: 14, + color: AppColors.primary, + ), + ), + ), + ], + ), + ), + ], + ), + ), + ); + } + + /// 构建快速操作卡片 + Widget _buildQuickActionCard({ + required IconData icon, + required String title, + required String subtitle, + required VoidCallback onTap, + }) { + return GestureDetector( + onTap: onTap, + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + Icon( + icon, + color: AppColors.primary, + size: 32, + ), + const SizedBox(height: 8), + Text( + title, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 4), + Text( + subtitle, + style: TextStyle( + fontSize: 12, + color: AppColors.onSurfaceVariant, + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ); + } + + /// 构建FAQ分类 + Widget _buildFAQCategory(String category) { + final categoryFAQs = _faqList.where((faq) => faq['category'] == category).toList(); + + return Container( + margin: const EdgeInsets.symmetric(horizontal: 16, vertical: 8), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Padding( + padding: const EdgeInsets.all(16), + child: Text( + category, + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: AppColors.onSurface, + ), + ), + ), + ...categoryFAQs.map((faq) => _buildFAQItem(faq)), + ], + ), + ); + } + + /// 构建FAQ项目 + Widget _buildFAQItem(Map faq) { + return ExpansionTile( + title: Text( + faq['question'], + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: AppColors.onSurface, + ), + ), + children: [ + Padding( + padding: const EdgeInsets.fromLTRB(16, 0, 16, 16), + child: Text( + faq['answer'], + style: TextStyle( + fontSize: 14, + color: AppColors.onSurfaceVariant, + height: 1.5, + ), + ), + ), + ], + ); + } + + /// 显示学习指南 + void _showLearningGuide() { + showDialog( + context: context, + builder: (context) { + return AlertDialog( + title: const Text('学习指南'), + content: const SingleChildScrollView( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + mainAxisSize: MainAxisSize.min, + children: [ + Text( + '1. 注册并完善个人信息', + style: TextStyle(fontWeight: FontWeight.w600), + ), + SizedBox(height: 8), + Text('创建账户后，请完善您的英语水平、学习目标等信息，以便为您提供个性化的学习内容。'), + SizedBox(height: 16), + Text( + '2. 设置学习目标', + style: TextStyle(fontWeight: FontWeight.w600), + ), + SizedBox(height: 8), + Text('在设置中制定每日学习目标，包括单词数量和学习时长，系统会帮助您跟踪进度。'), + SizedBox(height: 16), + Text( + '3. 选择学习模式', + style: TextStyle(fontWeight: FontWeight.w600), + ), + SizedBox(height: 8), + Text('根据您的需求选择单词学习、语法练习、听力训练等不同的学习模式。'), + SizedBox(height: 16), + Text( + '4. 坚持每日学习', + style: TextStyle(fontWeight: FontWeight.w600), + ), + SizedBox(height: 8), + Text('保持每日学习习惯，利用碎片时间进行学习，积少成多提升英语水平。'), + ], + ), + ), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('知道了'), + ), + ], + ); + }, + ); + } + + /// 联系客服 + void _contactCustomerService() { + showDialog( + context: context, + builder: (context) { + return AlertDialog( + title: const Text('联系客服'), + content: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text('您可以通过以下方式联系我们：'), + const SizedBox(height: 16), + Row( + children: [ + const Icon(Icons.email, size: 20), + const SizedBox(width: 8), + const Text('邮箱：'), + GestureDetector( + onTap: () { + Clipboard.setData(const ClipboardData(text: 'support@aienglish.com')); + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('邮箱地址已复制')), + ); + }, + child: Text( + 'support@aienglish.com', + style: TextStyle( + color: AppColors.primary, + decoration: TextDecoration.underline, + ), + ), + ), + ], + ), + const SizedBox(height: 8), + Row( + children: [ + const Icon(Icons.phone, size: 20), + const SizedBox(width: 8), + const Text('电话：'), + GestureDetector( + onTap: () { + Clipboard.setData(const ClipboardData(text: '400-123-4567')); + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('电话号码已复制')), + ); + }, + child: Text( + '400-123-4567', + style: TextStyle( + color: AppColors.primary, + decoration: TextDecoration.underline, + ), + ), + ), + ], + ), + const SizedBox(height: 8), + const Row( + children: [ + Icon(Icons.access_time, size: 20), + SizedBox(width: 8), + Text('服务时间：9:00-18:00（工作日）'), + ], + ), + ], + ), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('确定'), + ), + ], + ); + }, + ); + } + + /// 提交反馈 + Future _submitFeedback() async { + if (_feedbackController.text.trim().isEmpty) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('请输入反馈内容'), + backgroundColor: Colors.red, + ), + ); + return; + } + + setState(() { + _isSubmitting = true; + }); + + try { + // TODO: 实现提交反馈的API调用 + await Future.delayed(const Duration(seconds: 2)); // 模拟网络请求 + + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('反馈提交成功，感谢您的建议！'), + backgroundColor: Colors.green, + ), + ); + + // 清空表单 + _feedbackController.clear(); + _contactEmail = ''; + setState(() { + _selectedFeedbackType = '功能建议'; + }); + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('提交失败：$e'), + backgroundColor: Colors.red, + ), + ); + } + } finally { + if (mounted) { + setState(() { + _isSubmitting = false; + }); + } + } + } +} \ No newline at end of file diff --git a/client/lib/features/profile/screens/profile_detail_screen.dart b/client/lib/features/profile/screens/profile_detail_screen.dart new file mode 100644 index 0000000..03ecaa7 --- /dev/null +++ b/client/lib/features/profile/screens/profile_detail_screen.dart @@ -0,0 +1,811 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import 'package:image_picker/image_picker.dart'; +import 'dart:io'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/widgets/custom_button.dart'; +import '../../../core/widgets/custom_text_field.dart'; +import '../../../core/models/user_model.dart'; +import '../../auth/providers/auth_provider.dart'; +import '../widgets/profile_avatar.dart'; +import '../widgets/profile_info_card.dart'; +import '../widgets/learning_preferences_card.dart'; + +/// 个人资料详情屏幕 +class ProfileDetailScreen extends StatefulWidget { + const ProfileDetailScreen({super.key}); + + @override + State createState() => _ProfileDetailScreenState(); +} + +class _ProfileDetailScreenState extends State + with TickerProviderStateMixin { + late TabController _tabController; + final _formKey = GlobalKey(); + final _usernameController = TextEditingController(); + final _emailController = TextEditingController(); + final _phoneController = TextEditingController(); + final _bioController = TextEditingController(); + + bool _isEditing = false; + bool _isLoading = false; + File? _selectedImage; + + // 学习偏好设置 + int _dailyWordGoal = 20; + int _dailyStudyMinutes = 30; + EnglishLevel _englishLevel = EnglishLevel.intermediate; + bool _notificationsEnabled = true; + bool _soundEnabled = true; + bool _vibrationEnabled = true; + + @override + void initState() { + super.initState(); + _tabController = TabController(length: 3, vsync: this); + _loadUserData(); + } + + @override + void dispose() { + _tabController.dispose(); + _usernameController.dispose(); + _emailController.dispose(); + _phoneController.dispose(); + _bioController.dispose(); + super.dispose(); + } + + /// 加载用户数据 + void _loadUserData() { + final authProvider = Provider.of(context, listen: false); + final user = authProvider.state.user; + + if (user != null) { + _usernameController.text = user.username; + _emailController.text = user.email; + _phoneController.text = user.profile?.phone ?? ''; + _bioController.text = user.profile?.bio ?? ''; + + if (user.profile?.settings != null) { + _dailyWordGoal = user.profile!.settings!.dailyWordGoal; + _dailyStudyMinutes = user.profile!.settings!.dailyStudyMinutes; + _notificationsEnabled = user.profile!.settings!.notificationsEnabled; + _soundEnabled = user.profile!.settings!.soundEnabled; + _vibrationEnabled = user.profile!.settings!.vibrationEnabled; + } + + if (user.profile?.englishLevel != null) { + _englishLevel = user.profile!.englishLevel!; + } + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.background, + appBar: _buildAppBar(), + body: Column( + children: [ + // Tab栏 + Container( + color: AppColors.surface, + child: TabBar( + controller: _tabController, + labelColor: AppColors.primary, + unselectedLabelColor: AppColors.onSurfaceVariant, + indicatorColor: AppColors.primary, + indicatorWeight: 3, + labelStyle: AppTextStyles.titleSmall.copyWith( + fontWeight: FontWeight.w600, + ), + unselectedLabelStyle: AppTextStyles.titleSmall, + tabs: const [ + Tab(text: '基本信息'), + Tab(text: '学习偏好'), + Tab(text: '账户设置'), + ], + ), + ), + + // Tab内容 + Expanded( + child: TabBarView( + controller: _tabController, + children: [ + _buildBasicInfoTab(), + _buildLearningPreferencesTab(), + _buildAccountSettingsTab(), + ], + ), + ), + ], + ), + ); + } + + /// 构建应用栏 + PreferredSizeWidget _buildAppBar() { + return AppBar( + backgroundColor: AppColors.primary, + foregroundColor: AppColors.onPrimary, + title: Text( + '个人资料', + style: AppTextStyles.titleLarge.copyWith( + color: AppColors.onPrimary, + fontWeight: FontWeight.w600, + ), + ), + actions: [ + if (_isEditing) + TextButton( + onPressed: _isLoading ? null : _saveProfile, + child: _isLoading + ? SizedBox( + width: 20, + height: 20, + child: CircularProgressIndicator( + strokeWidth: 2, + valueColor: AlwaysStoppedAnimation(AppColors.onPrimary), + ), + ) + : Text( + '保存', + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.onPrimary, + fontWeight: FontWeight.w600, + ), + ), + ) + else + IconButton( + onPressed: () => setState(() => _isEditing = true), + icon: Icon( + Icons.edit, + color: AppColors.onPrimary, + ), + ), + const SizedBox(width: AppDimensions.spacingSm), + ], + ); + } + + /// 构建基本信息标签页 + Widget _buildBasicInfoTab() { + return SingleChildScrollView( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + child: Form( + key: _formKey, + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 头像部分 + _buildAvatarSection(), + const SizedBox(height: AppDimensions.spacingLg), + + // 基本信息表单 + ProfileInfoCard( + title: '基本信息', + child: Column( + children: [ + CustomTextField( + controller: _usernameController, + labelText: '用户名', + enabled: _isEditing, + validator: (value) { + if (value == null || value.isEmpty) { + return '请输入用户名'; + } + if (value.length < 2) { + return '用户名至少2个字符'; + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + CustomTextField( + controller: _emailController, + labelText: '邮箱', + enabled: false, // 邮箱不允许修改 + keyboardType: TextInputType.emailAddress, + ), + const SizedBox(height: AppDimensions.spacingMd), + + CustomTextField( + controller: _phoneController, + labelText: '手机号', + enabled: _isEditing, + keyboardType: TextInputType.phone, + validator: (value) { + if (value != null && value.isNotEmpty) { + if (!RegExp(r'^1[3-9]\d{9}$').hasMatch(value)) { + return '请输入正确的手机号'; + } + } + return null; + }, + ), + const SizedBox(height: AppDimensions.spacingMd), + + CustomTextField( + controller: _bioController, + labelText: '个人简介', + enabled: _isEditing, + maxLines: 3, + maxLength: 200, + validator: (value) { + if (value != null && value.length > 200) { + return '个人简介不能超过200个字符'; + } + return null; + }, + ), + ], + ), + ), + ], + ), + ), + ); + } + + /// 构建学习偏好标签页 + Widget _buildLearningPreferencesTab() { + return SingleChildScrollView( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + child: Column( + children: [ + LearningPreferencesCard( + title: '学习目标', + child: Column( + children: [ + _buildSliderSetting( + title: '每日单词目标', + value: _dailyWordGoal.toDouble(), + min: 5, + max: 100, + divisions: 19, + unit: '个', + onChanged: _isEditing + ? (value) => setState(() => _dailyWordGoal = value.round()) + : null, + ), + const SizedBox(height: AppDimensions.spacingMd), + + _buildSliderSetting( + title: '每日学习时长', + value: _dailyStudyMinutes.toDouble(), + min: 10, + max: 120, + divisions: 22, + unit: '分钟', + onChanged: _isEditing + ? (value) => setState(() => _dailyStudyMinutes = value.round()) + : null, + ), + ], + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + LearningPreferencesCard( + title: '英语水平', + child: _buildEnglishLevelSelector(), + ), + const SizedBox(height: AppDimensions.spacingMd), + + LearningPreferencesCard( + title: '通知设置', + child: Column( + children: [ + _buildSwitchSetting( + title: '学习提醒', + subtitle: '每日学习时间提醒', + value: _notificationsEnabled, + onChanged: _isEditing + ? (value) => setState(() => _notificationsEnabled = value) + : null, + ), + _buildSwitchSetting( + title: '音效', + subtitle: '操作反馈音效', + value: _soundEnabled, + onChanged: _isEditing + ? (value) => setState(() => _soundEnabled = value) + : null, + ), + _buildSwitchSetting( + title: '震动反馈', + subtitle: '操作震动反馈', + value: _vibrationEnabled, + onChanged: _isEditing + ? (value) => setState(() => _vibrationEnabled = value) + : null, + ), + ], + ), + ), + ], + ), + ); + } + + /// 构建账户设置标签页 + Widget _buildAccountSettingsTab() { + return SingleChildScrollView( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + child: Column( + children: [ + ProfileInfoCard( + title: '安全设置', + child: Column( + children: [ + _buildSettingItem( + icon: Icons.lock_outline, + title: '修改密码', + subtitle: '定期修改密码保护账户安全', + onTap: () => Navigator.pushNamed(context, '/change-password'), + ), + const Divider(), + _buildSettingItem( + icon: Icons.security, + title: '两步验证', + subtitle: '增强账户安全性', + onTap: () => _showComingSoon('两步验证'), + ), + ], + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + ProfileInfoCard( + title: '数据管理', + child: Column( + children: [ + _buildSettingItem( + icon: Icons.download, + title: '导出数据', + subtitle: '导出学习记录和个人数据', + onTap: () => _showComingSoon('数据导出'), + ), + const Divider(), + _buildSettingItem( + icon: Icons.delete_outline, + title: '清除缓存', + subtitle: '清除应用缓存数据', + onTap: _clearCache, + ), + ], + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + ProfileInfoCard( + title: '账户操作', + child: Column( + children: [ + _buildSettingItem( + icon: Icons.logout, + title: '退出登录', + subtitle: '退出当前账户', + onTap: _logout, + textColor: AppColors.warning, + ), + const Divider(), + _buildSettingItem( + icon: Icons.delete_forever, + title: '注销账户', + subtitle: '永久删除账户和所有数据', + onTap: () => _showDeleteAccountDialog(), + textColor: AppColors.error, + ), + ], + ), + ), + ], + ), + ); + } + + /// 构建头像部分 + Widget _buildAvatarSection() { + return Consumer(builder: (context, authProvider, child) { + final user = authProvider.state.user; + + return Center( + child: Column( + children: [ + ProfileAvatar( + imageUrl: user?.profile?.avatar, + selectedImage: _selectedImage, + size: 100, + isEditing: _isEditing, + onImageSelected: _selectImage, + ), + const SizedBox(height: AppDimensions.spacingMd), + + Text( + user?.username ?? '用户', + style: AppTextStyles.headlineSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: AppDimensions.spacingXs), + + Text( + user?.email ?? '', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ); + }); + } + + /// 构建滑块设置 + Widget _buildSliderSetting({ + required String title, + required double value, + required double min, + required double max, + required int divisions, + required String unit, + ValueChanged? onChanged, + }) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + title, + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w500, + ), + ), + Text( + '${value.round()} $unit', + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingSm), + + Slider( + value: value, + min: min, + max: max, + divisions: divisions, + activeColor: AppColors.primary, + inactiveColor: AppColors.primary.withOpacity(0.3), + onChanged: onChanged, + ), + ], + ); + } + + /// 构建开关设置 + Widget _buildSwitchSetting({ + required String title, + required String subtitle, + required bool value, + ValueChanged? onChanged, + }) { + return ListTile( + contentPadding: EdgeInsets.zero, + title: Text( + title, + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w500, + ), + ), + subtitle: Text( + subtitle, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + trailing: Switch( + value: value, + onChanged: onChanged, + activeColor: AppColors.primary, + ), + ); + } + + /// 构建英语水平选择器 + Widget _buildEnglishLevelSelector() { + return Column( + children: EnglishLevel.values.map((level) { + return RadioListTile( + contentPadding: EdgeInsets.zero, + title: Text( + _getEnglishLevelText(level), + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w500, + ), + ), + subtitle: Text( + _getEnglishLevelDescription(level), + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + value: level, + groupValue: _englishLevel, + onChanged: _isEditing + ? (value) => setState(() => _englishLevel = value!) + : null, + activeColor: AppColors.primary, + ); + }).toList(), + ); + } + + /// 构建设置项 + Widget _buildSettingItem({ + required IconData icon, + required String title, + required String subtitle, + required VoidCallback onTap, + Color? textColor, + }) { + return ListTile( + contentPadding: EdgeInsets.zero, + leading: Icon( + icon, + color: textColor ?? AppColors.onSurface, + ), + title: Text( + title, + style: AppTextStyles.titleSmall.copyWith( + color: textColor ?? AppColors.onSurface, + fontWeight: FontWeight.w500, + ), + ), + subtitle: Text( + subtitle, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + trailing: Icon( + Icons.chevron_right, + color: AppColors.onSurfaceVariant, + ), + onTap: onTap, + ); + } + + /// 选择图片 + Future _selectImage() async { + final picker = ImagePicker(); + final pickedFile = await picker.pickImage( + source: ImageSource.gallery, + maxWidth: 512, + maxHeight: 512, + imageQuality: 80, + ); + + if (pickedFile != null) { + setState(() { + _selectedImage = File(pickedFile.path); + }); + } + } + + /// 保存个人资料 + Future _saveProfile() async { + if (!_formKey.currentState!.validate()) { + return; + } + + setState(() => _isLoading = true); + + try { + final authProvider = Provider.of(context, listen: false); + + // TODO: 如果有选择新头像，先上传头像 + String? avatarUrl; + if (_selectedImage != null) { + // avatarUrl = await _uploadAvatar(_selectedImage!); + } + + await authProvider.updateProfile( + username: _usernameController.text, + phone: _phoneController.text, + avatar: avatarUrl, + ); + + setState(() { + _isEditing = false; + _selectedImage = null; + }); + + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: const Text('个人资料更新成功'), + backgroundColor: AppColors.success, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8.0), + ), + ), + ); + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('更新失败: $e'), + backgroundColor: AppColors.error, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8.0), + ), + ), + ); + } + } finally { + if (mounted) { + setState(() => _isLoading = false); + } + } + } + + /// 清除缓存 + Future _clearCache() async { + // TODO: 实现清除缓存功能 + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: const Text('缓存已清除'), + backgroundColor: AppColors.success, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8.0), + ), + ), + ); + } + + /// 退出登录 + Future _logout() async { + final confirmed = await showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('确认退出'), + content: const Text('确定要退出登录吗？'), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context, false), + child: const Text('取消'), + ), + TextButton( + onPressed: () => Navigator.pop(context, true), + child: Text( + '退出', + style: TextStyle(color: AppColors.warning), + ), + ), + ], + ), + ); + + if (confirmed == true) { + final authProvider = Provider.of(context, listen: false); + await authProvider.logout(); + + if (mounted) { + Navigator.pushNamedAndRemoveUntil( + context, + '/login', + (route) => false, + ); + } + } + } + + /// 显示注销账户对话框 + Future _showDeleteAccountDialog() async { + final confirmed = await showDialog( + context: context, + builder: (context) => AlertDialog( + title: Text( + '注销账户', + style: TextStyle(color: AppColors.error), + ), + content: const Text( + '注销账户将永久删除您的所有数据，包括学习记录、个人信息等。此操作不可恢复，请谨慎操作。', + ), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context, false), + child: const Text('取消'), + ), + TextButton( + onPressed: () => Navigator.pop(context, true), + child: Text( + '确认注销', + style: TextStyle(color: AppColors.error), + ), + ), + ], + ), + ); + + if (confirmed == true) { + // TODO: 实现注销账户功能 + _showComingSoon('账户注销'); + } + } + + /// 显示即将上线提示 + void _showComingSoon(String feature) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('$feature功能即将上线'), + backgroundColor: AppColors.info, + behavior: SnackBarBehavior.floating, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8.0), + ), + ), + ); + } + + /// 获取英语水平文本 + String _getEnglishLevelText(EnglishLevel level) { + switch (level) { + case EnglishLevel.beginner: + return '初级 (Beginner)'; + case EnglishLevel.elementary: + return '基础 (Elementary)'; + case EnglishLevel.intermediate: + return '中级 (Intermediate)'; + case EnglishLevel.upperIntermediate: + return '中高级 (Upper Intermediate)'; + case EnglishLevel.advanced: + return '高级 (Advanced)'; + case EnglishLevel.proficient: + return '精通 (Proficient)'; + case EnglishLevel.expert: + return '专家 (Expert)'; + } + } + + /// 获取英语水平描述 + String _getEnglishLevelDescription(EnglishLevel level) { + switch (level) { + case EnglishLevel.beginner: + return '基础词汇和语法，适合英语入门学习者'; + case EnglishLevel.elementary: + return '掌握基本词汇，能进行简单交流'; + case EnglishLevel.intermediate: + return '中等词汇量，能进行日常对话和阅读'; + case EnglishLevel.upperIntermediate: + return '较好的词汇量，能处理复杂话题'; + case EnglishLevel.advanced: + return '丰富词汇量，能流利交流和理解复杂内容'; + case EnglishLevel.proficient: + return '熟练掌握英语，能应对各种语言场景'; + case EnglishLevel.expert: + return '接近母语水平，能处理专业和学术内容'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/profile/screens/profile_edit_screen.dart b/client/lib/features/profile/screens/profile_edit_screen.dart new file mode 100644 index 0000000..41917eb --- /dev/null +++ b/client/lib/features/profile/screens/profile_edit_screen.dart @@ -0,0 +1,708 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import 'package:image_picker/image_picker.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../shared/widgets/custom_app_bar.dart'; +import '../../../core/widgets/custom_text_field.dart'; +import '../../../core/widgets/custom_button.dart'; +import '../../../core/providers/app_state_provider.dart'; +import '../../../shared/models/user_model.dart'; + +/// 个人信息编辑页面 +class ProfileEditScreen extends ConsumerStatefulWidget { + const ProfileEditScreen({super.key}); + + @override + ConsumerState createState() => _ProfileEditScreenState(); +} + +class _ProfileEditScreenState extends ConsumerState { + final _formKey = GlobalKey(); + final _usernameController = TextEditingController(); + final _emailController = TextEditingController(); + final _phoneController = TextEditingController(); + final _bioController = TextEditingController(); + final _realNameController = TextEditingController(); + final _locationController = TextEditingController(); + final _occupationController = TextEditingController(); + + String? _selectedGender; + DateTime? _selectedBirthday; + String? _selectedEducation; + String? _selectedEnglishLevel; + String? _selectedTargetLevel; + String? _selectedLearningGoal; + List _interests = []; + String? _avatarPath; + bool _isLoading = false; + + final List _genderOptions = ['male', 'female', 'other']; + final List _educationOptions = ['高中', '专科', '本科', '硕士', '博士']; + final List _englishLevelOptions = ['beginner', 'elementary', 'intermediate', 'upperIntermediate', 'advanced']; + final List _learningGoalOptions = ['dailyCommunication', 'businessEnglish', 'academicEnglish', 'examPreparation', 'travelEnglish']; + final List _interestOptions = ['编程', '英语学习', '阅读', '音乐', '电影', '旅行', '运动', '摄影', '绘画', '游戏']; + + @override + void initState() { + super.initState(); + _loadUserData(); + } + + @override + void dispose() { + _usernameController.dispose(); + _emailController.dispose(); + _phoneController.dispose(); + _bioController.dispose(); + _realNameController.dispose(); + _locationController.dispose(); + _occupationController.dispose(); + super.dispose(); + } + + void _loadUserData() { + final authProviderNotifier = ref.read(authProvider); + final user = authProviderNotifier.user; + if (user != null) { + _usernameController.text = user.username ?? ''; + _emailController.text = user.email ?? ''; + _phoneController.text = user.phone ?? ''; + _bioController.text = user.bio ?? ''; + _selectedGender = user.gender; + _selectedBirthday = user.birthday; + _selectedEnglishLevel = user.learningLevel; + _avatarPath = user.avatar; + } + } + + Future _pickImage() async { + final ImagePicker picker = ImagePicker(); + final XFile? image = await picker.pickImage( + source: ImageSource.gallery, + maxWidth: 512, + maxHeight: 512, + imageQuality: 80, + ); + + if (image != null) { + setState(() { + _avatarPath = image.path; + }); + } + } + + Future _selectBirthday() async { + final DateTime? picked = await showDatePicker( + context: context, + initialDate: _selectedBirthday ?? DateTime(1990), + firstDate: DateTime(1900), + lastDate: DateTime.now(), + builder: (context, child) { + return Theme( + data: Theme.of(context).copyWith( + colorScheme: ColorScheme.light( + primary: AppColors.primary, + onPrimary: AppColors.onPrimary, + surface: AppColors.surface, + onSurface: AppColors.onSurface, + ), + ), + child: child!, + ); + }, + ); + + if (picked != null) { + setState(() { + _selectedBirthday = picked; + }); + } + } + + void _showInterestsDialog() { + showDialog( + context: context, + builder: (context) { + List tempInterests = List.from(_interests); + return StatefulBuilder( + builder: (context, setDialogState) { + return AlertDialog( + title: const Text('选择兴趣爱好'), + content: SizedBox( + width: double.maxFinite, + child: ListView.builder( + shrinkWrap: true, + itemCount: _interestOptions.length, + itemBuilder: (context, index) { + final interest = _interestOptions[index]; + final isSelected = tempInterests.contains(interest); + return CheckboxListTile( + title: Text(interest), + value: isSelected, + onChanged: (bool? value) { + setDialogState(() { + if (value == true) { + tempInterests.add(interest); + } else { + tempInterests.remove(interest); + } + }); + }, + activeColor: AppColors.primary, + ); + }, + ), + ), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + TextButton( + onPressed: () { + setState(() { + _interests = tempInterests; + }); + Navigator.pop(context); + }, + child: const Text('确定'), + ), + ], + ); + }, + ); + }, + ); + } + + Future _saveProfile() async { + if (!_formKey.currentState!.validate()) return; + + setState(() { + _isLoading = true; + }); + + try { + final authProviderNotifier = ref.read(authProvider); + final success = await authProviderNotifier.updateProfile( + nickname: _usernameController.text.trim(), + avatar: _avatarPath, + phone: _phoneController.text.trim(), + birthday: _selectedBirthday, + gender: _selectedGender, + bio: _bioController.text.trim(), + learningLevel: _selectedEnglishLevel, + targetLanguage: 'english', + nativeLanguage: 'chinese', + dailyGoal: 30, + ); + + if (success) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('个人信息更新成功'), + backgroundColor: Colors.green, + ), + ); + Navigator.pop(context); + } + } else { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('更新失败，请重试'), + backgroundColor: Colors.red, + ), + ); + } + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('更新失败: $e'), + backgroundColor: Colors.red, + ), + ); + } + } finally { + if (mounted) { + setState(() { + _isLoading = false; + }); + } + } + } + + String _getGenderDisplayName(String gender) { + switch (gender) { + case 'male': + return '男'; + case 'female': + return '女'; + case 'other': + return '其他'; + default: + return gender; + } + } + + String _getEnglishLevelDisplayName(String level) { + switch (level) { + case 'beginner': + return '初学者'; + case 'elementary': + return '基础'; + case 'intermediate': + return '中级'; + case 'upperIntermediate': + return '中高级'; + case 'advanced': + return '高级'; + default: + return level; + } + } + + String _getLearningGoalDisplayName(String goal) { + switch (goal) { + case 'dailyCommunication': + return '日常交流'; + case 'businessEnglish': + return '商务英语'; + case 'academicEnglish': + return '学术英语'; + case 'examPreparation': + return '考试准备'; + case 'travelEnglish': + return '旅游英语'; + default: + return goal; + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.surface, + appBar: CustomAppBar( + title: '编辑个人信息', + actions: [ + TextButton( + onPressed: _isLoading ? null : _saveProfile, + child: Text( + '保存', + style: TextStyle( + color: _isLoading ? AppColors.onSurfaceVariant : AppColors.primary, + fontWeight: FontWeight.w600, + ), + ), + ), + ], + ), + body: Stack( + children: [ + Form( + key: _formKey, + child: SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 头像部分 + Center( + child: GestureDetector( + onTap: _pickImage, + child: Container( + width: 100, + height: 100, + decoration: BoxDecoration( + shape: BoxShape.circle, + border: Border.all( + color: AppColors.primary, + width: 2, + ), + ), + child: CircleAvatar( + radius: 48, + backgroundColor: AppColors.surface, + backgroundImage: _avatarPath != null + ? (_avatarPath!.startsWith('http') + ? NetworkImage(_avatarPath!) + : FileImage(XFile(_avatarPath!).path as dynamic)) + : null, + child: _avatarPath == null + ? Icon( + Icons.camera_alt, + size: 30, + color: AppColors.primary, + ) + : null, + ), + ), + ), + ), + const SizedBox(height: 8), + Center( + child: Text( + '点击更换头像', + style: TextStyle( + fontSize: 12, + color: AppColors.onSurfaceVariant, + ), + ), + ), + const SizedBox(height: 32), + + // 基本信息 + _buildSectionTitle('基本信息'), + const SizedBox(height: 16), + + CustomTextField( + controller: _usernameController, + labelText: '用户名', + hintText: '请输入用户名', + validator: (value) { + if (value == null || value.trim().isEmpty) { + return '请输入用户名'; + } + return null; + }, + ), + const SizedBox(height: 16), + + CustomTextField( + controller: _realNameController, + labelText: '真实姓名', + hintText: '请输入真实姓名', + ), + const SizedBox(height: 16), + + CustomTextField( + controller: _emailController, + labelText: '邮箱', + hintText: '请输入邮箱地址', + keyboardType: TextInputType.emailAddress, + enabled: false, // 邮箱通常不允许修改 + ), + const SizedBox(height: 16), + + CustomTextField( + controller: _phoneController, + labelText: '手机号', + hintText: '请输入手机号', + keyboardType: TextInputType.phone, + ), + const SizedBox(height: 16), + + // 性别选择 + _buildDropdownField( + label: '性别', + value: _selectedGender, + items: _genderOptions, + displayNameBuilder: _getGenderDisplayName, + onChanged: (value) { + setState(() { + _selectedGender = value; + }); + }, + ), + const SizedBox(height: 16), + + // 生日选择 + _buildDateField( + label: '生日', + value: _selectedBirthday, + onTap: _selectBirthday, + ), + const SizedBox(height: 16), + + CustomTextField( + controller: _locationController, + labelText: '所在地', + hintText: '请输入所在地', + ), + const SizedBox(height: 16), + + CustomTextField( + controller: _occupationController, + labelText: '职业', + hintText: '请输入职业', + ), + const SizedBox(height: 16), + + // 教育背景 + _buildDropdownField( + label: '教育背景', + value: _selectedEducation, + items: _educationOptions, + displayNameBuilder: (value) => value, + onChanged: (value) { + setState(() { + _selectedEducation = value; + }); + }, + ), + const SizedBox(height: 32), + + // 学习信息 + _buildSectionTitle('学习信息'), + const SizedBox(height: 16), + + // 当前英语水平 + _buildDropdownField( + label: '当前英语水平', + value: _selectedEnglishLevel, + items: _englishLevelOptions, + displayNameBuilder: _getEnglishLevelDisplayName, + onChanged: (value) { + setState(() { + _selectedEnglishLevel = value; + }); + }, + ), + const SizedBox(height: 16), + + // 目标英语水平 + _buildDropdownField( + label: '目标英语水平', + value: _selectedTargetLevel, + items: _englishLevelOptions, + displayNameBuilder: _getEnglishLevelDisplayName, + onChanged: (value) { + setState(() { + _selectedTargetLevel = value; + }); + }, + ), + const SizedBox(height: 16), + + // 学习目标 + _buildDropdownField( + label: '学习目标', + value: _selectedLearningGoal, + items: _learningGoalOptions, + displayNameBuilder: _getLearningGoalDisplayName, + onChanged: (value) { + setState(() { + _selectedLearningGoal = value; + }); + }, + ), + const SizedBox(height: 16), + + // 兴趣爱好 + _buildInterestsField(), + const SizedBox(height: 32), + + // 个人简介 + _buildSectionTitle('个人简介'), + const SizedBox(height: 16), + + CustomTextField( + controller: _bioController, + labelText: '个人简介', + hintText: '介绍一下自己吧...', + maxLines: 4, + ), + const SizedBox(height: 32), + + // 保存按钮 + CustomButton( + text: '保存修改', + onPressed: _saveProfile, + isLoading: _isLoading, + ), + const SizedBox(height: 32), + ], + ), + ), + ), + if (_isLoading) + Container( + color: Colors.black.withOpacity(0.3), + child: const Center( + child: CircularProgressIndicator(), + ), + ), + ], + ), + ); + } + + Widget _buildSectionTitle(String title) { + return Text( + title, + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: AppColors.onSurface, + ), + ); + } + + Widget _buildDropdownField({ + required String label, + required String? value, + required List items, + required String Function(String) displayNameBuilder, + required void Function(String?) onChanged, + }) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + label, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 8), + Container( + width: double.infinity, + padding: const EdgeInsets.symmetric(horizontal: 12), + decoration: BoxDecoration( + border: Border.all(color: AppColors.outline), + borderRadius: BorderRadius.circular(8), + ), + child: DropdownButtonHideUnderline( + child: DropdownButton( + value: value, + hint: Text('请选择$label'), + isExpanded: true, + items: items.map((item) { + return DropdownMenuItem( + value: item, + child: Text(displayNameBuilder(item)), + ); + }).toList(), + onChanged: onChanged, + ), + ), + ), + ], + ); + } + + Widget _buildDateField({ + required String label, + required DateTime? value, + required VoidCallback onTap, + }) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + label, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 8), + GestureDetector( + onTap: onTap, + child: Container( + width: double.infinity, + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 16), + decoration: BoxDecoration( + border: Border.all(color: AppColors.outline), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + value != null + ? '${value.year}-${value.month.toString().padLeft(2, '0')}-${value.day.toString().padLeft(2, '0')}' + : '请选择$label', + style: TextStyle( + fontSize: 16, + color: value != null ? AppColors.onSurface : AppColors.onSurfaceVariant, + ), + ), + Icon( + Icons.calendar_today, + color: AppColors.onSurfaceVariant, + size: 20, + ), + ], + ), + ), + ), + ], + ); + } + + Widget _buildInterestsField() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '兴趣爱好', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 8), + GestureDetector( + onTap: _showInterestsDialog, + child: Container( + width: double.infinity, + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 16), + decoration: BoxDecoration( + border: Border.all(color: AppColors.outline), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Expanded( + child: _interests.isEmpty + ? Text( + '请选择兴趣爱好', + style: TextStyle( + fontSize: 16, + color: AppColors.onSurfaceVariant, + ), + ) + : Wrap( + spacing: 8, + runSpacing: 4, + children: _interests.map((interest) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: AppColors.primary.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + interest, + style: TextStyle( + fontSize: 12, + color: AppColors.primary, + ), + ), + ); + }).toList(), + ), + ), + Icon( + Icons.arrow_forward_ios, + color: AppColors.onSurfaceVariant, + size: 16, + ), + ], + ), + ), + ), + ], + ); + } +} \ No newline at end of file diff --git a/client/lib/features/profile/screens/profile_home_screen.dart b/client/lib/features/profile/screens/profile_home_screen.dart new file mode 100644 index 0000000..43ea017 --- /dev/null +++ b/client/lib/features/profile/screens/profile_home_screen.dart @@ -0,0 +1,86 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/routes/app_routes.dart'; +import '../../auth/providers/auth_provider.dart'; + +class ProfileHomeScreen extends ConsumerWidget { + const ProfileHomeScreen({super.key}); + + @override + Widget build(BuildContext context, WidgetRef ref) { + final authState = ref.watch(authProvider); + final user = authState.user; + final isAuthenticated = authState.isAuthenticated; + + if (!isAuthenticated || user == null) { + return _buildLoginPrompt(context); + } + + return Scaffold( + backgroundColor: AppColors.surface, + appBar: AppBar( + title: const Text('个人中心'), + backgroundColor: AppColors.primary, + ), + body: Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + CircleAvatar( + radius: 50, + backgroundColor: AppColors.primary, + child: Text( + user.username?.substring(0, 1).toUpperCase() ?? 'U', + style: const TextStyle(fontSize: 32, color: Colors.white), + ), + ), + const SizedBox(height: 16), + Text( + user.username ?? '用户', + style: const TextStyle(fontSize: 24, fontWeight: FontWeight.bold), + ), + const SizedBox(height: 8), + Text( + user.email ?? '', + style: const TextStyle(fontSize: 16, color: Colors.grey), + ), + const SizedBox(height: 32), + ElevatedButton( + onPressed: () async { + await ref.read(authProvider.notifier).logout(); + if (context.mounted) { + Navigator.of(context).pushReplacementNamed(Routes.login); + } + }, + child: const Text('退出登录'), + ), + ], + ), + ), + ); + } + + Widget _buildLoginPrompt(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.surface, + body: Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + const Icon(Icons.person_outline, size: 80, color: Colors.grey), + const SizedBox(height: 16), + const Text('请先登录', style: TextStyle(fontSize: 20)), + const SizedBox(height: 32), + ElevatedButton( + onPressed: () { + Navigator.of(context).pushNamed(Routes.login); + }, + child: const Text('去登录'), + ), + ], + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/profile/screens/profile_home_screen_fixed.dart b/client/lib/features/profile/screens/profile_home_screen_fixed.dart new file mode 100644 index 0000000..1f41e28 --- /dev/null +++ b/client/lib/features/profile/screens/profile_home_screen_fixed.dart @@ -0,0 +1,86 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/theme/app_theme.dart'; +import '../../../core/routes/app_routes.dart'; +import '../../auth/providers/auth_provider.dart'; + +class ProfileHomeScreen extends ConsumerWidget { + const ProfileHomeScreen({super.key}); + + @override + Widget build(BuildContext context, WidgetRef ref) { + final authState = ref.watch(authProvider); + final user = authState.user; + final isAuthenticated = authState.isAuthenticated; + + if (!isAuthenticated || user == null) { + return _buildLoginPrompt(context); + } + + return Scaffold( + backgroundColor: AppColors.surface, + appBar: AppBar( + title: const Text('个人中心'), + backgroundColor: AppColors.primary, + ), + body: Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + CircleAvatar( + radius: 50, + backgroundColor: AppColors.primary, + child: Text( + user.username?.substring(0, 1).toUpperCase() ?? 'U', + style: const TextStyle(fontSize: 32, color: Colors.white), + ), + ), + const SizedBox(height: 16), + Text( + user.username ?? '用户', + style: const TextStyle(fontSize: 24, fontWeight: FontWeight.bold), + ), + const SizedBox(height: 8), + Text( + user.email ?? '', + style: const TextStyle(fontSize: 16, color: Colors.grey), + ), + const SizedBox(height: 32), + ElevatedButton( + onPressed: () async { + await ref.read(authProvider.notifier).logout(); + if (context.mounted) { + Navigator.of(context).pushReplacementNamed(Routes.login); + } + }, + child: const Text('退出登录'), + ), + ], + ), + ), + ); + } + + Widget _buildLoginPrompt(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.surface, + body: Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + const Icon(Icons.person_outline, size: 80, color: Colors.grey), + const SizedBox(height: 16), + const Text('请先登录', style: TextStyle(fontSize: 20)), + const SizedBox(height: 32), + ElevatedButton( + onPressed: () { + Navigator.of(context).pushNamed(Routes.login); + }, + child: const Text('去登录'), + ), + ], + ), + ), + ); + } +} diff --git a/client/lib/features/profile/screens/settings_screen.dart b/client/lib/features/profile/screens/settings_screen.dart new file mode 100644 index 0000000..e893644 --- /dev/null +++ b/client/lib/features/profile/screens/settings_screen.dart @@ -0,0 +1,731 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/models/user_model.dart'; +import '../../auth/providers/auth_provider.dart'; +import 'change_password_screen.dart'; + +/// 设置屏幕 +class SettingsScreen extends StatefulWidget { + const SettingsScreen({super.key}); + + @override + State createState() => _SettingsScreenState(); +} + +class _SettingsScreenState extends State { + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: AppColors.background, + appBar: _buildAppBar(), + body: SafeArea( + child: SingleChildScrollView( + child: Column( + children: [ + // 通知设置 + _buildNotificationSettings(), + const SizedBox(height: AppDimensions.spacingSm), + + // 学习设置 + _buildLearningSettings(), + const SizedBox(height: AppDimensions.spacingSm), + + // 账户设置 + _buildAccountSettings(), + const SizedBox(height: AppDimensions.spacingSm), + + // 其他设置 + _buildOtherSettings(), + const SizedBox(height: AppDimensions.spacingXl), + ], + ), + ), + ), + ); + } + + /// 构建应用栏 + PreferredSizeWidget _buildAppBar() { + return AppBar( + backgroundColor: AppColors.surface, + foregroundColor: AppColors.onSurface, + elevation: 0, + title: Text( + '设置', + style: AppTextStyles.titleLarge.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + ); + } + + /// 构建通知设置 + Widget _buildNotificationSettings() { + return Consumer( + builder: (context, authNotifier, child) { + final user = authNotifier.state.user; + final settings = user?.profile?.settings ?? const UserSettings(); + + return _buildSettingsSection( + title: '通知设置', + icon: Icons.notifications_outlined, + children: [ + _buildSwitchTile( + title: '推送通知', + subtitle: '接收学习提醒和重要消息', + value: settings.notificationsEnabled, + onChanged: (value) { + _updateSettings(settings.copyWith( + notificationsEnabled: value, + )); + }, + ), + _buildSwitchTile( + title: '声音提醒', + subtitle: '播放通知声音', + value: settings.soundEnabled, + onChanged: (value) { + _updateSettings(settings.copyWith( + soundEnabled: value, + )); + }, + ), + _buildSwitchTile( + title: '振动提醒', + subtitle: '接收通知时振动', + value: settings.vibrationEnabled, + onChanged: (value) { + _updateSettings(settings.copyWith( + vibrationEnabled: value, + )); + }, + ), + ], + ); + }, + ); + } + + /// 构建学习设置 + Widget _buildLearningSettings() { + return Consumer( + builder: (context, authNotifier, child) { + final user = authNotifier.state.user; + final settings = user?.profile?.settings ?? const UserSettings(); + + return _buildSettingsSection( + title: '学习设置', + icon: Icons.school_outlined, + children: [ + _buildListTile( + title: '每日单词目标', + subtitle: '${settings.dailyWordGoal} 个单词', + trailing: const Icon(Icons.chevron_right), + onTap: () => _showDailyGoalDialog('word', settings.dailyWordGoal), + ), + _buildListTile( + title: '每日学习时长', + subtitle: '${settings.dailyStudyMinutes} 分钟', + trailing: const Icon(Icons.chevron_right), + onTap: () => _showDailyGoalDialog('time', settings.dailyStudyMinutes), + ), + _buildSwitchTile( + title: '自动播放音频', + subtitle: '学习时自动播放单词发音', + value: settings.autoPlayAudio, + onChanged: (value) { + _updateSettings(settings.copyWith( + autoPlayAudio: value, + )); + }, + ), + _buildListTile( + title: '音频播放速度', + subtitle: '${settings.audioSpeed}x', + trailing: const Icon(Icons.chevron_right), + onTap: () => _showAudioSpeedDialog(settings.audioSpeed), + ), + _buildSwitchTile( + title: '显示中文翻译', + subtitle: '学习时显示单词翻译', + value: settings.showTranslation, + onChanged: (value) { + _updateSettings(settings.copyWith( + showTranslation: value, + )); + }, + ), + _buildSwitchTile( + title: '显示音标', + subtitle: '学习时显示单词音标', + value: settings.showPronunciation, + onChanged: (value) { + _updateSettings(settings.copyWith( + showPronunciation: value, + )); + }, + ), + ], + ); + }, + ); + } + + /// 构建账户设置 + Widget _buildAccountSettings() { + return _buildSettingsSection( + title: '账户设置', + icon: Icons.account_circle_outlined, + children: [ + _buildListTile( + title: '修改密码', + subtitle: '更改登录密码', + trailing: const Icon(Icons.chevron_right), + onTap: () { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => const ChangePasswordScreen(), + ), + ); + }, + ), + _buildListTile( + title: '清除缓存', + subtitle: '清除本地缓存数据', + trailing: const Icon(Icons.chevron_right), + onTap: _showClearCacheDialog, + ), + _buildListTile( + title: '退出登录', + subtitle: '退出当前账户', + trailing: const Icon(Icons.chevron_right), + onTap: _showLogoutDialog, + ), + _buildListTile( + title: '注销账户', + subtitle: '永久删除账户和数据', + trailing: const Icon(Icons.chevron_right), + textColor: AppColors.error, + onTap: _showDeleteAccountDialog, + ), + ], + ); + } + + /// 构建其他设置 + Widget _buildOtherSettings() { + return Consumer( + builder: (context, authNotifier, child) { + final user = authNotifier.state.user; + final settings = user?.profile?.settings ?? const UserSettings(); + + return _buildSettingsSection( + title: '其他设置', + icon: Icons.settings_outlined, + children: [ + _buildListTile( + title: '语言设置', + subtitle: _getLanguageDisplayName(settings.language), + trailing: const Icon(Icons.chevron_right), + onTap: () => _showLanguageDialog(settings.language), + ), + _buildListTile( + title: '主题设置', + subtitle: _getThemeDisplayName(settings.theme), + trailing: const Icon(Icons.chevron_right), + onTap: () => _showThemeDialog(settings.theme), + ), + _buildListTile( + title: '关于我们', + subtitle: '版本信息和帮助', + trailing: const Icon(Icons.chevron_right), + onTap: _showAboutDialog, + ), + _buildListTile( + title: '用户协议', + subtitle: '查看用户服务协议', + trailing: const Icon(Icons.chevron_right), + onTap: () => _showWebView('用户协议', 'https://example.com/terms'), + ), + _buildListTile( + title: '隐私政策', + subtitle: '查看隐私保护政策', + trailing: const Icon(Icons.chevron_right), + onTap: () => _showWebView('隐私政策', 'https://example.com/privacy'), + ), + ], + ); + }, + ); + } + + /// 构建设置分组 + Widget _buildSettingsSection({ + required String title, + required IconData icon, + required List children, + }) { + return Container( + margin: const EdgeInsets.symmetric( + horizontal: AppDimensions.spacingMd, + ), + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.05), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 分组标题 + Padding( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + child: Row( + children: [ + Icon( + icon, + color: AppColors.primary, + size: 20, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + title, + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + ), + + // 分组内容 + ...children, + ], + ), + ); + } + + /// 构建列表项 + Widget _buildListTile({ + required String title, + required String subtitle, + Widget? trailing, + VoidCallback? onTap, + Color? textColor, + }) { + return ListTile( + title: Text( + title, + style: AppTextStyles.bodyLarge.copyWith( + color: textColor ?? AppColors.onSurface, + fontWeight: FontWeight.w500, + ), + ), + subtitle: Text( + subtitle, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + trailing: trailing, + onTap: onTap, + contentPadding: const EdgeInsets.symmetric( + horizontal: AppDimensions.spacingMd, + vertical: AppDimensions.spacingXs, + ), + ); + } + + /// 构建开关项 + Widget _buildSwitchTile({ + required String title, + required String subtitle, + required bool value, + required ValueChanged onChanged, + }) { + return SwitchListTile( + title: Text( + title, + style: AppTextStyles.bodyLarge.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w500, + ), + ), + subtitle: Text( + subtitle, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + value: value, + onChanged: onChanged, + activeColor: AppColors.primary, + contentPadding: const EdgeInsets.symmetric( + horizontal: AppDimensions.spacingMd, + vertical: AppDimensions.spacingXs, + ), + ); + } + + /// 更新设置 + Future _updateSettings(UserSettings settings) async { + try { + final authNotifier = Provider.of(context, listen: false); + final currentUser = authNotifier.state.user; + + if (currentUser != null) { + // 将设置转换为Map格式传递给updateProfile + final settingsMap = { + 'notificationsEnabled': settings.notificationsEnabled, + 'soundEnabled': settings.soundEnabled, + 'vibrationEnabled': settings.vibrationEnabled, + 'language': settings.language, + 'theme': settings.theme, + 'dailyGoal': settings.dailyGoal, + 'dailyWordGoal': settings.dailyWordGoal, + 'dailyStudyMinutes': settings.dailyStudyMinutes, + 'reminderTimes': settings.reminderTimes, + 'autoPlayAudio': settings.autoPlayAudio, + 'audioSpeed': settings.audioSpeed, + 'showTranslation': settings.showTranslation, + 'showPronunciation': settings.showPronunciation, + }; + + await authNotifier.updateProfile( + username: currentUser.username, + email: currentUser.email, + phone: currentUser.profile?.phone, + avatar: currentUser.profile?.avatar, + ); + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('设置更新失败: $e'), + backgroundColor: AppColors.error, + ), + ); + } + } + } + + /// 显示每日目标设置对话框 + void _showDailyGoalDialog(String type, int currentValue) { + final controller = TextEditingController(text: currentValue.toString()); + + showDialog( + context: context, + builder: (context) => AlertDialog( + title: Text(type == 'word' ? '设置每日单词目标' : '设置每日学习时长'), + content: TextField( + controller: controller, + keyboardType: TextInputType.number, + decoration: InputDecoration( + labelText: type == 'word' ? '单词数量' : '分钟数', + suffixText: type == 'word' ? '个' : '分钟', + ), + ), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + TextButton( + onPressed: () { + final value = int.tryParse(controller.text) ?? currentValue; + if (value > 0) { + final authNotifier = Provider.of(context, listen: false); + final user = authNotifier.state.user; + final settings = user?.profile?.settings ?? UserSettings(); + + if (type == 'word') { + _updateSettings(settings.copyWith(dailyWordGoal: value)); + } else { + _updateSettings(settings.copyWith(dailyStudyMinutes: value)); + } + } + Navigator.pop(context); + }, + child: const Text('确定'), + ), + ], + ), + ); + } + + /// 显示音频速度设置对话框 + void _showAudioSpeedDialog(double currentSpeed) { + final speeds = [0.5, 0.75, 1.0, 1.25, 1.5, 2.0]; + + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('设置音频播放速度'), + content: Column( + mainAxisSize: MainAxisSize.min, + children: speeds.map((speed) { + return RadioListTile( + title: Text('${speed}x'), + value: speed, + groupValue: currentSpeed, + onChanged: (value) { + if (value != null) { + final authNotifier = Provider.of(context, listen: false); + final user = authNotifier.state.user; + final settings = user?.profile?.settings ?? const UserSettings(); + + _updateSettings(settings.copyWith(audioSpeed: value)); + } + Navigator.pop(context); + }, + ); + }).toList(), + ), + ), + ); + } + + /// 显示语言设置对话框 + void _showLanguageDialog(String currentLanguage) { + final languages = { + 'zh': '中文', + 'en': 'English', + }; + + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('选择语言'), + content: Column( + mainAxisSize: MainAxisSize.min, + children: languages.entries.map((entry) { + return RadioListTile( + title: Text(entry.value), + value: entry.key, + groupValue: currentLanguage, + onChanged: (value) { + if (value != null) { + final authNotifier = Provider.of(context, listen: false); + final user = authNotifier.state.user; + final settings = user?.profile?.settings ?? const UserSettings(); + + _updateSettings(settings.copyWith(language: value)); + } + Navigator.pop(context); + }, + ); + }).toList(), + ), + ), + ); + } + + /// 显示主题设置对话框 + void _showThemeDialog(String currentTheme) { + final themes = { + 'light': '浅色主题', + 'dark': '深色主题', + 'system': '跟随系统', + }; + + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('选择主题'), + content: Column( + mainAxisSize: MainAxisSize.min, + children: themes.entries.map((entry) { + return RadioListTile( + title: Text(entry.value), + value: entry.key, + groupValue: currentTheme, + onChanged: (value) { + if (value != null) { + final authNotifier = Provider.of(context, listen: false); + final user = authNotifier.state.user; + final settings = user?.profile?.settings ?? const UserSettings(); + + _updateSettings(settings.copyWith(theme: value)); + } + Navigator.pop(context); + }, + ); + }).toList(), + ), + ), + ); + } + + /// 显示清除缓存对话框 + void _showClearCacheDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('清除缓存'), + content: const Text('确定要清除所有缓存数据吗？这将删除已下载的音频、图片等文件。'), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + TextButton( + onPressed: () { + // TODO: 实现清除缓存逻辑 + Navigator.pop(context); + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('缓存已清除')), + ); + }, + child: const Text('确定'), + ), + ], + ), + ); + } + + /// 显示退出登录对话框 + void _showLogoutDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('退出登录'), + content: const Text('确定要退出当前账户吗？'), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + TextButton( + onPressed: () async { + final authNotifier = Provider.of(context, listen: false); + await authNotifier.logout(); + if (mounted) { + Navigator.pop(context); + Navigator.pushNamedAndRemoveUntil( + context, + '/login', + (route) => false, + ); + } + }, + child: const Text('确定'), + ), + ], + ), + ); + } + + /// 显示注销账户对话框 + void _showDeleteAccountDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: Text( + '注销账户', + style: TextStyle(color: AppColors.error), + ), + content: const Text( + '警告：此操作将永久删除您的账户和所有数据，且无法恢复。确定要继续吗？', + ), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + TextButton( + onPressed: () { + // TODO: 实现注销账户逻辑 + Navigator.pop(context); + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: const Text('账户注销功能暂未开放'), + backgroundColor: AppColors.warning, + ), + ); + }, + style: TextButton.styleFrom( + foregroundColor: AppColors.error, + ), + child: const Text('确定注销'), + ), + ], + ), + ); + } + + /// 显示关于对话框 + void _showAboutDialog() { + showAboutDialog( + context: context, + applicationName: 'AI英语学习', + applicationVersion: '1.0.0', + applicationIcon: Container( + width: 64, + height: 64, + decoration: BoxDecoration( + color: AppColors.primary, + borderRadius: BorderRadius.circular(16), + ), + child: Icon( + Icons.school, + color: AppColors.onPrimary, + size: 32, + ), + ), + children: [ + const Text('一款基于AI技术的智能英语学习应用'), + const SizedBox(height: 16), + const Text('© 2024 AI英语学习团队'), + ], + ); + } + + /// 显示网页视图 + void _showWebView(String title, String url) { + // TODO: 实现网页视图 + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('即将打开: $title'), + ), + ); + } + + /// 获取语言显示名称 + String _getLanguageDisplayName(String language) { + switch (language) { + case 'zh': + return '中文'; + case 'en': + return 'English'; + default: + return '中文'; + } + } + + /// 获取主题显示名称 + String _getThemeDisplayName(String theme) { + switch (theme) { + case 'light': + return '浅色主题'; + case 'dark': + return '深色主题'; + case 'system': + return '跟随系统'; + default: + return '浅色主题'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/profile/widgets/about_dialog.dart b/client/lib/features/profile/widgets/about_dialog.dart new file mode 100644 index 0000000..b2ac438 --- /dev/null +++ b/client/lib/features/profile/widgets/about_dialog.dart @@ -0,0 +1,576 @@ +import 'package:flutter/material.dart'; +import 'package:flutter/services.dart'; +import 'package:package_info_plus/package_info_plus.dart'; +import '../../../core/theme/app_colors.dart'; + +/// 关于应用对话框 +class AboutAppDialog extends StatefulWidget { + const AboutAppDialog({super.key}); + + @override + State createState() => _AboutAppDialogState(); +} + +class _AboutAppDialogState extends State { + PackageInfo? _packageInfo; + + @override + void initState() { + super.initState(); + _loadPackageInfo(); + } + + Future _loadPackageInfo() async { + try { + final packageInfo = await PackageInfo.fromPlatform(); + if (mounted) { + setState(() { + _packageInfo = packageInfo; + }); + } + } catch (e) { + // 如果获取包信息失败，使用默认值 + if (mounted) { + setState(() { + _packageInfo = PackageInfo( + appName: 'AI英语学习', + packageName: 'com.example.ai_english_learning', + version: '1.0.0', + buildNumber: '1', + buildSignature: '', + installerStore: null, + ); + }); + } + } + } + + @override + Widget build(BuildContext context) { + return Dialog( + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Container( + padding: const EdgeInsets.all(24), + constraints: const BoxConstraints(maxWidth: 400), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + // 应用图标和名称 + _buildAppHeader(), + + const SizedBox(height: 24), + + // 版本信息 + _buildVersionInfo(), + + const SizedBox(height: 24), + + // 应用描述 + _buildAppDescription(), + + const SizedBox(height: 24), + + // 开发团队信息 + _buildTeamInfo(), + + const SizedBox(height: 24), + + // 联系方式 + _buildContactInfo(), + + const SizedBox(height: 24), + + // 法律信息 + _buildLegalInfo(), + + const SizedBox(height: 24), + + // 关闭按钮 + _buildCloseButton(), + ], + ), + ), + ); + } + + /// 构建应用头部 + Widget _buildAppHeader() { + return Column( + children: [ + // 应用图标 + Container( + width: 80, + height: 80, + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [ + AppColors.primary, + AppColors.primary.withOpacity(0.8), + ], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + borderRadius: BorderRadius.circular(20), + boxShadow: [ + BoxShadow( + color: AppColors.primary.withOpacity(0.3), + blurRadius: 20, + offset: const Offset(0, 8), + ), + ], + ), + child: const Icon( + Icons.school, + color: Colors.white, + size: 40, + ), + ), + + const SizedBox(height: 16), + + // 应用名称 + Text( + _packageInfo?.appName ?? 'AI英语学习', + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + color: AppColors.onSurface, + ), + ), + + const SizedBox(height: 8), + + // 应用标语 + Text( + '智能化英语学习助手', + style: TextStyle( + fontSize: 16, + color: AppColors.onSurfaceVariant, + ), + ), + ], + ); + } + + /// 构建版本信息 + Widget _buildVersionInfo() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: AppColors.outline.withOpacity(0.2), + ), + ), + child: Column( + children: [ + _buildInfoRow( + '版本号', + _packageInfo?.version ?? '1.0.0', + ), + const SizedBox(height: 8), + _buildInfoRow( + '构建号', + _packageInfo?.buildNumber ?? '1', + ), + const SizedBox(height: 8), + _buildInfoRow( + '发布日期', + '2024年1月', + ), + ], + ), + ); + } + + /// 构建应用描述 + Widget _buildAppDescription() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '应用介绍', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.w600, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 12), + Text( + 'AI英语学习是一款基于人工智能技术的英语学习应用，提供个性化的学习方案，包括单词记忆、语法练习、听力训练、口语练习等功能，帮助用户高效提升英语水平。', + style: TextStyle( + fontSize: 14, + color: AppColors.onSurfaceVariant, + height: 1.5, + ), + ), + ], + ); + } + + /// 构建团队信息 + Widget _buildTeamInfo() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '开发团队', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.w600, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 12), + _buildTeamMember('产品经理', 'Alice Wang'), + _buildTeamMember('技术负责人', 'Bob Chen'), + _buildTeamMember('UI/UX设计师', 'Carol Li'), + _buildTeamMember('前端开发', 'David Zhang'), + _buildTeamMember('后端开发', 'Eva Liu'), + ], + ); + } + + /// 构建团队成员信息 + Widget _buildTeamMember(String role, String name) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 4), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + role, + style: TextStyle( + fontSize: 14, + color: AppColors.onSurfaceVariant, + ), + ), + Text( + name, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: AppColors.onSurface, + ), + ), + ], + ), + ); + } + + /// 构建联系信息 + Widget _buildContactInfo() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '联系我们', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.w600, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 12), + _buildContactItem( + Icons.email, + '邮箱', + 'support@aienglish.com', + () => _copyToClipboard('support@aienglish.com', '邮箱地址已复制'), + ), + _buildContactItem( + Icons.language, + '官网', + 'www.aienglish.com', + () => _copyToClipboard('www.aienglish.com', '网址已复制'), + ), + _buildContactItem( + Icons.phone, + '客服电话', + '400-123-4567', + () => _copyToClipboard('400-123-4567', '电话号码已复制'), + ), + ], + ); + } + + /// 构建联系项目 + Widget _buildContactItem( + IconData icon, + String label, + String value, + VoidCallback onTap, + ) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 4), + child: GestureDetector( + onTap: onTap, + child: Row( + children: [ + Icon( + icon, + size: 16, + color: AppColors.primary, + ), + const SizedBox(width: 8), + Text( + '$label: ', + style: TextStyle( + fontSize: 14, + color: AppColors.onSurfaceVariant, + ), + ), + Expanded( + child: Text( + value, + style: TextStyle( + fontSize: 14, + color: AppColors.primary, + decoration: TextDecoration.underline, + ), + ), + ), + Icon( + Icons.copy, + size: 16, + color: AppColors.onSurfaceVariant, + ), + ], + ), + ), + ); + } + + /// 构建法律信息 + Widget _buildLegalInfo() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '法律信息', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.w600, + color: AppColors.onSurface, + ), + ), + const SizedBox(height: 12), + Row( + mainAxisAlignment: MainAxisAlignment.spaceAround, + children: [ + _buildLegalLink('用户协议', () => _showLegalDocument('用户协议')), + _buildLegalLink('隐私政策', () => _showLegalDocument('隐私政策')), + _buildLegalLink('开源许可', () => _showLicenses()), + ], + ), + const SizedBox(height: 12), + Text( + '© 2024 AI英语学习团队. 保留所有权利.', + style: TextStyle( + fontSize: 12, + color: AppColors.onSurfaceVariant, + ), + textAlign: TextAlign.center, + ), + ], + ); + } + + /// 构建法律链接 + Widget _buildLegalLink(String text, VoidCallback onTap) { + return GestureDetector( + onTap: onTap, + child: Text( + text, + style: TextStyle( + fontSize: 14, + color: AppColors.primary, + decoration: TextDecoration.underline, + ), + ), + ); + } + + /// 构建信息行 + Widget _buildInfoRow(String label, String value) { + return Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + label, + style: TextStyle( + fontSize: 14, + color: AppColors.onSurfaceVariant, + ), + ), + Text( + value, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: AppColors.onSurface, + ), + ), + ], + ); + } + + /// 构建关闭按钮 + Widget _buildCloseButton() { + return SizedBox( + width: double.infinity, + child: ElevatedButton( + onPressed: () => Navigator.of(context).pop(), + style: ElevatedButton.styleFrom( + backgroundColor: AppColors.primary, + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(vertical: 12), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + child: const Text( + '关闭', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + ), + ); + } + + /// 复制到剪贴板 + void _copyToClipboard(String text, String message) { + Clipboard.setData(ClipboardData(text: text)); + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text(message), + duration: const Duration(seconds: 2), + ), + ); + } + + /// 显示法律文档 + void _showLegalDocument(String title) { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: Text(title), + content: SingleChildScrollView( + child: Text( + title == '用户协议' + ? _getUserAgreementText() + : _getPrivacyPolicyText(), + style: const TextStyle(fontSize: 14, height: 1.5), + ), + ), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('关闭'), + ), + ], + ), + ); + } + + /// 显示开源许可 + void _showLicenses() { + showLicensePage( + context: context, + applicationName: _packageInfo?.appName ?? 'AI英语学习', + applicationVersion: _packageInfo?.version ?? '1.0.0', + applicationIcon: Container( + width: 48, + height: 48, + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [ + AppColors.primary, + AppColors.primary.withOpacity(0.8), + ], + ), + borderRadius: BorderRadius.circular(12), + ), + child: const Icon( + Icons.school, + color: Colors.white, + size: 24, + ), + ), + ); + } + + /// 获取用户协议文本 + String _getUserAgreementText() { + return ''' +欢迎使用AI英语学习应用！ + +1. 服务条款 +本应用为用户提供英语学习服务，包括但不限于单词学习、语法练习、听力训练等功能。 + +2. 用户责任 +用户应当合法使用本应用，不得进行任何违法违规行为。 + +3. 隐私保护 +我们重视用户隐私，详细信息请查看隐私政策。 + +4. 知识产权 +本应用的所有内容均受知识产权法保护。 + +5. 免责声明 +本应用仅供学习参考，不承担任何学习效果保证责任。 + +6. 协议修改 +我们保留随时修改本协议的权利，修改后的协议将在应用内公布。 + +如有疑问，请联系客服：support@aienglish.com +'''; + } + + /// 获取隐私政策文本 + String _getPrivacyPolicyText() { + return ''' +AI英语学习隐私政策 + +1. 信息收集 +我们可能收集以下信息： +- 账户信息（用户名、邮箱等） +- 学习数据（学习进度、成绩等） +- 设备信息（设备型号、操作系统等） + +2. 信息使用 +收集的信息用于： +- 提供个性化学习服务 +- 改进应用功能 +- 发送重要通知 + +3. 信息保护 +我们采用行业标准的安全措施保护用户信息。 + +4. 信息共享 +除法律要求外，我们不会与第三方共享用户个人信息。 + +5. Cookie使用 +我们可能使用Cookie来改善用户体验。 + +6. 政策更新 +本隐私政策可能会定期更新，请关注最新版本。 + +联系我们：support@aienglish.com +'''; + } +} + +/// 显示关于应用对话框的便捷方法 +void showAboutAppDialog(BuildContext context) { + showDialog( + context: context, + builder: (context) => const AboutAppDialog(), + ); +} \ No newline at end of file diff --git a/client/lib/features/profile/widgets/learning_preferences_card.dart b/client/lib/features/profile/widgets/learning_preferences_card.dart new file mode 100644 index 0000000..8966bae --- /dev/null +++ b/client/lib/features/profile/widgets/learning_preferences_card.dart @@ -0,0 +1,100 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; + +/// 学习偏好卡片组件 +class LearningPreferencesCard extends StatelessWidget { + final String title; + final Widget child; + final EdgeInsetsGeometry? padding; + final VoidCallback? onTap; + final IconData? icon; + + const LearningPreferencesCard({ + super.key, + required this.title, + required this.child, + this.padding, + this.onTap, + this.icon, + }); + + @override + Widget build(BuildContext context) { + return Container( + width: double.infinity, + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + border: Border.all( + color: AppColors.primary.withOpacity(0.1), + width: 1, + ), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.05), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Material( + color: Colors.transparent, + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + child: Padding( + padding: padding ?? const EdgeInsets.all(AppDimensions.spacingMd), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题行 + Row( + children: [ + if (icon != null) ...[ + Container( + padding: const EdgeInsets.all(AppDimensions.spacingSm), + decoration: BoxDecoration( + color: AppColors.primary.withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + ), + child: Icon( + icon, + color: AppColors.primary, + size: 20, + ), + ), + const SizedBox(width: AppDimensions.spacingSm), + ], + + Expanded( + child: Text( + title, + style: AppTextStyles.titleMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + ), + + if (onTap != null) + Icon( + Icons.chevron_right, + color: AppColors.onSurfaceVariant, + size: 20, + ), + ], + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 内容 + child, + ], + ), + ), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/profile/widgets/profile_avatar.dart b/client/lib/features/profile/widgets/profile_avatar.dart new file mode 100644 index 0000000..1d350cb --- /dev/null +++ b/client/lib/features/profile/widgets/profile_avatar.dart @@ -0,0 +1,144 @@ +import 'package:flutter/material.dart'; +import 'dart:io'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_dimensions.dart'; + +/// 个人资料头像组件 +class ProfileAvatar extends StatelessWidget { + final String? imageUrl; + final File? selectedImage; + final double size; + final bool isEditing; + final VoidCallback? onImageSelected; + + const ProfileAvatar({ + super.key, + this.imageUrl, + this.selectedImage, + this.size = 80, + this.isEditing = false, + this.onImageSelected, + }); + + @override + Widget build(BuildContext context) { + return Stack( + children: [ + // 头像 + Container( + width: size, + height: size, + decoration: BoxDecoration( + shape: BoxShape.circle, + border: Border.all( + color: AppColors.primary.withOpacity(0.3), + width: 2, + ), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: ClipOval( + child: _buildAvatarImage(), + ), + ), + + // 编辑按钮 + if (isEditing) + Positioned( + right: 0, + bottom: 0, + child: GestureDetector( + onTap: onImageSelected, + child: Container( + width: size * 0.3, + height: size * 0.3, + decoration: BoxDecoration( + color: AppColors.primary, + shape: BoxShape.circle, + border: Border.all( + color: AppColors.surface, + width: 2, + ), + ), + child: Icon( + Icons.camera_alt, + color: AppColors.onPrimary, + size: size * 0.15, + ), + ), + ), + ), + ], + ); + } + + /// 构建头像图片 + Widget _buildAvatarImage() { + // 优先显示选中的图片 + if (selectedImage != null) { + return Image.file( + selectedImage!, + fit: BoxFit.cover, + width: size, + height: size, + ); + } + + // 显示网络图片 + if (imageUrl != null && imageUrl!.isNotEmpty) { + return Image.network( + imageUrl!, + fit: BoxFit.cover, + width: size, + height: size, + errorBuilder: (context, error, stackTrace) { + return _buildDefaultAvatar(); + }, + loadingBuilder: (context, child, loadingProgress) { + if (loadingProgress == null) return child; + return Center( + child: CircularProgressIndicator( + value: loadingProgress.expectedTotalBytes != null + ? loadingProgress.cumulativeBytesLoaded / + loadingProgress.expectedTotalBytes! + : null, + strokeWidth: 2, + valueColor: AlwaysStoppedAnimation(AppColors.primary), + ), + ); + }, + ); + } + + // 默认头像 + return _buildDefaultAvatar(); + } + + /// 构建默认头像 + Widget _buildDefaultAvatar() { + return Container( + width: size, + height: size, + decoration: BoxDecoration( + gradient: LinearGradient( + begin: Alignment.topLeft, + end: Alignment.bottomRight, + colors: [ + AppColors.primary.withOpacity(0.8), + AppColors.primary, + ], + ), + ), + child: Icon( + Icons.person, + color: AppColors.onPrimary, + size: size * 0.5, + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/profile/widgets/profile_info_card.dart b/client/lib/features/profile/widgets/profile_info_card.dart new file mode 100644 index 0000000..ed3ce57 --- /dev/null +++ b/client/lib/features/profile/widgets/profile_info_card.dart @@ -0,0 +1,65 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../../../core/theme/app_dimensions.dart'; + +/// 个人信息卡片组件 +class ProfileInfoCard extends StatelessWidget { + final String title; + final Widget child; + final EdgeInsetsGeometry? padding; + final VoidCallback? onTap; + + const ProfileInfoCard({ + super.key, + required this.title, + required this.child, + this.padding, + this.onTap, + }); + + @override + Widget build(BuildContext context) { + return Container( + width: double.infinity, + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.05), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Material( + color: Colors.transparent, + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + child: Padding( + padding: padding ?? const EdgeInsets.all(AppDimensions.spacingMd), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题 + Text( + title, + style: AppTextStyles.titleMedium.copyWith( + color: AppColors.onSurface, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 内容 + child, + ], + ), + ), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/reading/data/reading_static_data.dart b/client/lib/features/reading/data/reading_static_data.dart new file mode 100644 index 0000000..838ca28 --- /dev/null +++ b/client/lib/features/reading/data/reading_static_data.dart @@ -0,0 +1,269 @@ +import '../models/reading_exercise_model.dart'; + +class ReadingStaticData { + // 阅读分类数据 + static const List categories = [ + ReadingCategory( + id: 'news', + name: '新闻资讯', + description: '最新的国际新闻和时事报道', + icon: 'newspaper', + articleCount: 25, + type: ReadingExerciseType.news, + ), + ReadingCategory( + id: 'story', + name: '故事文学', + description: '经典故事和现代文学作品', + icon: 'book', + articleCount: 18, + type: ReadingExerciseType.story, + ), + ReadingCategory( + id: 'science', + name: '科学探索', + description: '科学发现和研究成果', + icon: 'science', + articleCount: 22, + type: ReadingExerciseType.science, + ), + ReadingCategory( + id: 'business', + name: '商业财经', + description: '商业趋势和经济分析', + icon: 'business', + articleCount: 20, + type: ReadingExerciseType.business, + ), + ReadingCategory( + id: 'culture', + name: '文化艺术', + description: '文化传统和艺术欣赏', + icon: 'palette', + articleCount: 15, + type: ReadingExerciseType.culture, + ), + ReadingCategory( + id: 'technology', + name: '科技前沿', + description: '最新科技动态和创新', + icon: 'computer', + articleCount: 28, + type: ReadingExerciseType.technology, + ), + ReadingCategory( + id: 'health', + name: '健康生活', + description: '健康知识和生活方式', + icon: 'favorite', + articleCount: 16, + type: ReadingExerciseType.health, + ), + ReadingCategory( + id: 'travel', + name: '旅游探险', + description: '世界各地的旅游体验', + icon: 'flight', + articleCount: 12, + type: ReadingExerciseType.travel, + ), + ]; + + // 阅读练习数据 + static final List exercises = [ + // 新闻类 + ReadingExercise( + id: 'news_1', + title: 'Climate Change Summit Reaches Historic Agreement', + content: ''' +The 28th Conference of the Parties (COP28) concluded yesterday with a landmark agreement that marks a significant step forward in global climate action. Representatives from 195 countries unanimously approved a comprehensive framework aimed at limiting global temperature rise to 1.5 degrees Celsius above pre-industrial levels. + +The agreement includes ambitious targets for renewable energy adoption, with participating nations committing to triple their renewable energy capacity by 2030. Additionally, the framework establishes a \$100 billion annual fund to support developing countries in their transition to clean energy technologies. + +Dr. Sarah Mitchell, lead climate scientist at the International Environmental Institute, described the agreement as "the most comprehensive climate action plan we've seen to date." She emphasized that the success of this initiative will depend heavily on the implementation strategies adopted by individual nations. + +The agreement also addresses the critical issue of fossil fuel dependency, with developed nations pledging to reduce their carbon emissions by 50% within the next decade. This represents a significant acceleration from previous commitments and reflects the growing urgency of climate action. + +However, environmental activists have expressed mixed reactions to the agreement. While acknowledging the progress made, many argue that the timeline for implementation remains too conservative given the current rate of environmental degradation. + +The next phase will involve the development of detailed implementation plans by each participating country, with progress reviews scheduled every two years. The first comprehensive assessment is expected to take place in 2026. +''', + summary: '第28届联合国气候变化大会达成历史性协议，195个国家承诺将全球温升控制在1.5摄氏度以内。', + type: ReadingExerciseType.news, + difficulty: ReadingDifficulty.intermediate, + wordCount: 285, + estimatedTime: 4, + questions: [ + ReadingQuestion( + id: 'q1', + question: 'How many countries participated in the COP28 agreement?', + options: ['185', '195', '200', '210'], + correctAnswer: 1, + explanation: 'The text states that "Representatives from 195 countries unanimously approved a comprehensive framework."', + type: 'multiple_choice', + ), + ReadingQuestion( + id: 'q2', + question: 'What is the target for renewable energy capacity by 2030?', + options: ['Double', 'Triple', 'Quadruple', 'Increase by 50%'], + correctAnswer: 1, + explanation: 'The agreement includes "committing to triple their renewable energy capacity by 2030."', + type: 'multiple_choice', + ), + ReadingQuestion( + id: 'q3', + question: 'The agreement establishes a fund to support developing countries.', + options: ['True', 'False'], + correctAnswer: 0, + explanation: 'The text mentions "a \$100 billion annual fund to support developing countries."', + type: 'true_false', + ), + ], + tags: ['climate', 'environment', 'international', 'politics'], + source: 'Global News Network', + publishDate: DateTime(2024, 1, 15), + imageUrl: 'assets/images/climate_summit.jpg', + ), + + // 科技类 + ReadingExercise( + id: 'tech_1', + title: 'Artificial Intelligence Revolutionizes Medical Diagnosis', + content: ''' +A groundbreaking study published in the Journal of Medical Innovation reveals that artificial intelligence systems can now diagnose certain medical conditions with accuracy rates exceeding 95%. The research, conducted over three years at leading medical institutions worldwide, demonstrates AI's potential to transform healthcare delivery. + +The AI system, developed by MedTech Solutions, analyzes medical imaging data including X-rays, MRIs, and CT scans. By processing thousands of images and comparing them against a vast database of diagnosed cases, the system can identify patterns that might be missed by human radiologists. + +Dr. James Chen, the study's lead researcher, explains that the AI system is particularly effective in detecting early-stage cancers and neurological disorders. "The system's ability to identify subtle abnormalities in medical images is remarkable," he notes. "It can detect changes that are barely visible to the human eye." + +The implementation of this technology has already begun in several hospitals across North America and Europe. Initial results show a 30% reduction in diagnostic errors and a 40% decrease in the time required for diagnosis. This efficiency gain is particularly valuable in emergency situations where rapid diagnosis can be life-saving. + +However, medical professionals emphasize that AI is intended to supplement, not replace, human expertise. The technology serves as a powerful diagnostic tool that enhances physicians' capabilities rather than substituting their clinical judgment. + +The next phase of development focuses on expanding the AI's capabilities to include treatment recommendations and personalized medicine approaches. Researchers anticipate that within five years, AI-assisted diagnosis will become standard practice in most medical facilities worldwide. +''', + summary: '人工智能在医疗诊断领域取得突破，准确率超过95%，有望变革医疗服务。', + type: ReadingExerciseType.technology, + difficulty: ReadingDifficulty.proficient, + wordCount: 312, + estimatedTime: 5, + questions: [ + ReadingQuestion( + id: 'q1', + question: 'What is the accuracy rate of the AI diagnostic system?', + options: ['Over 90%', 'Over 95%', 'Over 98%', 'Over 99%'], + correctAnswer: 1, + explanation: 'The text states "accuracy rates exceeding 95%."', + type: 'multiple_choice', + ), + ReadingQuestion( + id: 'q2', + question: 'How long was the research study conducted?', + options: ['Two years', 'Three years', 'Four years', 'Five years'], + correctAnswer: 1, + explanation: 'The research was "conducted over three years."', + type: 'multiple_choice', + ), + ReadingQuestion( + id: 'q3', + question: 'The AI system is designed to replace human doctors.', + options: ['True', 'False'], + correctAnswer: 1, + explanation: 'The text states that "AI is intended to supplement, not replace, human expertise."', + type: 'true_false', + ), + ], + tags: ['AI', 'medical', 'technology', 'healthcare'], + source: 'Tech Today Magazine', + publishDate: DateTime(2024, 1, 10), + imageUrl: 'assets/images/ai_medical.jpg', + ), + + // 故事类 + ReadingExercise( + id: 'story_1', + title: 'The Last Library', + content: ''' +In the year 2087, Maya discovered something extraordinary hidden beneath the ruins of what was once New York City. As she carefully moved aside the debris, her flashlight illuminated rows upon rows of books—real books with paper pages and printed words. She had found the last library. + +Maya had grown up in a world where all information existed in digital form, accessible through neural implants that connected directly to the Global Information Network. Physical books were considered obsolete, relics of a primitive past. Yet here she stood, surrounded by thousands of volumes that had somehow survived the Great Digital Transition of 2055. + +She picked up a book at random—"Pride and Prejudice" by Jane Austen. As she opened it, the musty smell of old paper filled her nostrils. The sensation was unlike anything she had experienced. Each page turned with a soft whisper, and the words seemed to dance before her eyes in a way that digital text never had. + +Hours passed as Maya explored the library. She discovered poetry that made her heart race, adventure stories that transported her to distant lands, and philosophical works that challenged her understanding of existence. For the first time in her life, she understood why her grandmother had spoken so fondly of "the old ways." + +As the sun began to set, Maya faced a difficult decision. The authorities would surely destroy this place if they discovered it, viewing it as a dangerous reminder of inefficient past technologies. But she couldn't bear the thought of losing this treasure trove of human knowledge and creativity. + +Maya made her choice. She would become the guardian of the last library, protecting it for future generations who might one day rediscover the magic of the written word. In a world that had forgotten the value of physical books, she would remember. +''', + summary: '在2087年，Maya发现了最后一座图书馆，决定成为它的守护者。', + type: ReadingExerciseType.story, + difficulty: ReadingDifficulty.intermediate, + wordCount: 298, + estimatedTime: 4, + questions: [ + ReadingQuestion( + id: 'q1', + question: 'In what year does the story take place?', + options: ['2055', '2087', '2090', '2100'], + correctAnswer: 1, + explanation: 'The story begins with "In the year 2087, Maya discovered..."', + type: 'multiple_choice', + ), + ReadingQuestion( + id: 'q2', + question: 'What was the first book Maya picked up?', + options: ['Romeo and Juliet', 'Pride and Prejudice', 'Jane Eyre', 'Sense and Sensibility'], + correctAnswer: 1, + explanation: 'Maya picked up "Pride and Prejudice" by Jane Austen.', + type: 'multiple_choice', + ), + ReadingQuestion( + id: 'q3', + question: 'Maya decided to destroy the library to protect society.', + options: ['True', 'False'], + correctAnswer: 1, + explanation: 'Maya decided to become the guardian of the library, not destroy it.', + type: 'true_false', + ), + ], + tags: ['fiction', 'future', 'books', 'technology'], + source: 'Future Fiction Quarterly', + publishDate: DateTime(2024, 1, 5), + imageUrl: 'assets/images/library_story.jpg', + ), + ]; + + // 根据类型获取练习 + static List getExercisesByType(ReadingExerciseType type) { + return exercises.where((exercise) => exercise.type == type).toList(); + } + + // 根据难度获取练习 + static List getExercisesByDifficulty(ReadingDifficulty difficulty) { + return exercises.where((exercise) => exercise.difficulty == difficulty).toList(); + } + + // 获取推荐练习 + static List getRecommendedExercises() { + return exercises.take(3).toList(); + } + + // 根据ID获取练习 + static ReadingExercise? getExerciseById(String id) { + try { + return exercises.firstWhere((exercise) => exercise.id == id); + } catch (e) { + return null; + } + } + + // 根据类型获取分类 + static ReadingCategory? getCategoryByType(ReadingExerciseType type) { + try { + return categories.firstWhere((category) => category.type == type); + } catch (e) { + return null; + } + } +} \ No newline at end of file diff --git a/client/lib/features/reading/models/reading_article.dart b/client/lib/features/reading/models/reading_article.dart new file mode 100644 index 0000000..01045d8 --- /dev/null +++ b/client/lib/features/reading/models/reading_article.dart @@ -0,0 +1,138 @@ +class ReadingArticle { + final String id; + final String title; + final String content; + final String category; + final String difficulty; + final int wordCount; + final int estimatedReadingTime; // in minutes + final List tags; + final String source; + final DateTime publishDate; + final bool isCompleted; + final double? comprehensionScore; + final int? readingTime; // actual reading time in seconds + + const ReadingArticle({ + required this.id, + required this.title, + required this.content, + required this.category, + required this.difficulty, + required this.wordCount, + required this.estimatedReadingTime, + required this.tags, + required this.source, + required this.publishDate, + this.isCompleted = false, + this.comprehensionScore, + this.readingTime, + }); + + factory ReadingArticle.fromJson(Map json) { + return ReadingArticle( + id: json['id'] as String, + title: json['title'] as String, + content: json['content'] as String, + category: json['category'] as String, + difficulty: json['difficulty'] as String, + wordCount: json['wordCount'] as int, + estimatedReadingTime: json['estimatedReadingTime'] as int, + tags: List.from(json['tags'] as List), + source: json['source'] as String, + publishDate: DateTime.parse(json['publishDate'] as String), + isCompleted: json['isCompleted'] as bool? ?? false, + comprehensionScore: json['comprehensionScore'] as double?, + readingTime: json['readingTime'] as int?, + ); + } + + Map toJson() { + return { + 'id': id, + 'title': title, + 'content': content, + 'category': category, + 'difficulty': difficulty, + 'wordCount': wordCount, + 'estimatedReadingTime': estimatedReadingTime, + 'tags': tags, + 'source': source, + 'publishDate': publishDate.toIso8601String(), + 'isCompleted': isCompleted, + 'comprehensionScore': comprehensionScore, + 'readingTime': readingTime, + }; + } + + ReadingArticle copyWith({ + String? id, + String? title, + String? content, + String? category, + String? difficulty, + int? wordCount, + int? estimatedReadingTime, + List? tags, + String? source, + DateTime? publishDate, + bool? isCompleted, + double? comprehensionScore, + int? readingTime, + }) { + return ReadingArticle( + id: id ?? this.id, + title: title ?? this.title, + content: content ?? this.content, + category: category ?? this.category, + difficulty: difficulty ?? this.difficulty, + wordCount: wordCount ?? this.wordCount, + estimatedReadingTime: estimatedReadingTime ?? this.estimatedReadingTime, + tags: tags ?? this.tags, + source: source ?? this.source, + publishDate: publishDate ?? this.publishDate, + isCompleted: isCompleted ?? this.isCompleted, + comprehensionScore: comprehensionScore ?? this.comprehensionScore, + readingTime: readingTime ?? this.readingTime, + ); + } + + String get difficultyLabel { + switch (difficulty.toLowerCase()) { + case 'a1': + case 'a2': + return '初级'; + case 'b1': + case 'b2': + return '中级'; + case 'c1': + case 'c2': + return '高级'; + default: + return '未知'; + } + } + + String get categoryLabel { + switch (category.toLowerCase()) { + case 'cet4': + return '四级阅读'; + case 'cet6': + return '六级阅读'; + case 'toefl': + return '托福阅读'; + case 'ielts': + return '雅思阅读'; + case 'daily': + return '日常阅读'; + case 'business': + return '商务阅读'; + case 'academic': + return '学术阅读'; + case 'news': + return '新闻阅读'; + default: + return category; + } + } +} \ No newline at end of file diff --git a/client/lib/features/reading/models/reading_exercise_model.dart b/client/lib/features/reading/models/reading_exercise_model.dart new file mode 100644 index 0000000..22a5afb --- /dev/null +++ b/client/lib/features/reading/models/reading_exercise_model.dart @@ -0,0 +1,125 @@ +/// 阅读练习类型枚举 +enum ReadingExerciseType { + news, // 新闻 + story, // 故事 + science, // 科学 + business, // 商务 + culture, // 文化 + technology, // 科技 + health, // 健康 + travel, // 旅游 +} + +/// 阅读难度枚举 +enum ReadingDifficulty { + elementary, // 初级 A1-A2 + intermediate, // 中级 B1 + upperIntermediate, // 中高级 B2 + advanced, // 高级 C1 + proficient, // 精通 C2 +} + +/// 阅读练习分类 +class ReadingCategory { + final String id; + final String name; + final String description; + final String icon; + final int articleCount; + final ReadingExerciseType type; + + const ReadingCategory({ + required this.id, + required this.name, + required this.description, + required this.icon, + required this.articleCount, + required this.type, + }); +} + +/// 阅读练习 +class ReadingExercise { + final String id; + final String title; + final String content; + final String summary; + final ReadingExerciseType type; + final ReadingDifficulty difficulty; + final int wordCount; + final int estimatedTime; // 预估阅读时间（分钟） + final List questions; + final List tags; + final String source; + final DateTime publishDate; + final String imageUrl; + + const ReadingExercise({ + required this.id, + required this.title, + required this.content, + required this.summary, + required this.type, + required this.difficulty, + required this.wordCount, + required this.estimatedTime, + required this.questions, + required this.tags, + required this.source, + required this.publishDate, + required this.imageUrl, + }); +} + +/// 阅读问题 +class ReadingQuestion { + final String id; + final String question; + final List options; + final int correctAnswer; // 正确答案的索引 + final String explanation; + final String type; // multiple_choice, true_false, fill_blank + + const ReadingQuestion({ + required this.id, + required this.question, + required this.options, + required this.correctAnswer, + required this.explanation, + required this.type, + }); +} + +/// 阅读结果 +class ReadingResult { + final String exerciseId; + final int correctAnswers; + final int totalQuestions; + final int readingTime; // 实际阅读时间（秒） + final DateTime completedAt; + final List userAnswers; + + const ReadingResult({ + required this.exerciseId, + required this.correctAnswers, + required this.totalQuestions, + required this.readingTime, + required this.completedAt, + required this.userAnswers, + }); + + double get accuracy => correctAnswers / totalQuestions; +} + +/// 用户答案 +class UserAnswer { + final String questionId; + final int selectedAnswer; + final bool isCorrect; + + const UserAnswer({ + required this.questionId, + required this.selectedAnswer, + required this.isCorrect, + }); +} \ No newline at end of file diff --git a/client/lib/features/reading/models/reading_question.dart b/client/lib/features/reading/models/reading_question.dart new file mode 100644 index 0000000..f3a0d27 --- /dev/null +++ b/client/lib/features/reading/models/reading_question.dart @@ -0,0 +1,241 @@ +enum QuestionType { + multipleChoice, + trueFalse, + fillInBlank, + shortAnswer, +} + +class ReadingQuestion { + final String id; + final String articleId; + final QuestionType type; + final String question; + final List options; // For multiple choice questions + final String correctAnswer; + final String explanation; + final int order; + final String? userAnswer; + final bool? isCorrect; + + const ReadingQuestion({ + required this.id, + required this.articleId, + required this.type, + required this.question, + required this.options, + required this.correctAnswer, + required this.explanation, + required this.order, + this.userAnswer, + this.isCorrect, + }); + + factory ReadingQuestion.fromJson(Map json) { + return ReadingQuestion( + id: json['id'] as String, + articleId: json['articleId'] as String, + type: QuestionType.values.firstWhere( + (e) => e.toString().split('.').last == json['type'], + orElse: () => QuestionType.multipleChoice, + ), + question: json['question'] as String, + options: List.from(json['options'] as List? ?? []), + correctAnswer: json['correctAnswer'] as String, + explanation: json['explanation'] as String, + order: json['order'] as int, + userAnswer: json['userAnswer'] as String?, + isCorrect: json['isCorrect'] as bool?, + ); + } + + Map toJson() { + return { + 'id': id, + 'articleId': articleId, + 'type': type.toString().split('.').last, + 'question': question, + 'options': options, + 'correctAnswer': correctAnswer, + 'explanation': explanation, + 'order': order, + 'userAnswer': userAnswer, + 'isCorrect': isCorrect, + }; + } + + ReadingQuestion copyWith({ + String? id, + String? articleId, + QuestionType? type, + String? question, + List? options, + String? correctAnswer, + String? explanation, + int? order, + String? userAnswer, + bool? isCorrect, + }) { + return ReadingQuestion( + id: id ?? this.id, + articleId: articleId ?? this.articleId, + type: type ?? this.type, + question: question ?? this.question, + options: options ?? this.options, + correctAnswer: correctAnswer ?? this.correctAnswer, + explanation: explanation ?? this.explanation, + order: order ?? this.order, + userAnswer: userAnswer ?? this.userAnswer, + isCorrect: isCorrect ?? this.isCorrect, + ); + } + + String get typeLabel { + switch (type) { + case QuestionType.multipleChoice: + return '选择题'; + case QuestionType.trueFalse: + return '判断题'; + case QuestionType.fillInBlank: + return '填空题'; + case QuestionType.shortAnswer: + return '简答题'; + } + } +} + +class ReadingExercise { + final String id; + final String articleId; + final List questions; + final DateTime? startTime; + final DateTime? endTime; + final double? score; + final bool isCompleted; + + const ReadingExercise({ + required this.id, + required this.articleId, + required this.questions, + this.startTime, + this.endTime, + this.score, + this.isCompleted = false, + }); + + factory ReadingExercise.fromJson(Map json) { + return ReadingExercise( + id: json['id'] as String, + articleId: json['articleId'] as String, + questions: (json['questions'] as List) + .map((q) => ReadingQuestion.fromJson(q as Map)) + .toList(), + startTime: json['startTime'] != null + ? DateTime.parse(json['startTime'] as String) + : null, + endTime: json['endTime'] != null + ? DateTime.parse(json['endTime'] as String) + : null, + score: json['score'] as double?, + isCompleted: json['isCompleted'] as bool? ?? false, + ); + } + + Map toJson() { + return { + 'id': id, + 'articleId': articleId, + 'questions': questions.map((q) => q.toJson()).toList(), + 'startTime': startTime?.toIso8601String(), + 'endTime': endTime?.toIso8601String(), + 'score': score, + 'isCompleted': isCompleted, + }; + } + + ReadingExercise copyWith({ + String? id, + String? articleId, + List? questions, + DateTime? startTime, + DateTime? endTime, + double? score, + bool? isCompleted, + }) { + return ReadingExercise( + id: id ?? this.id, + articleId: articleId ?? this.articleId, + questions: questions ?? this.questions, + startTime: startTime ?? this.startTime, + endTime: endTime ?? this.endTime, + score: score ?? this.score, + isCompleted: isCompleted ?? this.isCompleted, + ); + } + + int get totalQuestions => questions.length; + + int get answeredQuestions { + return questions.where((q) => q.userAnswer != null).length; + } + + int get correctAnswers { + return questions.where((q) => q.isCorrect == true).length; + } + + double get progressPercentage { + if (totalQuestions == 0) return 0.0; + return (answeredQuestions / totalQuestions) * 100; + } + + Duration? get duration { + if (startTime != null && endTime != null) { + return endTime!.difference(startTime!); + } + return null; + } +} + +/// 阅读练习结果 +class ReadingExerciseResult { + final double score; + final int correctCount; + final int totalCount; + final Duration timeSpent; // 用时 + final double accuracy; + + const ReadingExerciseResult({ + required this.score, + required this.correctCount, + required this.totalCount, + required this.timeSpent, + required this.accuracy, + }); + + /// 错误题数 + int get wrongCount => totalCount - correctCount; + + /// 总题数（别名） + int get totalQuestions => totalCount; + + factory ReadingExerciseResult.fromJson(Map json) { + return ReadingExerciseResult( + score: (json['score'] as num).toDouble(), + correctCount: json['correctCount'] as int, + totalCount: json['totalCount'] as int, + timeSpent: Duration(seconds: json['timeSpent'] as int), + accuracy: (json['accuracy'] as num).toDouble(), + ); + } + + Map toJson() { + return { + 'score': score, + 'correctCount': correctCount, + 'totalCount': totalCount, + 'timeSpent': timeSpent.inSeconds, + 'accuracy': accuracy, + }; + } + + bool get isPassed => score >= 60.0; +} \ No newline at end of file diff --git a/client/lib/features/reading/models/reading_stats.dart b/client/lib/features/reading/models/reading_stats.dart new file mode 100644 index 0000000..64b7412 --- /dev/null +++ b/client/lib/features/reading/models/reading_stats.dart @@ -0,0 +1,280 @@ +class ReadingStats { + final int totalArticlesRead; + final int practicesDone; + final double averageScore; + final int totalReadingTime; // in minutes + final double averageReadingSpeed; // words per minute + final double comprehensionAccuracy; // percentage + final int vocabularyMastered; + final int consecutiveDays; + final Map categoryStats; // category -> articles read + final Map difficultyStats; // difficulty -> average score + final List dailyRecords; + + const ReadingStats({ + required this.totalArticlesRead, + required this.practicesDone, + required this.averageScore, + required this.totalReadingTime, + required this.averageReadingSpeed, + required this.comprehensionAccuracy, + required this.vocabularyMastered, + required this.consecutiveDays, + required this.categoryStats, + required this.difficultyStats, + required this.dailyRecords, + }); + + factory ReadingStats.fromJson(Map json) { + final totalArticlesRead = json['totalArticlesRead']; + final practicesDone = json['practicesDone']; + final averageScore = json['averageScore']; + final totalReadingTime = json['totalReadingTime']; + final averageReadingSpeed = json['averageReadingSpeed']; + final comprehensionAccuracy = json['comprehensionAccuracy']; + final vocabularyMastered = json['vocabularyMastered']; + final consecutiveDays = json['consecutiveDays']; + + final rawCategoryStats = json['categoryStats']; + final Map categoryStats = {}; + if (rawCategoryStats is Map) { + rawCategoryStats.forEach((key, value) { + final k = key is String ? key : key.toString(); + final v = value is num ? value.toInt() : 0; + categoryStats[k] = v; + }); + } + + final rawDifficultyStats = json['difficultyStats']; + final Map difficultyStats = {}; + if (rawDifficultyStats is Map) { + rawDifficultyStats.forEach((key, value) { + final k = key is String ? key : key.toString(); + final v = value is num ? value.toDouble() : 0.0; + difficultyStats[k] = v; + }); + } + + final rawDailyRecords = json['dailyRecords']; + final List dailyRecords = []; + if (rawDailyRecords is List) { + for (final record in rawDailyRecords) { + if (record is Map) { + dailyRecords.add(DailyReadingRecord.fromJson(record)); + } + } + } + + return ReadingStats( + totalArticlesRead: totalArticlesRead is num ? totalArticlesRead.toInt() : 0, + practicesDone: practicesDone is num ? practicesDone.toInt() : 0, + averageScore: averageScore is num ? averageScore.toDouble() : 0.0, + totalReadingTime: totalReadingTime is num ? totalReadingTime.toInt() : 0, + averageReadingSpeed: averageReadingSpeed is num ? averageReadingSpeed.toDouble() : 0.0, + comprehensionAccuracy: comprehensionAccuracy is num ? comprehensionAccuracy.toDouble() : 0.0, + vocabularyMastered: vocabularyMastered is num ? vocabularyMastered.toInt() : 0, + consecutiveDays: consecutiveDays is num ? consecutiveDays.toInt() : 0, + categoryStats: categoryStats, + difficultyStats: difficultyStats, + dailyRecords: dailyRecords, + ); + } + + Map toJson() { + return { + 'totalArticlesRead': totalArticlesRead, + 'practicesDone': practicesDone, + 'averageScore': averageScore, + 'totalReadingTime': totalReadingTime, + 'averageReadingSpeed': averageReadingSpeed, + 'comprehensionAccuracy': comprehensionAccuracy, + 'vocabularyMastered': vocabularyMastered, + 'consecutiveDays': consecutiveDays, + 'categoryStats': categoryStats, + 'difficultyStats': difficultyStats, + 'dailyRecords': dailyRecords.map((record) => record.toJson()).toList(), + }; + } + + ReadingStats copyWith({ + int? totalArticlesRead, + int? practicesDone, + double? averageScore, + int? totalReadingTime, + double? averageReadingSpeed, + double? comprehensionAccuracy, + int? vocabularyMastered, + int? consecutiveDays, + Map? categoryStats, + Map? difficultyStats, + List? dailyRecords, + }) { + return ReadingStats( + totalArticlesRead: totalArticlesRead ?? this.totalArticlesRead, + practicesDone: practicesDone ?? this.practicesDone, + averageScore: averageScore ?? this.averageScore, + totalReadingTime: totalReadingTime ?? this.totalReadingTime, + averageReadingSpeed: averageReadingSpeed ?? this.averageReadingSpeed, + comprehensionAccuracy: comprehensionAccuracy ?? this.comprehensionAccuracy, + vocabularyMastered: vocabularyMastered ?? this.vocabularyMastered, + consecutiveDays: consecutiveDays ?? this.consecutiveDays, + categoryStats: categoryStats ?? this.categoryStats, + difficultyStats: difficultyStats ?? this.difficultyStats, + dailyRecords: dailyRecords ?? this.dailyRecords, + ); + } + + String get readingTimeFormatted { + final hours = totalReadingTime ~/ 60; + final minutes = totalReadingTime % 60; + if (hours > 0) { + return '${hours}小时${minutes}分钟'; + } + return '${minutes}分钟'; + } + + String get averageScoreFormatted { + return '${averageScore.toStringAsFixed(1)}分'; + } + + String get comprehensionAccuracyFormatted { + return '${comprehensionAccuracy.toStringAsFixed(1)}%'; + } + + String get averageReadingSpeedFormatted { + return '${averageReadingSpeed.toStringAsFixed(0)}词/分钟'; + } +} + +class DailyReadingRecord { + final DateTime date; + final int articlesRead; + final int practicesDone; + final int readingTime; // in minutes + final double averageScore; + final int vocabularyLearned; + + const DailyReadingRecord({ + required this.date, + required this.articlesRead, + required this.practicesDone, + required this.readingTime, + required this.averageScore, + required this.vocabularyLearned, + }); + + factory DailyReadingRecord.fromJson(Map json) { + final dateRaw = json['date']; + final articlesRead = json['articlesRead']; + final practicesDone = json['practicesDone']; + final readingTime = json['readingTime']; + final averageScore = json['averageScore']; + final vocabularyLearned = json['vocabularyLearned']; + + return DailyReadingRecord( + date: dateRaw is String ? DateTime.parse(dateRaw) : DateTime.fromMillisecondsSinceEpoch(0), + articlesRead: articlesRead is num ? articlesRead.toInt() : 0, + practicesDone: practicesDone is num ? practicesDone.toInt() : 0, + readingTime: readingTime is num ? readingTime.toInt() : 0, + averageScore: averageScore is num ? averageScore.toDouble() : 0.0, + vocabularyLearned: vocabularyLearned is num ? vocabularyLearned.toInt() : 0, + ); + } + + Map toJson() { + return { + 'date': date.toIso8601String(), + 'articlesRead': articlesRead, + 'practicesDone': practicesDone, + 'readingTime': readingTime, + 'averageScore': averageScore, + 'vocabularyLearned': vocabularyLearned, + }; + } + + DailyReadingRecord copyWith({ + DateTime? date, + int? articlesRead, + int? practicesDone, + int? readingTime, + double? averageScore, + int? vocabularyLearned, + }) { + return DailyReadingRecord( + date: date ?? this.date, + articlesRead: articlesRead ?? this.articlesRead, + practicesDone: practicesDone ?? this.practicesDone, + readingTime: readingTime ?? this.readingTime, + averageScore: averageScore ?? this.averageScore, + vocabularyLearned: vocabularyLearned ?? this.vocabularyLearned, + ); + } +} + +class ReadingProgress { + final String category; + final int totalArticles; + final int completedArticles; + final double averageScore; + final String difficulty; + + const ReadingProgress({ + required this.category, + required this.totalArticles, + required this.completedArticles, + required this.averageScore, + required this.difficulty, + }); + + factory ReadingProgress.fromJson(Map json) { + return ReadingProgress( + category: json['category'] as String, + totalArticles: json['totalArticles'] as int, + completedArticles: json['completedArticles'] as int, + averageScore: (json['averageScore'] as num).toDouble(), + difficulty: json['difficulty'] as String, + ); + } + + Map toJson() { + return { + 'category': category, + 'totalArticles': totalArticles, + 'completedArticles': completedArticles, + 'averageScore': averageScore, + 'difficulty': difficulty, + }; + } + + double get progressPercentage { + if (totalArticles == 0) return 0.0; + return (completedArticles / totalArticles) * 100; + } + + String get progressText { + return '$completedArticles/$totalArticles'; + } + + String get categoryLabel { + switch (category.toLowerCase()) { + case 'cet4': + return '四级阅读'; + case 'cet6': + return '六级阅读'; + case 'toefl': + return '托福阅读'; + case 'ielts': + return '雅思阅读'; + case 'daily': + return '日常阅读'; + case 'business': + return '商务阅读'; + case 'academic': + return '学术阅读'; + case 'news': + return '新闻阅读'; + default: + return category; + } + } +} \ No newline at end of file diff --git a/client/lib/features/reading/providers/reading_provider.dart b/client/lib/features/reading/providers/reading_provider.dart new file mode 100644 index 0000000..1e60d44 --- /dev/null +++ b/client/lib/features/reading/providers/reading_provider.dart @@ -0,0 +1,189 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/reading_exercise_model.dart'; +import '../services/reading_service.dart'; + +/// 阅读材料列表状态 +class ReadingMaterialsState { + final List materials; + final bool isLoading; + final String? error; + + ReadingMaterialsState({ + this.materials = const [], + this.isLoading = false, + this.error, + }); + + ReadingMaterialsState copyWith({ + List? materials, + bool? isLoading, + String? error, + }) { + return ReadingMaterialsState( + materials: materials ?? this.materials, + isLoading: isLoading ?? this.isLoading, + error: error, + ); + } +} + +/// 阅读材料列表 Notifier +class ReadingMaterialsNotifier extends StateNotifier { + final ReadingService _readingService; + + ReadingMaterialsNotifier(this._readingService) : super(ReadingMaterialsState()); + + /// 加载阅读材料列表 + Future loadMaterials({ + String? category, + String? difficulty, + int page = 1, + }) async { + state = state.copyWith(isLoading: true, error: null); + + try { + final materials = await _readingService.getArticles( + category: category, + difficulty: difficulty, + page: page, + ); + + // 将后端数据转换为前端模型 + final exercises = materials.map((article) { + return ReadingExercise( + id: article.id, + title: article.title, + content: article.content, + summary: '', // 后端ReadingArticle没有summary字段 + type: _mapCategoryToType(article.category), + difficulty: _mapDifficultyLevel(article.difficulty), + wordCount: article.wordCount, + estimatedTime: article.estimatedReadingTime, + questions: [], // 题目需要单独获取 + tags: article.tags, // 已经是List + source: article.source, + publishDate: article.publishDate, + imageUrl: '', // 后端暂无图片字段 + ); + }).toList(); + + state = state.copyWith(materials: exercises, isLoading: false); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } + + /// 获取推荐材料 + Future loadRecommendedMaterials() async { + state = state.copyWith(isLoading: true, error: null); + + try { + final materials = await _readingService.getRecommendedArticles(limit: 3); + + final exercises = materials.map((article) { + return ReadingExercise( + id: article.id, + title: article.title, + content: article.content, + summary: '', // 后端ReadingArticle没有summary字段 + type: _mapCategoryToType(article.category), + difficulty: _mapDifficultyLevel(article.difficulty), + wordCount: article.wordCount, + estimatedTime: article.estimatedReadingTime, + questions: [], + tags: article.tags, // 已经是List + source: article.source, + publishDate: article.publishDate, + imageUrl: '', // 后端暂无图片字段 + ); + }).toList(); + + state = state.copyWith(materials: exercises, isLoading: false); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } + + ReadingExerciseType _mapCategoryToType(String category) { + switch (category.toLowerCase()) { + case 'news': + return ReadingExerciseType.news; + case 'story': + return ReadingExerciseType.story; + case 'science': + return ReadingExerciseType.science; + case 'business': + return ReadingExerciseType.business; + case 'technology': + return ReadingExerciseType.technology; + default: + return ReadingExerciseType.news; + } + } + + ReadingDifficulty _mapDifficultyLevel(String difficulty) { + switch (difficulty.toLowerCase()) { + case 'beginner': + case 'elementary': + return ReadingDifficulty.elementary; + case 'intermediate': + return ReadingDifficulty.intermediate; + case 'upper-intermediate': + case 'upperintermediate': + return ReadingDifficulty.upperIntermediate; + case 'advanced': + return ReadingDifficulty.advanced; + case 'proficient': + return ReadingDifficulty.proficient; + default: + return ReadingDifficulty.intermediate; + } + } +} + +/// 阅读服务 Provider +final readingServiceProvider = Provider((ref) { + return ReadingService(); +}); + +/// 阅读材料列表 Provider +final readingMaterialsProvider = StateNotifierProvider((ref) { + final service = ref.watch(readingServiceProvider); + return ReadingMaterialsNotifier(service); +}); + +/// 推荐阅读材料 Provider +final recommendedReadingProvider = FutureProvider>((ref) async { + final service = ref.watch(readingServiceProvider); + + try { + final materials = await service.getRecommendedArticles(limit: 3); + + return materials.map((article) { + return ReadingExercise( + id: article.id, + title: article.title, + content: article.content, + summary: '', // 后端ReadingArticle没有summary字段 + type: ReadingExerciseType.news, + difficulty: ReadingDifficulty.intermediate, + wordCount: article.wordCount, + estimatedTime: article.estimatedReadingTime, + questions: [], + tags: article.tags, // 已经是List + source: article.source, + publishDate: article.publishDate, + imageUrl: '', // 后端暂无图片字段 + ); + }).toList(); + } catch (e) { + // 发生错误时返回空列表 + return []; + } +}); diff --git a/client/lib/features/reading/screens/reading_article_screen.dart b/client/lib/features/reading/screens/reading_article_screen.dart new file mode 100644 index 0000000..a56d178 --- /dev/null +++ b/client/lib/features/reading/screens/reading_article_screen.dart @@ -0,0 +1,426 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../providers/reading_provider.dart'; +import '../models/reading_article.dart'; +import '../widgets/reading_content_widget.dart'; +import '../widgets/reading_toolbar.dart'; +import 'reading_exercise_screen.dart'; + +/// 阅读文章详情页面 +class ReadingArticleScreen extends StatefulWidget { + final String articleId; + + const ReadingArticleScreen({ + super.key, + required this.articleId, + }); + + @override + State createState() => _ReadingArticleScreenState(); +} + +class _ReadingArticleScreenState extends State { + final ScrollController _scrollController = ScrollController(); + bool _isReading = false; + DateTime? _startTime; + + @override + void initState() { + super.initState(); + _loadArticle(); + _startReading(); + } + + @override + void dispose() { + _endReading(); + _scrollController.dispose(); + super.dispose(); + } + + void _loadArticle() { + final provider = context.read(); + provider.loadArticle(widget.articleId); + } + + void _startReading() { + _startTime = DateTime.now(); + _isReading = true; + } + + void _endReading() { + if (_isReading && _startTime != null) { + final duration = DateTime.now().difference(_startTime!); + final provider = context.read(); + provider.recordReadingProgress( + articleId: widget.articleId, + readingTime: duration.inSeconds, + completed: true, + ); + _isReading = false; + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: Colors.white, + appBar: AppBar( + title: const Text( + '阅读文章', + style: TextStyle( + fontWeight: FontWeight.bold, + color: Colors.white, + ), + ), + backgroundColor: const Color(0xFF2196F3), + elevation: 0, + iconTheme: const IconThemeData(color: Colors.white), + actions: [ + Consumer( + builder: (context, provider, child) { + final article = provider.currentArticle; + if (article == null) return const SizedBox.shrink(); + + return IconButton( + icon: Icon( + Icons.favorite, + color: provider.favoriteArticles.any((a) => a.id == article.id) + ? Colors.red + : Colors.white, + ), + onPressed: () => _toggleFavorite(article), + ); + }, + ), + IconButton( + icon: const Icon(Icons.share, color: Colors.white), + onPressed: _shareArticle, + ), + ], + ), + body: Consumer( + builder: (context, provider, child) { + if (provider.isLoading) { + return const Center(child: CircularProgressIndicator()); + } + + if (provider.error != null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + provider.error!, + style: TextStyle(color: Colors.grey[600]), + textAlign: TextAlign.center, + ), + const SizedBox(height: 16), + ElevatedButton( + onPressed: _loadArticle, + child: const Text('重试'), + ), + ], + ), + ); + } + + final article = provider.currentArticle; + if (article == null) { + return const Center( + child: Text('文章不存在'), + ); + } + + return Column( + children: [ + // 文章信息头部 + _buildArticleHeader(article), + + // 阅读工具栏 + const ReadingToolbar(), + + // 文章内容 + Expanded( + child: ReadingContentWidget( + article: article, + scrollController: _scrollController, + ), + ), + + // 底部操作栏 + _buildBottomActions(article), + ], + ); + }, + ), + ); + } + + /// 构建文章信息头部 + Widget _buildArticleHeader(ReadingArticle article) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.grey[50], + border: Border( + bottom: BorderSide(color: Colors.grey[200]!), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题 + Text( + article.title, + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + const SizedBox(height: 8), + + // 文章信息 + Row( + children: [ + // 分类标签 + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + article.categoryLabel, + style: const TextStyle( + fontSize: 12, + color: Color(0xFF2196F3), + fontWeight: FontWeight.w500, + ), + ), + ), + const SizedBox(width: 8), + + // 难度标签 + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: _getDifficultyColor(article.difficulty).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + article.difficultyLabel, + style: TextStyle( + fontSize: 12, + color: _getDifficultyColor(article.difficulty), + fontWeight: FontWeight.w500, + ), + ), + ), + const Spacer(), + + // 字数和阅读时间 + Text( + '${article.wordCount}词 · ${article.readingTime}分钟', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + + // 来源和发布时间 + if (article.source != null || article.publishDate != null) + Padding( + padding: const EdgeInsets.only(top: 8), + child: Row( + children: [ + if (article.source != null) ...[ + Icon( + Icons.source, + size: 14, + color: Colors.grey[500], + ), + const SizedBox(width: 4), + Text( + article.source!, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + if (article.source != null && article.publishDate != null) + Text( + ' · ', + style: TextStyle( + fontSize: 12, + color: Colors.grey[500], + ), + ), + if (article.publishDate != null) ...[ + Icon( + Icons.schedule, + size: 14, + color: Colors.grey[500], + ), + const SizedBox(width: 4), + Text( + _formatDate(article.publishDate!), + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ], + ), + ), + ], + ), + ); + } + + /// 构建底部操作栏 + Widget _buildBottomActions(ReadingArticle article) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, -2), + ), + ], + ), + child: Row( + children: [ + // 开始练习按钮 + Expanded( + child: ElevatedButton( + onPressed: () => _startExercise(article), + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(vertical: 12), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + child: const Text( + '开始练习', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + ), + ), + const SizedBox(width: 12), + + // 重新阅读按钮 + OutlinedButton( + onPressed: () => _scrollToTop(), + style: OutlinedButton.styleFrom( + foregroundColor: const Color(0xFF2196F3), + side: const BorderSide(color: Color(0xFF2196F3)), + padding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 12, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + child: const Text('重新阅读'), + ), + ], + ), + ); + } + + /// 获取难度颜色 + Color _getDifficultyColor(String difficulty) { + switch (difficulty.toLowerCase()) { + case 'a1': + case 'a2': + return Colors.green; + case 'b1': + case 'b2': + return Colors.orange; + case 'c1': + case 'c2': + return Colors.red; + default: + return Colors.grey; + } + } + + /// 格式化日期 + String _formatDate(DateTime date) { + return '${date.year}-${date.month.toString().padLeft(2, '0')}-${date.day.toString().padLeft(2, '0')}'; + } + + /// 切换收藏状态 + void _toggleFavorite(ReadingArticle article) { + final provider = context.read(); + final isFavorite = provider.favoriteArticles.any((a) => a.id == article.id); + + if (isFavorite) { + provider.unfavoriteArticle(article.id); + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('已取消收藏')), + ); + } else { + provider.favoriteArticle(article.id); + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('已添加到收藏')), + ); + } + } + + /// 分享文章 + void _shareArticle() { + final article = context.read().currentArticle; + if (article != null) { + // TODO: 实现分享功能 + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('分享功能开发中...')), + ); + } + } + + /// 开始练习 + void _startExercise(ReadingArticle article) { + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => ReadingExerciseScreen(articleId: article.id), + ), + ); + } + + /// 滚动到顶部 + void _scrollToTop() { + _scrollController.animateTo( + 0, + duration: const Duration(milliseconds: 500), + curve: Curves.easeInOut, + ); + } +} \ No newline at end of file diff --git a/client/lib/features/reading/screens/reading_category_screen.dart b/client/lib/features/reading/screens/reading_category_screen.dart new file mode 100644 index 0000000..f538968 --- /dev/null +++ b/client/lib/features/reading/screens/reading_category_screen.dart @@ -0,0 +1,499 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/reading_exercise_model.dart'; +import '../providers/reading_provider.dart'; +import 'reading_exercise_screen.dart'; + +/// 阅读分类页面 +class ReadingCategoryScreen extends ConsumerStatefulWidget { + final ReadingExerciseType exerciseType; + + const ReadingCategoryScreen({ + super.key, + required this.exerciseType, + }); + + @override + ConsumerState createState() => _ReadingCategoryScreenState(); +} + +class _ReadingCategoryScreenState extends ConsumerState { + ReadingDifficulty? selectedDifficulty; + + @override + void initState() { + super.initState(); + WidgetsBinding.instance.addPostFrameCallback((_) { + _loadRemote(); + }); + } + + void _loadRemote() { + final cat = _typeToCategory(widget.exerciseType); + final level = selectedDifficulty != null ? _difficultyToLevel(selectedDifficulty!) : null; + ref.read(readingMaterialsProvider.notifier).loadMaterials( + category: cat, + difficulty: level, + page: 1, + ); + } + + void _filterExercises() { + _loadRemote(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + backgroundColor: Colors.transparent, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back, color: Colors.black87), + onPressed: () => Navigator.of(context).pop(), + ), + title: Text( + _categoryLabel(widget.exerciseType), + style: const TextStyle( + color: Colors.black87, + fontSize: 18, + fontWeight: FontWeight.w600, + ), + ), + centerTitle: true, + ), + body: RefreshIndicator( + onRefresh: () async { + _loadRemote(); + }, + child: Column( + children: [ + _buildFilterSection(), + Expanded( + child: _buildExercisesList(), + ), + ], + ), + ), + ); + } + + Widget _buildFilterSection() { + return Container( + width: double.infinity, + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: LayoutBuilder( + builder: (context, constraints) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '根据难度筛选文章', + style: TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + const SizedBox(height: 16), + const Text( + '难度筛选', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + // 响应式难度筛选布局 + constraints.maxWidth > 600 + ? Row( + children: [ + _buildDifficultyChip('全部', null), + const SizedBox(width: 8), + ...ReadingDifficulty.values.map((difficulty) => + Padding( + padding: const EdgeInsets.only(right: 8), + child: _buildDifficultyChip(_getDifficultyName(difficulty), difficulty), + ), + ), + ], + ) + : Wrap( + spacing: 8, + runSpacing: 8, + children: [ + _buildDifficultyChip('全部', null), + ...ReadingDifficulty.values.map((difficulty) => + _buildDifficultyChip(_getDifficultyName(difficulty), difficulty)), + ], + ), + ], + ); + }, + ), + ); + } + + Widget _buildDifficultyChip(String label, ReadingDifficulty? difficulty) { + final isSelected = selectedDifficulty == difficulty; + return FilterChip( + label: Text(label), + selected: isSelected, + onSelected: (selected) { + setState(() { + selectedDifficulty = selected ? difficulty : null; + _loadRemote(); + }); + }, + selectedColor: const Color(0xFF2196F3).withOpacity(0.2), + checkmarkColor: const Color(0xFF2196F3), + ); + } + + Widget _buildExercisesList() { + final state = ref.watch(readingMaterialsProvider); + if (state.isLoading) { + return const Center(child: CircularProgressIndicator()); + } + if (state.error != null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + const Icon(Icons.error_outline, size: 64, color: Colors.redAccent), + const SizedBox(height: 16), + Text('加载失败: ${state.error}', style: const TextStyle(color: Colors.redAccent)), + const SizedBox(height: 8), + TextButton( + onPressed: _loadRemote, + child: const Text('重试'), + ), + ], + ), + ); + } + + final exercises = state.materials; + if (exercises.isEmpty) { + return const Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.book_outlined, + size: 64, + color: Colors.grey, + ), + SizedBox(height: 16), + Text( + '暂无相关练习', + style: TextStyle( + fontSize: 16, + color: Colors.grey, + ), + ), + ], + ), + ); + } + + return LayoutBuilder( + builder: (context, constraints) { + if (constraints.maxWidth > 800) { + return _buildGridLayout(exercises); + } else { + return _buildListLayout(exercises); + } + }, + ); + } + + Widget _buildListLayout(List exercises) { + return ListView.builder( + padding: const EdgeInsets.symmetric(horizontal: 16), + itemCount: exercises.length, + itemBuilder: (context, index) { + final exercise = exercises[index]; + return Padding( + padding: const EdgeInsets.only(bottom: 12), + child: _buildExerciseCard(exercise), + ); + }, + ); + } + + Widget _buildGridLayout(List exercises) { + return GridView.builder( + padding: const EdgeInsets.all(16), + gridDelegate: SliverGridDelegateWithFixedCrossAxisCount( + crossAxisCount: _getCrossAxisCount(MediaQuery.of(context).size.width), + crossAxisSpacing: 16, + mainAxisSpacing: 16, + childAspectRatio: 1.2, + ), + itemCount: exercises.length, + itemBuilder: (context, index) { + final exercise = exercises[index]; + return _buildExerciseCard(exercise); + }, + ); + } + + int _getCrossAxisCount(double width) { + if (width > 1200) return 3; + if (width > 800) return 2; + return 1; + } + + Widget _buildExerciseCard(ReadingExercise exercise) { + return GestureDetector( + onTap: () => _navigateToExercise(exercise), + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + exercise.title, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ), + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: _getDifficultyColor(exercise.difficulty), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + _getDifficultyLabel(exercise.difficulty), + style: const TextStyle( + fontSize: 12, + color: Colors.white, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + const SizedBox(height: 8), + Text( + exercise.summary, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 12), + Row( + children: [ + Icon( + Icons.access_time, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 4), + Text( + '${exercise.estimatedTime}分钟', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + const SizedBox(width: 16), + Icon( + Icons.text_fields, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 4), + Text( + '${exercise.wordCount}词', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + const SizedBox(width: 16), + Icon( + Icons.quiz, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 4), + Text( + '${exercise.questions.length}题', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + if (exercise.tags.isNotEmpty) ...[ + const SizedBox(height: 8), + Wrap( + spacing: 4, + children: exercise.tags.take(3).map((tag) => Container( + padding: const EdgeInsets.symmetric(horizontal: 6, vertical: 2), + decoration: BoxDecoration( + color: Colors.grey[200], + borderRadius: BorderRadius.circular(8), + ), + child: Text( + tag, + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + ), + )).toList(), + ), + ], + ], + ), + ), + ); + } + + String _getDifficultyName(ReadingDifficulty difficulty) { + switch (difficulty) { + case ReadingDifficulty.elementary: + return '初级 (A1)'; + case ReadingDifficulty.intermediate: + return '中级 (B1)'; + case ReadingDifficulty.upperIntermediate: + return '中高级 (B2)'; + case ReadingDifficulty.advanced: + return '高级 (C1)'; + case ReadingDifficulty.proficient: + return '精通 (C2)'; + } + } + + String _getDifficultyLabel(ReadingDifficulty difficulty) { + switch (difficulty) { + case ReadingDifficulty.elementary: + return 'A1'; + case ReadingDifficulty.intermediate: + return 'B1'; + case ReadingDifficulty.upperIntermediate: + return 'B2'; + case ReadingDifficulty.advanced: + return 'C1'; + case ReadingDifficulty.proficient: + return 'C2'; + } + } + + Color _getDifficultyColor(ReadingDifficulty difficulty) { + switch (difficulty) { + case ReadingDifficulty.elementary: + return Colors.green; + case ReadingDifficulty.intermediate: + return Colors.blue; + case ReadingDifficulty.upperIntermediate: + return Colors.orange; + case ReadingDifficulty.advanced: + return Colors.red; + case ReadingDifficulty.proficient: + return Colors.purple; + } + } + + String _typeToCategory(ReadingExerciseType type) { + switch (type) { + case ReadingExerciseType.news: + return 'news'; + case ReadingExerciseType.story: + return 'story'; + case ReadingExerciseType.science: + return 'science'; + case ReadingExerciseType.business: + return 'business'; + case ReadingExerciseType.culture: + return 'culture'; + case ReadingExerciseType.technology: + return 'technology'; + case ReadingExerciseType.health: + return 'health'; + case ReadingExerciseType.travel: + return 'travel'; + } + } + + String _difficultyToLevel(ReadingDifficulty difficulty) { + switch (difficulty) { + case ReadingDifficulty.elementary: + return 'elementary'; + case ReadingDifficulty.intermediate: + return 'intermediate'; + case ReadingDifficulty.upperIntermediate: + return 'upper-intermediate'; + case ReadingDifficulty.advanced: + return 'advanced'; + case ReadingDifficulty.proficient: + return 'proficient'; + } + } + + String _categoryLabel(ReadingExerciseType type) { + switch (type) { + case ReadingExerciseType.news: + return '新闻'; + case ReadingExerciseType.story: + return '故事'; + case ReadingExerciseType.science: + return '科学'; + case ReadingExerciseType.business: + return '商务'; + case ReadingExerciseType.culture: + return '文化'; + case ReadingExerciseType.technology: + return '科技'; + case ReadingExerciseType.health: + return '健康'; + case ReadingExerciseType.travel: + return '旅游'; + } + } + + void _navigateToExercise(ReadingExercise exercise) { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => ReadingExerciseScreen(exercise: exercise), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/reading/screens/reading_exercise_screen.dart b/client/lib/features/reading/screens/reading_exercise_screen.dart new file mode 100644 index 0000000..b1257ff --- /dev/null +++ b/client/lib/features/reading/screens/reading_exercise_screen.dart @@ -0,0 +1,781 @@ +import 'package:flutter/material.dart'; +import '../models/reading_exercise_model.dart'; + +/// 阅读练习详情页面 +class ReadingExerciseScreen extends StatefulWidget { + final ReadingExercise exercise; + + const ReadingExerciseScreen({ + super.key, + required this.exercise, + }); + + @override + State createState() => _ReadingExerciseScreenState(); +} + +class _ReadingExerciseScreenState extends State + with TickerProviderStateMixin { + late TabController _tabController; + Map userAnswers = {}; + bool showResults = false; + int score = 0; + + @override + void initState() { + super.initState(); + _tabController = TabController(length: 2, vsync: this); + } + + @override + void dispose() { + _tabController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + backgroundColor: Colors.transparent, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back, color: Colors.black87), + onPressed: () => Navigator.of(context).pop(), + ), + title: Text( + widget.exercise.title, + style: const TextStyle( + color: Colors.black87, + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + centerTitle: true, + bottom: TabBar( + controller: _tabController, + labelColor: const Color(0xFF2196F3), + unselectedLabelColor: Colors.grey, + indicatorColor: const Color(0xFF2196F3), + tabs: const [ + Tab(text: '阅读文章'), + Tab(text: '练习题'), + ], + ), + ), + body: TabBarView( + controller: _tabController, + children: [ + _buildArticleTab(), + _buildQuestionsTab(), + ], + ), + ); + } + + Widget _buildArticleTab() { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildArticleHeader(), + const SizedBox(height: 20), + _buildArticleContent(), + const SizedBox(height: 20), + _buildArticleFooter(), + ], + ), + ); + } + + Widget _buildArticleHeader() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + widget.exercise.title, + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + ), + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: _getDifficultyColor(widget.exercise.difficulty), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + _getDifficultyLabel(widget.exercise.difficulty), + style: const TextStyle( + fontSize: 12, + color: Colors.white, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + const SizedBox(height: 12), + Text( + widget.exercise.summary, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + _buildInfoChip(Icons.access_time, '${widget.exercise.estimatedTime}分钟'), + const SizedBox(width: 12), + _buildInfoChip(Icons.text_fields, '${widget.exercise.wordCount}词'), + const SizedBox(width: 12), + _buildInfoChip(Icons.quiz, '${widget.exercise.questions.length}题'), + ], + ), + if (widget.exercise.tags.isNotEmpty) ...[ + const SizedBox(height: 12), + Wrap( + spacing: 6, + runSpacing: 6, + children: widget.exercise.tags.map((tag) => Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: Colors.grey[200], + borderRadius: BorderRadius.circular(12), + ), + child: Text( + tag, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + )).toList(), + ), + ], + ], + ), + ); + } + + Widget _buildInfoChip(IconData icon, String text) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(8), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + icon, + size: 14, + color: Colors.grey[600], + ), + const SizedBox(width: 4), + Text( + text, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ); + } + + Widget _buildArticleContent() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '文章内容', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Text( + widget.exercise.content, + style: const TextStyle( + fontSize: 16, + height: 1.6, + color: Colors.black87, + ), + ), + ], + ), + ); + } + + Widget _buildArticleFooter() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '文章信息', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + Row( + children: [ + const Text( + '来源：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + ), + ), + Text( + widget.exercise.source, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + ], + ), + const SizedBox(height: 8), + Row( + children: [ + const Text( + '发布时间：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + ), + ), + Text( + '${widget.exercise.publishDate.year}年${widget.exercise.publishDate.month}月${widget.exercise.publishDate.day}日', + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildQuestionsTab() { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + children: [ + if (showResults) _buildResultsHeader(), + ...widget.exercise.questions.asMap().entries.map((entry) { + final index = entry.key; + final question = entry.value; + return Padding( + padding: const EdgeInsets.only(bottom: 16), + child: _buildQuestionCard(question, index), + ); + }).toList(), + const SizedBox(height: 20), + if (!showResults) + SizedBox( + width: double.infinity, + child: ElevatedButton( + onPressed: _submitAnswers, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + padding: const EdgeInsets.symmetric(vertical: 16), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: const Text( + '提交答案', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.white, + ), + ), + ), + ), + if (showResults) + SizedBox( + width: double.infinity, + child: ElevatedButton( + onPressed: _resetQuiz, + style: ElevatedButton.styleFrom( + backgroundColor: Colors.grey, + padding: const EdgeInsets.symmetric(vertical: 16), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: const Text( + '重新练习', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.white, + ), + ), + ), + ), + ], + ), + ); + } + + Widget _buildResultsHeader() { + final percentage = (score / widget.exercise.questions.length * 100).round(); + return Container( + margin: const EdgeInsets.only(bottom: 20), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + const Text( + '练习结果', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + mainAxisAlignment: MainAxisAlignment.spaceAround, + children: [ + Column( + children: [ + Text( + '$score', + style: const TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + const Text( + '正确题数', + style: TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ), + Column( + children: [ + Text( + '${widget.exercise.questions.length}', + style: const TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + color: Colors.grey, + ), + ), + const Text( + '总题数', + style: TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ), + Column( + children: [ + Text( + '$percentage%', + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + color: percentage >= 80 ? Colors.green : + percentage >= 60 ? Colors.orange : Colors.red, + ), + ), + const Text( + '正确率', + style: TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ), + ], + ), + ], + ), + ); + } + + Widget _buildQuestionCard(ReadingQuestion question, int index) { + final userAnswer = userAnswers[question.id]; + final isCorrect = userAnswer == question.correctAnswer; + final showAnswer = showResults; + + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + border: showAnswer + ? Border.all( + color: isCorrect ? Colors.green : Colors.red, + width: 2, + ) + : null, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + width: 24, + height: 24, + decoration: BoxDecoration( + color: const Color(0xFF2196F3), + borderRadius: BorderRadius.circular(12), + ), + child: Center( + child: Text( + '${index + 1}', + style: const TextStyle( + color: Colors.white, + fontSize: 12, + fontWeight: FontWeight.bold, + ), + ), + ), + ), + const SizedBox(width: 12), + Expanded( + child: Text( + question.question, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ), + if (showAnswer) + Icon( + isCorrect ? Icons.check_circle : Icons.cancel, + color: isCorrect ? Colors.green : Colors.red, + ), + ], + ), + const SizedBox(height: 16), + if (question.type == 'multiple_choice') + ...question.options.asMap().entries.map((entry) { + final optionIndex = entry.key; + final option = entry.value; + final isSelected = userAnswer == optionIndex; + final isCorrectOption = optionIndex == question.correctAnswer; + + Color? backgroundColor; + Color? textColor; + if (showAnswer) { + if (isCorrectOption) { + backgroundColor = Colors.green.withOpacity(0.1); + textColor = Colors.green; + } else if (isSelected && !isCorrectOption) { + backgroundColor = Colors.red.withOpacity(0.1); + textColor = Colors.red; + } + } else if (isSelected) { + backgroundColor = const Color(0xFF2196F3).withOpacity(0.1); + textColor = const Color(0xFF2196F3); + } + + return GestureDetector( + onTap: showAnswer ? null : () { + setState(() { + userAnswers[question.id] = optionIndex; + }); + }, + child: Container( + margin: const EdgeInsets.only(bottom: 8), + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: backgroundColor ?? Colors.grey[50], + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: backgroundColor != null + ? (textColor ?? Colors.grey) + : Colors.grey.withOpacity(0.3), + ), + ), + child: Row( + children: [ + Container( + width: 20, + height: 20, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: isSelected ? (textColor ?? const Color(0xFF2196F3)) : Colors.transparent, + border: Border.all( + color: textColor ?? Colors.grey, + ), + ), + child: isSelected + ? const Icon( + Icons.check, + size: 12, + color: Colors.white, + ) + : null, + ), + const SizedBox(width: 12), + Expanded( + child: Text( + option, + style: TextStyle( + fontSize: 14, + color: textColor ?? Colors.black87, + ), + ), + ), + ], + ), + ), + ); + }).toList(), + if (question.type == 'true_false') + Row( + children: [ + Expanded( + child: _buildTrueFalseOption(question, true, 'True'), + ), + const SizedBox(width: 12), + Expanded( + child: _buildTrueFalseOption(question, false, 'False'), + ), + ], + ), + if (showAnswer && question.explanation.isNotEmpty) ...[ + const SizedBox(height: 16), + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '解析：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + const SizedBox(height: 4), + Text( + question.explanation, + style: const TextStyle( + fontSize: 14, + color: Colors.black87, + ), + ), + ], + ), + ), + ], + ], + ), + ); + } + + Widget _buildTrueFalseOption(ReadingQuestion question, bool value, String label) { + final userAnswer = userAnswers[question.id]; + final isSelected = userAnswer == (value ? 0 : 1); + final isCorrect = (value ? 0 : 1) == question.correctAnswer; + final showAnswer = showResults; + + Color? backgroundColor; + Color? textColor; + if (showAnswer) { + if (isCorrect) { + backgroundColor = Colors.green.withOpacity(0.1); + textColor = Colors.green; + } else if (isSelected && !isCorrect) { + backgroundColor = Colors.red.withOpacity(0.1); + textColor = Colors.red; + } + } else if (isSelected) { + backgroundColor = const Color(0xFF2196F3).withOpacity(0.1); + textColor = const Color(0xFF2196F3); + } + + return GestureDetector( + onTap: showAnswer ? null : () { + setState(() { + userAnswers[question.id] = value ? 0 : 1; + }); + }, + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: backgroundColor ?? Colors.grey[50], + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: backgroundColor != null + ? (textColor ?? Colors.grey) + : Colors.grey.withOpacity(0.3), + ), + ), + child: Center( + child: Text( + label, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: textColor ?? Colors.black87, + ), + ), + ), + ), + ); + } + + void _submitAnswers() { + if (userAnswers.length < widget.exercise.questions.length) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('请完成所有题目后再提交'), + backgroundColor: Colors.orange, + ), + ); + return; + } + + int correctCount = 0; + for (final question in widget.exercise.questions) { + if (userAnswers[question.id] == question.correctAnswer) { + correctCount++; + } + } + + setState(() { + score = correctCount; + showResults = true; + }); + + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('练习完成！正确率：${(correctCount / widget.exercise.questions.length * 100).round()}%'), + backgroundColor: Colors.green, + ), + ); + } + + void _resetQuiz() { + setState(() { + userAnswers.clear(); + showResults = false; + score = 0; + }); + } + + String _getDifficultyLabel(ReadingDifficulty difficulty) { + switch (difficulty) { + case ReadingDifficulty.elementary: + return 'A1'; + case ReadingDifficulty.intermediate: + return 'B1'; + case ReadingDifficulty.upperIntermediate: + return 'B2'; + case ReadingDifficulty.advanced: + return 'C1'; + case ReadingDifficulty.proficient: + return 'C2'; + } + } + + Color _getDifficultyColor(ReadingDifficulty difficulty) { + switch (difficulty) { + case ReadingDifficulty.elementary: + return Colors.green; + case ReadingDifficulty.intermediate: + return Colors.orange; + case ReadingDifficulty.upperIntermediate: + return Colors.deepOrange; + case ReadingDifficulty.advanced: + return Colors.red; + case ReadingDifficulty.proficient: + return Colors.purple; + } + } +} \ No newline at end of file diff --git a/client/lib/features/reading/screens/reading_favorites_screen.dart b/client/lib/features/reading/screens/reading_favorites_screen.dart new file mode 100644 index 0000000..6507b3f --- /dev/null +++ b/client/lib/features/reading/screens/reading_favorites_screen.dart @@ -0,0 +1,527 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../models/reading_article.dart'; +import '../providers/reading_provider.dart'; +import '../widgets/reading_article_card.dart'; +import 'reading_article_screen.dart'; +import 'reading_search_screen.dart'; + +/// 阅读收藏页面 +class ReadingFavoritesScreen extends StatefulWidget { + const ReadingFavoritesScreen({super.key}); + + @override + State createState() => _ReadingFavoritesScreenState(); +} + +class _ReadingFavoritesScreenState extends State { + String _selectedDifficulty = 'all'; + String _selectedCategory = 'all'; + String _sortBy = 'newest'; + bool _isLoading = true; + List _filteredFavorites = []; + + @override + void initState() { + super.initState(); + _loadFavorites(); + } + + /// 加载收藏文章 + Future _loadFavorites() async { + setState(() { + _isLoading = true; + }); + + try { + final provider = Provider.of(context, listen: false); + await provider.loadFavoriteArticles(); + _applyFilters(); + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('加载收藏失败: $e'), + backgroundColor: Colors.red, + ), + ); + } + } finally { + if (mounted) { + setState(() { + _isLoading = false; + }); + } + } + } + + /// 应用筛选条件 + void _applyFilters() { + final provider = Provider.of(context, listen: false); + List favorites = List.from(provider.favoriteArticles); + + // 难度筛选 + if (_selectedDifficulty != 'all') { + favorites = favorites.where((article) => + article.difficulty == _selectedDifficulty + ).toList(); + } + + // 分类筛选 + if (_selectedCategory != 'all') { + favorites = favorites.where((article) => + article.category == _selectedCategory + ).toList(); + } + + // 排序 + switch (_sortBy) { + case 'newest': + favorites.sort((a, b) => b.publishDate.compareTo(a.publishDate)); + break; + case 'oldest': + favorites.sort((a, b) => a.publishDate.compareTo(b.publishDate)); + break; + case 'difficulty': + favorites.sort((a, b) { + const difficultyOrder = {'beginner': 1, 'intermediate': 2, 'advanced': 3}; + return (difficultyOrder[a.difficulty] ?? 0) + .compareTo(difficultyOrder[b.difficulty] ?? 0); + }); + break; + case 'wordCount': + favorites.sort((a, b) => a.wordCount.compareTo(b.wordCount)); + break; + } + + setState(() { + _filteredFavorites = favorites; + }); + } + + /// 取消收藏 + Future _unfavoriteArticle(ReadingArticle article) async { + try { + final provider = Provider.of(context, listen: false); + await provider.favoriteArticle(article.id); + _applyFilters(); + + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('已取消收藏'), + duration: Duration(seconds: 2), + ), + ); + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('取消收藏失败: $e'), + backgroundColor: Colors.red, + ), + ); + } + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: Colors.grey[50], + appBar: AppBar( + title: const Text('我的收藏'), + backgroundColor: Colors.white, + foregroundColor: Colors.black87, + elevation: 0, + actions: [ + IconButton( + icon: const Icon(Icons.search), + onPressed: () { + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => const ReadingSearchScreen(), + ), + ); + }, + ), + PopupMenuButton( + icon: const Icon(Icons.sort), + onSelected: (value) { + setState(() { + _sortBy = value; + }); + _applyFilters(); + }, + itemBuilder: (context) => [ + const PopupMenuItem( + value: 'newest', + child: Text('最新收藏'), + ), + const PopupMenuItem( + value: 'oldest', + child: Text('最早收藏'), + ), + const PopupMenuItem( + value: 'difficulty', + child: Text('按难度'), + ), + const PopupMenuItem( + value: 'wordCount', + child: Text('按字数'), + ), + ], + ), + ], + ), + body: Column( + children: [ + // 筛选条件 + _buildFilterSection(), + + // 收藏列表 + Expanded( + child: _isLoading + ? const Center( + child: CircularProgressIndicator( + valueColor: AlwaysStoppedAnimation(Color(0xFF2196F3)), + ), + ) + : _buildFavoritesList(), + ), + ], + ), + ); + } + + /// 构建筛选条件 + Widget _buildFilterSection() { + return Container( + padding: const EdgeInsets.all(16), + color: Colors.white, + child: Column( + children: [ + // 难度筛选 + Row( + children: [ + const Text( + '难度：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: Colors.black87, + ), + ), + const SizedBox(width: 8), + Expanded( + child: SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + _buildFilterChip('全部', 'all', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + _applyFilters(); + }), + _buildFilterChip('初级', 'beginner', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + _applyFilters(); + }), + _buildFilterChip('中级', 'intermediate', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + _applyFilters(); + }), + _buildFilterChip('高级', 'advanced', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + _applyFilters(); + }), + ], + ), + ), + ), + ], + ), + + const SizedBox(height: 12), + + // 分类筛选 + Row( + children: [ + const Text( + '分类：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: Colors.black87, + ), + ), + const SizedBox(width: 8), + Expanded( + child: SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + _buildFilterChip('全部', 'all', _selectedCategory, (value) { + setState(() { + _selectedCategory = value; + }); + _applyFilters(); + }), + _buildFilterChip('新闻', 'news', _selectedCategory, (value) { + setState(() { + _selectedCategory = value; + }); + _applyFilters(); + }), + _buildFilterChip('科技', 'technology', _selectedCategory, (value) { + setState(() { + _selectedCategory = value; + }); + _applyFilters(); + }), + _buildFilterChip('商务', 'business', _selectedCategory, (value) { + setState(() { + _selectedCategory = value; + }); + _applyFilters(); + }), + _buildFilterChip('文化', 'culture', _selectedCategory, (value) { + setState(() { + _selectedCategory = value; + }); + _applyFilters(); + }), + ], + ), + ), + ), + ], + ), + ], + ), + ); + } + + /// 构建筛选标签 + Widget _buildFilterChip( + String label, + String value, + String selectedValue, + Function(String) onSelected, + ) { + final isSelected = selectedValue == value; + + return Padding( + padding: const EdgeInsets.only(right: 8), + child: GestureDetector( + onTap: () => onSelected(value), + child: Container( + padding: const EdgeInsets.symmetric( + horizontal: 12, + vertical: 6, + ), + decoration: BoxDecoration( + color: isSelected ? const Color(0xFF2196F3) : Colors.grey[100], + borderRadius: BorderRadius.circular(16), + border: Border.all( + color: isSelected ? const Color(0xFF2196F3) : Colors.grey[300]!, + ), + ), + child: Text( + label, + style: TextStyle( + fontSize: 12, + color: isSelected ? Colors.white : Colors.grey[700], + fontWeight: isSelected ? FontWeight.w500 : FontWeight.normal, + ), + ), + ), + ), + ); + } + + /// 构建收藏列表 + Widget _buildFavoritesList() { + if (_filteredFavorites.isEmpty) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.favorite_border, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + _selectedDifficulty == 'all' && _selectedCategory == 'all' + ? '还没有收藏任何文章' + : '没有符合条件的收藏文章', + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + Text( + _selectedDifficulty == 'all' && _selectedCategory == 'all' + ? '去发现一些有趣的文章吧' + : '试试调整筛选条件', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + ), + const SizedBox(height: 24), + ElevatedButton( + onPressed: () { + Navigator.of(context).pop(); + }, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric( + horizontal: 24, + vertical: 12, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(20), + ), + ), + child: const Text('去阅读'), + ), + ], + ), + ); + } + + return Column( + children: [ + // 统计信息 + Container( + padding: const EdgeInsets.all(16), + color: Colors.white, + child: Row( + children: [ + Text( + '共 ${_filteredFavorites.length} 篇收藏', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const Spacer(), + if (_selectedDifficulty != 'all' || _selectedCategory != 'all') + TextButton( + onPressed: () { + setState(() { + _selectedDifficulty = 'all'; + _selectedCategory = 'all'; + }); + _applyFilters(); + }, + child: const Text( + '清除筛选', + style: TextStyle( + fontSize: 14, + color: Color(0xFF2196F3), + ), + ), + ), + ], + ), + ), + + // 文章列表 + Expanded( + child: ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: _filteredFavorites.length, + itemBuilder: (context, index) { + final article = _filteredFavorites[index]; + return Padding( + padding: const EdgeInsets.only(bottom: 12), + child: Dismissible( + key: Key('favorite_${article.id}'), + direction: DismissDirection.endToStart, + background: Container( + alignment: Alignment.centerRight, + padding: const EdgeInsets.only(right: 20), + decoration: BoxDecoration( + color: Colors.red, + borderRadius: BorderRadius.circular(12), + ), + child: const Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.favorite_border, + color: Colors.white, + size: 24, + ), + SizedBox(height: 4), + Text( + '取消收藏', + style: TextStyle( + color: Colors.white, + fontSize: 12, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ), + confirmDismiss: (direction) async { + return await showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('确认取消收藏'), + content: Text('确定要取消收藏「${article.title}」吗？'), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(false), + child: const Text('取消'), + ), + TextButton( + onPressed: () => Navigator.of(context).pop(true), + child: const Text( + '确定', + style: TextStyle(color: Colors.red), + ), + ), + ], + ), + ) ?? false; + }, + onDismissed: (direction) { + _unfavoriteArticle(article); + }, + child: ReadingArticleCard( + article: article, + onTap: () { + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => ReadingArticleScreen( + articleId: article.id, + ), + ), + ); + }, + ), + ), + ); + }, + ), + ), + ], + ); + } +} \ No newline at end of file diff --git a/client/lib/features/reading/screens/reading_history_screen.dart b/client/lib/features/reading/screens/reading_history_screen.dart new file mode 100644 index 0000000..5188284 --- /dev/null +++ b/client/lib/features/reading/screens/reading_history_screen.dart @@ -0,0 +1,782 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../models/reading_article.dart'; +import '../providers/reading_provider.dart'; +import '../widgets/reading_article_card.dart'; +import 'reading_article_screen.dart'; +import 'reading_search_screen.dart'; + +/// 阅读历史页面 +class ReadingHistoryScreen extends StatefulWidget { + const ReadingHistoryScreen({super.key}); + + @override + State createState() => _ReadingHistoryScreenState(); +} + +class _ReadingHistoryScreenState extends State { + String _selectedPeriod = 'all'; + String _selectedDifficulty = 'all'; + String _sortBy = 'newest'; + bool _isLoading = true; + List _filteredHistory = []; + + @override + void initState() { + super.initState(); + _loadHistory(); + } + + /// 加载阅读历史 + Future _loadHistory() async { + setState(() { + _isLoading = true; + }); + + try { + final provider = Provider.of(context, listen: false); + await provider.loadReadingHistory(); + _applyFilters(); + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('加载历史失败: $e'), + backgroundColor: Colors.red, + ), + ); + } + } finally { + if (mounted) { + setState(() { + _isLoading = false; + }); + } + } + } + + /// 应用筛选条件 + void _applyFilters() { + final provider = Provider.of(context, listen: false); + List history = List.from(provider.readingHistory); + + // 时间筛选 + if (_selectedPeriod != 'all') { + final now = DateTime.now(); + DateTime cutoffDate; + + switch (_selectedPeriod) { + case 'today': + cutoffDate = DateTime(now.year, now.month, now.day); + break; + case 'week': + cutoffDate = now.subtract(const Duration(days: 7)); + break; + case 'month': + cutoffDate = DateTime(now.year, now.month - 1, now.day); + break; + default: + cutoffDate = DateTime(1970); + } + + history = history.where((article) => + article.publishDate.isAfter(cutoffDate) + ).toList(); + } + + // 难度筛选 + if (_selectedDifficulty != 'all') { + history = history.where((article) => + article.difficulty == _selectedDifficulty + ).toList(); + } + + // 排序 + switch (_sortBy) { + case 'newest': + history.sort((a, b) => b.publishDate.compareTo(a.publishDate)); + break; + case 'oldest': + history.sort((a, b) => a.publishDate.compareTo(b.publishDate)); + break; + case 'difficulty': + history.sort((a, b) { + const difficultyOrder = {'beginner': 1, 'intermediate': 2, 'advanced': 3}; + return (difficultyOrder[a.difficulty] ?? 0) + .compareTo(difficultyOrder[b.difficulty] ?? 0); + }); + break; + case 'readingTime': + history.sort((a, b) => (a.readingTime ?? 0).compareTo(b.readingTime ?? 0)); + break; + } + + setState(() { + _filteredHistory = history; + }); + } + + /// 清除历史记录 + Future _clearHistory() async { + final confirmed = await showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('清除历史记录'), + content: const Text('确定要清除所有阅读历史记录吗？此操作不可撤销。'), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(false), + child: const Text('取消'), + ), + TextButton( + onPressed: () => Navigator.of(context).pop(true), + child: const Text( + '确定', + style: TextStyle(color: Colors.red), + ), + ), + ], + ), + ); + + if (confirmed == true) { + try { + final provider = Provider.of(context, listen: false); + // TODO: 实现清除历史记录功能 + // await provider.clearReadingHistory(); + _applyFilters(); + + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('历史记录已清除'), + duration: Duration(seconds: 2), + ), + ); + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('清除失败: $e'), + backgroundColor: Colors.red, + ), + ); + } + } + } + } + + /// 删除单个历史记录 + Future _removeHistoryItem(ReadingArticle article) async { + try { + final provider = Provider.of(context, listen: false); + // TODO: 实现移除历史记录功能 + // await provider.removeFromHistory(article.id); + _applyFilters(); + + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('已从历史记录中移除'), + duration: Duration(seconds: 2), + ), + ); + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('移除失败: $e'), + backgroundColor: Colors.red, + ), + ); + } + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: Colors.grey[50], + appBar: AppBar( + title: const Text('阅读历史'), + backgroundColor: Colors.white, + foregroundColor: Colors.black87, + elevation: 0, + actions: [ + IconButton( + icon: const Icon(Icons.search), + onPressed: () { + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => const ReadingSearchScreen(), + ), + ); + }, + ), + PopupMenuButton( + icon: const Icon(Icons.more_vert), + onSelected: (value) { + if (value == 'clear') { + _clearHistory(); + } else { + setState(() { + _sortBy = value; + }); + _applyFilters(); + } + }, + itemBuilder: (context) => [ + const PopupMenuItem( + value: 'newest', + child: Text('最近阅读'), + ), + const PopupMenuItem( + value: 'oldest', + child: Text('最早阅读'), + ), + const PopupMenuItem( + value: 'difficulty', + child: Text('按难度'), + ), + const PopupMenuItem( + value: 'readingTime', + child: Text('按阅读时长'), + ), + const PopupMenuDivider(), + const PopupMenuItem( + value: 'clear', + child: Text( + '清除历史', + style: TextStyle(color: Colors.red), + ), + ), + ], + ), + ], + ), + body: Column( + children: [ + // 筛选条件 + _buildFilterSection(), + + // 历史列表 + Expanded( + child: _isLoading + ? const Center( + child: CircularProgressIndicator( + valueColor: AlwaysStoppedAnimation(Color(0xFF2196F3)), + ), + ) + : _buildHistoryList(), + ), + ], + ), + ); + } + + /// 构建筛选条件 + Widget _buildFilterSection() { + return Container( + padding: const EdgeInsets.all(16), + color: Colors.white, + child: Column( + children: [ + // 时间筛选 + Row( + children: [ + const Text( + '时间：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: Colors.black87, + ), + ), + const SizedBox(width: 8), + Expanded( + child: SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + _buildFilterChip('全部', 'all', _selectedPeriod, (value) { + setState(() { + _selectedPeriod = value; + }); + _applyFilters(); + }), + _buildFilterChip('今天', 'today', _selectedPeriod, (value) { + setState(() { + _selectedPeriod = value; + }); + _applyFilters(); + }), + _buildFilterChip('本周', 'week', _selectedPeriod, (value) { + setState(() { + _selectedPeriod = value; + }); + _applyFilters(); + }), + _buildFilterChip('本月', 'month', _selectedPeriod, (value) { + setState(() { + _selectedPeriod = value; + }); + _applyFilters(); + }), + ], + ), + ), + ), + ], + ), + + const SizedBox(height: 12), + + // 难度筛选 + Row( + children: [ + const Text( + '难度：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: Colors.black87, + ), + ), + const SizedBox(width: 8), + Expanded( + child: SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + _buildFilterChip('全部', 'all', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + _applyFilters(); + }), + _buildFilterChip('初级', 'beginner', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + _applyFilters(); + }), + _buildFilterChip('中级', 'intermediate', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + _applyFilters(); + }), + _buildFilterChip('高级', 'advanced', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + _applyFilters(); + }), + ], + ), + ), + ), + ], + ), + ], + ), + ); + } + + /// 构建筛选标签 + Widget _buildFilterChip( + String label, + String value, + String selectedValue, + Function(String) onSelected, + ) { + final isSelected = selectedValue == value; + + return Padding( + padding: const EdgeInsets.only(right: 8), + child: GestureDetector( + onTap: () => onSelected(value), + child: Container( + padding: const EdgeInsets.symmetric( + horizontal: 12, + vertical: 6, + ), + decoration: BoxDecoration( + color: isSelected ? const Color(0xFF2196F3) : Colors.grey[100], + borderRadius: BorderRadius.circular(16), + border: Border.all( + color: isSelected ? const Color(0xFF2196F3) : Colors.grey[300]!, + ), + ), + child: Text( + label, + style: TextStyle( + fontSize: 12, + color: isSelected ? Colors.white : Colors.grey[700], + fontWeight: isSelected ? FontWeight.w500 : FontWeight.normal, + ), + ), + ), + ), + ); + } + + /// 构建历史列表 + Widget _buildHistoryList() { + if (_filteredHistory.isEmpty) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.history, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + _selectedPeriod == 'all' && _selectedDifficulty == 'all' + ? '还没有阅读历史' + : '没有符合条件的阅读记录', + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + Text( + _selectedPeriod == 'all' && _selectedDifficulty == 'all' + ? '开始你的第一次阅读吧' + : '试试调整筛选条件', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + ), + const SizedBox(height: 24), + ElevatedButton( + onPressed: () { + Navigator.of(context).pop(); + }, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric( + horizontal: 24, + vertical: 12, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(20), + ), + ), + child: const Text('去阅读'), + ), + ], + ), + ); + } + + return Column( + children: [ + // 统计信息 + Container( + padding: const EdgeInsets.all(16), + color: Colors.white, + child: Row( + children: [ + Text( + '共 ${_filteredHistory.length} 条记录', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const Spacer(), + if (_selectedPeriod != 'all' || _selectedDifficulty != 'all') + TextButton( + onPressed: () { + setState(() { + _selectedPeriod = 'all'; + _selectedDifficulty = 'all'; + }); + _applyFilters(); + }, + child: const Text( + '清除筛选', + style: TextStyle( + fontSize: 14, + color: Color(0xFF2196F3), + ), + ), + ), + ], + ), + ), + + // 文章列表 + Expanded( + child: ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: _filteredHistory.length, + itemBuilder: (context, index) { + final article = _filteredHistory[index]; + return Padding( + padding: const EdgeInsets.only(bottom: 12), + child: Dismissible( + key: Key('history_${article.id}'), + direction: DismissDirection.endToStart, + background: Container( + alignment: Alignment.centerRight, + padding: const EdgeInsets.only(right: 20), + decoration: BoxDecoration( + color: Colors.red, + borderRadius: BorderRadius.circular(12), + ), + child: const Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.delete_outline, + color: Colors.white, + size: 24, + ), + SizedBox(height: 4), + Text( + '删除记录', + style: TextStyle( + color: Colors.white, + fontSize: 12, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ), + confirmDismiss: (direction) async { + return await showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('删除记录'), + content: Text('确定要删除「${article.title}」的阅读记录吗？'), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(false), + child: const Text('取消'), + ), + TextButton( + onPressed: () => Navigator.of(context).pop(true), + child: const Text( + '确定', + style: TextStyle(color: Colors.red), + ), + ), + ], + ), + ) ?? false; + }, + onDismissed: (direction) { + _removeHistoryItem(article); + }, + child: _buildHistoryCard(article), + ), + ); + }, + ), + ), + ], + ); + } + + /// 构建历史记录卡片 + Widget _buildHistoryCard(ReadingArticle article) { + return GestureDetector( + onTap: () { + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => ReadingArticleScreen( + articleId: article.id, + ), + ), + ); + }, + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题和时间 + Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Expanded( + child: Text( + article.title, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ), + const SizedBox(width: 8), + Text( + _formatDate(article.publishDate), + style: TextStyle( + fontSize: 12, + color: Colors.grey[500], + ), + ), + ], + ), + + const SizedBox(height: 8), + + // 摘要 + Text( + article.content.length > 100 + ? '${article.content.substring(0, 100)}...' + : article.content, + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + height: 1.4, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + + const SizedBox(height: 12), + + // 标签和进度 + Row( + children: [ + // 难度标签 + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: _getDifficultyColor(article.difficulty).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + _getDifficultyText(article.difficulty), + style: TextStyle( + fontSize: 12, + color: _getDifficultyColor(article.difficulty), + fontWeight: FontWeight.w500, + ), + ), + ), + + const SizedBox(width: 8), + + // 分类标签 + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(12), + ), + child: Text( + article.category, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ), + + const Spacer(), + + // 阅读时长 + Row( + children: [ + Icon( + Icons.access_time, + size: 14, + color: Colors.grey[500], + ), + const SizedBox(width: 4), + Text( + '${article.readingTime}分钟', + style: TextStyle( + fontSize: 12, + color: Colors.grey[500], + ), + ), + ], + ), + ], + ), + ], + ), + ), + ); + } + + /// 格式化日期 + String _formatDate(DateTime date) { + final now = DateTime.now(); + final difference = now.difference(date); + + if (difference.inDays == 0) { + return '今天'; + } else if (difference.inDays == 1) { + return '昨天'; + } else if (difference.inDays < 7) { + return '${difference.inDays}天前'; + } else if (difference.inDays < 30) { + return '${(difference.inDays / 7).floor()}周前'; + } else { + return '${date.month}月${date.day}日'; + } + } + + /// 获取难度颜色 + Color _getDifficultyColor(String difficulty) { + switch (difficulty) { + case 'beginner': + return Colors.green; + case 'intermediate': + return Colors.orange; + case 'advanced': + return Colors.red; + default: + return Colors.grey; + } + } + + /// 获取难度文本 + String _getDifficultyText(String difficulty) { + switch (difficulty) { + case 'beginner': + return '初级'; + case 'intermediate': + return '中级'; + case 'advanced': + return '高级'; + default: + return '未知'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/reading/screens/reading_home_screen.dart b/client/lib/features/reading/screens/reading_home_screen.dart new file mode 100644 index 0000000..041f28e --- /dev/null +++ b/client/lib/features/reading/screens/reading_home_screen.dart @@ -0,0 +1,721 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/reading_exercise_model.dart'; +import '../providers/reading_provider.dart'; +import 'reading_category_screen.dart'; +import 'reading_exercise_screen.dart'; + +/// 阅读理解主页面 +class ReadingHomeScreen extends ConsumerStatefulWidget { + const ReadingHomeScreen({super.key}); + + @override + ConsumerState createState() => _ReadingHomeScreenState(); +} + +class _ReadingHomeScreenState extends ConsumerState { + @override + void initState() { + super.initState(); + // 加载推荐文章 + WidgetsBinding.instance.addPostFrameCallback((_) { + ref.read(readingMaterialsProvider.notifier).loadRecommendedMaterials(); + }); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + backgroundColor: Colors.transparent, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back, color: Colors.black87), + onPressed: () => Navigator.of(context).pop(), + ), + title: const Text( + '阅读理解', + style: TextStyle( + color: Colors.black87, + fontSize: 18, + fontWeight: FontWeight.w600, + ), + ), + centerTitle: true, + ), + body: SingleChildScrollView( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildReadingModes(context), + const SizedBox(height: 20), + _buildArticleCategories(), + const SizedBox(height: 20), + _buildRecommendedArticles(context), + const SizedBox(height: 20), + _buildReadingProgress(), + const SizedBox(height: 100), // 底部导航栏空间 + ], + ), + ), + ), + ); + } + + Widget _buildReadingModes(BuildContext context) { + return Container( + width: double.infinity, + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '阅读模式', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + LayoutBuilder( + builder: (context, constraints) { + // 在宽屏幕上使用更宽松的布局 + if (constraints.maxWidth > 600) { + return Row( + children: [ + Expanded( + child: _buildModeCard( + context, + '休闲阅读', + '轻松阅读体验', + Icons.book_outlined, + Colors.green, + () => _navigateToCategory(context, ReadingExerciseType.story), + ), + ), + const SizedBox(width: 20), + Expanded( + child: _buildModeCard( + context, + '练习阅读', + '结合练习题', + Icons.quiz, + Colors.blue, + () => _showExerciseTypeDialog(context), + ), + ), + ], + ); + } else { + return Row( + children: [ + Expanded( + child: _buildModeCard( + context, + '休闲阅读', + '轻松阅读体验', + Icons.book_outlined, + Colors.green, + () => _navigateToCategory(context, ReadingExerciseType.story), + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildModeCard( + context, + '练习阅读', + '结合练习题', + Icons.quiz, + Colors.blue, + () => _showExerciseTypeDialog(context), + ), + ), + ], + ); + } + }, + ), + ], + ), + ); + } + + Widget _buildModeCard(BuildContext context, String title, String subtitle, IconData icon, Color color, VoidCallback onTap) { + return GestureDetector( + onTap: onTap, + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: color.withOpacity(0.3)), + ), + child: Column( + children: [ + Icon( + icon, + color: color, + size: 32, + ), + const SizedBox(height: 8), + Text( + title, + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: color, + ), + ), + const SizedBox(height: 4), + Text( + subtitle, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ); + } + + Widget _buildArticleCategories() { + return Container( + width: double.infinity, + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '文章分类', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Consumer( + builder: (context, ref, _) { + final materialsState = ref.watch(readingMaterialsProvider); + if (materialsState.isLoading) { + return const Center(child: CircularProgressIndicator()); + } + if (materialsState.error != null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + const Icon(Icons.error_outline, size: 48, color: Colors.redAccent), + const SizedBox(height: 12), + Text('加载失败: ${materialsState.error}', style: const TextStyle(color: Colors.redAccent)), + const SizedBox(height: 8), + TextButton( + onPressed: () { + ref.read(readingMaterialsProvider.notifier).loadRecommendedMaterials(); + }, + child: const Text('重试'), + ), + ], + ), + ); + } + final materials = materialsState.materials; + if (materials.isEmpty) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + const Icon(Icons.category, size: 48, color: Colors.grey), + const SizedBox(height: 12), + const Text('暂无文章分类', style: TextStyle(color: Colors.grey)), + const SizedBox(height: 8), + TextButton( + onPressed: () { + ref.read(readingMaterialsProvider.notifier).loadRecommendedMaterials(); + }, + child: const Text('刷新'), + ), + ], + ), + ); + } + final Map counts = {}; + for (final m in materials) { + final key = m.type.name; + counts[key] = (counts[key] ?? 0) + 1; + } + final categories = counts.keys.toList(); + return GridView.builder( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount( + crossAxisCount: 2, + crossAxisSpacing: 12, + mainAxisSpacing: 12, + childAspectRatio: 2.5, + ), + itemCount: categories.length.clamp(0, 4), + itemBuilder: (context, index) { + final name = categories[index]; + final count = counts[name] ?? 0; + final color = [Colors.blue, Colors.green, Colors.orange, Colors.purple][index % 4]; + final icon = [Icons.computer, Icons.people, Icons.business_center, Icons.history_edu][index % 4]; + return GestureDetector( + onTap: () => _navigateToCategory(context, _mapStringToType(name)), + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Icon(icon, color: color, size: 24), + const SizedBox(width: 8), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Text( + name, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: color, + ), + ), + Text( + '$count篇', + style: const TextStyle(fontSize: 10, color: Colors.grey), + ), + ], + ), + ), + ], + ), + ), + ); + }, + ); + }, + ), + ], + ), + ); + } + + ReadingExerciseType _mapStringToType(String name) { + switch (name.toLowerCase()) { + case 'news': + return ReadingExerciseType.news; + case 'story': + return ReadingExerciseType.story; + case 'science': + return ReadingExerciseType.science; + case 'business': + return ReadingExerciseType.business; + case 'technology': + return ReadingExerciseType.technology; + default: + return ReadingExerciseType.news; + } + } + + Widget _buildRecommendedArticles(BuildContext context) { + final materialsState = ref.watch(readingMaterialsProvider); + + return Container( + width: double.infinity, + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '推荐文章', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + materialsState.isLoading + ? const Center(child: CircularProgressIndicator()) + : materialsState.error != null + ? Center( + child: Text( + '加载失败: ${materialsState.error}', + style: const TextStyle(color: Colors.red), + ), + ) + : LayoutBuilder( + builder: (context, constraints) { + final exercises = materialsState.materials; + if (exercises.isEmpty) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + const Icon(Icons.article_outlined, size: 48, color: Colors.grey), + const SizedBox(height: 12), + const Text('暂无推荐文章', style: TextStyle(color: Colors.grey)), + const SizedBox(height: 8), + TextButton( + onPressed: () { + ref.read(readingMaterialsProvider.notifier).loadRecommendedMaterials(); + }, + child: const Text('刷新'), + ), + ], + ), + ); + } + + if (constraints.maxWidth > 800) { + // 宽屏幕：使用网格布局 + return GridView.builder( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount( + crossAxisCount: 2, + crossAxisSpacing: 16, + mainAxisSpacing: 12, + childAspectRatio: 3.0, + ), + itemCount: exercises.length, + itemBuilder: (context, index) { + return _buildArticleItem(context, exercises[index]); + }, + ); + } else { + // 窄屏幕：使用列表布局 + return Column( + children: exercises.map((exercise) => + Padding( + padding: const EdgeInsets.only(bottom: 12), + child: _buildArticleItem(context, exercise), + ), + ).toList(), + ); + } + }, + ), + ], + ), + ); + } + + Widget _buildArticleItem(BuildContext context, ReadingExercise exercise) { + String getDifficultyLabel(ReadingDifficulty difficulty) { + switch (difficulty) { + case ReadingDifficulty.elementary: + return 'A1-A2'; + case ReadingDifficulty.intermediate: + return 'B1'; + case ReadingDifficulty.upperIntermediate: + return 'B2'; + case ReadingDifficulty.advanced: + return 'C1'; + case ReadingDifficulty.proficient: + return 'C2'; + } + } + + return GestureDetector( + onTap: () => _navigateToExercise(context, exercise), + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Container( + width: 40, + height: 40, + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(20), + ), + child: const Icon( + Icons.article, + color: Color(0xFF2196F3), + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + exercise.title, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + ), + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + Text( + exercise.summary, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 4), + Row( + children: [ + Text( + '${exercise.wordCount}词', + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + ), + const SizedBox(width: 8), + Text( + '${exercise.estimatedTime}分钟', + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + ), + ], + ), + ], + ), + ), + Container( + padding: const EdgeInsets.symmetric(horizontal: 6, vertical: 2), + decoration: BoxDecoration( + color: const Color(0xFF2196F3), + borderRadius: BorderRadius.circular(4), + ), + child: Text( + getDifficultyLabel(exercise.difficulty), + style: const TextStyle( + fontSize: 10, + color: Colors.white, + ), + ), + ), + ], + ), + ), + ); + } + + Widget _buildReadingProgress() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '阅读统计', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Consumer( + builder: (context, ref, _) { + final service = ref.watch(readingServiceProvider); + return FutureBuilder( + future: service.getReadingStats(), + builder: (context, snapshot) { + if (snapshot.connectionState == ConnectionState.waiting) { + return const Center(child: CircularProgressIndicator()); + } + if (snapshot.hasError) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + const Icon(Icons.error_outline, size: 48, color: Colors.redAccent), + const SizedBox(height: 12), + Text('获取统计失败: ${snapshot.error}', style: const TextStyle(color: Colors.redAccent)), + const SizedBox(height: 8), + TextButton( + onPressed: () { + setState(() {}); + }, + child: const Text('重试'), + ), + ], + ), + ); + } + if (!snapshot.hasData) { + return const Center(child: Text('暂无阅读统计', style: TextStyle(color: Colors.grey))); + } + final stats = snapshot.data!; + if (stats.totalArticlesRead == 0) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: const [ + Icon(Icons.bar_chart, size: 48, color: Colors.grey), + SizedBox(height: 12), + Text('暂无阅读统计', style: TextStyle(color: Colors.grey)), + ], + ), + ); + } + return Row( + mainAxisAlignment: MainAxisAlignment.spaceAround, + children: [ + _buildProgressItem('${stats.totalArticlesRead}', '已读文章', Icons.article), + _buildProgressItem('${stats.averageReadingSpeed.toStringAsFixed(0)}', '阅读速度', Icons.speed), + _buildProgressItem('${stats.comprehensionAccuracy.toStringAsFixed(0)}%', '理解率', Icons.psychology), + ], + ); + }, + ); + }, + ), + ], + ), + ); + } + + Widget _buildProgressItem(String value, String label, IconData icon) { + return Column( + children: [ + Icon( + icon, + color: const Color(0xFF2196F3), + size: 24, + ), + const SizedBox(height: 8), + Text( + value, + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + const SizedBox(height: 4), + Text( + label, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ); + } + + // 导航到分类页面 + void _navigateToCategory(BuildContext context, ReadingExerciseType type) { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => ReadingCategoryScreen(exerciseType: type), + ), + ); + } + + // 导航到练习页面 + void _navigateToExercise(BuildContext context, ReadingExercise exercise) { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => ReadingExerciseScreen(exercise: exercise), + ), + ); + } + + // 显示练习类型选择对话框 + void _showExerciseTypeDialog(BuildContext context) { + showDialog( + context: context, + builder: (BuildContext context) { + return AlertDialog( + title: const Text('选择练习类型'), + content: Column( + mainAxisSize: MainAxisSize.min, + children: [ + {'name': 'news', 'label': '新闻'}, + {'name': 'story', 'label': '故事'}, + {'name': 'science', 'label': '科学'}, + {'name': 'business', 'label': '商务'}, + {'name': 'technology', 'label': '科技'}, + ].map((category) { + return ListTile( + leading: const Icon(Icons.book), + title: Text(category['label']!), + onTap: () { + Navigator.pop(context); + _navigateToCategory(context, _mapStringToType(category['name']!)); + }, + ); + }).toList(), + ), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + ], + ); + }, + ); + } +} \ No newline at end of file diff --git a/client/lib/features/reading/screens/reading_result_screen.dart b/client/lib/features/reading/screens/reading_result_screen.dart new file mode 100644 index 0000000..23d9958 --- /dev/null +++ b/client/lib/features/reading/screens/reading_result_screen.dart @@ -0,0 +1,890 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../models/reading_question.dart'; +import '../providers/reading_provider.dart'; +import '../widgets/reading_article_card.dart'; + +/// 阅读练习结果页面 +class ReadingResultScreen extends StatefulWidget { + final ReadingExercise exercise; + final String articleTitle; + + const ReadingResultScreen({ + super.key, + required this.exercise, + required this.articleTitle, + }); + + @override + State createState() => _ReadingResultScreenState(); +} + +class _ReadingResultScreenState extends State + with TickerProviderStateMixin { + late AnimationController _animationController; + late Animation _fadeAnimation; + late Animation _slideAnimation; + + @override + void initState() { + super.initState(); + _animationController = AnimationController( + duration: const Duration(milliseconds: 800), + vsync: this, + ); + + _fadeAnimation = Tween( + begin: 0.0, + end: 1.0, + ).animate(CurvedAnimation( + parent: _animationController, + curve: Curves.easeInOut, + )); + + _slideAnimation = Tween( + begin: const Offset(0, 0.3), + end: Offset.zero, + ).animate(CurvedAnimation( + parent: _animationController, + curve: Curves.easeOutBack, + )); + + _animationController.forward(); + } + + @override + void dispose() { + _animationController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: Colors.grey[50], + appBar: AppBar( + title: const Text('练习结果'), + backgroundColor: Colors.white, + foregroundColor: Colors.black87, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.close), + onPressed: () => Navigator.of(context).pop(), + ), + ), + body: FadeTransition( + opacity: _fadeAnimation, + child: SlideTransition( + position: _slideAnimation, + child: SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 结果概览卡片 + _buildResultOverviewCard(), + + const SizedBox(height: 16), + + // 详细分析 + _buildDetailedAnalysis(), + + const SizedBox(height: 16), + + // 问题详情 + _buildQuestionDetails(), + + const SizedBox(height: 16), + + // 推荐文章 + _buildRecommendedArticles(), + + const SizedBox(height: 80), // 为底部按钮留空间 + ], + ), + ), + ), + ), + bottomNavigationBar: _buildBottomActions(), + ); + } + + /// 构建结果概览卡片 + Widget _buildResultOverviewCard() { + final score = widget.exercise.score ?? 0.0; + final totalQuestions = widget.exercise.totalQuestions; + final correctAnswers = widget.exercise.correctAnswers; + final percentage = (score * 100).round(); + + Color scoreColor; + String scoreText; + IconData scoreIcon; + + if (percentage >= 90) { + scoreColor = Colors.green; + scoreText = '优秀'; + scoreIcon = Icons.emoji_events; + } else if (percentage >= 80) { + scoreColor = Colors.blue; + scoreText = '良好'; + scoreIcon = Icons.thumb_up; + } else if (percentage >= 70) { + scoreColor = Colors.orange; + scoreText = '一般'; + scoreIcon = Icons.trending_up; + } else { + scoreColor = Colors.red; + scoreText = '需要努力'; + scoreIcon = Icons.refresh; + } + + return Card( + elevation: 4, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Container( + padding: const EdgeInsets.all(24), + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(16), + gradient: LinearGradient( + begin: Alignment.topLeft, + end: Alignment.bottomRight, + colors: [ + scoreColor.withOpacity(0.1), + scoreColor.withOpacity(0.05), + ], + ), + ), + child: Column( + children: [ + // 分数圆环 + Container( + width: 120, + height: 120, + child: Stack( + children: [ + // 背景圆环 + Container( + width: 120, + height: 120, + child: CircularProgressIndicator( + value: 1.0, + strokeWidth: 8, + backgroundColor: Colors.grey[200], + valueColor: AlwaysStoppedAnimation( + Colors.grey[200]!, + ), + ), + ), + // 进度圆环 + Container( + width: 120, + height: 120, + child: CircularProgressIndicator( + value: score, + strokeWidth: 8, + backgroundColor: Colors.transparent, + valueColor: AlwaysStoppedAnimation(scoreColor), + ), + ), + // 中心内容 + Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + scoreIcon, + color: scoreColor, + size: 24, + ), + const SizedBox(height: 4), + Text( + '$percentage%', + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: scoreColor, + ), + ), + ], + ), + ), + ], + ), + ), + + const SizedBox(height: 16), + + // 评价文本 + Text( + scoreText, + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: scoreColor, + ), + ), + + const SizedBox(height: 8), + + // 详细信息 + Text( + '答对 $correctAnswers / $totalQuestions 题', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + + const SizedBox(height: 4), + + Text( + '用时 ${_formatDuration(widget.exercise.duration)}', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ), + ), + ); + } + + /// 构建详细分析 + Widget _buildDetailedAnalysis() { + final questions = widget.exercise.questions; + final multipleChoice = questions.where((q) => q.type == QuestionType.multipleChoice).length; + final trueFalse = questions.where((q) => q.type == QuestionType.trueFalse).length; + final fillBlank = questions.where((q) => q.type == QuestionType.fillInBlank).length; + final shortAnswer = questions.where((q) => q.type == QuestionType.shortAnswer).length; + + final multipleChoiceCorrect = questions + .where((q) => q.type == QuestionType.multipleChoice && q.isCorrect == true) + .length; + final trueFalseCorrect = questions + .where((q) => q.type == QuestionType.trueFalse && q.isCorrect == true) + .length; + final fillBlankCorrect = questions + .where((q) => q.type == QuestionType.fillInBlank && q.isCorrect == true) + .length; + final shortAnswerCorrect = questions + .where((q) => q.type == QuestionType.shortAnswer && q.isCorrect == true) + .length; + + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '题型分析', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + + const SizedBox(height: 12), + + if (multipleChoice > 0) + _buildQuestionTypeRow( + '选择题', + multipleChoiceCorrect, + multipleChoice, + Icons.radio_button_checked, + ), + + if (trueFalse > 0) + _buildQuestionTypeRow( + '判断题', + trueFalseCorrect, + trueFalse, + Icons.check_circle, + ), + + if (fillBlank > 0) + _buildQuestionTypeRow( + '填空题', + fillBlankCorrect, + fillBlank, + Icons.edit, + ), + + if (shortAnswer > 0) + _buildQuestionTypeRow( + '简答题', + shortAnswerCorrect, + shortAnswer, + Icons.description, + ), + ], + ), + ), + ); + } + + /// 构建题型统计行 + Widget _buildQuestionTypeRow( + String type, + int correct, + int total, + IconData icon, + ) { + final percentage = total > 0 ? (correct / total * 100).round() : 0; + + return Padding( + padding: const EdgeInsets.symmetric(vertical: 4), + child: Row( + children: [ + Icon( + icon, + size: 20, + color: Colors.grey[600], + ), + const SizedBox(width: 8), + Text( + type, + style: const TextStyle( + fontSize: 14, + color: Colors.black87, + ), + ), + const Spacer(), + Text( + '$correct/$total', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const SizedBox(width: 8), + Text( + '$percentage%', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: percentage >= 80 ? Colors.green : + percentage >= 60 ? Colors.orange : Colors.red, + ), + ), + ], + ), + ); + } + + /// 构建问题详情 + Widget _buildQuestionDetails() { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + const Text( + '题目详情', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + const Spacer(), + TextButton( + onPressed: () { + _showQuestionDetailsDialog(); + }, + child: const Text('查看解析'), + ), + ], + ), + + const SizedBox(height: 12), + + ...widget.exercise.questions.asMap().entries.map((entry) { + final index = entry.key; + final question = entry.value; + + return _buildQuestionSummaryItem(index + 1, question); + }).toList(), + ], + ), + ), + ); + } + + /// 构建问题摘要项 + Widget _buildQuestionSummaryItem(int number, ReadingQuestion question) { + final isCorrect = question.isCorrect == true; + + return Container( + margin: const EdgeInsets.symmetric(vertical: 4), + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: isCorrect ? Colors.green.withOpacity(0.1) : Colors.red.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: isCorrect ? Colors.green.withOpacity(0.3) : Colors.red.withOpacity(0.3), + ), + ), + child: Row( + children: [ + // 题号 + Container( + width: 24, + height: 24, + decoration: BoxDecoration( + color: isCorrect ? Colors.green : Colors.red, + shape: BoxShape.circle, + ), + child: Center( + child: Text( + '$number', + style: const TextStyle( + color: Colors.white, + fontSize: 12, + fontWeight: FontWeight.bold, + ), + ), + ), + ), + + const SizedBox(width: 12), + + // 问题信息 + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + _getQuestionTypeText(question.type), + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 2), + Text( + question.question, + style: const TextStyle( + fontSize: 14, + color: Colors.black87, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ], + ), + ), + + // 结果图标 + Icon( + isCorrect ? Icons.check_circle : Icons.cancel, + color: isCorrect ? Colors.green : Colors.red, + size: 20, + ), + ], + ), + ); + } + + /// 获取问题类型文本 + String _getQuestionTypeText(QuestionType type) { + switch (type) { + case QuestionType.multipleChoice: + return '选择题'; + case QuestionType.trueFalse: + return '判断题'; + case QuestionType.fillInBlank: + return '填空题'; + case QuestionType.shortAnswer: + return '简答题'; + } + } + + /// 构建推荐文章 + Widget _buildRecommendedArticles() { + return Consumer( + builder: (context, provider, child) { + final recommendations = provider.recommendedArticles; + + if (recommendations.isEmpty) { + return const SizedBox.shrink(); + } + + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '推荐阅读', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + + const SizedBox(height: 12), + + ...recommendations.take(3).map((article) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 4), + child: ReadingArticleCard( + article: article, + onTap: () { + Navigator.of(context).pop(); + // 导航到文章详情页 + }, + ), + ); + }).toList(), + ], + ), + ), + ); + }, + ); + } + + /// 构建底部操作按钮 + Widget _buildBottomActions() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.1), + blurRadius: 4, + offset: const Offset(0, -2), + ), + ], + ), + child: Row( + children: [ + Expanded( + child: OutlinedButton( + onPressed: () { + // 重新练习 + Navigator.of(context).pop(); + // 重新开始练习逻辑 + }, + style: OutlinedButton.styleFrom( + foregroundColor: const Color(0xFF2196F3), + side: const BorderSide(color: Color(0xFF2196F3)), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + padding: const EdgeInsets.symmetric(vertical: 12), + ), + child: const Text('重新练习'), + ), + ), + + const SizedBox(width: 12), + + Expanded( + child: ElevatedButton( + onPressed: () { + Navigator.of(context).pop(); + }, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + padding: const EdgeInsets.symmetric(vertical: 12), + ), + child: const Text('完成'), + ), + ), + ], + ), + ); + } + + /// 显示问题详情对话框 + void _showQuestionDetailsDialog() { + showDialog( + context: context, + builder: (context) => Dialog( + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Container( + constraints: const BoxConstraints(maxHeight: 600), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + // 标题 + Container( + padding: const EdgeInsets.all(16), + decoration: const BoxDecoration( + color: Color(0xFF2196F3), + borderRadius: BorderRadius.only( + topLeft: Radius.circular(16), + topRight: Radius.circular(16), + ), + ), + child: Row( + children: [ + const Text( + '题目解析', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Colors.white, + ), + ), + const Spacer(), + IconButton( + onPressed: () => Navigator.of(context).pop(), + icon: const Icon( + Icons.close, + color: Colors.white, + ), + ), + ], + ), + ), + + // 内容 + Flexible( + child: ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: widget.exercise.questions.length, + itemBuilder: (context, index) { + final question = widget.exercise.questions[index]; + return _buildQuestionDetailItem(index + 1, question); + }, + ), + ), + ], + ), + ), + ), + ); + } + + /// 构建问题详情项 + Widget _buildQuestionDetailItem(int number, ReadingQuestion question) { + final isCorrect = question.isCorrect == true; + + return Container( + margin: const EdgeInsets.symmetric(vertical: 8), + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + border: Border.all(color: Colors.grey[300]!), + borderRadius: BorderRadius.circular(12), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 题号和类型 + Row( + children: [ + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: isCorrect ? Colors.green : Colors.red, + borderRadius: BorderRadius.circular(4), + ), + child: Text( + '第$number题', + style: const TextStyle( + color: Colors.white, + fontSize: 12, + fontWeight: FontWeight.bold, + ), + ), + ), + const SizedBox(width: 8), + Text( + _getQuestionTypeText(question.type), + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + const Spacer(), + Icon( + isCorrect ? Icons.check_circle : Icons.cancel, + color: isCorrect ? Colors.green : Colors.red, + size: 20, + ), + ], + ), + + const SizedBox(height: 12), + + // 问题 + Text( + question.question, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: Colors.black87, + ), + ), + + const SizedBox(height: 8), + + // 选项（如果有） + if (question.options.isNotEmpty) ... + question.options.asMap().entries.map((entry) { + final optionIndex = entry.key; + final option = entry.value; + final optionLetter = String.fromCharCode(65 + optionIndex); + final isUserAnswer = question.userAnswer == optionLetter; + final isCorrectAnswer = question.correctAnswer == optionLetter; + + Color? backgroundColor; + Color? textColor; + + if (isCorrectAnswer) { + backgroundColor = Colors.green.withOpacity(0.1); + textColor = Colors.green[700]; + } else if (isUserAnswer && !isCorrectAnswer) { + backgroundColor = Colors.red.withOpacity(0.1); + textColor = Colors.red[700]; + } + + return Container( + margin: const EdgeInsets.symmetric(vertical: 2), + padding: const EdgeInsets.all(8), + decoration: BoxDecoration( + color: backgroundColor, + borderRadius: BorderRadius.circular(6), + ), + child: Row( + children: [ + Text( + '$optionLetter. ', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: textColor ?? Colors.black87, + ), + ), + Expanded( + child: Text( + option, + style: TextStyle( + fontSize: 14, + color: textColor ?? Colors.black87, + ), + ), + ), + if (isCorrectAnswer) + const Icon( + Icons.check, + color: Colors.green, + size: 16, + ), + if (isUserAnswer && !isCorrectAnswer) + const Icon( + Icons.close, + color: Colors.red, + size: 16, + ), + ], + ), + ); + }).toList(), + + // 用户答案和正确答案 + if (question.type != QuestionType.multipleChoice) ...[ + const SizedBox(height: 8), + if (question.userAnswer?.isNotEmpty == true) + Text( + '你的答案：${question.userAnswer}', + style: TextStyle( + fontSize: 14, + color: isCorrect ? Colors.green[700] : Colors.red[700], + ), + ), + Text( + '正确答案：${question.correctAnswer}', + style: TextStyle( + fontSize: 14, + color: Colors.green[700], + fontWeight: FontWeight.w500, + ), + ), + ], + + // 解析 + if (question.explanation.isNotEmpty) ...[ + const SizedBox(height: 12), + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '解析', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: Colors.blue, + ), + ), + const SizedBox(height: 4), + Text( + question.explanation, + style: const TextStyle( + fontSize: 14, + color: Colors.black87, + ), + ), + ], + ), + ), + ], + ], + ), + ); + } + + /// 格式化持续时间 + String _formatDuration(Duration? duration) { + if (duration == null) return '未知'; + + final minutes = duration.inMinutes; + final seconds = duration.inSeconds % 60; + + if (minutes > 0) { + return '${minutes}分${seconds}秒'; + } else { + return '${seconds}秒'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/reading/screens/reading_search_screen.dart b/client/lib/features/reading/screens/reading_search_screen.dart new file mode 100644 index 0000000..67d2447 --- /dev/null +++ b/client/lib/features/reading/screens/reading_search_screen.dart @@ -0,0 +1,684 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../models/reading_article.dart'; +import '../providers/reading_provider.dart'; +import '../widgets/reading_article_card.dart'; +import '../widgets/reading_search_bar.dart'; +import 'reading_article_screen.dart'; + +/// 阅读搜索页面 +class ReadingSearchScreen extends StatefulWidget { + final String? initialQuery; + + const ReadingSearchScreen({ + super.key, + this.initialQuery, + }); + + @override + State createState() => _ReadingSearchScreenState(); +} + +class _ReadingSearchScreenState extends State { + late TextEditingController _searchController; + String _currentQuery = ''; + bool _isSearching = false; + List _searchResults = []; + List _searchHistory = []; + String _selectedDifficulty = 'all'; + String _selectedCategory = 'all'; + String _sortBy = 'relevance'; + + @override + void initState() { + super.initState(); + _searchController = TextEditingController(text: widget.initialQuery); + _currentQuery = widget.initialQuery ?? ''; + + if (_currentQuery.isNotEmpty) { + WidgetsBinding.instance.addPostFrameCallback((_) { + _performSearch(_currentQuery); + }); + } + + _loadSearchHistory(); + } + + @override + void dispose() { + _searchController.dispose(); + super.dispose(); + } + + /// 加载搜索历史 + void _loadSearchHistory() { + // TODO: 从本地存储加载搜索历史 + _searchHistory = [ + '四级阅读', + '商务英语', + '科技文章', + '新闻报道', + ]; + } + + /// 保存搜索历史 + void _saveSearchHistory(String query) { + if (query.trim().isEmpty) return; + + setState(() { + _searchHistory.remove(query); + _searchHistory.insert(0, query); + if (_searchHistory.length > 10) { + _searchHistory = _searchHistory.take(10).toList(); + } + }); + + // TODO: 保存到本地存储 + } + + /// 执行搜索 + Future _performSearch(String query) async { + if (query.trim().isEmpty) return; + + setState(() { + _isSearching = true; + _currentQuery = query; + }); + + _saveSearchHistory(query); + + try { + final provider = Provider.of(context, listen: false); + await provider.searchArticles(query); + + setState(() { + _searchResults = provider.articles; + }); + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('搜索失败: $e'), + backgroundColor: Colors.red, + ), + ); + } + } finally { + if (mounted) { + setState(() { + _isSearching = false; + }); + } + } + } + + /// 清除搜索历史 + void _clearSearchHistory() { + setState(() { + _searchHistory.clear(); + }); + // TODO: 清除本地存储 + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: Colors.grey[50], + appBar: AppBar( + title: const Text('搜索文章'), + backgroundColor: Colors.white, + foregroundColor: Colors.black87, + elevation: 0, + bottom: PreferredSize( + preferredSize: const Size.fromHeight(60), + child: Container( + padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8), + child: TextField( + controller: _searchController, + decoration: InputDecoration( + hintText: '搜索文章标题、内容或标签...', + hintStyle: TextStyle(color: Colors.grey[500]), + prefixIcon: const Icon( + Icons.search, + color: Color(0xFF2196F3), + ), + suffixIcon: _searchController.text.isNotEmpty + ? IconButton( + icon: const Icon(Icons.clear), + onPressed: () { + _searchController.clear(); + setState(() { + _currentQuery = ''; + _searchResults.clear(); + }); + }, + ) + : null, + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(25), + borderSide: BorderSide.none, + ), + filled: true, + fillColor: Colors.white, + contentPadding: const EdgeInsets.symmetric( + horizontal: 20, + vertical: 12, + ), + ), + onChanged: (value) { + setState(() {}); + }, + onSubmitted: _performSearch, + textInputAction: TextInputAction.search, + ), + ), + ), + ), + body: Column( + children: [ + // 筛选条件 + _buildFilterSection(), + + // 搜索结果或历史 + Expanded( + child: _currentQuery.isEmpty + ? _buildSearchHistory() + : _buildSearchResults(), + ), + ], + ), + ); + } + + /// 构建筛选条件 + Widget _buildFilterSection() { + return Container( + padding: const EdgeInsets.all(16), + color: Colors.white, + child: Column( + children: [ + // 难度筛选 + Row( + children: [ + const Text( + '难度：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: Colors.black87, + ), + ), + const SizedBox(width: 8), + Expanded( + child: SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + _buildFilterChip('全部', 'all', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + _buildFilterChip('初级', 'beginner', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + _buildFilterChip('中级', 'intermediate', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + _buildFilterChip('高级', 'advanced', _selectedDifficulty, (value) { + setState(() { + _selectedDifficulty = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + ], + ), + ), + ), + ], + ), + + const SizedBox(height: 12), + + // 分类筛选 + Row( + children: [ + const Text( + '分类：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: Colors.black87, + ), + ), + const SizedBox(width: 8), + Expanded( + child: SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + _buildFilterChip('全部', 'all', _selectedCategory, (value) { + setState(() { + _selectedCategory = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + _buildFilterChip('新闻', 'news', _selectedCategory, (value) { + setState(() { + _selectedCategory = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + _buildFilterChip('科技', 'technology', _selectedCategory, (value) { + setState(() { + _selectedCategory = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + _buildFilterChip('商务', 'business', _selectedCategory, (value) { + setState(() { + _selectedCategory = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + _buildFilterChip('文化', 'culture', _selectedCategory, (value) { + setState(() { + _selectedCategory = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + ], + ), + ), + ), + ], + ), + + const SizedBox(height: 12), + + // 排序方式 + Row( + children: [ + const Text( + '排序：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: Colors.black87, + ), + ), + const SizedBox(width: 8), + Expanded( + child: SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + _buildFilterChip('相关度', 'relevance', _sortBy, (value) { + setState(() { + _sortBy = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + _buildFilterChip('最新', 'newest', _sortBy, (value) { + setState(() { + _sortBy = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + _buildFilterChip('热门', 'popular', _sortBy, (value) { + setState(() { + _sortBy = value; + }); + if (_currentQuery.isNotEmpty) { + _performSearch(_currentQuery); + } + }), + ], + ), + ), + ), + ], + ), + ], + ), + ); + } + + /// 构建筛选标签 + Widget _buildFilterChip( + String label, + String value, + String selectedValue, + Function(String) onSelected, + ) { + final isSelected = selectedValue == value; + + return Padding( + padding: const EdgeInsets.only(right: 8), + child: GestureDetector( + onTap: () => onSelected(value), + child: Container( + padding: const EdgeInsets.symmetric( + horizontal: 12, + vertical: 6, + ), + decoration: BoxDecoration( + color: isSelected ? const Color(0xFF2196F3) : Colors.grey[100], + borderRadius: BorderRadius.circular(16), + border: Border.all( + color: isSelected ? const Color(0xFF2196F3) : Colors.grey[300]!, + ), + ), + child: Text( + label, + style: TextStyle( + fontSize: 12, + color: isSelected ? Colors.white : Colors.grey[700], + fontWeight: isSelected ? FontWeight.w500 : FontWeight.normal, + ), + ), + ), + ), + ); + } + + /// 构建搜索历史 + Widget _buildSearchHistory() { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 热门搜索 + _buildHotSearches(), + + const SizedBox(height: 24), + + // 搜索历史 + if (_searchHistory.isNotEmpty) _buildHistorySection(), + ], + ), + ); + } + + /// 构建热门搜索 + Widget _buildHotSearches() { + final hotSearches = [ + '四级阅读', + '六级阅读', + '托福阅读', + '雅思阅读', + '商务英语', + '日常对话', + '科技文章', + '新闻报道', + '文化差异', + '环境保护', + ]; + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '热门搜索', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + + const SizedBox(height: 12), + + Wrap( + spacing: 8, + runSpacing: 8, + children: hotSearches.map((search) { + return GestureDetector( + onTap: () { + _searchController.text = search; + _performSearch(search); + }, + child: Container( + padding: const EdgeInsets.symmetric( + horizontal: 12, + vertical: 8, + ), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + border: Border.all(color: Colors.grey[300]!), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + Icons.trending_up, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 4), + Text( + search, + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + ), + ], + ), + ), + ); + }).toList(), + ), + ], + ); + } + + /// 构建历史搜索 + Widget _buildHistorySection() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + const Text( + '搜索历史', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + const Spacer(), + TextButton( + onPressed: _clearSearchHistory, + child: Text( + '清空', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ), + ], + ), + + const SizedBox(height: 8), + + ..._searchHistory.map((history) { + return ListTile( + leading: Icon( + Icons.history, + color: Colors.grey[500], + size: 20, + ), + title: Text( + history, + style: const TextStyle( + fontSize: 14, + color: Colors.black87, + ), + ), + trailing: IconButton( + icon: Icon( + Icons.close, + color: Colors.grey[500], + size: 18, + ), + onPressed: () { + setState(() { + _searchHistory.remove(history); + }); + }, + ), + onTap: () { + _searchController.text = history; + _performSearch(history); + }, + ); + }).toList(), + ], + ); + } + + /// 构建搜索结果 + Widget _buildSearchResults() { + if (_isSearching) { + return const Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + CircularProgressIndicator( + valueColor: AlwaysStoppedAnimation(Color(0xFF2196F3)), + ), + SizedBox(height: 16), + Text( + '搜索中...', + style: TextStyle( + fontSize: 16, + color: Colors.grey, + ), + ), + ], + ), + ); + } + + if (_searchResults.isEmpty) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.search_off, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '没有找到相关文章', + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + Text( + '试试其他关键词或调整筛选条件', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + ), + ], + ), + ); + } + + return Column( + children: [ + // 结果统计 + Container( + padding: const EdgeInsets.all(16), + color: Colors.white, + child: Row( + children: [ + Text( + '找到 ${_searchResults.length} 篇相关文章', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const Spacer(), + Text( + '搜索"$_currentQuery"', + style: const TextStyle( + fontSize: 14, + color: Colors.black87, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ), + + // 文章列表 + Expanded( + child: ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: _searchResults.length, + itemBuilder: (context, index) { + final article = _searchResults[index]; + return Padding( + padding: const EdgeInsets.only(bottom: 12), + child: ReadingArticleCard( + article: article, + onTap: () { + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => ReadingArticleScreen( + articleId: article.id, + ), + ), + ); + }, + ), + ); + }, + ), + ), + ], + ); + } +} \ No newline at end of file diff --git a/client/lib/features/reading/services/reading_service.dart b/client/lib/features/reading/services/reading_service.dart new file mode 100644 index 0000000..6aa11d9 --- /dev/null +++ b/client/lib/features/reading/services/reading_service.dart @@ -0,0 +1,280 @@ +import 'package:dio/dio.dart'; +import '../../../core/network/api_client.dart'; +import '../../../core/network/api_endpoints.dart'; +import '../../../core/services/enhanced_api_service.dart'; +import '../../../core/models/api_response.dart'; +import '../models/reading_article.dart'; +import '../models/reading_question.dart'; +import '../models/reading_stats.dart'; + +/// 阅读服务类 +class ReadingService { + final ApiClient _apiClient = ApiClient.instance; + final EnhancedApiService _enhancedApiService = EnhancedApiService(); + + // 缓存时长配置 + static const Duration _shortCacheDuration = Duration(minutes: 5); + static const Duration _longCacheDuration = Duration(hours: 1); + + /// 获取文章列表 + Future> getArticles({ + String? category, + String? difficulty, + int page = 1, + int limit = 20, + }) async { + try { + final response = await _enhancedApiService.get>( + ApiEndpoints.readingMaterials, + queryParameters: { + if (category != null) 'category': category, + if (difficulty != null) 'level': difficulty, + 'page': page, + 'limit': limit, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final List list = data['data'] ?? []; + return list.map((json) => ReadingArticle.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取文章列表失败: $e'); + } + } + + /// 获取单篇文章详情 + Future getArticle(String articleId) async { + try { + final response = await _enhancedApiService.get( + '${ApiEndpoints.readingMaterials}/$articleId', + cacheDuration: _longCacheDuration, + fromJson: (data) => ReadingArticle.fromJson(data['data']), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取文章详情失败: $e'); + } + } + + /// 获取文章练习题 + Future getArticleExercise(String articleId) async { + try { + final response = await _enhancedApiService.get( + '${ApiEndpoints.reading}/exercises/$articleId', + cacheDuration: _longCacheDuration, + fromJson: (data) => ReadingExercise.fromJson(data['data']), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取练习题失败: $e'); + } + } + + /// 提交练习答案 + Future submitExercise(ReadingExercise exercise) async { + try { + final response = await _apiClient.post( + '${ApiEndpoints.reading}/exercises/${exercise.id}/submit', + data: exercise.toJson(), + ); + + if (response.statusCode == 200) { + return ReadingExercise.fromJson(response.data['data']); + } else { + throw Exception('Failed to submit exercise'); + } + } catch (e) { + throw Exception('Error submitting exercise: $e'); + } + } + + /// 记录阅读进度 + Future recordReadingProgress({ + required String articleId, + required int readingTime, + required bool completed, + double? comprehensionScore, + }) async { + try { + final response = await _apiClient.post( + '${ApiEndpoints.readingRecords}', + data: { + 'article_id': articleId, + 'reading_time': readingTime, + 'completed': completed, + if (comprehensionScore != null) 'comprehension_score': comprehensionScore, + }, + ); + + if (response.statusCode != 200) { + throw Exception('Failed to record progress'); + } + } catch (e) { + throw Exception('Error recording progress: $e'); + } + } + + /// 获取阅读统计 + Future getReadingStats() async { + try { + final response = await _apiClient.get( + ApiEndpoints.readingStats, + ); + + if (response.statusCode == 200) { + return ReadingStats.fromJson(response.data['data']); + } else { + throw Exception('Failed to load reading stats'); + } + } catch (e) { + throw Exception('Error fetching reading stats: $e'); + } + } + + /// 获取推荐文章 + Future> getRecommendedArticles({int limit = 10}) async { + try { + final response = await _apiClient.get( + '${ApiEndpoints.reading}/recommendations', + queryParameters: {'limit': limit}, + ); + + if (response.statusCode == 200) { + final List data = response.data['data']; + return data.map((json) => ReadingArticle.fromJson(json)).toList(); + } else { + throw Exception('Failed to load recommended articles'); + } + } catch (e) { + throw Exception('Error fetching recommended articles: $e'); + } + } + + /// 搜索文章 + Future> searchArticles({ + required String query, + String? category, + String? difficulty, + int page = 1, + int limit = 20, + }) async { + try { + final response = await _apiClient.get( + '${ApiEndpoints.readingMaterials}/search', + queryParameters: { + 'q': query, + if (category != null) 'category': category, + if (difficulty != null) 'difficulty': difficulty, + 'page': page, + 'limit': limit, + }, + ); + + if (response.statusCode == 200) { + final List data = response.data['data']; + return data.map((json) => ReadingArticle.fromJson(json)).toList(); + } else { + throw Exception('Failed to search articles'); + } + } catch (e) { + throw Exception('Error searching articles: $e'); + } + } + + /// 收藏文章 + Future favoriteArticle(String articleId) async { + try { + final response = await _apiClient.post( + '${ApiEndpoints.readingMaterials}/$articleId/favorite', + ); + + if (response.statusCode != 200) { + throw Exception('Failed to favorite article'); + } + } catch (e) { + throw Exception('Error favoriting article: $e'); + } + } + + /// 取消收藏文章 + Future unfavoriteArticle(String articleId) async { + try { + final response = await _apiClient.delete( + '${ApiEndpoints.readingMaterials}/$articleId/favorite', + ); + + if (response.statusCode != 200) { + throw Exception('Failed to unfavorite article'); + } + } catch (e) { + throw Exception('Error unfavoriting article: $e'); + } + } + + /// 获取收藏文章 + Future> getFavoriteArticles({ + int page = 1, + int limit = 20, + }) async { + try { + final response = await _apiClient.get( + '${ApiEndpoints.readingMaterials}/favorites', + queryParameters: { + 'page': page, + 'limit': limit, + }, + ); + + if (response.statusCode == 200) { + final List data = response.data['data']; + return data.map((json) => ReadingArticle.fromJson(json)).toList(); + } else { + throw Exception('Failed to load favorite articles'); + } + } catch (e) { + throw Exception('Error fetching favorite articles: $e'); + } + } + + /// 获取阅读历史 + Future> getReadingHistory({ + int page = 1, + int limit = 20, + }) async { + try { + final response = await _apiClient.get( + '${ApiEndpoints.readingRecords}', + queryParameters: { + 'page': page, + 'limit': limit, + }, + ); + + if (response.statusCode == 200) { + final List data = response.data['data']; + return data.map((json) => ReadingArticle.fromJson(json)).toList(); + } else { + throw Exception('Failed to load reading history'); + } + } catch (e) { + throw Exception('Error fetching reading history: $e'); + } + } +} \ No newline at end of file diff --git a/client/lib/features/reading/widgets/reading_article_card.dart b/client/lib/features/reading/widgets/reading_article_card.dart new file mode 100644 index 0000000..d3d837d --- /dev/null +++ b/client/lib/features/reading/widgets/reading_article_card.dart @@ -0,0 +1,274 @@ +import 'package:flutter/material.dart'; +import '../models/reading_article.dart'; + +/// 阅读文章卡片组件 +class ReadingArticleCard extends StatelessWidget { + final ReadingArticle article; + final VoidCallback? onTap; + final VoidCallback? onFavorite; + final bool showProgress; + + const ReadingArticleCard({ + super.key, + required this.article, + this.onTap, + this.onFavorite, + this.showProgress = false, + }); + + @override + Widget build(BuildContext context) { + return Card( + margin: const EdgeInsets.only(bottom: 16), + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题和收藏按钮 + Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Expanded( + child: Text( + article.title, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ), + if (onFavorite != null) + IconButton( + icon: const Icon( + Icons.favorite_border, + color: Colors.grey, + size: 20, + ), + onPressed: onFavorite, + padding: EdgeInsets.zero, + constraints: const BoxConstraints( + minWidth: 24, + minHeight: 24, + ), + ), + ], + ), + + const SizedBox(height: 8), + + // 文章摘要 + if (article.content.isNotEmpty) + Text( + _getExcerpt(article.content), + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + height: 1.4, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + + const SizedBox(height: 12), + + // 标签行 + Row( + children: [ + // 分类标签 + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + article.categoryLabel, + style: const TextStyle( + fontSize: 12, + color: Color(0xFF2196F3), + fontWeight: FontWeight.w500, + ), + ), + ), + const SizedBox(width: 8), + + // 难度标签 + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: _getDifficultyColor(article.difficulty).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + article.difficultyLabel, + style: TextStyle( + fontSize: 12, + color: _getDifficultyColor(article.difficulty), + fontWeight: FontWeight.w500, + ), + ), + ), + + const Spacer(), + + // 字数和阅读时间 + Text( + '${article.wordCount}词', + style: TextStyle( + fontSize: 12, + color: Colors.grey[500], + ), + ), + const SizedBox(width: 8), + Icon( + Icons.schedule, + size: 12, + color: Colors.grey[500], + ), + const SizedBox(width: 2), + Text( + '${article.readingTime}分钟', + style: TextStyle( + fontSize: 12, + color: Colors.grey[500], + ), + ), + ], + ), + + // 进度条（如果需要显示） + if (showProgress && article.isCompleted) + Padding( + padding: const EdgeInsets.only(top: 12), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '已完成', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + if (article.comprehensionScore != null) + Text( + '得分: ${article.comprehensionScore}分', + style: TextStyle( + fontSize: 12, + color: _getScoreColor(article.comprehensionScore!.toInt()), + fontWeight: FontWeight.w500, + ), + ), + ], + ), + const SizedBox(height: 4), + LinearProgressIndicator( + value: 1.0, + backgroundColor: Colors.grey[200], + valueColor: AlwaysStoppedAnimation( + _getScoreColor((article.comprehensionScore ?? 0).toInt()), + ), + ), + ], + ), + ), + + // 标签（如果有） + if (article.tags.isNotEmpty) + Padding( + padding: const EdgeInsets.only(top: 8), + child: Wrap( + spacing: 6, + runSpacing: 4, + children: article.tags.take(3).map((tag) { + return Container( + padding: const EdgeInsets.symmetric( + horizontal: 6, + vertical: 2, + ), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(8), + ), + child: Text( + '#$tag', + style: TextStyle( + fontSize: 10, + color: Colors.grey[600], + ), + ), + ); + }).toList(), + ), + ), + ], + ), + ), + ), + ); + } + + /// 获取文章摘要 + String _getExcerpt(String content) { + // 移除HTML标签和多余空白 + String cleanContent = content + .replaceAll(RegExp(r'<[^>]*>'), '') + .replaceAll(RegExp(r'\s+'), ' ') + .trim(); + + // 截取前100个字符作为摘要 + if (cleanContent.length <= 100) { + return cleanContent; + } + + return '${cleanContent.substring(0, 100)}...'; + } + + /// 获取难度颜色 + Color _getDifficultyColor(String difficulty) { + switch (difficulty.toLowerCase()) { + case 'a1': + case 'a2': + return Colors.green; + case 'b1': + case 'b2': + return Colors.orange; + case 'c1': + case 'c2': + return Colors.red; + default: + return Colors.grey; + } + } + + /// 获取分数颜色 + Color _getScoreColor(int score) { + if (score >= 90) { + return Colors.green; + } else if (score >= 70) { + return Colors.orange; + } else { + return Colors.red; + } + } +} \ No newline at end of file diff --git a/client/lib/features/reading/widgets/reading_category_tabs.dart b/client/lib/features/reading/widgets/reading_category_tabs.dart new file mode 100644 index 0000000..5b7215d --- /dev/null +++ b/client/lib/features/reading/widgets/reading_category_tabs.dart @@ -0,0 +1,240 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../providers/reading_provider.dart'; + +/// 阅读分类标签组件 +class ReadingCategoryTabs extends StatelessWidget { + const ReadingCategoryTabs({super.key}); + + static const List> categories = [ + {'key': '', 'label': '全部'}, + {'key': 'cet4', 'label': '四级'}, + {'key': 'cet6', 'label': '六级'}, + {'key': 'toefl', 'label': '托福'}, + {'key': 'ielts', 'label': '雅思'}, + {'key': 'daily', 'label': '日常'}, + {'key': 'business', 'label': '商务'}, + {'key': 'academic', 'label': '学术'}, + ]; + + @override + Widget build(BuildContext context) { + return Container( + height: 50, + padding: const EdgeInsets.symmetric(vertical: 8), + decoration: BoxDecoration( + color: Colors.white, + border: Border( + bottom: BorderSide(color: Colors.grey[200]!), + ), + ), + child: Consumer( + builder: (context, provider, child) { + return ListView.builder( + scrollDirection: Axis.horizontal, + padding: const EdgeInsets.symmetric(horizontal: 16), + itemCount: categories.length, + itemBuilder: (context, index) { + final category = categories[index]; + final isSelected = provider.selectedCategory == category['key'] || + (provider.selectedCategory == null && category['key'] == ''); + + return Padding( + padding: const EdgeInsets.only(right: 12), + child: _buildCategoryChip( + context, + category['label']!, + category['key']!, + isSelected, + provider, + ), + ); + }, + ); + }, + ), + ); + } + + /// 构建分类标签 + Widget _buildCategoryChip( + BuildContext context, + String label, + String key, + bool isSelected, + ReadingProvider provider, + ) { + return GestureDetector( + onTap: () { + final selectedKey = key.isEmpty ? null : key; + provider.setFilter(category: selectedKey); + provider.loadArticles(refresh: true); + }, + child: AnimatedContainer( + duration: const Duration(milliseconds: 200), + padding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 6, + ), + decoration: BoxDecoration( + color: isSelected + ? const Color(0xFF2196F3) + : Colors.grey[100], + borderRadius: BorderRadius.circular(20), + border: Border.all( + color: isSelected + ? const Color(0xFF2196F3) + : Colors.grey[300]!, + width: 1, + ), + ), + child: Text( + label, + style: TextStyle( + color: isSelected + ? Colors.white + : Colors.grey[700], + fontSize: 14, + fontWeight: isSelected + ? FontWeight.w600 + : FontWeight.normal, + ), + ), + ), + ); + } +} + +/// 阅读难度筛选组件 +class ReadingDifficultyFilter extends StatelessWidget { + const ReadingDifficultyFilter({super.key}); + + static const List> difficulties = [ + {'key': '', 'label': '全部难度'}, + {'key': 'a1', 'label': 'A1'}, + {'key': 'a2', 'label': 'A2'}, + {'key': 'b1', 'label': 'B1'}, + {'key': 'b2', 'label': 'B2'}, + {'key': 'c1', 'label': 'C1'}, + {'key': 'c2', 'label': 'C2'}, + ]; + + @override + Widget build(BuildContext context) { + return Container( + height: 50, + padding: const EdgeInsets.symmetric(vertical: 8), + decoration: BoxDecoration( + color: Colors.white, + border: Border( + bottom: BorderSide(color: Colors.grey[200]!), + ), + ), + child: Consumer( + builder: (context, provider, child) { + return ListView.builder( + scrollDirection: Axis.horizontal, + padding: const EdgeInsets.symmetric(horizontal: 16), + itemCount: difficulties.length, + itemBuilder: (context, index) { + final difficulty = difficulties[index]; + final isSelected = provider.selectedDifficulty == difficulty['key'] || + (provider.selectedDifficulty == null && difficulty['key'] == ''); + + return Padding( + padding: const EdgeInsets.only(right: 12), + child: _buildDifficultyChip( + context, + difficulty['label']!, + difficulty['key']!, + isSelected, + provider, + ), + ); + }, + ); + }, + ), + ); + } + + /// 构建难度标签 + Widget _buildDifficultyChip( + BuildContext context, + String label, + String key, + bool isSelected, + ReadingProvider provider, + ) { + final color = _getDifficultyColor(key); + + return GestureDetector( + onTap: () { + final selectedKey = key.isEmpty ? null : key; + provider.setFilter(difficulty: selectedKey); + provider.loadArticles(refresh: true); + }, + child: AnimatedContainer( + duration: const Duration(milliseconds: 200), + padding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 6, + ), + decoration: BoxDecoration( + color: isSelected + ? color + : color.withOpacity(0.1), + borderRadius: BorderRadius.circular(20), + border: Border.all( + color: color, + width: 1, + ), + ), + child: Text( + label, + style: TextStyle( + color: isSelected + ? Colors.white + : color, + fontSize: 14, + fontWeight: isSelected + ? FontWeight.w600 + : FontWeight.normal, + ), + ), + ), + ); + } + + /// 获取难度颜色 + Color _getDifficultyColor(String difficulty) { + switch (difficulty.toLowerCase()) { + case 'a1': + case 'a2': + return Colors.green; + case 'b1': + case 'b2': + return Colors.orange; + case 'c1': + case 'c2': + return Colors.red; + default: + return const Color(0xFF2196F3); + } + } +} + +/// 组合的分类和难度筛选组件 +class ReadingFilterTabs extends StatelessWidget { + const ReadingFilterTabs({super.key}); + + @override + Widget build(BuildContext context) { + return Column( + children: [ + const ReadingCategoryTabs(), + const ReadingDifficultyFilter(), + ], + ); + } +} \ No newline at end of file diff --git a/client/lib/features/reading/widgets/reading_content_widget.dart b/client/lib/features/reading/widgets/reading_content_widget.dart new file mode 100644 index 0000000..24d11ec --- /dev/null +++ b/client/lib/features/reading/widgets/reading_content_widget.dart @@ -0,0 +1,209 @@ +import 'package:flutter/material.dart'; +import '../models/reading_article.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/theme/app_text_styles.dart'; + +/// 阅读内容组件 +class ReadingContentWidget extends StatefulWidget { + final ReadingArticle article; + final ScrollController? scrollController; + final VoidCallback? onWordTap; + final Function(String)? onTextSelection; + + const ReadingContentWidget({ + super.key, + required this.article, + this.scrollController, + this.onWordTap, + this.onTextSelection, + }); + + @override + State createState() => _ReadingContentWidgetState(); +} + +class _ReadingContentWidgetState extends State { + double _fontSize = 16.0; + double _lineHeight = 1.6; + bool _isDarkMode = false; + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 文章标题 + Text( + widget.article.title, + style: AppTextStyles.headlineMedium.copyWith( + fontSize: _fontSize + 4, + fontWeight: FontWeight.bold, + color: _isDarkMode ? AppColors.onSurface : AppColors.onSurface, + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 文章信息 + Row( + children: [ + Icon( + Icons.category_outlined, + size: 16, + color: AppColors.onSurfaceVariant, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + widget.article.category, + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + Icon( + Icons.schedule_outlined, + size: 16, + color: AppColors.onSurfaceVariant, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + '${widget.article.estimatedReadingTime} 分钟', + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + Icon( + Icons.text_fields_outlined, + size: 16, + color: AppColors.onSurfaceVariant, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + '${widget.article.wordCount} 词', + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingLg), + + // 阅读设置工具栏 + _buildReadingToolbar(), + const SizedBox(height: AppDimensions.spacingMd), + + // 文章内容 + Expanded( + child: SingleChildScrollView( + controller: widget.scrollController, + child: SelectableText( + widget.article.content, + style: AppTextStyles.bodyLarge.copyWith( + fontSize: _fontSize, + height: _lineHeight, + color: _isDarkMode ? AppColors.onSurface : AppColors.onSurface, + ), + onSelectionChanged: (selection, cause) { + if (selection.isValid && widget.onTextSelection != null) { + final selectedText = widget.article.content + .substring(selection.start, selection.end); + widget.onTextSelection!(selectedText); + } + }, + ), + ), + ), + ], + ), + ); + } + + Widget _buildReadingToolbar() { + return Container( + padding: const EdgeInsets.symmetric( + horizontal: AppDimensions.spacingSm, + vertical: AppDimensions.spacingXs, + ), + decoration: BoxDecoration( + color: AppColors.surfaceVariant, + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + ), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceEvenly, + children: [ + // 字体大小调节 + Row( + children: [ + IconButton( + onPressed: () { + setState(() { + if (_fontSize > 12) _fontSize -= 1; + }); + }, + icon: const Icon(Icons.text_decrease), + iconSize: 20, + ), + Text( + '${_fontSize.toInt()}', + style: AppTextStyles.bodySmall, + ), + IconButton( + onPressed: () { + setState(() { + if (_fontSize < 24) _fontSize += 1; + }); + }, + icon: const Icon(Icons.text_increase), + iconSize: 20, + ), + ], + ), + + // 行间距调节 + Row( + children: [ + IconButton( + onPressed: () { + setState(() { + if (_lineHeight > 1.2) _lineHeight -= 0.1; + }); + }, + icon: const Icon(Icons.format_line_spacing), + iconSize: 20, + ), + Text( + '${(_lineHeight * 10).toInt() / 10}', + style: AppTextStyles.bodySmall, + ), + IconButton( + onPressed: () { + setState(() { + if (_lineHeight < 2.0) _lineHeight += 0.1; + }); + }, + icon: const Icon(Icons.format_line_spacing), + iconSize: 20, + ), + ], + ), + + // 夜间模式切换 + IconButton( + onPressed: () { + setState(() { + _isDarkMode = !_isDarkMode; + }); + }, + icon: Icon( + _isDarkMode ? Icons.light_mode : Icons.dark_mode, + ), + iconSize: 20, + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/reading/widgets/reading_progress_bar.dart b/client/lib/features/reading/widgets/reading_progress_bar.dart new file mode 100644 index 0000000..51194a8 --- /dev/null +++ b/client/lib/features/reading/widgets/reading_progress_bar.dart @@ -0,0 +1,240 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/theme/app_text_styles.dart'; + +/// 阅读进度条组件 +class ReadingProgressBar extends StatelessWidget { + final int current; + final int total; + final double? progress; + final String? label; + final bool showPercentage; + final Color? progressColor; + final Color? backgroundColor; + + const ReadingProgressBar({ + super.key, + required this.current, + required this.total, + this.progress, + this.label, + this.showPercentage = true, + this.progressColor, + this.backgroundColor, + }); + + @override + Widget build(BuildContext context) { + final progressValue = progress ?? (total > 0 ? current / total : 0.0); + final percentage = (progressValue * 100).toInt(); + + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题和进度信息 + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + label ?? '进度', + style: AppTextStyles.titleMedium, + ), + Row( + children: [ + Text( + '$current / $total', + style: AppTextStyles.bodyMedium.copyWith( + fontWeight: FontWeight.w500, + ), + ), + if (showPercentage) ...[ + const SizedBox(width: AppDimensions.spacingSm), + Text( + '$percentage%', + style: AppTextStyles.bodyMedium.copyWith( + color: progressColor ?? AppColors.primary, + fontWeight: FontWeight.bold, + ), + ), + ], + ], + ), + ], + ), + const SizedBox(height: AppDimensions.spacingSm), + + // 进度条 + LinearProgressIndicator( + value: progressValue, + backgroundColor: backgroundColor ?? AppColors.surfaceVariant, + valueColor: AlwaysStoppedAnimation( + progressColor ?? AppColors.primary, + ), + minHeight: 6, + ), + ], + ), + ); + } +} + +/// 圆形进度条组件 +class ReadingCircularProgressBar extends StatelessWidget { + final int current; + final int total; + final double? progress; + final double size; + final double strokeWidth; + final Color? progressColor; + final Color? backgroundColor; + final Widget? child; + + const ReadingCircularProgressBar({ + super.key, + required this.current, + required this.total, + this.progress, + this.size = 80, + this.strokeWidth = 6, + this.progressColor, + this.backgroundColor, + this.child, + }); + + @override + Widget build(BuildContext context) { + final progressValue = progress ?? (total > 0 ? current / total : 0.0); + final percentage = (progressValue * 100).toInt(); + + return SizedBox( + width: size, + height: size, + child: Stack( + alignment: Alignment.center, + children: [ + // 圆形进度条 + CircularProgressIndicator( + value: progressValue, + strokeWidth: strokeWidth, + backgroundColor: backgroundColor ?? AppColors.surfaceVariant, + valueColor: AlwaysStoppedAnimation( + progressColor ?? AppColors.primary, + ), + ), + + // 中心内容 + child ?? + Column( + mainAxisSize: MainAxisSize.min, + children: [ + Text( + '$percentage%', + style: AppTextStyles.titleMedium.copyWith( + fontWeight: FontWeight.bold, + color: progressColor ?? AppColors.primary, + ), + ), + Text( + '$current/$total', + style: AppTextStyles.bodySmall.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ], + ), + ); + } +} + +/// 步骤进度条组件 +class ReadingStepProgressBar extends StatelessWidget { + final int currentStep; + final int totalSteps; + final List? stepLabels; + final Color? activeColor; + final Color? inactiveColor; + final Color? completedColor; + + const ReadingStepProgressBar({ + super.key, + required this.currentStep, + required this.totalSteps, + this.stepLabels, + this.activeColor, + this.inactiveColor, + this.completedColor, + }); + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + child: Row( + children: List.generate(totalSteps, (index) { + final stepNumber = index + 1; + final isCompleted = stepNumber < currentStep; + final isActive = stepNumber == currentStep; + final isInactive = stepNumber > currentStep; + + Color stepColor; + if (isCompleted) { + stepColor = completedColor ?? AppColors.success; + } else if (isActive) { + stepColor = activeColor ?? AppColors.primary; + } else { + stepColor = inactiveColor ?? AppColors.surfaceVariant; + } + + return Expanded( + child: Row( + children: [ + // 步骤圆圈 + Container( + width: 32, + height: 32, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: stepColor, + ), + child: Center( + child: isCompleted + ? Icon( + Icons.check, + color: AppColors.onPrimary, + size: 16, + ) + : Text( + stepNumber.toString(), + style: AppTextStyles.bodySmall.copyWith( + color: isInactive + ? AppColors.onSurfaceVariant + : AppColors.onPrimary, + fontWeight: FontWeight.bold, + ), + ), + ), + ), + + // 连接线（除了最后一个步骤） + if (index < totalSteps - 1) + Expanded( + child: Container( + height: 2, + color: isCompleted + ? (completedColor ?? AppColors.success) + : (inactiveColor ?? AppColors.surfaceVariant), + ), + ), + ], + ), + ); + }), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/reading/widgets/reading_question_widget.dart b/client/lib/features/reading/widgets/reading_question_widget.dart new file mode 100644 index 0000000..de7fd9f --- /dev/null +++ b/client/lib/features/reading/widgets/reading_question_widget.dart @@ -0,0 +1,335 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../models/reading_question.dart'; + +/// 阅读问题组件 +class ReadingQuestionWidget extends StatelessWidget { + final ReadingQuestion question; + final String? selectedAnswer; + final bool showResult; + final Function(String) onAnswerSelected; + final VoidCallback? onNext; + final VoidCallback? onPrevious; + final bool isFirst; + final bool isLast; + + const ReadingQuestionWidget({ + super.key, + required this.question, + this.selectedAnswer, + this.showResult = false, + required this.onAnswerSelected, + this.onNext, + this.onPrevious, + this.isFirst = false, + this.isLast = false, + }); + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingLg), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 问题类型标签 + Container( + padding: const EdgeInsets.symmetric( + horizontal: AppDimensions.spacingSm, + vertical: AppDimensions.spacingXs, + ), + decoration: BoxDecoration( + color: _getQuestionTypeColor(question.type).withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + border: Border.all( + color: _getQuestionTypeColor(question.type), + width: 1, + ), + ), + child: Text( + _getQuestionTypeLabel(question.type), + style: AppTextStyles.bodySmall.copyWith( + color: _getQuestionTypeColor(question.type), + fontWeight: FontWeight.w500, + ), + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + + // 问题内容 + Text( + question.question, + style: AppTextStyles.titleMedium.copyWith( + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: AppDimensions.spacingLg), + + // 选项列表 + ...question.options.asMap().entries.map((entry) { + final index = entry.key; + final option = entry.value; + final optionKey = String.fromCharCode(65 + index.toInt()); // A, B, C, D + final isSelected = selectedAnswer == optionKey; + final isCorrect = showResult && question.correctAnswer == optionKey; + final isWrong = showResult && isSelected && !isCorrect; + + return Container( + margin: const EdgeInsets.only(bottom: AppDimensions.spacingSm), + child: InkWell( + onTap: showResult ? null : () => onAnswerSelected(optionKey), + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + child: Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: _getOptionBackgroundColor( + isSelected, + isCorrect, + isWrong, + showResult, + ), + border: Border.all( + color: _getOptionBorderColor( + isSelected, + isCorrect, + isWrong, + showResult, + ), + width: 2, + ), + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + ), + child: Row( + children: [ + // 选项标识 + Container( + width: 32, + height: 32, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: _getOptionLabelColor( + isSelected, + isCorrect, + isWrong, + showResult, + ), + ), + child: Center( + child: Text( + optionKey, + style: AppTextStyles.bodyMedium.copyWith( + color: _getOptionLabelTextColor( + isSelected, + isCorrect, + isWrong, + showResult, + ), + fontWeight: FontWeight.bold, + ), + ), + ), + ), + const SizedBox(width: AppDimensions.spacingMd), + + // 选项内容 + Expanded( + child: Text( + option, + style: AppTextStyles.bodyMedium.copyWith( + color: _getOptionTextColor( + isSelected, + isCorrect, + isWrong, + showResult, + ), + ), + ), + ), + + // 结果图标 + if (showResult && (isCorrect || isWrong)) + Icon( + isCorrect ? Icons.check_circle : Icons.cancel, + color: isCorrect ? AppColors.success : AppColors.error, + size: 24, + ), + ], + ), + ), + ), + ); + }).toList(), + + // 解析（如果显示结果且有解析） + if (showResult && question.explanation != null) ...[ + const SizedBox(height: AppDimensions.spacingLg), + Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.info.withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + border: Border.all( + color: AppColors.info.withOpacity(0.3), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.lightbulb_outline, + color: AppColors.info, + size: 20, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + '解析', + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.info, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingSm), + Text( + question.explanation!, + style: AppTextStyles.bodyMedium, + ), + ], + ), + ), + ], + + const SizedBox(height: AppDimensions.spacingXl), + + // 导航按钮 + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + // 上一题按钮 + if (!isFirst) + OutlinedButton.icon( + onPressed: onPrevious, + icon: const Icon(Icons.arrow_back), + label: const Text('上一题'), + ) + else + const SizedBox.shrink(), + + // 下一题/完成按钮 + if (!isLast) + ElevatedButton.icon( + onPressed: selectedAnswer != null ? onNext : null, + icon: const Icon(Icons.arrow_forward), + label: const Text('下一题'), + ) + else + ElevatedButton.icon( + onPressed: selectedAnswer != null ? onNext : null, + icon: const Icon(Icons.check), + label: const Text('完成'), + ), + ], + ), + ], + ), + ); + } + + String _getQuestionTypeLabel(QuestionType type) { + switch (type) { + case QuestionType.multipleChoice: + return '选择题'; + case QuestionType.trueFalse: + return '判断题'; + case QuestionType.fillInBlank: + return '填空题'; + case QuestionType.shortAnswer: + return '简答题'; + } + } + + Color _getQuestionTypeColor(QuestionType type) { + switch (type) { + case QuestionType.multipleChoice: + return AppColors.primary; + case QuestionType.trueFalse: + return AppColors.secondary; + case QuestionType.fillInBlank: + return AppColors.warning; + case QuestionType.shortAnswer: + return AppColors.info; + } + } + + Color _getOptionBackgroundColor( + bool isSelected, + bool isCorrect, + bool isWrong, + bool showResult, + ) { + if (showResult) { + if (isCorrect) return AppColors.success.withOpacity(0.1); + if (isWrong) return AppColors.error.withOpacity(0.1); + } + if (isSelected) return AppColors.primary.withOpacity(0.1); + return AppColors.surface; + } + + Color _getOptionBorderColor( + bool isSelected, + bool isCorrect, + bool isWrong, + bool showResult, + ) { + if (showResult) { + if (isCorrect) return AppColors.success; + if (isWrong) return AppColors.error; + } + if (isSelected) return AppColors.primary; + return AppColors.outline; + } + + Color _getOptionLabelColor( + bool isSelected, + bool isCorrect, + bool isWrong, + bool showResult, + ) { + if (showResult) { + if (isCorrect) return AppColors.success; + if (isWrong) return AppColors.error; + } + if (isSelected) return AppColors.primary; + return AppColors.surfaceVariant; + } + + Color _getOptionLabelTextColor( + bool isSelected, + bool isCorrect, + bool isWrong, + bool showResult, + ) { + if (showResult && (isCorrect || isWrong)) return AppColors.onPrimary; + if (isSelected) return AppColors.onPrimary; + return AppColors.onSurfaceVariant; + } + + Color _getOptionTextColor( + bool isSelected, + bool isCorrect, + bool isWrong, + bool showResult, + ) { + if (showResult) { + if (isCorrect) return AppColors.success; + if (isWrong) return AppColors.error; + } + if (isSelected) return AppColors.primary; + return AppColors.onSurface; + } +} \ No newline at end of file diff --git a/client/lib/features/reading/widgets/reading_result_dialog.dart b/client/lib/features/reading/widgets/reading_result_dialog.dart new file mode 100644 index 0000000..4080a3e --- /dev/null +++ b/client/lib/features/reading/widgets/reading_result_dialog.dart @@ -0,0 +1,419 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/theme/app_text_styles.dart'; +import '../models/reading_question.dart'; + +/// 阅读结果对话框 +class ReadingResultDialog extends StatelessWidget { + final ReadingExercise exercise; + final VoidCallback? onReview; + final VoidCallback? onRetry; + final VoidCallback? onFinish; + + const ReadingResultDialog({ + super.key, + required this.exercise, + this.onReview, + this.onRetry, + this.onFinish, + }); + + ReadingExerciseResult get result { + // 计算练习结果 + int correctCount = 0; + int totalCount = exercise.questions.length; + + for (final question in exercise.questions) { + if (question.userAnswer == question.correctAnswer) { + correctCount++; + } + } + + double score = totalCount > 0 ? (correctCount / totalCount) * 100 : 0; + + return ReadingExerciseResult( + score: score, + correctCount: correctCount, + totalCount: totalCount, + timeSpent: Duration.zero, // 可以从练习中获取 + accuracy: score, + ); + } + + @override + Widget build(BuildContext context) { + return Dialog( + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(AppDimensions.radiusLg), + ), + child: Container( + padding: const EdgeInsets.all(AppDimensions.spacingLg), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + // 结果图标和标题 + _buildHeader(), + const SizedBox(height: AppDimensions.spacingLg), + + // 分数展示 + _buildScoreDisplay(), + const SizedBox(height: AppDimensions.spacingLg), + + // 详细统计 + _buildDetailedStats(), + const SizedBox(height: AppDimensions.spacingLg), + + // 评价和建议 + _buildFeedback(), + const SizedBox(height: AppDimensions.spacingXl), + + // 操作按钮 + _buildActionButtons(context), + ], + ), + ), + ); + } + + Widget _buildHeader() { + final isExcellent = result.score >= 90; + final isGood = result.score >= 70; + final isPass = result.score >= 60; + + IconData iconData; + Color iconColor; + String title; + + if (isExcellent) { + iconData = Icons.emoji_events; + iconColor = AppColors.warning; + title = '优秀！'; + } else if (isGood) { + iconData = Icons.thumb_up; + iconColor = AppColors.success; + title = '良好！'; + } else if (isPass) { + iconData = Icons.check_circle; + iconColor = AppColors.info; + title = '及格！'; + } else { + iconData = Icons.refresh; + iconColor = AppColors.error; + title = '需要加油！'; + } + + return Column( + children: [ + Container( + width: 80, + height: 80, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: iconColor.withOpacity(0.1), + ), + child: Icon( + iconData, + size: 40, + color: iconColor, + ), + ), + const SizedBox(height: AppDimensions.spacingMd), + Text( + title, + style: AppTextStyles.headlineSmall.copyWith( + color: iconColor, + fontWeight: FontWeight.bold, + ), + ), + ], + ); + } + + Widget _buildScoreDisplay() { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingLg), + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [ + AppColors.primary.withOpacity(0.1), + AppColors.secondary.withOpacity(0.1), + ], + ), + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + border: Border.all( + color: AppColors.primary.withOpacity(0.3), + ), + ), + child: Column( + children: [ + Text( + '总分', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + const SizedBox(height: AppDimensions.spacingSm), + Row( + mainAxisAlignment: MainAxisAlignment.center, + crossAxisAlignment: CrossAxisAlignment.baseline, + textBaseline: TextBaseline.alphabetic, + children: [ + Text( + result.score.toString(), + style: AppTextStyles.displayMedium.copyWith( + color: AppColors.primary, + fontWeight: FontWeight.bold, + ), + ), + Text( + ' / 100', + style: AppTextStyles.titleLarge.copyWith( + color: AppColors.onSurfaceVariant, + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildDetailedStats() { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.surfaceVariant.withOpacity(0.3), + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + ), + child: Column( + children: [ + _buildStatRow('正确题数', '${result.correctCount}', AppColors.success), + const SizedBox(height: AppDimensions.spacingSm), + _buildStatRow('错误题数', '${result.wrongCount}', AppColors.error), + const SizedBox(height: AppDimensions.spacingSm), + _buildStatRow('总题数', '${result.totalQuestions}', AppColors.onSurface), + const SizedBox(height: AppDimensions.spacingSm), + _buildStatRow( + '正确率', + '${((result.correctCount / result.totalQuestions) * 100).toInt()}%', + AppColors.primary, + ), + const SizedBox(height: AppDimensions.spacingSm), + _buildStatRow( + '用时', + _formatDuration(result.timeSpent), + AppColors.info, + ), + ], + ), + ); + } + + Widget _buildStatRow(String label, String value, Color valueColor) { + return Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + label, + style: AppTextStyles.bodyMedium, + ), + Text( + value, + style: AppTextStyles.bodyMedium.copyWith( + color: valueColor, + fontWeight: FontWeight.w600, + ), + ), + ], + ); + } + + Widget _buildFeedback() { + String feedback = _getFeedbackMessage(); + List suggestions = _getSuggestions(); + + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingMd), + decoration: BoxDecoration( + color: AppColors.info.withOpacity(0.1), + borderRadius: BorderRadius.circular(AppDimensions.radiusMd), + border: Border.all( + color: AppColors.info.withOpacity(0.3), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.psychology, + color: AppColors.info, + size: 20, + ), + const SizedBox(width: AppDimensions.spacingSm), + Text( + '学习建议', + style: AppTextStyles.titleSmall.copyWith( + color: AppColors.info, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingSm), + Text( + feedback, + style: AppTextStyles.bodyMedium, + ), + if (suggestions.isNotEmpty) ...[ + const SizedBox(height: AppDimensions.spacingSm), + ...suggestions.map((suggestion) => Padding( + padding: const EdgeInsets.only(top: AppDimensions.spacingXs), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '• ', + style: AppTextStyles.bodyMedium.copyWith( + color: AppColors.info, + ), + ), + Expanded( + child: Text( + suggestion, + style: AppTextStyles.bodyMedium, + ), + ), + ], + ), + )), + ], + ], + ), + ); + } + + Widget _buildActionButtons(BuildContext context) { + return Row( + children: [ + // 查看解析按钮 + if (onReview != null) + Expanded( + child: OutlinedButton.icon( + onPressed: () { + onReview?.call(); + }, + icon: const Icon(Icons.visibility), + label: const Text('查看解析'), + ), + ), + + if (onReview != null && (onRetry != null || onFinish != null)) + const SizedBox(width: AppDimensions.spacingMd), + + // 重新练习按钮 + if (onRetry != null) + Expanded( + child: OutlinedButton.icon( + onPressed: () { + onRetry?.call(); + }, + icon: const Icon(Icons.refresh), + label: const Text('重新练习'), + ), + ), + + if (onRetry != null && onFinish != null) + const SizedBox(width: AppDimensions.spacingMd), + + // 完成按钮 + if (onFinish != null) + Expanded( + child: ElevatedButton.icon( + onPressed: () { + onFinish?.call(); + }, + icon: const Icon(Icons.check), + label: const Text('完成'), + ), + ), + ], + ); + } + + String _getFeedbackMessage() { + final accuracy = (result.correctCount / result.totalQuestions) * 100; + + if (accuracy >= 90) { + return '太棒了！你的阅读理解能力非常出色，继续保持这种学习状态！'; + } else if (accuracy >= 80) { + return '很好！你的阅读理解能力不错，再接再厉！'; + } else if (accuracy >= 70) { + return '不错！你的阅读理解能力还可以，继续努力提升！'; + } else if (accuracy >= 60) { + return '及格了！但还有很大的提升空间，建议多练习阅读理解。'; + } else { + return '需要加强练习！建议从基础阅读开始，逐步提升理解能力。'; + } + } + + List _getSuggestions() { + final accuracy = (result.correctCount / result.totalQuestions) * 100; + + if (accuracy >= 80) { + return [ + '可以尝试更高难度的阅读材料', + '注意总结阅读技巧和方法', + '保持每日阅读的好习惯', + ]; + } else if (accuracy >= 60) { + return [ + '多练习不同类型的阅读题目', + '注意理解文章的主旨大意', + '学会从文中寻找关键信息', + '提高词汇量和语法理解', + ]; + } else { + return [ + '从简单的阅读材料开始练习', + '重点提升基础词汇量', + '学习基本的阅读理解技巧', + '每天坚持阅读练习', + '可以寻求老师或同学的帮助', + ]; + } + } + + String _formatDuration(Duration duration) { + final minutes = duration.inMinutes; + final seconds = duration.inSeconds % 60; + + if (minutes > 0) { + return '${minutes}分${seconds}秒'; + } else { + return '${seconds}秒'; + } + } +} + +/// 显示阅读结果对话框 +Future showReadingResultDialog( + BuildContext context, + ReadingExercise exercise, { + VoidCallback? onRestart, + VoidCallback? onContinue, + VoidCallback? onClose, +}) { + return showDialog( + context: context, + barrierDismissible: false, + builder: (context) => ReadingResultDialog( + exercise: exercise, + onReview: onRestart, + onRetry: onContinue, + onFinish: onClose, + ), + ); +} \ No newline at end of file diff --git a/client/lib/features/reading/widgets/reading_search_bar.dart b/client/lib/features/reading/widgets/reading_search_bar.dart new file mode 100644 index 0000000..83877ec --- /dev/null +++ b/client/lib/features/reading/widgets/reading_search_bar.dart @@ -0,0 +1,303 @@ +import 'package:flutter/material.dart'; + +/// 阅读搜索栏组件 +class ReadingSearchBar extends StatefulWidget { + final Function(String) onSearch; + final String? initialQuery; + final String hintText; + + const ReadingSearchBar({ + super.key, + required this.onSearch, + this.initialQuery, + this.hintText = '搜索文章标题、内容或标签...', + }); + + @override + State createState() => _ReadingSearchBarState(); +} + +class _ReadingSearchBarState extends State { + late TextEditingController _controller; + final FocusNode _focusNode = FocusNode(); + + @override + void initState() { + super.initState(); + _controller = TextEditingController(text: widget.initialQuery); + + // 自动聚焦 + WidgetsBinding.instance.addPostFrameCallback((_) { + _focusNode.requestFocus(); + }); + } + + @override + void dispose() { + _controller.dispose(); + _focusNode.dispose(); + super.dispose(); + } + + void _performSearch() { + final query = _controller.text.trim(); + if (query.isNotEmpty) { + widget.onSearch(query); + } + } + + @override + Widget build(BuildContext context) { + return Dialog( + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Padding( + padding: const EdgeInsets.all(20), + child: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题 + const Text( + '搜索文章', + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: Colors.black87, + ), + ), + + const SizedBox(height: 16), + + // 搜索输入框 + TextField( + controller: _controller, + focusNode: _focusNode, + decoration: InputDecoration( + hintText: widget.hintText, + hintStyle: TextStyle(color: Colors.grey[500]), + prefixIcon: const Icon( + Icons.search, + color: Color(0xFF2196F3), + ), + suffixIcon: _controller.text.isNotEmpty + ? IconButton( + icon: const Icon(Icons.clear), + onPressed: () { + _controller.clear(); + setState(() {}); + }, + ) + : null, + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(12), + borderSide: BorderSide(color: Colors.grey[300]!), + ), + focusedBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(12), + borderSide: const BorderSide( + color: Color(0xFF2196F3), + width: 2, + ), + ), + enabledBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(12), + borderSide: BorderSide(color: Colors.grey[300]!), + ), + contentPadding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 12, + ), + ), + onChanged: (value) { + setState(() {}); + }, + onSubmitted: (_) => _performSearch(), + textInputAction: TextInputAction.search, + ), + + const SizedBox(height: 16), + + // 搜索建议 + _buildSearchSuggestions(), + + const SizedBox(height: 20), + + // 操作按钮 + Row( + mainAxisAlignment: MainAxisAlignment.end, + children: [ + TextButton( + onPressed: () => Navigator.of(context).pop(), + child: Text( + '取消', + style: TextStyle(color: Colors.grey[600]), + ), + ), + const SizedBox(width: 12), + ElevatedButton( + onPressed: _controller.text.trim().isNotEmpty + ? _performSearch + : null, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + padding: const EdgeInsets.symmetric( + horizontal: 24, + vertical: 12, + ), + ), + child: const Text('搜索'), + ), + ], + ), + ], + ), + ), + ); + } + + /// 构建搜索建议 + Widget _buildSearchSuggestions() { + final suggestions = [ + '四级阅读', + '六级阅读', + '托福阅读', + '雅思阅读', + '商务英语', + '日常对话', + '科技文章', + '新闻报道', + ]; + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '热门搜索', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: Colors.grey[700], + ), + ), + const SizedBox(height: 8), + Wrap( + spacing: 8, + runSpacing: 8, + children: suggestions.map((suggestion) { + return GestureDetector( + onTap: () { + _controller.text = suggestion; + setState(() {}); + _performSearch(); + }, + child: Container( + padding: const EdgeInsets.symmetric( + horizontal: 12, + vertical: 6, + ), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(16), + border: Border.all(color: Colors.grey[300]!), + ), + child: Text( + suggestion, + style: TextStyle( + fontSize: 12, + color: Colors.grey[700], + ), + ), + ), + ); + }).toList(), + ), + ], + ); + } +} + +/// 简化的搜索栏组件（用于嵌入页面） +class ReadingSearchField extends StatefulWidget { + final Function(String) onSearch; + final Function()? onTap; + final String? initialQuery; + final bool enabled; + + const ReadingSearchField({ + super.key, + required this.onSearch, + this.onTap, + this.initialQuery, + this.enabled = true, + }); + + @override + State createState() => _ReadingSearchFieldState(); +} + +class _ReadingSearchFieldState extends State { + late TextEditingController _controller; + + @override + void initState() { + super.initState(); + _controller = TextEditingController(text: widget.initialQuery); + } + + @override + void dispose() { + _controller.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Container( + margin: const EdgeInsets.all(16), + child: TextField( + controller: _controller, + enabled: widget.enabled, + onTap: widget.onTap, + decoration: InputDecoration( + hintText: '搜索文章...', + hintStyle: TextStyle(color: Colors.grey[500]), + prefixIcon: const Icon( + Icons.search, + color: Color(0xFF2196F3), + ), + suffixIcon: _controller.text.isNotEmpty + ? IconButton( + icon: const Icon(Icons.clear), + onPressed: () { + _controller.clear(); + widget.onSearch(''); + setState(() {}); + }, + ) + : null, + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(25), + borderSide: BorderSide.none, + ), + filled: true, + fillColor: Colors.white, + contentPadding: const EdgeInsets.symmetric( + horizontal: 20, + vertical: 12, + ), + ), + onChanged: (value) { + setState(() {}); + }, + onSubmitted: widget.onSearch, + textInputAction: TextInputAction.search, + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/reading/widgets/reading_stats_card.dart b/client/lib/features/reading/widgets/reading_stats_card.dart new file mode 100644 index 0000000..d3a5a3a --- /dev/null +++ b/client/lib/features/reading/widgets/reading_stats_card.dart @@ -0,0 +1,289 @@ +import 'package:flutter/material.dart'; +import '../models/reading_stats.dart'; + +/// 阅读统计卡片组件 +class ReadingStatsCard extends StatelessWidget { + final ReadingStats stats; + + const ReadingStatsCard({ + super.key, + required this.stats, + }); + + @override + Widget build(BuildContext context) { + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + gradient: const LinearGradient( + colors: [Color(0xFF2196F3), Color(0xFF1976D2)], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: const Color(0xFF2196F3).withOpacity(0.3), + blurRadius: 10, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题 + const Row( + children: [ + Icon( + Icons.analytics, + color: Colors.white, + size: 24, + ), + SizedBox(width: 8), + Text( + '阅读统计', + style: TextStyle( + color: Colors.white, + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + + const SizedBox(height: 16), + + // 统计数据网格 + Row( + children: [ + Expanded( + child: _buildStatItem( + icon: Icons.article, + label: '已读文章', + value: stats.totalArticlesRead.toString(), + unit: '篇', + ), + ), + Expanded( + child: _buildStatItem( + icon: Icons.quiz, + label: '练习次数', + value: stats.practicesDone.toString(), + unit: '次', + ), + ), + ], + ), + + const SizedBox(height: 12), + + Row( + children: [ + Expanded( + child: _buildStatItem( + icon: Icons.score, + label: '平均分数', + value: stats.averageScore.toStringAsFixed(1), + unit: '分', + ), + ), + Expanded( + child: _buildStatItem( + icon: Icons.speed, + label: '阅读速度', + value: stats.averageReadingSpeed.toStringAsFixed(0), + unit: '词/分', + ), + ), + ], + ), + + const SizedBox(height: 12), + + Row( + children: [ + Expanded( + child: _buildStatItem( + icon: Icons.schedule, + label: '总时长', + value: '${stats.totalReadingTime}分钟', + unit: '', + ), + ), + Expanded( + child: _buildStatItem( + icon: Icons.local_fire_department, + label: '连续天数', + value: stats.consecutiveDays.toString(), + unit: '天', + ), + ), + ], + ), + + const SizedBox(height: 16), + + // 理解准确度进度条 + _buildAccuracyProgress(), + + const SizedBox(height: 12), + + // 词汇掌握进度条 + _buildVocabularyProgress(), + ], + ), + ); + } + + /// 构建统计项目 + Widget _buildStatItem({ + required IconData icon, + required String label, + required String value, + required String unit, + }) { + return Column( + children: [ + Icon( + icon, + color: Colors.white70, + size: 20, + ), + const SizedBox(height: 4), + Text( + label, + style: const TextStyle( + color: Colors.white70, + fontSize: 12, + ), + ), + const SizedBox(height: 2), + Row( + mainAxisAlignment: MainAxisAlignment.center, + crossAxisAlignment: CrossAxisAlignment.baseline, + textBaseline: TextBaseline.alphabetic, + children: [ + Text( + value, + style: const TextStyle( + color: Colors.white, + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + if (unit.isNotEmpty) + Text( + unit, + style: const TextStyle( + color: Colors.white70, + fontSize: 12, + ), + ), + ], + ), + ], + ); + } + + /// 构建理解准确度进度条 + Widget _buildAccuracyProgress() { + final accuracy = stats.comprehensionAccuracy; + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '理解准确度', + style: TextStyle( + color: Colors.white, + fontSize: 14, + fontWeight: FontWeight.w500, + ), + ), + Text( + '${accuracy.toStringAsFixed(1)}%', + style: const TextStyle( + color: Colors.white, + fontSize: 14, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 6), + ClipRRect( + borderRadius: BorderRadius.circular(4), + child: LinearProgressIndicator( + value: accuracy / 100, + backgroundColor: Colors.white.withOpacity(0.3), + valueColor: AlwaysStoppedAnimation( + _getAccuracyColor(accuracy), + ), + minHeight: 6, + ), + ), + ], + ); + } + + /// 构建词汇掌握进度条 + Widget _buildVocabularyProgress() { + final vocabulary = stats.vocabularyMastered; + final maxVocabulary = 10000; // 假设最大词汇量为10000 + final progress = (vocabulary / maxVocabulary).clamp(0.0, 1.0); + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '词汇掌握', + style: TextStyle( + color: Colors.white, + fontSize: 14, + fontWeight: FontWeight.w500, + ), + ), + Text( + '$vocabulary 词', + style: const TextStyle( + color: Colors.white, + fontSize: 14, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 6), + ClipRRect( + borderRadius: BorderRadius.circular(4), + child: LinearProgressIndicator( + value: progress, + backgroundColor: Colors.white.withOpacity(0.3), + valueColor: const AlwaysStoppedAnimation( + Colors.greenAccent, + ), + minHeight: 6, + ), + ), + ], + ); + } + + /// 获取准确度颜色 + Color _getAccuracyColor(double accuracy) { + if (accuracy >= 90) { + return Colors.greenAccent; + } else if (accuracy >= 70) { + return Colors.yellowAccent; + } else { + return Colors.redAccent; + } + } +} \ No newline at end of file diff --git a/client/lib/features/reading/widgets/reading_toolbar.dart b/client/lib/features/reading/widgets/reading_toolbar.dart new file mode 100644 index 0000000..75b4f5f --- /dev/null +++ b/client/lib/features/reading/widgets/reading_toolbar.dart @@ -0,0 +1,340 @@ +import 'package:flutter/material.dart'; +import '../../../core/theme/app_colors.dart'; +import '../../../core/theme/app_dimensions.dart'; +import '../../../core/theme/app_text_styles.dart'; + +/// 阅读工具栏组件 +class ReadingToolbar extends StatelessWidget { + final VoidCallback? onBookmark; + final VoidCallback? onShare; + final VoidCallback? onTranslate; + final VoidCallback? onHighlight; + final VoidCallback? onNote; + final VoidCallback? onSettings; + final bool isBookmarked; + final bool showProgress; + final double? progress; + + const ReadingToolbar({ + super.key, + this.onBookmark, + this.onShare, + this.onTranslate, + this.onHighlight, + this.onNote, + this.onSettings, + this.isBookmarked = false, + this.showProgress = false, + this.progress, + }); + + @override + Widget build(BuildContext context) { + return Container( + height: 60, + decoration: BoxDecoration( + color: AppColors.surface, + boxShadow: [ + BoxShadow( + color: AppColors.shadow.withOpacity(0.1), + blurRadius: 8, + offset: const Offset(0, -2), + ), + ], + ), + child: Column( + children: [ + // 进度条 + if (showProgress && progress != null) + LinearProgressIndicator( + value: progress, + backgroundColor: AppColors.surfaceVariant, + valueColor: AlwaysStoppedAnimation(AppColors.primary), + minHeight: 2, + ), + + // 工具栏按钮 + Expanded( + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceEvenly, + children: [ + // 书签 + _ToolbarButton( + icon: isBookmarked ? Icons.bookmark : Icons.bookmark_border, + label: '书签', + onTap: onBookmark, + isActive: isBookmarked, + ), + + // 分享 + _ToolbarButton( + icon: Icons.share_outlined, + label: '分享', + onTap: onShare, + ), + + // 翻译 + _ToolbarButton( + icon: Icons.translate_outlined, + label: '翻译', + onTap: onTranslate, + ), + + // 高亮 + _ToolbarButton( + icon: Icons.highlight_outlined, + label: '高亮', + onTap: onHighlight, + ), + + // 笔记 + _ToolbarButton( + icon: Icons.note_outlined, + label: '笔记', + onTap: onNote, + ), + + // 设置 + _ToolbarButton( + icon: Icons.settings_outlined, + label: '设置', + onTap: onSettings, + ), + ], + ), + ), + ], + ), + ); + } +} + +class _ToolbarButton extends StatelessWidget { + final IconData icon; + final String label; + final VoidCallback? onTap; + final bool isActive; + + const _ToolbarButton({ + required this.icon, + required this.label, + this.onTap, + this.isActive = false, + }); + + @override + Widget build(BuildContext context) { + return InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(AppDimensions.radiusSm), + child: Container( + padding: const EdgeInsets.symmetric( + horizontal: AppDimensions.spacingXs, + vertical: AppDimensions.spacingXs, + ), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + icon, + size: 20, + color: isActive ? AppColors.primary : AppColors.onSurfaceVariant, + ), + const SizedBox(height: 2), + Text( + label, + style: AppTextStyles.labelSmall.copyWith( + color: isActive ? AppColors.primary : AppColors.onSurfaceVariant, + fontSize: 10, + ), + ), + ], + ), + ), + ); + } +} + +/// 阅读设置底部弹窗 +class ReadingSettingsBottomSheet extends StatefulWidget { + final double fontSize; + final double lineHeight; + final bool isDarkMode; + final Function(double)? onFontSizeChanged; + final Function(double)? onLineHeightChanged; + final Function(bool)? onDarkModeChanged; + + const ReadingSettingsBottomSheet({ + super.key, + required this.fontSize, + required this.lineHeight, + required this.isDarkMode, + this.onFontSizeChanged, + this.onLineHeightChanged, + this.onDarkModeChanged, + }); + + @override + State createState() => _ReadingSettingsBottomSheetState(); +} + +class _ReadingSettingsBottomSheetState extends State { + late double _fontSize; + late double _lineHeight; + late bool _isDarkMode; + + @override + void initState() { + super.initState(); + _fontSize = widget.fontSize; + _lineHeight = widget.lineHeight; + _isDarkMode = widget.isDarkMode; + } + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.all(AppDimensions.spacingLg), + decoration: BoxDecoration( + color: AppColors.surface, + borderRadius: const BorderRadius.vertical( + top: Radius.circular(AppDimensions.radiusLg), + ), + ), + child: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题 + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '阅读设置', + style: AppTextStyles.headlineSmall, + ), + IconButton( + onPressed: () => Navigator.pop(context), + icon: const Icon(Icons.close), + ), + ], + ), + const SizedBox(height: AppDimensions.spacingLg), + + // 字体大小 + Text( + '字体大小', + style: AppTextStyles.titleMedium, + ), + const SizedBox(height: AppDimensions.spacingSm), + Row( + children: [ + IconButton( + onPressed: () { + if (_fontSize > 12) { + setState(() { + _fontSize -= 1; + }); + widget.onFontSizeChanged?.call(_fontSize); + } + }, + icon: const Icon(Icons.remove), + ), + Expanded( + child: Slider( + value: _fontSize, + min: 12, + max: 24, + divisions: 12, + label: '${_fontSize.toInt()}', + onChanged: (value) { + setState(() { + _fontSize = value; + }); + widget.onFontSizeChanged?.call(value); + }, + ), + ), + IconButton( + onPressed: () { + if (_fontSize < 24) { + setState(() { + _fontSize += 1; + }); + widget.onFontSizeChanged?.call(_fontSize); + } + }, + icon: const Icon(Icons.add), + ), + ], + ), + + // 行间距 + Text( + '行间距', + style: AppTextStyles.titleMedium, + ), + const SizedBox(height: AppDimensions.spacingSm), + Row( + children: [ + IconButton( + onPressed: () { + if (_lineHeight > 1.2) { + setState(() { + _lineHeight -= 0.1; + }); + widget.onLineHeightChanged?.call(_lineHeight); + } + }, + icon: const Icon(Icons.remove), + ), + Expanded( + child: Slider( + value: _lineHeight, + min: 1.2, + max: 2.0, + divisions: 8, + label: '${(_lineHeight * 10).toInt() / 10}', + onChanged: (value) { + setState(() { + _lineHeight = value; + }); + widget.onLineHeightChanged?.call(value); + }, + ), + ), + IconButton( + onPressed: () { + if (_lineHeight < 2.0) { + setState(() { + _lineHeight += 0.1; + }); + widget.onLineHeightChanged?.call(_lineHeight); + } + }, + icon: const Icon(Icons.add), + ), + ], + ), + + // 夜间模式 + SwitchListTile( + title: Text( + '夜间模式', + style: AppTextStyles.titleMedium, + ), + value: _isDarkMode, + onChanged: (value) { + setState(() { + _isDarkMode = value; + }); + widget.onDarkModeChanged?.call(value); + }, + ), + + const SizedBox(height: AppDimensions.spacingLg), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/data/ai_tutor_data.dart b/client/lib/features/speaking/data/ai_tutor_data.dart new file mode 100644 index 0000000..e61c8fa --- /dev/null +++ b/client/lib/features/speaking/data/ai_tutor_data.dart @@ -0,0 +1,139 @@ +import '../models/ai_tutor.dart'; + +/// AI导师静态数据 +class AITutorData { + static final List _tutors = [ + AITutor( + id: 'tutor_business_001', + type: TutorType.business, + name: 'Emma Wilson', + avatar: '👩‍💼', + introduction: '我是Emma，拥有10年国际商务经验的专业导师。我将帮助你掌握商务英语，提升职场沟通能力。', + specialties: [ + '商务会议主持', + '产品演示与推介', + '商务谈判技巧', + '邮件沟通礼仪', + '客户关系维护', + '团队协作沟通', + ], + sampleQuestions: [ + 'Could you tell me about your company\'s main products?', + 'What\'s your strategy for the next quarter?', + 'How do you handle difficult clients?', + 'Can you walk me through your proposal?', + 'What are the key benefits of this solution?', + ], + personality: '专业、严谨、富有耐心，善于引导学员进行深度商务对话', + createdAt: DateTime.now().subtract(const Duration(days: 30)), + updatedAt: DateTime.now().subtract(const Duration(days: 1)), + ), + + AITutor( + id: 'tutor_daily_001', + type: TutorType.daily, + name: 'Mike Johnson', + avatar: '👨‍🦱', + introduction: '嗨！我是Mike，一个热爱生活的英语导师。让我们一起在轻松愉快的氛围中提升你的日常英语交流能力！', + specialties: [ + '日常生活对话', + '购物与消费', + '餐厅用餐', + '交通出行', + '社交聚会', + '兴趣爱好分享', + ], + sampleQuestions: [ + 'What did you do over the weekend?', + 'How was your day today?', + 'What\'s your favorite type of food?', + 'Do you have any hobbies?', + 'What\'s the weather like today?', + ], + personality: '友好、幽默、平易近人，善于创造轻松的对话氛围', + createdAt: DateTime.now().subtract(const Duration(days: 25)), + updatedAt: DateTime.now().subtract(const Duration(days: 1)), + ), + + AITutor( + id: 'tutor_travel_001', + type: TutorType.travel, + name: 'Sarah Chen', + avatar: '👩‍✈️', + introduction: '我是Sarah，环游过50多个国家的旅行达人。我会教你在世界各地都能自信交流的旅行英语！', + specialties: [ + '机场办理手续', + '酒店预订入住', + '问路与导航', + '景点游览', + '紧急情况处理', + '文化交流', + ], + sampleQuestions: [ + 'Where would you like to go for your next trip?', + 'Have you ever been to any foreign countries?', + 'What\'s your favorite travel destination?', + 'How do you usually plan your trips?', + 'What would you do if you got lost in a foreign city?', + ], + personality: '热情、冒险、见多识广，能分享丰富的旅行经验', + createdAt: DateTime.now().subtract(const Duration(days: 20)), + updatedAt: DateTime.now().subtract(const Duration(days: 1)), + ), + + AITutor( + id: 'tutor_academic_001', + type: TutorType.academic, + name: 'Dr. Robert Smith', + avatar: '👨‍🎓', + introduction: '我是Robert博士，在学术界工作了15年。我将帮助你掌握学术英语，提升演讲和论文写作能力。', + specialties: [ + '学术演讲技巧', + '论文讨论', + '研究方法论述', + '学术会议参与', + '同行评议', + '批判性思维表达', + ], + sampleQuestions: [ + 'What\'s your research focus?', + 'How would you approach this research problem?', + 'What are the limitations of this study?', + 'Can you explain your methodology?', + 'What are the implications of these findings?', + ], + personality: '博学、严谨、启发性强，善于引导深度学术思考', + createdAt: DateTime.now().subtract(const Duration(days: 15)), + updatedAt: DateTime.now().subtract(const Duration(days: 1)), + ), + ]; + + /// 获取所有AI导师 + static List getAllTutors() { + return List.unmodifiable(_tutors); + } + + /// 根据ID获取AI导师 + static AITutor? getTutorById(String id) { + try { + return _tutors.firstWhere((tutor) => tutor.id == id); + } catch (e) { + return null; + } + } + + /// 根据类型获取AI导师 + static AITutor? getTutorByType(TutorType type) { + try { + return _tutors.firstWhere((tutor) => tutor.type == type); + } catch (e) { + return null; + } + } + + /// 获取推荐的AI导师 + static List getRecommendedTutors() { + // 返回所有导师，实际应用中可以根据用户偏好推荐 + return getAllTutors(); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/data/pronunciation_data.dart b/client/lib/features/speaking/data/pronunciation_data.dart new file mode 100644 index 0000000..a736b50 --- /dev/null +++ b/client/lib/features/speaking/data/pronunciation_data.dart @@ -0,0 +1,304 @@ +import '../models/pronunciation_item.dart'; + +/// 发音练习静态数据 +class PronunciationData { + static final List _wordPronunciation = [ + PronunciationItem( + id: 'word_001', + text: 'pronunciation', + phonetic: '/prəˌnʌnsiˈeɪʃn/', + audioUrl: 'assets/audio/pronunciation.mp3', + type: PronunciationType.word, + difficulty: DifficultyLevel.intermediate, + category: '学习词汇', + tips: [ + '注意重音在第四个音节', + '末尾的-tion读作/ʃn/', + '中间的nun要清晰发音' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'word_002', + text: 'communication', + phonetic: '/kəˌmjuːnɪˈkeɪʃn/', + audioUrl: 'assets/audio/communication.mp3', + type: PronunciationType.word, + difficulty: DifficultyLevel.intermediate, + category: '商务词汇', + tips: [ + '重音在第五个音节', + '注意/mju:/的发音', + '末尾-tion读作/ʃn/' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'word_003', + text: 'restaurant', + phonetic: '/ˈrestərɑːnt/', + audioUrl: 'assets/audio/restaurant.mp3', + type: PronunciationType.word, + difficulty: DifficultyLevel.beginner, + category: '日常词汇', + tips: [ + '重音在第一个音节', + '注意/r/音的发音', + '末尾的t通常不发音' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'word_004', + text: 'schedule', + phonetic: '/ˈʃedjuːl/', + audioUrl: 'assets/audio/schedule.mp3', + type: PronunciationType.word, + difficulty: DifficultyLevel.intermediate, + category: '工作词汇', + tips: [ + '英式发音以/ʃ/开头', + '美式发音以/sk/开头', + '重音在第一个音节' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'word_005', + text: 'comfortable', + phonetic: '/ˈkʌmftəbl/', + audioUrl: 'assets/audio/comfortable.mp3', + type: PronunciationType.word, + difficulty: DifficultyLevel.advanced, + category: '形容词', + tips: [ + '注意弱读音节', + '中间的or通常省略', + '末尾的-able读作/əbl/' + ], + createdAt: DateTime.now(), + ), + ]; + + static final List _sentencePronunciation = [ + PronunciationItem( + id: 'sentence_001', + text: 'How are you doing today?', + phonetic: '/haʊ ɑːr juː ˈduːɪŋ təˈdeɪ/', + audioUrl: 'assets/audio/how_are_you.mp3', + type: PronunciationType.sentence, + difficulty: DifficultyLevel.beginner, + category: '日常问候', + tips: [ + '注意连读：How are → /haʊər/', + '语调上扬表示疑问', + 'today重音在第二个音节' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'sentence_002', + text: 'Could you please help me with this?', + phonetic: '/kʊd juː pliːz help miː wɪð ðɪs/', + audioUrl: 'assets/audio/could_you_help.mp3', + type: PronunciationType.sentence, + difficulty: DifficultyLevel.intermediate, + category: '请求帮助', + tips: [ + '礼貌的语调，温和下降', + '注意could的弱读', + 'with this连读' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'sentence_003', + text: 'I would like to make a reservation.', + phonetic: '/aɪ wʊd laɪk tuː meɪk ə ˌrezərˈveɪʃn/', + audioUrl: 'assets/audio/reservation.mp3', + type: PronunciationType.sentence, + difficulty: DifficultyLevel.intermediate, + category: '预订服务', + tips: [ + '正式语调，清晰发音', + 'would like连读', + 'reservation重音在第三个音节' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'sentence_004', + text: 'The weather is absolutely beautiful today.', + phonetic: '/ðə ˈweðər ɪz ˌæbsəˈluːtli ˈbjuːtɪfl təˈdeɪ/', + audioUrl: 'assets/audio/weather_beautiful.mp3', + type: PronunciationType.sentence, + difficulty: DifficultyLevel.advanced, + category: '天气描述', + tips: [ + '注意节奏和重音分布', + 'absolutely的重音模式', + '形容词的语调变化' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'sentence_005', + text: 'I am looking forward to hearing from you.', + phonetic: '/aɪ æm ˈlʊkɪŋ ˈfɔːrwərd tuː ˈhɪrɪŋ frəm juː/', + audioUrl: 'assets/audio/looking_forward.mp3', + type: PronunciationType.sentence, + difficulty: DifficultyLevel.advanced, + category: '商务表达', + tips: [ + '正式商务语调', + '注意短语的完整性', + 'forward to连读' + ], + createdAt: DateTime.now(), + ), + ]; + + static final List _phrasePronunciation = [ + PronunciationItem( + id: 'phrase_001', + text: 'Nice to meet you', + phonetic: '/naɪs tuː miːt juː/', + audioUrl: 'assets/audio/nice_to_meet.mp3', + type: PronunciationType.phrase, + difficulty: DifficultyLevel.beginner, + category: '问候语', + tips: [ + '连读：Nice to → /naɪstə/', + '友好的语调', + '重音在Nice和meet上' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'phrase_002', + text: 'Thank you very much', + phonetic: '/θæŋk juː ˈveri mʌtʃ/', + audioUrl: 'assets/audio/thank_you_much.mp3', + type: PronunciationType.phrase, + difficulty: DifficultyLevel.beginner, + category: '感谢语', + tips: [ + '注意th音的发音', + 'very much重音分布', + '真诚的语调' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'phrase_003', + text: 'Excuse me', + phonetic: '/ɪkˈskjuːz miː/', + audioUrl: 'assets/audio/excuse_me.mp3', + type: PronunciationType.phrase, + difficulty: DifficultyLevel.beginner, + category: '礼貌用语', + tips: [ + '重音在excuse的第二个音节', + '礼貌的上升语调', + '清晰的/z/音' + ], + createdAt: DateTime.now(), + ), + ]; + + static final List _phonemePronunciation = [ + PronunciationItem( + id: 'phoneme_001', + text: '/θ/ - think, three, thank', + phonetic: '/θ/', + audioUrl: 'assets/audio/th_sound.mp3', + type: PronunciationType.phoneme, + difficulty: DifficultyLevel.intermediate, + category: '辅音', + tips: [ + '舌尖轻触上齿', + '气流从舌齿间通过', + '不要发成/s/或/f/' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'phoneme_002', + text: '/r/ - red, right, very', + phonetic: '/r/', + audioUrl: 'assets/audio/r_sound.mp3', + type: PronunciationType.phoneme, + difficulty: DifficultyLevel.advanced, + category: '辅音', + tips: [ + '舌尖向上卷起', + '不要触碰口腔任何部位', + '声带振动' + ], + createdAt: DateTime.now(), + ), + PronunciationItem( + id: 'phoneme_003', + text: '/æ/ - cat, hat, bad', + phonetic: '/æ/', + audioUrl: 'assets/audio/ae_sound.mp3', + type: PronunciationType.phoneme, + difficulty: DifficultyLevel.intermediate, + category: '元音', + tips: [ + '嘴巴张得比/e/大', + '舌位较低', + '短元音，发音清脆' + ], + createdAt: DateTime.now(), + ), + ]; + + /// 获取所有发音练习项目 + static List getAllItems() { + return [ + ..._wordPronunciation, + ..._sentencePronunciation, + ..._phrasePronunciation, + ..._phonemePronunciation, + ]; + } + + /// 根据类型获取发音练习项目 + static List getItemsByType(PronunciationType type) { + switch (type) { + case PronunciationType.word: + return _wordPronunciation; + case PronunciationType.sentence: + return _sentencePronunciation; + case PronunciationType.phrase: + return _phrasePronunciation; + case PronunciationType.phoneme: + return _phonemePronunciation; + } + } + + /// 根据难度获取发音练习项目 + static List getItemsByDifficulty(DifficultyLevel difficulty) { + return getAllItems().where((item) => item.difficulty == difficulty).toList(); + } + + /// 根据分类获取发音练习项目 + static List getItemsByCategory(String category) { + return getAllItems().where((item) => item.category == category).toList(); + } + + /// 根据ID获取发音练习项目 + static PronunciationItem? getItemById(String id) { + try { + return getAllItems().firstWhere((item) => item.id == id); + } catch (e) { + return null; + } + } + + /// 获取所有分类 + static List getAllCategories() { + return getAllItems().map((item) => item.category).toSet().toList(); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/data/scenario_data.dart b/client/lib/features/speaking/data/scenario_data.dart new file mode 100644 index 0000000..bda57ed --- /dev/null +++ b/client/lib/features/speaking/data/scenario_data.dart @@ -0,0 +1,304 @@ +import '../models/conversation_scenario.dart'; + +/// 对话场景静态数据 +class ScenarioData { + static final List _scenarios = [ + ConversationScenario( + id: 'restaurant_ordering', + title: 'Ordering Food at Restaurant', + subtitle: '餐厅点餐对话', + description: '学习在餐厅点餐的常用英语表达，包括询问菜单、下订单、特殊要求等。', + duration: '10分钟', + level: 'B1', + type: ScenarioType.restaurant, + objectives: [ + '学会阅读英文菜单', + '掌握点餐的基本表达', + '学会提出特殊要求', + '了解餐厅服务流程', + ], + keyPhrases: [ + 'I\'d like to order...', + 'What do you recommend?', + 'Could I have the menu, please?', + 'I\'m allergic to...', + 'Could you make it less spicy?', + 'Check, please.', + ], + steps: [ + ScenarioStep( + stepNumber: 1, + title: '入座问候', + description: '服务员引导您入座并提供菜单', + role: 'npc', + content: 'Good evening! Welcome to our restaurant. How many people are in your party?', + options: [ + 'Just one, please.', + 'Table for two, please.', + 'We have a reservation under Smith.', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 2, + title: '查看菜单', + description: '服务员询问您是否需要时间看菜单', + role: 'npc', + content: 'Here\'s your table. Would you like to see the menu, or do you need a few minutes?', + options: [ + 'Could I have the menu, please?', + 'I need a few minutes to decide.', + 'What do you recommend?', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 3, + title: '点餐', + description: '服务员准备为您点餐', + role: 'npc', + content: 'Are you ready to order, or would you like to hear about our specials?', + options: [ + 'I\'d like to hear about the specials.', + 'I\'m ready to order.', + 'Could you give me a few more minutes?', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 4, + title: '下订单', + description: '告诉服务员您想要什么', + role: 'user', + content: 'What would you like to order?', + options: [ + 'I\'d like the grilled salmon, please.', + 'Could I have the pasta with marinara sauce?', + 'I\'ll have the chicken Caesar salad.', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 5, + title: '特殊要求', + description: '提出任何特殊的饮食要求', + role: 'npc', + content: 'How would you like that cooked? Any special requests?', + options: [ + 'Medium rare, please.', + 'Could you make it less spicy?', + 'I\'m allergic to nuts, please make sure there are none.', + ], + correctOption: null, + ), + ], + createdAt: DateTime.now(), + ), + ConversationScenario( + id: 'job_interview', + title: 'Job Interview Practice', + subtitle: '工作面试练习', + description: '模拟真实的英语工作面试场景，练习自我介绍、回答常见问题和提问技巧。', + duration: '15分钟', + level: 'B2', + type: ScenarioType.interview, + objectives: [ + '掌握自我介绍技巧', + '学会回答常见面试问题', + '练习询问公司信息', + '提高面试自信心', + ], + keyPhrases: [ + 'Tell me about yourself.', + 'What are your strengths?', + 'Why do you want this job?', + 'Where do you see yourself in 5 years?', + 'Do you have any questions for us?', + 'Thank you for your time.', + ], + steps: [ + ScenarioStep( + stepNumber: 1, + title: '面试开始', + description: '面试官欢迎您并开始面试', + role: 'npc', + content: 'Good morning! Please have a seat. Thank you for coming in today.', + options: [ + 'Good morning! Thank you for having me.', + 'Hello! I\'m excited to be here.', + 'Thank you for the opportunity.', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 2, + title: '自我介绍', + description: '面试官要求您进行自我介绍', + role: 'npc', + content: 'Let\'s start with you telling me a little bit about yourself.', + options: [ + 'I have 5 years of experience in marketing...', + 'I\'m a recent graduate with a degree in...', + 'I\'m currently working as a... and looking for new challenges.', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 3, + title: '优势询问', + description: '面试官询问您的优势', + role: 'npc', + content: 'What would you say are your greatest strengths?', + options: [ + 'I\'m very detail-oriented and organized.', + 'I work well under pressure and meet deadlines.', + 'I\'m a strong team player with good communication skills.', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 4, + title: '职业规划', + description: '面试官询问您的职业规划', + role: 'npc', + content: 'Where do you see yourself in five years?', + options: [ + 'I see myself in a leadership role, managing a team.', + 'I want to become an expert in my field.', + 'I hope to have grown professionally and taken on more responsibilities.', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 5, + title: '提问环节', + description: '面试官询问您是否有问题', + role: 'npc', + content: 'Do you have any questions about the company or the position?', + options: [ + 'What does a typical day look like in this role?', + 'What are the opportunities for professional development?', + 'What do you enjoy most about working here?', + ], + correctOption: null, + ), + ], + createdAt: DateTime.now(), + ), + ConversationScenario( + id: 'business_meeting', + title: 'Business Meeting Discussion', + subtitle: '商务会议讨论', + description: '参与英语商务会议，学习表达观点、提出建议和进行专业讨论。', + duration: '20分钟', + level: 'C1', + type: ScenarioType.business, + objectives: [ + '学会在会议中表达观点', + '掌握商务讨论技巧', + '练习提出建议和反对意见', + '提高商务英语水平', + ], + keyPhrases: [ + 'I\'d like to propose...', + 'From my perspective...', + 'I agree with your point, however...', + 'Could we consider...', + 'Let\'s move on to the next item.', + 'To summarize...', + ], + steps: [ + ScenarioStep( + stepNumber: 1, + title: '会议开始', + description: '会议主持人开始会议并介绍议程', + role: 'npc', + content: 'Good morning, everyone. Let\'s begin today\'s meeting. Our main agenda is to discuss the new marketing strategy.', + options: [ + 'Good morning! I\'m looking forward to the discussion.', + 'Thank you for organizing this meeting.', + 'I have some ideas I\'d like to share.', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 2, + title: '观点表达', + description: '主持人邀请您分享观点', + role: 'npc', + content: 'What are your thoughts on our current marketing approach?', + options: [ + 'I think we should focus more on digital marketing.', + 'From my perspective, we need to target younger demographics.', + 'I believe our current strategy is effective, but we could improve...', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 3, + title: '建议提出', + description: '有人提出了一个建议，您需要回应', + role: 'npc', + content: 'I propose we increase our social media budget by 30%. What do you think?', + options: [ + 'That\'s an interesting proposal. Could we see some data first?', + 'I agree, but we should also consider the ROI.', + 'I have some concerns about that approach.', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 4, + title: '讨论深入', + description: '深入讨论具体实施方案', + role: 'npc', + content: 'How do you suggest we implement this new strategy?', + options: [ + 'We could start with a pilot program.', + 'I recommend we form a dedicated team.', + 'Let\'s set clear milestones and deadlines.', + ], + correctOption: null, + ), + ScenarioStep( + stepNumber: 5, + title: '会议总结', + description: '总结会议要点和下一步行动', + role: 'npc', + content: 'Let\'s summarize what we\'ve discussed and assign action items.', + options: [ + 'I can take responsibility for the market research.', + 'Should we schedule a follow-up meeting?', + 'I\'ll prepare a detailed proposal by next week.', + ], + correctOption: null, + ), + ], + createdAt: DateTime.now(), + ), + ]; + + /// 获取所有场景 + static List getAllScenarios() { + return List.from(_scenarios); + } + + /// 根据ID获取场景 + static ConversationScenario? getScenarioById(String id) { + try { + return _scenarios.firstWhere((scenario) => scenario.id == id); + } catch (e) { + return null; + } + } + + /// 根据类型获取场景 + static List getScenariosByType(ScenarioType type) { + return _scenarios.where((scenario) => scenario.type == type).toList(); + } + + /// 根据难度级别获取场景 + static List getScenariosByLevel(String level) { + return _scenarios.where((scenario) => scenario.level == level).toList(); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/data/speaking_static_data.dart b/client/lib/features/speaking/data/speaking_static_data.dart new file mode 100644 index 0000000..2b0199a --- /dev/null +++ b/client/lib/features/speaking/data/speaking_static_data.dart @@ -0,0 +1,338 @@ +import '../models/speaking_scenario.dart'; + +/// 口语练习静态数据 +class SpeakingStaticData { + static final List _tasks = [ + // 日常对话场景 + SpeakingTask( + id: 'daily_001', + title: '自我介绍', + description: '学习如何进行基本的自我介绍', + scenario: SpeakingScenario.dailyConversation, + difficulty: SpeakingDifficulty.beginner, + objectives: [ + '能够清晰地介绍自己的姓名、年龄和职业', + '掌握基本的问候语和礼貌用语', + '学会询问他人的基本信息', + ], + keyPhrases: [ + 'My name is...', + 'I am from...', + 'I work as...', + 'Nice to meet you', + 'How about you?', + ], + backgroundInfo: '在日常生活中，自我介绍是最基本的社交技能。无论是在工作场合还是社交聚会，都需要用到这项技能。', + estimatedDuration: 10, + isRecommended: true, + createdAt: DateTime.now().subtract(const Duration(days: 30)), + updatedAt: DateTime.now().subtract(const Duration(days: 30)), + ), + + SpeakingTask( + id: 'daily_002', + title: '询问方向', + description: '学习如何询问和指示方向', + scenario: SpeakingScenario.dailyConversation, + difficulty: SpeakingDifficulty.elementary, + objectives: [ + '能够礼貌地询问方向', + '理解和给出简单的方向指示', + '掌握常用的地点和方向词汇', + ], + keyPhrases: [ + 'Excuse me, where is...?', + 'How can I get to...?', + 'Go straight', + 'Turn left/right', + 'It\'s on your left/right', + ], + estimatedDuration: 15, + createdAt: DateTime.now().subtract(const Duration(days: 25)), + updatedAt: DateTime.now().subtract(const Duration(days: 25)), + ), + + // 商务会议场景 + SpeakingTask( + id: 'business_001', + title: '会议开场', + description: '学习如何主持和参与会议开场', + scenario: SpeakingScenario.businessMeeting, + difficulty: SpeakingDifficulty.intermediate, + objectives: [ + '能够正式地开始会议', + '介绍会议议程和参与者', + '掌握商务会议的基本礼仪', + ], + keyPhrases: [ + 'Let\'s get started', + 'Today\'s agenda includes...', + 'I\'d like to introduce...', + 'The purpose of this meeting is...', + 'Any questions before we begin?', + ], + backgroundInfo: '商务会议是职场中重要的沟通方式，掌握会议开场技巧能够提升专业形象。', + estimatedDuration: 20, + isRecommended: true, + createdAt: DateTime.now().subtract(const Duration(days: 20)), + updatedAt: DateTime.now().subtract(const Duration(days: 20)), + ), + + SpeakingTask( + id: 'business_002', + title: '产品介绍', + description: '学习如何向客户介绍产品', + scenario: SpeakingScenario.businessMeeting, + difficulty: SpeakingDifficulty.upperIntermediate, + objectives: [ + '能够清晰地描述产品特点', + '强调产品的优势和价值', + '回答客户的疑问', + ], + keyPhrases: [ + 'Our product features...', + 'The main benefit is...', + 'This will help you...', + 'Compared to competitors...', + 'Would you like to know more about...?', + ], + estimatedDuration: 25, + createdAt: DateTime.now().subtract(const Duration(days: 18)), + updatedAt: DateTime.now().subtract(const Duration(days: 18)), + ), + + // 求职面试场景 + SpeakingTask( + id: 'interview_001', + title: '面试自我介绍', + description: '学习面试中的专业自我介绍', + scenario: SpeakingScenario.jobInterview, + difficulty: SpeakingDifficulty.intermediate, + objectives: [ + '能够简洁有力地介绍自己', + '突出相关工作经验和技能', + '展现对职位的兴趣和热情', + ], + keyPhrases: [ + 'I have X years of experience in...', + 'My background includes...', + 'I\'m particularly skilled at...', + 'I\'m excited about this opportunity because...', + 'I believe I would be a good fit because...', + ], + backgroundInfo: '面试自我介绍是求职过程中的关键环节，需要在短时间内给面试官留下深刻印象。', + estimatedDuration: 15, + isRecommended: true, + createdAt: DateTime.now().subtract(const Duration(days: 15)), + updatedAt: DateTime.now().subtract(const Duration(days: 15)), + ), + + // 购物场景 + SpeakingTask( + id: 'shopping_001', + title: '服装购买', + description: '学习在服装店购物的对话', + scenario: SpeakingScenario.shopping, + difficulty: SpeakingDifficulty.elementary, + objectives: [ + '能够询问商品信息', + '表达对尺寸和颜色的需求', + '进行价格谈判和付款', + ], + keyPhrases: [ + 'Do you have this in size...?', + 'Can I try this on?', + 'How much does this cost?', + 'Do you accept credit cards?', + 'I\'ll take it', + ], + estimatedDuration: 12, + createdAt: DateTime.now().subtract(const Duration(days: 12)), + updatedAt: DateTime.now().subtract(const Duration(days: 12)), + ), + + // 餐厅场景 + SpeakingTask( + id: 'restaurant_001', + title: '餐厅点餐', + description: '学习在餐厅点餐的完整流程', + scenario: SpeakingScenario.restaurant, + difficulty: SpeakingDifficulty.elementary, + objectives: [ + '能够预订餐桌', + '阅读菜单并点餐', + '处理特殊饮食要求', + ], + keyPhrases: [ + 'I\'d like to make a reservation', + 'Can I see the menu?', + 'I\'ll have the...', + 'I\'m allergic to...', + 'Could I get the check, please?', + ], + estimatedDuration: 18, + createdAt: DateTime.now().subtract(const Duration(days: 10)), + updatedAt: DateTime.now().subtract(const Duration(days: 10)), + ), + + // 旅行场景 + SpeakingTask( + id: 'travel_001', + title: '机场办理登机', + description: '学习在机场办理登机手续', + scenario: SpeakingScenario.travel, + difficulty: SpeakingDifficulty.intermediate, + objectives: [ + '能够办理登机手续', + '处理行李托运', + '询问航班信息', + ], + keyPhrases: [ + 'I\'d like to check in', + 'Here\'s my passport', + 'I have one bag to check', + 'What gate is my flight?', + 'What time is boarding?', + ], + backgroundInfo: '机场是国际旅行的重要场所，掌握相关英语对话能够让旅行更加顺利。', + estimatedDuration: 20, + createdAt: DateTime.now().subtract(const Duration(days: 8)), + updatedAt: DateTime.now().subtract(const Duration(days: 8)), + ), + + // 学术讨论场景 + SpeakingTask( + id: 'academic_001', + title: '课堂讨论', + description: '学习参与学术课堂讨论', + scenario: SpeakingScenario.academic, + difficulty: SpeakingDifficulty.advanced, + objectives: [ + '能够表达学术观点', + '进行逻辑性论证', + '礼貌地反驳不同观点', + ], + keyPhrases: [ + 'In my opinion...', + 'The evidence suggests...', + 'I disagree because...', + 'That\'s an interesting point, however...', + 'Could you elaborate on...?', + ], + estimatedDuration: 30, + createdAt: DateTime.now().subtract(const Duration(days: 5)), + updatedAt: DateTime.now().subtract(const Duration(days: 5)), + ), + + // 社交聚会场景 + SpeakingTask( + id: 'social_001', + title: '聚会闲聊', + description: '学习在社交聚会中的轻松对话', + scenario: SpeakingScenario.socializing, + difficulty: SpeakingDifficulty.intermediate, + objectives: [ + '能够进行轻松的闲聊', + '分享个人兴趣和经历', + '保持对话的自然流畅', + ], + keyPhrases: [ + 'How do you know the host?', + 'What do you do for fun?', + 'Have you been here before?', + 'That sounds interesting!', + 'I should probably get going', + ], + estimatedDuration: 15, + createdAt: DateTime.now().subtract(const Duration(days: 3)), + updatedAt: DateTime.now().subtract(const Duration(days: 3)), + ), + + // 演讲展示场景 + SpeakingTask( + id: 'presentation_001', + title: '产品演示', + description: '学习进行产品演示和展示', + scenario: SpeakingScenario.presentation, + difficulty: SpeakingDifficulty.advanced, + objectives: [ + '能够结构化地组织演示内容', + '使用视觉辅助工具', + '处理观众的问题和反馈', + ], + keyPhrases: [ + 'Today I\'ll be presenting...', + 'As you can see in this slide...', + 'Let me demonstrate...', + 'Are there any questions?', + 'Thank you for your attention', + ], + backgroundInfo: '产品演示是商务环境中的重要技能，需要结合专业知识和演讲技巧。', + estimatedDuration: 35, + isRecommended: true, + createdAt: DateTime.now().subtract(const Duration(days: 1)), + updatedAt: DateTime.now().subtract(const Duration(days: 1)), + ), + ]; + + /// 获取所有任务 + static List getAllTasks() { + return List.from(_tasks); + } + + /// 根据场景获取任务 + static List getTasksByScenario(SpeakingScenario scenario) { + return _tasks.where((task) => task.scenario == scenario).toList(); + } + + /// 根据难度获取任务 + static List getTasksByDifficulty(SpeakingDifficulty difficulty) { + return _tasks.where((task) => task.difficulty == difficulty).toList(); + } + + /// 获取推荐任务 + static List getRecommendedTasks() { + return _tasks.where((task) => task.isRecommended).toList(); + } + + /// 获取最近任务 + static List getRecentTasks() { + final sortedTasks = List.from(_tasks); + sortedTasks.sort((a, b) => b.updatedAt.compareTo(a.updatedAt)); + return sortedTasks.take(5).toList(); + } + + /// 获取热门任务（按完成次数排序） + static List getPopularTasks() { + final sortedTasks = List.from(_tasks); + sortedTasks.sort((a, b) => b.completionCount.compareTo(a.completionCount)); + return sortedTasks.take(5).toList(); + } + + /// 根据ID获取任务 + static SpeakingTask? getTaskById(String id) { + try { + return _tasks.firstWhere((task) => task.id == id); + } catch (e) { + return null; + } + } + + /// 获取场景统计 + static Map getScenarioStats() { + final stats = {}; + for (final scenario in SpeakingScenario.values) { + stats[scenario] = _tasks.where((task) => task.scenario == scenario).length; + } + return stats; + } + + /// 获取难度统计 + static Map getDifficultyStats() { + final stats = {}; + for (final difficulty in SpeakingDifficulty.values) { + stats[difficulty] = _tasks.where((task) => task.difficulty == difficulty).length; + } + return stats; + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/models/ai_tutor.dart b/client/lib/features/speaking/models/ai_tutor.dart new file mode 100644 index 0000000..99ff353 --- /dev/null +++ b/client/lib/features/speaking/models/ai_tutor.dart @@ -0,0 +1,150 @@ +import 'package:flutter/material.dart'; + +/// AI导师类型枚举 +enum TutorType { + business, + daily, + travel, + academic, +} + +/// AI导师扩展方法 +extension TutorTypeExtension on TutorType { + String get displayName { + switch (this) { + case TutorType.business: + return '商务导师'; + case TutorType.daily: + return '日常导师'; + case TutorType.travel: + return '旅行导师'; + case TutorType.academic: + return '学术导师'; + } + } + + String get description { + switch (this) { + case TutorType.business: + return '专业商务场景'; + case TutorType.daily: + return '生活场景对话'; + case TutorType.travel: + return '旅游场景专训'; + case TutorType.academic: + return '学术讨论演讲'; + } + } + + IconData get icon { + switch (this) { + case TutorType.business: + return Icons.business_center; + case TutorType.daily: + return Icons.chat; + case TutorType.travel: + return Icons.flight; + case TutorType.academic: + return Icons.school; + } + } + + Color get color { + switch (this) { + case TutorType.business: + return Colors.blue; + case TutorType.daily: + return Colors.green; + case TutorType.travel: + return Colors.orange; + case TutorType.academic: + return Colors.purple; + } + } +} + +/// AI导师模型 +class AITutor { + final String id; + final TutorType type; + final String name; + final String avatar; + final String introduction; + final List specialties; + final List sampleQuestions; + final String personality; + final DateTime createdAt; + final DateTime updatedAt; + + const AITutor({ + required this.id, + required this.type, + required this.name, + required this.avatar, + required this.introduction, + required this.specialties, + required this.sampleQuestions, + required this.personality, + required this.createdAt, + required this.updatedAt, + }); + + factory AITutor.fromJson(Map json) { + return AITutor( + id: json['id'] as String, + type: TutorType.values.firstWhere( + (e) => e.name == json['type'], + orElse: () => TutorType.daily, + ), + name: json['name'] as String, + avatar: json['avatar'] as String, + introduction: json['introduction'] as String, + specialties: List.from(json['specialties'] as List), + sampleQuestions: List.from(json['sampleQuestions'] as List), + personality: json['personality'] as String, + createdAt: DateTime.parse(json['createdAt'] as String), + updatedAt: DateTime.parse(json['updatedAt'] as String), + ); + } + + Map toJson() { + return { + 'id': id, + 'type': type.name, + 'name': name, + 'avatar': avatar, + 'introduction': introduction, + 'specialties': specialties, + 'sampleQuestions': sampleQuestions, + 'personality': personality, + 'createdAt': createdAt.toIso8601String(), + 'updatedAt': updatedAt.toIso8601String(), + }; + } + + AITutor copyWith({ + String? id, + TutorType? type, + String? name, + String? avatar, + String? introduction, + List? specialties, + List? sampleQuestions, + String? personality, + DateTime? createdAt, + DateTime? updatedAt, + }) { + return AITutor( + id: id ?? this.id, + type: type ?? this.type, + name: name ?? this.name, + avatar: avatar ?? this.avatar, + introduction: introduction ?? this.introduction, + specialties: specialties ?? this.specialties, + sampleQuestions: sampleQuestions ?? this.sampleQuestions, + personality: personality ?? this.personality, + createdAt: createdAt ?? this.createdAt, + updatedAt: updatedAt ?? this.updatedAt, + ); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/models/conversation.dart b/client/lib/features/speaking/models/conversation.dart new file mode 100644 index 0000000..bbf9af4 --- /dev/null +++ b/client/lib/features/speaking/models/conversation.dart @@ -0,0 +1,155 @@ +enum MessageType { + user, + ai, + system; +} + +enum ConversationStatus { + active, + paused, + completed, + cancelled; + + String get displayName { + switch (this) { + case ConversationStatus.active: + return '进行中'; + case ConversationStatus.paused: + return '已暂停'; + case ConversationStatus.completed: + return '已完成'; + case ConversationStatus.cancelled: + return '已取消'; + } + } +} + +class ConversationMessage { + final String id; + final String content; + final MessageType type; + final DateTime timestamp; + final String? audioUrl; + final double? confidence; // 语音识别置信度 + final Map? metadata; + + const ConversationMessage({ + required this.id, + required this.content, + required this.type, + required this.timestamp, + this.audioUrl, + this.confidence, + this.metadata, + }); + + factory ConversationMessage.fromJson(Map json) { + return ConversationMessage( + id: json['id'] as String, + content: json['content'] as String, + type: MessageType.values.firstWhere( + (e) => e.name == json['type'], + orElse: () => MessageType.user, + ), + timestamp: DateTime.parse(json['timestamp'] as String), + audioUrl: json['audioUrl'] as String?, + confidence: json['confidence'] as double?, + metadata: json['metadata'] as Map?, + ); + } + + Map toJson() { + return { + 'id': id, + 'content': content, + 'type': type.name, + 'timestamp': timestamp.toIso8601String(), + 'audioUrl': audioUrl, + 'confidence': confidence, + 'metadata': metadata, + }; + } +} + +class Conversation { + final String id; + final String taskId; + final String userId; + final List messages; + final ConversationStatus status; + final DateTime startTime; + final DateTime? endTime; + final int totalDuration; // 总时长（秒） + final Map? settings; + + const Conversation({ + required this.id, + required this.taskId, + required this.userId, + required this.messages, + required this.status, + required this.startTime, + this.endTime, + required this.totalDuration, + this.settings, + }); + + factory Conversation.fromJson(Map json) { + return Conversation( + id: json['id'] as String, + taskId: json['taskId'] as String, + userId: json['userId'] as String, + messages: (json['messages'] as List) + .map((e) => ConversationMessage.fromJson(e as Map)) + .toList(), + status: ConversationStatus.values.firstWhere( + (e) => e.name == json['status'], + orElse: () => ConversationStatus.active, + ), + startTime: DateTime.parse(json['startTime'] as String), + endTime: json['endTime'] != null + ? DateTime.parse(json['endTime'] as String) + : null, + totalDuration: json['totalDuration'] as int, + settings: json['settings'] as Map?, + ); + } + + Map toJson() { + return { + 'id': id, + 'taskId': taskId, + 'userId': userId, + 'messages': messages.map((e) => e.toJson()).toList(), + 'status': status.name, + 'startTime': startTime.toIso8601String(), + 'endTime': endTime?.toIso8601String(), + 'totalDuration': totalDuration, + 'settings': settings, + }; + } + + Conversation copyWith({ + String? id, + String? taskId, + String? userId, + List? messages, + ConversationStatus? status, + DateTime? startTime, + DateTime? endTime, + int? totalDuration, + Map? settings, + }) { + return Conversation( + id: id ?? this.id, + taskId: taskId ?? this.taskId, + userId: userId ?? this.userId, + messages: messages ?? this.messages, + status: status ?? this.status, + startTime: startTime ?? this.startTime, + endTime: endTime ?? this.endTime, + totalDuration: totalDuration ?? this.totalDuration, + settings: settings ?? this.settings, + ); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/models/conversation_scenario.dart b/client/lib/features/speaking/models/conversation_scenario.dart new file mode 100644 index 0000000..c083e7d --- /dev/null +++ b/client/lib/features/speaking/models/conversation_scenario.dart @@ -0,0 +1,193 @@ +/// 对话场景数据模型 +class ConversationScenario { + final String id; + final String title; + final String subtitle; + final String description; + final String duration; + final String level; + final ScenarioType type; + final List objectives; + final List keyPhrases; + final List steps; + final DateTime createdAt; + + ConversationScenario({ + required this.id, + required this.title, + required this.subtitle, + required this.description, + required this.duration, + required this.level, + required this.type, + required this.objectives, + required this.keyPhrases, + required this.steps, + required this.createdAt, + }); + + factory ConversationScenario.fromJson(Map json) { + return ConversationScenario( + id: json['id'], + title: json['title'], + subtitle: json['subtitle'], + description: json['description'], + duration: json['duration'], + level: json['level'], + type: ScenarioType.values.firstWhere( + (e) => e.toString().split('.').last == json['type'], + ), + objectives: List.from(json['objectives']), + keyPhrases: List.from(json['keyPhrases']), + steps: (json['steps'] as List) + .map((step) => ScenarioStep.fromJson(step)) + .toList(), + createdAt: DateTime.parse(json['createdAt']), + ); + } + + Map toJson() { + return { + 'id': id, + 'title': title, + 'subtitle': subtitle, + 'description': description, + 'duration': duration, + 'level': level, + 'type': type.toString().split('.').last, + 'objectives': objectives, + 'keyPhrases': keyPhrases, + 'steps': steps.map((step) => step.toJson()).toList(), + 'createdAt': createdAt.toIso8601String(), + }; + } + + ConversationScenario copyWith({ + String? id, + String? title, + String? subtitle, + String? description, + String? duration, + String? level, + ScenarioType? type, + List? objectives, + List? keyPhrases, + List? steps, + DateTime? createdAt, + }) { + return ConversationScenario( + id: id ?? this.id, + title: title ?? this.title, + subtitle: subtitle ?? this.subtitle, + description: description ?? this.description, + duration: duration ?? this.duration, + level: level ?? this.level, + type: type ?? this.type, + objectives: objectives ?? this.objectives, + keyPhrases: keyPhrases ?? this.keyPhrases, + steps: steps ?? this.steps, + createdAt: createdAt ?? this.createdAt, + ); + } +} + +/// 场景类型枚举 +enum ScenarioType { + restaurant, + interview, + business, + travel, + shopping, + medical, + education, + social, +} + +extension ScenarioTypeExtension on ScenarioType { + String get displayName { + switch (this) { + case ScenarioType.restaurant: + return '餐厅用餐'; + case ScenarioType.interview: + return '工作面试'; + case ScenarioType.business: + return '商务会议'; + case ScenarioType.travel: + return '旅行出行'; + case ScenarioType.shopping: + return '购物消费'; + case ScenarioType.medical: + return '医疗健康'; + case ScenarioType.education: + return '教育学习'; + case ScenarioType.social: + return '社交聚会'; + } + } + + String get icon { + switch (this) { + case ScenarioType.restaurant: + return '🍽️'; + case ScenarioType.interview: + return '💼'; + case ScenarioType.business: + return '🏢'; + case ScenarioType.travel: + return '✈️'; + case ScenarioType.shopping: + return '🛍️'; + case ScenarioType.medical: + return '🏥'; + case ScenarioType.education: + return '📚'; + case ScenarioType.social: + return '🎉'; + } + } +} + +/// 场景步骤 +class ScenarioStep { + final int stepNumber; + final String title; + final String description; + final String role; // 'user' or 'npc' + final String content; + final List options; + final String? correctOption; + + ScenarioStep({ + required this.stepNumber, + required this.title, + required this.description, + required this.role, + required this.content, + required this.options, + this.correctOption, + }); + + factory ScenarioStep.fromJson(Map json) { + return ScenarioStep( + stepNumber: json['stepNumber'], + title: json['title'], + description: json['description'], + role: json['role'], + content: json['content'], + options: List.from(json['options']), + correctOption: json['correctOption'], + ); + } + + Map toJson() { + return { + 'stepNumber': stepNumber, + 'title': title, + 'description': description, + 'role': role, + 'content': content, + 'options': options, + 'correctOption': correctOption, + }; + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/models/pronunciation_assessment.dart b/client/lib/features/speaking/models/pronunciation_assessment.dart new file mode 100644 index 0000000..47c6842 --- /dev/null +++ b/client/lib/features/speaking/models/pronunciation_assessment.dart @@ -0,0 +1,176 @@ +enum PronunciationCriteria { + accuracy, + fluency, + completeness, + prosody; + + String get displayName { + switch (this) { + case PronunciationCriteria.accuracy: + return '准确性'; + case PronunciationCriteria.fluency: + return '流利度'; + case PronunciationCriteria.completeness: + return '完整性'; + case PronunciationCriteria.prosody: + return '韵律'; + } + } + + String get description { + switch (this) { + case PronunciationCriteria.accuracy: + return '发音的准确程度'; + case PronunciationCriteria.fluency: + return '语音的流畅程度'; + case PronunciationCriteria.completeness: + return '内容的完整程度'; + case PronunciationCriteria.prosody: + return '语调和节奏的自然程度'; + } + } +} + +class WordPronunciation { + final String word; + final double accuracyScore; // 0-100 + final String? errorType; + final List phonemes; + final List phonemeScores; + final int startTime; // 毫秒 + final int endTime; // 毫秒 + + const WordPronunciation({ + required this.word, + required this.accuracyScore, + this.errorType, + required this.phonemes, + required this.phonemeScores, + required this.startTime, + required this.endTime, + }); + + factory WordPronunciation.fromJson(Map json) { + return WordPronunciation( + word: json['word'] as String, + accuracyScore: (json['accuracyScore'] as num).toDouble(), + errorType: json['errorType'] as String?, + phonemes: List.from(json['phonemes'] ?? []), + phonemeScores: List.from( + (json['phonemeScores'] as List? ?? []) + .map((e) => (e as num).toDouble()), + ), + startTime: json['startTime'] as int, + endTime: json['endTime'] as int, + ); + } + + Map toJson() { + return { + 'word': word, + 'accuracyScore': accuracyScore, + 'errorType': errorType, + 'phonemes': phonemes, + 'phonemeScores': phonemeScores, + 'startTime': startTime, + 'endTime': endTime, + }; + } +} + +class PronunciationAssessment { + final String id; + final String conversationId; + final String messageId; + final String originalText; + final String recognizedText; + final Map scores; // 0-100 + final double overallScore; // 0-100 + final List wordDetails; + final List suggestions; + final DateTime assessedAt; + final Map? metadata; + + const PronunciationAssessment({ + required this.id, + required this.conversationId, + required this.messageId, + required this.originalText, + required this.recognizedText, + required this.scores, + required this.overallScore, + required this.wordDetails, + required this.suggestions, + required this.assessedAt, + this.metadata, + }); + + factory PronunciationAssessment.fromJson(Map json) { + final scoresMap = {}; + final scoresJson = json['scores'] as Map? ?? {}; + for (final criteria in PronunciationCriteria.values) { + scoresMap[criteria] = (scoresJson[criteria.name] as num?)?.toDouble() ?? 0.0; + } + + return PronunciationAssessment( + id: json['id'] as String, + conversationId: json['conversationId'] as String, + messageId: json['messageId'] as String, + originalText: json['originalText'] as String, + recognizedText: json['recognizedText'] as String, + scores: scoresMap, + overallScore: (json['overallScore'] as num).toDouble(), + wordDetails: (json['wordDetails'] as List? ?? []) + .map((e) => WordPronunciation.fromJson(e as Map)) + .toList(), + suggestions: List.from(json['suggestions'] ?? []), + assessedAt: DateTime.parse(json['assessedAt'] as String), + metadata: json['metadata'] as Map?, + ); + } + + Map toJson() { + final scoresJson = {}; + for (final entry in scores.entries) { + scoresJson[entry.key.name] = entry.value; + } + + return { + 'id': id, + 'conversationId': conversationId, + 'messageId': messageId, + 'originalText': originalText, + 'recognizedText': recognizedText, + 'scores': scoresJson, + 'overallScore': overallScore, + 'wordDetails': wordDetails.map((e) => e.toJson()).toList(), + 'suggestions': suggestions, + 'assessedAt': assessedAt.toIso8601String(), + 'metadata': metadata, + }; + } + + String get accuracyLevel { + if (overallScore >= 90) return '优秀'; + if (overallScore >= 80) return '良好'; + if (overallScore >= 70) return '中等'; + if (overallScore >= 60) return '及格'; + return '需要改进'; + } + + List get mainIssues { + final issues = []; + + if (scores[PronunciationCriteria.accuracy]! < 70) { + issues.add('发音准确性需要提高'); + } + if (scores[PronunciationCriteria.fluency]! < 70) { + issues.add('语音流利度有待改善'); + } + if (scores[PronunciationCriteria.prosody]! < 70) { + issues.add('语调和节奏需要调整'); + } + + return issues; + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/models/pronunciation_item.dart b/client/lib/features/speaking/models/pronunciation_item.dart new file mode 100644 index 0000000..2158350 --- /dev/null +++ b/client/lib/features/speaking/models/pronunciation_item.dart @@ -0,0 +1,201 @@ +/// 发音练习项目数据模型 +class PronunciationItem { + final String id; + final String text; + final String phonetic; + final String audioUrl; + final PronunciationType type; + final DifficultyLevel difficulty; + final String category; + final List tips; + final DateTime createdAt; + + PronunciationItem({ + required this.id, + required this.text, + required this.phonetic, + required this.audioUrl, + required this.type, + required this.difficulty, + required this.category, + required this.tips, + required this.createdAt, + }); + + factory PronunciationItem.fromJson(Map json) { + return PronunciationItem( + id: json['id'], + text: json['text'], + phonetic: json['phonetic'], + audioUrl: json['audioUrl'], + type: PronunciationType.values.firstWhere( + (e) => e.toString().split('.').last == json['type'], + ), + difficulty: DifficultyLevel.values.firstWhere( + (e) => e.toString().split('.').last == json['difficulty'], + ), + category: json['category'], + tips: List.from(json['tips']), + createdAt: DateTime.parse(json['createdAt']), + ); + } + + Map toJson() { + return { + 'id': id, + 'text': text, + 'phonetic': phonetic, + 'audioUrl': audioUrl, + 'type': type.toString().split('.').last, + 'difficulty': difficulty.toString().split('.').last, + 'category': category, + 'tips': tips, + 'createdAt': createdAt.toIso8601String(), + }; + } + + PronunciationItem copyWith({ + String? id, + String? text, + String? phonetic, + String? audioUrl, + PronunciationType? type, + DifficultyLevel? difficulty, + String? category, + List? tips, + DateTime? createdAt, + }) { + return PronunciationItem( + id: id ?? this.id, + text: text ?? this.text, + phonetic: phonetic ?? this.phonetic, + audioUrl: audioUrl ?? this.audioUrl, + type: type ?? this.type, + difficulty: difficulty ?? this.difficulty, + category: category ?? this.category, + tips: tips ?? this.tips, + createdAt: createdAt ?? this.createdAt, + ); + } +} + +/// 发音练习类型 +enum PronunciationType { + word, + sentence, + phrase, + phoneme, +} + +extension PronunciationTypeExtension on PronunciationType { + String get displayName { + switch (this) { + case PronunciationType.word: + return '单词发音'; + case PronunciationType.sentence: + return '句子朗读'; + case PronunciationType.phrase: + return '短语练习'; + case PronunciationType.phoneme: + return '音素练习'; + } + } + + String get description { + switch (this) { + case PronunciationType.word: + return '练习单个单词的准确发音'; + case PronunciationType.sentence: + return '练习完整句子的语调和节奏'; + case PronunciationType.phrase: + return '练习常用短语的连读'; + case PronunciationType.phoneme: + return '练习基础音素的发音'; + } + } + + String get icon { + switch (this) { + case PronunciationType.word: + return '🔤'; + case PronunciationType.sentence: + return '📝'; + case PronunciationType.phrase: + return '💬'; + case PronunciationType.phoneme: + return '🔊'; + } + } +} + +/// 难度级别 +enum DifficultyLevel { + beginner, + intermediate, + advanced, +} + +extension DifficultyLevelExtension on DifficultyLevel { + String get displayName { + switch (this) { + case DifficultyLevel.beginner: + return '初级'; + case DifficultyLevel.intermediate: + return '中级'; + case DifficultyLevel.advanced: + return '高级'; + } + } + + String get code { + switch (this) { + case DifficultyLevel.beginner: + return 'A1-A2'; + case DifficultyLevel.intermediate: + return 'B1-B2'; + case DifficultyLevel.advanced: + return 'C1-C2'; + } + } +} + +/// 发音练习记录 +class PronunciationRecord { + final String id; + final String itemId; + final double score; + final String feedback; + final DateTime practiceDate; + final int attempts; + + PronunciationRecord({ + required this.id, + required this.itemId, + required this.score, + required this.feedback, + required this.practiceDate, + required this.attempts, + }); + + factory PronunciationRecord.fromJson(Map json) { + return PronunciationRecord( + id: json['id'], + itemId: json['itemId'], + score: json['score'].toDouble(), + feedback: json['feedback'], + practiceDate: DateTime.parse(json['practiceDate']), + attempts: json['attempts'], + ); + } + + Map toJson() { + return { + 'id': id, + 'itemId': itemId, + 'score': score, + 'feedback': feedback, + 'practiceDate': practiceDate.toIso8601String(), + 'attempts': attempts, + }; + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/models/speaking_scenario.dart b/client/lib/features/speaking/models/speaking_scenario.dart new file mode 100644 index 0000000..9a9eee6 --- /dev/null +++ b/client/lib/features/speaking/models/speaking_scenario.dart @@ -0,0 +1,163 @@ +enum SpeakingScenario { + dailyConversation, + businessMeeting, + jobInterview, + shopping, + restaurant, + travel, + academic, + socializing, + phoneCall, + presentation; + + String get displayName { + switch (this) { + case SpeakingScenario.dailyConversation: + return '日常对话'; + case SpeakingScenario.businessMeeting: + return '商务会议'; + case SpeakingScenario.jobInterview: + return '求职面试'; + case SpeakingScenario.shopping: + return '购物'; + case SpeakingScenario.restaurant: + return '餐厅'; + case SpeakingScenario.travel: + return '旅行'; + case SpeakingScenario.academic: + return '学术讨论'; + case SpeakingScenario.socializing: + return '社交聚会'; + case SpeakingScenario.phoneCall: + return '电话通话'; + case SpeakingScenario.presentation: + return '演讲展示'; + } + } + + String get description { + switch (this) { + case SpeakingScenario.dailyConversation: + return '练习日常生活中的基本对话'; + case SpeakingScenario.businessMeeting: + return '提升商务环境下的沟通能力'; + case SpeakingScenario.jobInterview: + return '准备求职面试的常见问题'; + case SpeakingScenario.shopping: + return '学习购物时的实用表达'; + case SpeakingScenario.restaurant: + return '掌握餐厅点餐的对话技巧'; + case SpeakingScenario.travel: + return '旅行中的必备口语交流'; + case SpeakingScenario.academic: + return '学术环境下的专业讨论'; + case SpeakingScenario.socializing: + return '社交场合的自然交流'; + case SpeakingScenario.phoneCall: + return '电话沟通的特殊技巧'; + case SpeakingScenario.presentation: + return '公开演讲和展示技能'; + } + } +} + +enum SpeakingDifficulty { + beginner, + elementary, + intermediate, + upperIntermediate, + advanced; + + String get displayName { + switch (this) { + case SpeakingDifficulty.beginner: + return '初学者'; + case SpeakingDifficulty.elementary: + return '基础'; + case SpeakingDifficulty.intermediate: + return '中级'; + case SpeakingDifficulty.upperIntermediate: + return '中高级'; + case SpeakingDifficulty.advanced: + return '高级'; + } + } +} + +class SpeakingTask { + final String id; + final String title; + final String description; + final SpeakingScenario scenario; + final SpeakingDifficulty difficulty; + final List objectives; + final List keyPhrases; + final String? backgroundInfo; + final int estimatedDuration; // 预估时长（分钟） + final bool isRecommended; // 是否推荐 + final bool isFavorite; // 是否收藏 + final int completionCount; // 完成次数 + final DateTime createdAt; + final DateTime updatedAt; + + const SpeakingTask({ + required this.id, + required this.title, + required this.description, + required this.scenario, + required this.difficulty, + required this.objectives, + required this.keyPhrases, + this.backgroundInfo, + required this.estimatedDuration, + this.isRecommended = false, + this.isFavorite = false, + this.completionCount = 0, + required this.createdAt, + required this.updatedAt, + }); + + factory SpeakingTask.fromJson(Map json) { + return SpeakingTask( + id: json['id'] as String, + title: json['title'] as String, + description: json['description'] as String, + scenario: SpeakingScenario.values.firstWhere( + (e) => e.name == json['scenario'], + orElse: () => SpeakingScenario.dailyConversation, + ), + difficulty: SpeakingDifficulty.values.firstWhere( + (e) => e.name == json['difficulty'], + orElse: () => SpeakingDifficulty.intermediate, + ), + objectives: List.from(json['objectives'] ?? []), + keyPhrases: List.from(json['keyPhrases'] ?? []), + backgroundInfo: json['backgroundInfo'] as String?, + estimatedDuration: json['estimatedDuration'] as int, + isRecommended: json['isRecommended'] as bool? ?? false, + isFavorite: json['isFavorite'] as bool? ?? false, + completionCount: json['completionCount'] as int? ?? 0, + createdAt: DateTime.parse(json['createdAt'] as String), + updatedAt: DateTime.parse(json['updatedAt'] as String), + ); + } + + Map toJson() { + return { + 'id': id, + 'title': title, + 'description': description, + 'scenario': scenario.name, + 'difficulty': difficulty.name, + 'objectives': objectives, + 'keyPhrases': keyPhrases, + 'backgroundInfo': backgroundInfo, + 'estimatedDuration': estimatedDuration, + 'isRecommended': isRecommended, + 'isFavorite': isFavorite, + 'completionCount': completionCount, + 'createdAt': createdAt.toIso8601String(), + 'updatedAt': updatedAt.toIso8601String(), + }; + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/models/speaking_stats.dart b/client/lib/features/speaking/models/speaking_stats.dart new file mode 100644 index 0000000..fc33f18 --- /dev/null +++ b/client/lib/features/speaking/models/speaking_stats.dart @@ -0,0 +1,244 @@ +import 'speaking_scenario.dart'; +import 'pronunciation_assessment.dart'; + +class SpeakingStats { + final int totalSessions; + final int totalMinutes; + final double averageScore; + final Map scenarioStats; + final Map difficultyStats; + final List progressData; + final SpeakingSkillAnalysis skillAnalysis; + final DateTime lastUpdated; + + const SpeakingStats({ + required this.totalSessions, + required this.totalMinutes, + required this.averageScore, + required this.scenarioStats, + required this.difficultyStats, + required this.progressData, + required this.skillAnalysis, + required this.lastUpdated, + }); + + factory SpeakingStats.fromJson(Map json) { + final scenarioStatsJson = json['scenarioStats'] as Map? ?? {}; + final scenarioStats = {}; + for (final scenario in SpeakingScenario.values) { + final v = scenarioStatsJson[scenario.name]; + scenarioStats[scenario] = (v is num) ? v.toInt() : 0; + } + + final difficultyStatsLegacy = json['difficultyStats'] as Map?; + final levelStatsBackend = json['stats_by_level'] as Map?; + final difficultyStats = {}; + if (difficultyStatsLegacy != null) { + for (final difficulty in SpeakingDifficulty.values) { + final v = difficultyStatsLegacy[difficulty.name]; + difficultyStats[difficulty] = (v is num) ? v.toInt() : 0; + } + } else { + for (final difficulty in SpeakingDifficulty.values) { + final key = { + SpeakingDifficulty.beginner: 'beginner', + SpeakingDifficulty.elementary: 'elementary', + SpeakingDifficulty.intermediate: 'intermediate', + SpeakingDifficulty.upperIntermediate: 'upper_intermediate', + SpeakingDifficulty.advanced: 'advanced', + }[difficulty]!; + final entry = levelStatsBackend?[key]; + int count = 0; + if (entry is Map) { + final c = entry['count']; + if (c is num) count = c.toInt(); + } + difficultyStats[difficulty] = count; + } + } + + final avgScores = json['average_scores'] as Map? ?? {}; + final averageScore = (json['averageScore'] as num?)?.toDouble() ?? (avgScores['overall'] as num?)?.toDouble() ?? 0.0; + + final skillAnalysisJson = json['skillAnalysis'] as Map?; + final skillAnalysis = skillAnalysisJson != null + ? SpeakingSkillAnalysis.fromJson(skillAnalysisJson) + : SpeakingSkillAnalysis( + criteriaScores: { + PronunciationCriteria.accuracy: (avgScores['accuracy'] as num?)?.toDouble() ?? 0.0, + PronunciationCriteria.fluency: (avgScores['fluency'] as num?)?.toDouble() ?? 0.0, + PronunciationCriteria.completeness: (avgScores['completeness'] as num?)?.toDouble() ?? 0.0, + PronunciationCriteria.prosody: (avgScores['prosody'] as num?)?.toDouble() ?? 0.0, + }, + commonErrors: {}, + strengths: const [], + weaknesses: const [], + recommendations: const [], + improvementRate: 0.0, + lastAnalyzed: DateTime.now(), + ); + + return SpeakingStats( + totalSessions: (json['totalSessions'] as int?) ?? (json['total_records'] as num?)?.toInt() ?? 0, + totalMinutes: (json['totalMinutes'] as int?) ?? (json['total_duration'] as num?)?.toInt() ?? 0, + averageScore: averageScore, + scenarioStats: scenarioStats, + difficultyStats: difficultyStats, + progressData: (json['progressData'] as List? ?? []) + .map((e) => SpeakingProgressData.fromJson(e as Map)) + .toList(), + skillAnalysis: skillAnalysis, + lastUpdated: (json['lastUpdated'] is String) + ? DateTime.parse(json['lastUpdated'] as String) + : DateTime.now(), + ); + } + + Map toJson() { + final scenarioStatsJson = {}; + for (final entry in scenarioStats.entries) { + scenarioStatsJson[entry.key.name] = entry.value; + } + + final difficultyStatsJson = {}; + for (final entry in difficultyStats.entries) { + difficultyStatsJson[entry.key.name] = entry.value; + } + + return { + 'totalSessions': totalSessions, + 'totalMinutes': totalMinutes, + 'averageScore': averageScore, + 'scenarioStats': scenarioStatsJson, + 'difficultyStats': difficultyStatsJson, + 'progressData': progressData.map((e) => e.toJson()).toList(), + 'skillAnalysis': skillAnalysis.toJson(), + 'lastUpdated': lastUpdated.toIso8601String(), + }; + } +} + +class SpeakingProgressData { + final DateTime date; + final double averageScore; + final int sessionCount; + final int totalMinutes; + final Map criteriaScores; + + const SpeakingProgressData({ + required this.date, + required this.averageScore, + required this.sessionCount, + required this.totalMinutes, + required this.criteriaScores, + }); + + factory SpeakingProgressData.fromJson(Map json) { + final criteriaScoresJson = json['criteriaScores'] as Map? ?? {}; + final criteriaScores = {}; + for (final criteria in PronunciationCriteria.values) { + criteriaScores[criteria] = (criteriaScoresJson[criteria.name] as num?)?.toDouble() ?? 0.0; + } + + return SpeakingProgressData( + date: DateTime.parse(json['date'] as String), + averageScore: (json['averageScore'] as num).toDouble(), + sessionCount: (json['sessionCount'] as num).toInt(), + totalMinutes: (json['totalMinutes'] as num).toInt(), + criteriaScores: criteriaScores, + ); + } + + Map toJson() { + final criteriaScoresJson = {}; + for (final entry in criteriaScores.entries) { + criteriaScoresJson[entry.key.name] = entry.value; + } + + return { + 'date': date.toIso8601String(), + 'averageScore': averageScore, + 'sessionCount': sessionCount, + 'totalMinutes': totalMinutes, + 'criteriaScores': criteriaScoresJson, + }; + } +} + +class SpeakingSkillAnalysis { + final Map criteriaScores; + final Map commonErrors; + final List strengths; + final List weaknesses; + final List recommendations; + final double improvementRate; // 改进速度 + final DateTime lastAnalyzed; + + const SpeakingSkillAnalysis({ + required this.criteriaScores, + required this.commonErrors, + required this.strengths, + required this.weaknesses, + required this.recommendations, + required this.improvementRate, + required this.lastAnalyzed, + }); + + factory SpeakingSkillAnalysis.fromJson(Map json) { + final criteriaScoresJson = json['criteriaScores'] as Map? ?? {}; + final criteriaScores = {}; + for (final criteria in PronunciationCriteria.values) { + criteriaScores[criteria] = (criteriaScoresJson[criteria.name] as num?)?.toDouble() ?? 0.0; + } + + return SpeakingSkillAnalysis( + criteriaScores: criteriaScores, + commonErrors: Map.from(json['commonErrors'] ?? {}), + strengths: List.from(json['strengths'] ?? []), + weaknesses: List.from(json['weaknesses'] ?? []), + recommendations: List.from(json['recommendations'] ?? []), + improvementRate: (json['improvementRate'] as num?)?.toDouble() ?? 0.0, + lastAnalyzed: (json['lastAnalyzed'] is String) + ? DateTime.parse(json['lastAnalyzed'] as String) + : DateTime.now(), + ); + } + + Map toJson() { + final criteriaScoresJson = {}; + for (final entry in criteriaScores.entries) { + criteriaScoresJson[entry.key.name] = entry.value; + } + + return { + 'criteriaScores': criteriaScoresJson, + 'commonErrors': commonErrors, + 'strengths': strengths, + 'weaknesses': weaknesses, + 'recommendations': recommendations, + 'improvementRate': improvementRate, + 'lastAnalyzed': lastAnalyzed.toIso8601String(), + }; + } + + String get overallLevel { + final averageScore = criteriaScores.values.reduce((a, b) => a + b) / criteriaScores.length; + if (averageScore >= 90) return '优秀'; + if (averageScore >= 80) return '良好'; + if (averageScore >= 70) return '中等'; + if (averageScore >= 60) return '及格'; + return '需要改进'; + } + + PronunciationCriteria get strongestSkill { + return criteriaScores.entries + .reduce((a, b) => a.value > b.value ? a : b) + .key; + } + + PronunciationCriteria get weakestSkill { + return criteriaScores.entries + .reduce((a, b) => a.value < b.value ? a : b) + .key; + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/providers/speaking_provider.dart b/client/lib/features/speaking/providers/speaking_provider.dart new file mode 100644 index 0000000..4e75214 --- /dev/null +++ b/client/lib/features/speaking/providers/speaking_provider.dart @@ -0,0 +1,125 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/speaking_scenario.dart'; +import '../models/conversation.dart'; +import '../services/speaking_service.dart'; + +/// 口语任务状态 +class SpeakingTasksState { + final List tasks; + final bool isLoading; + final String? error; + + SpeakingTasksState({ + this.tasks = const [], + this.isLoading = false, + this.error, + }); + + SpeakingTasksState copyWith({ + List? tasks, + bool? isLoading, + String? error, + }) { + return SpeakingTasksState( + tasks: tasks ?? this.tasks, + isLoading: isLoading ?? this.isLoading, + error: error, + ); + } +} + +/// 口语任务 Notifier +class SpeakingTasksNotifier extends StateNotifier { + final SpeakingService _speakingService; + + SpeakingTasksNotifier(this._speakingService) : super(SpeakingTasksState()); + + /// 加载口语场景列表 + Future loadScenarios({ + SpeakingScenario? scenario, + SpeakingDifficulty? difficulty, + int page = 1, + }) async { + state = state.copyWith(isLoading: true, error: null); + + try { + final response = await _speakingService.getSpeakingScenarios( + scenario: scenario, + difficulty: difficulty, + page: page, + ); + + if (response.success && response.data != null) { + state = state.copyWith(tasks: response.data!, isLoading: false); + } else { + state = state.copyWith( + isLoading: false, + error: response.message, + ); + } + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } + + /// 获取推荐任务 + Future loadRecommendedTasks() async { + state = state.copyWith(isLoading: true, error: null); + + try { + final response = await _speakingService.getRecommendedTasks(); + + if (response.success && response.data != null) { + state = state.copyWith(tasks: response.data!, isLoading: false); + } else { + state = state.copyWith( + isLoading: false, + error: response.message, + ); + } + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } +} + +/// 口语服务 Provider +final speakingServiceProvider = Provider((ref) { + return SpeakingService(); +}); + +/// 口语任务列表 Provider +final speakingTasksProvider = StateNotifierProvider((ref) { + final service = ref.watch(speakingServiceProvider); + return SpeakingTasksNotifier(service); +}); + +/// 推荐口语任务 Provider +final recommendedSpeakingTasksProvider = FutureProvider>((ref) async { + final service = ref.watch(speakingServiceProvider); + + try { + final response = await service.getRecommendedTasks(); + return response.data ?? []; + } catch (e) { + return []; + } +}); + +/// 用户口语历史 Provider +final userSpeakingHistoryProvider = FutureProvider>((ref) async { + final service = ref.watch(speakingServiceProvider); + + try { + final response = await service.getUserSpeakingHistory(limit: 5); + return response.data ?? []; + } catch (e) { + return []; + } +}); diff --git a/client/lib/features/speaking/screens/ai_conversation_screen.dart b/client/lib/features/speaking/screens/ai_conversation_screen.dart new file mode 100644 index 0000000..8f6cca6 --- /dev/null +++ b/client/lib/features/speaking/screens/ai_conversation_screen.dart @@ -0,0 +1,604 @@ +import 'package:flutter/material.dart'; +import '../models/ai_tutor.dart'; +import '../models/conversation.dart'; + +/// AI对话页面 +class AIConversationScreen extends StatefulWidget { + final AITutor tutor; + + const AIConversationScreen({ + super.key, + required this.tutor, + }); + + @override + State createState() => _AIConversationScreenState(); +} + +class _AIConversationScreenState extends State { + final TextEditingController _messageController = TextEditingController(); + final ScrollController _scrollController = ScrollController(); + final List _messages = []; + bool _isTyping = false; + bool _isRecording = false; + + @override + void initState() { + super.initState(); + _initializeConversation(); + } + + void _initializeConversation() { + // 添加导师的欢迎消息 + final welcomeMessage = ConversationMessage( + id: 'welcome_${DateTime.now().millisecondsSinceEpoch}', + content: _getWelcomeMessage(), + type: MessageType.ai, + timestamp: DateTime.now(), + ); + + setState(() { + _messages.add(welcomeMessage); + }); + } + + String _getWelcomeMessage() { + switch (widget.tutor.type) { + case TutorType.business: + return '${widget.tutor.introduction}\n\n让我们开始商务英语对话练习吧！你可以告诉我你的工作背景，或者我们可以模拟一个商务场景。'; + case TutorType.daily: + return '${widget.tutor.introduction}\n\n今天想聊什么呢？我们可以谈论天气、兴趣爱好，或者你今天做了什么有趣的事情！'; + case TutorType.travel: + return '${widget.tutor.introduction}\n\n准备好开始我们的旅行英语之旅了吗？告诉我你想去哪里旅行，或者我们可以模拟在机场、酒店的场景！'; + case TutorType.academic: + return '${widget.tutor.introduction}\n\n欢迎来到学术英语课堂！我们可以讨论你的研究领域，或者练习学术演讲技巧。'; + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + backgroundColor: widget.tutor.type.color, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back, color: Colors.white), + onPressed: () => Navigator.of(context).pop(), + ), + title: Row( + children: [ + Text( + widget.tutor.avatar, + style: const TextStyle(fontSize: 24), + ), + const SizedBox(width: 8), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + widget.tutor.name, + style: const TextStyle( + color: Colors.white, + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + Text( + widget.tutor.type.displayName, + style: const TextStyle( + color: Colors.white70, + fontSize: 12, + ), + ), + ], + ), + ), + ], + ), + actions: [ + IconButton( + icon: const Icon(Icons.info_outline, color: Colors.white), + onPressed: _showTutorInfo, + ), + ], + ), + body: Column( + children: [ + Expanded( + child: ListView.builder( + controller: _scrollController, + padding: const EdgeInsets.all(16), + itemCount: _messages.length + (_isTyping ? 1 : 0), + itemBuilder: (context, index) { + if (index == _messages.length && _isTyping) { + return _buildTypingIndicator(); + } + return _buildMessageBubble(_messages[index]); + }, + ), + ), + _buildInputArea(), + ], + ), + ); + } + + Widget _buildMessageBubble(ConversationMessage message) { + final isUser = message.type == MessageType.user; + + return Padding( + padding: const EdgeInsets.symmetric(vertical: 4), + child: Row( + mainAxisAlignment: isUser ? MainAxisAlignment.end : MainAxisAlignment.start, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + if (!isUser) ...[ + CircleAvatar( + radius: 16, + backgroundColor: widget.tutor.type.color.withOpacity(0.1), + child: Text( + widget.tutor.avatar, + style: const TextStyle(fontSize: 16), + ), + ), + const SizedBox(width: 8), + ], + Flexible( + child: Container( + padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 12), + decoration: BoxDecoration( + color: isUser ? widget.tutor.type.color : Colors.white, + borderRadius: BorderRadius.circular(20), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 5, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + message.content, + style: TextStyle( + color: isUser ? Colors.white : Colors.black87, + fontSize: 14, + ), + ), + const SizedBox(height: 4), + Text( + _formatTime(message.timestamp), + style: TextStyle( + color: isUser ? Colors.white70 : Colors.grey, + fontSize: 10, + ), + ), + ], + ), + ), + ), + if (isUser) ...[ + const SizedBox(width: 8), + CircleAvatar( + radius: 16, + backgroundColor: Colors.blue.withOpacity(0.1), + child: const Icon( + Icons.person, + size: 16, + color: Colors.blue, + ), + ), + ], + ], + ), + ); + } + + Widget _buildTypingIndicator() { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 4), + child: Row( + children: [ + CircleAvatar( + radius: 16, + backgroundColor: widget.tutor.type.color.withOpacity(0.1), + child: Text( + widget.tutor.avatar, + style: const TextStyle(fontSize: 16), + ), + ), + const SizedBox(width: 8), + Container( + padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 12), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(20), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 5, + offset: const Offset(0, 2), + ), + ], + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + _buildDot(0), + const SizedBox(width: 4), + _buildDot(1), + const SizedBox(width: 4), + _buildDot(2), + ], + ), + ), + ], + ), + ); + } + + Widget _buildDot(int index) { + return AnimatedContainer( + duration: Duration(milliseconds: 600 + (index * 200)), + width: 6, + height: 6, + decoration: BoxDecoration( + color: widget.tutor.type.color.withOpacity(0.6), + shape: BoxShape.circle, + ), + ); + } + + Widget _buildInputArea() { + return Container( + padding: const EdgeInsets.all(16), + decoration: const BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.black12, + blurRadius: 5, + offset: Offset(0, -2), + ), + ], + ), + child: Row( + children: [ + GestureDetector( + onTapDown: (_) => _startRecording(), + onTapUp: (_) => _stopRecording(), + onTapCancel: () => _stopRecording(), + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: _isRecording ? Colors.red : widget.tutor.type.color, + shape: BoxShape.circle, + ), + child: Icon( + _isRecording ? Icons.stop : Icons.mic, + color: Colors.white, + size: 20, + ), + ), + ), + const SizedBox(width: 12), + Expanded( + child: TextField( + controller: _messageController, + decoration: InputDecoration( + hintText: '输入消息...', + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(25), + borderSide: BorderSide.none, + ), + filled: true, + fillColor: Colors.grey[100], + contentPadding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 12, + ), + ), + onSubmitted: (_) => _sendMessage(), + ), + ), + const SizedBox(width: 12), + GestureDetector( + onTap: _sendMessage, + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: widget.tutor.type.color, + shape: BoxShape.circle, + ), + child: const Icon( + Icons.send, + color: Colors.white, + size: 20, + ), + ), + ), + ], + ), + ); + } + + void _sendMessage() { + final text = _messageController.text.trim(); + if (text.isEmpty) return; + + // 添加用户消息 + final userMessage = ConversationMessage( + id: 'user_${DateTime.now().millisecondsSinceEpoch}', + content: text, + type: MessageType.user, + timestamp: DateTime.now(), + ); + + setState(() { + _messages.add(userMessage); + _isTyping = true; + }); + + _messageController.clear(); + _scrollToBottom(); + + // 生成AI回复 + _generateAIResponse(text); + } + + void _generateAIResponse(String userMessage) { + // 模拟AI思考时间 + Future.delayed(const Duration(milliseconds: 1500), () { + final aiResponse = _getAIResponse(userMessage); + + final aiMessage = ConversationMessage( + id: 'ai_${DateTime.now().millisecondsSinceEpoch}', + content: aiResponse, + type: MessageType.ai, + timestamp: DateTime.now(), + ); + + setState(() { + _isTyping = false; + _messages.add(aiMessage); + }); + + _scrollToBottom(); + }); + } + + String _getAIResponse(String userMessage) { + final message = userMessage.toLowerCase(); + + // 根据导师类型和用户消息生成相应回复 + switch (widget.tutor.type) { + case TutorType.business: + return _getBusinessResponse(message); + case TutorType.daily: + return _getDailyResponse(message); + case TutorType.travel: + return _getTravelResponse(message); + case TutorType.academic: + return _getAcademicResponse(message); + } + } + + String _getBusinessResponse(String message) { + if (message.contains('meeting') || message.contains('会议')) { + return "Great! Let's discuss meeting preparation. What type of meeting are you attending? Is it a client presentation, team meeting, or board meeting?"; + } else if (message.contains('presentation') || message.contains('演讲')) { + return "Presentations are crucial in business. What's your presentation topic? I can help you structure your content and practice key phrases."; + } else if (message.contains('email') || message.contains('邮件')) { + return "Business emails require professional tone. Are you writing to a client, colleague, or supervisor? What's the main purpose of your email?"; + } else if (message.contains('hello') || message.contains('hi') || message.contains('你好')) { + return "Hello! I'm your business English tutor. I can help you with presentations, meetings, negotiations, and professional communication. What would you like to practice today?"; + } else { + return "That's an interesting point. In business context, we should consider the professional implications. Could you elaborate on your specific business scenario?"; + } + } + + String _getDailyResponse(String message) { + if (message.contains('weather') || message.contains('天气')) { + return "The weather is a great conversation starter! How's the weather where you are? You can say 'It's sunny/rainy/cloudy today' or 'What a beautiful day!'"; + } else if (message.contains('food') || message.contains('吃') || message.contains('饭')) { + return "Food is always a fun topic! What's your favorite cuisine? You can practice ordering food or describing flavors. Try saying 'I'd like to order...' or 'This tastes delicious!'"; + } else if (message.contains('hobby') || message.contains('爱好')) { + return "Hobbies are personal and interesting! What do you enjoy doing in your free time? You can say 'I enjoy...' or 'My hobby is...' or 'In my spare time, I like to...'"; + } else if (message.contains('hello') || message.contains('hi') || message.contains('你好')) { + return "Hi there! I'm here to help you with everyday English conversations. We can talk about weather, food, hobbies, shopping, or any daily activities. What interests you?"; + } else { + return "That's interesting! In daily conversations, we often share personal experiences. Can you tell me more about that? It's great practice for natural English!"; + } + } + + String _getTravelResponse(String message) { + if (message.contains('airport') || message.contains('flight') || message.contains('机场')) { + return "Airport conversations are essential for travelers! Are you checking in, going through security, or asking for directions? Try phrases like 'Where is gate B12?' or 'Is this flight delayed?'"; + } else if (message.contains('hotel') || message.contains('酒店')) { + return "Hotel interactions are important! Are you checking in, asking about amenities, or reporting an issue? Practice saying 'I have a reservation under...' or 'Could you help me with...'"; + } else if (message.contains('restaurant') || message.contains('餐厅')) { + return "Dining out while traveling is fun! Are you making a reservation, ordering food, or asking about local specialties? Try 'Table for two, please' or 'What do you recommend?'"; + } else if (message.contains('direction') || message.contains('路')) { + return "Getting directions is crucial when traveling! Practice asking 'How do I get to...?' or 'Is it walking distance?' You can also say 'Could you show me on the map?'"; + } else if (message.contains('hello') || message.contains('hi') || message.contains('你好')) { + return "Welcome, fellow traveler! I'm your travel English companion. I can help you with airport conversations, hotel bookings, restaurant orders, and asking for directions. Where shall we start?"; + } else { + return "That sounds like a great travel experience! When traveling, it's important to communicate clearly. Can you describe the situation in more detail? I'll help you with the right phrases!"; + } + } + + String _getAcademicResponse(String message) { + if (message.contains('research') || message.contains('研究')) { + return "Research is fundamental in academics! What's your research area? We can practice presenting findings, discussing methodology, or explaining complex concepts clearly."; + } else if (message.contains('presentation') || message.contains('论文')) { + return "Academic presentations require clear structure and precise language. Are you presenting research results, defending a thesis, or giving a conference talk? Let's work on your key points!"; + } else if (message.contains('discussion') || message.contains('讨论')) { + return "Academic discussions involve critical thinking and evidence-based arguments. What topic are you discussing? Practice phrases like 'According to the research...' or 'The evidence suggests...'"; + } else if (message.contains('writing') || message.contains('写作')) { + return "Academic writing has specific conventions. Are you working on an essay, research paper, or thesis? I can help with structure, citations, and formal language."; + } else if (message.contains('hello') || message.contains('hi') || message.contains('你好')) { + return "Greetings! I'm your academic English tutor. I specialize in research discussions, academic presentations, scholarly writing, and conference communications. What academic skill would you like to develop?"; + } else { + return "That's a thoughtful academic point. In scholarly discourse, we need to support our arguments with evidence. Could you provide more context or examples to strengthen your position?"; + } + } + + void _startRecording() { + setState(() { + _isRecording = true; + }); + // TODO: 实现语音录制功能 + } + + void _stopRecording() { + setState(() { + _isRecording = false; + }); + // TODO: 处理录制的语音 + } + + void _scrollToBottom() { + WidgetsBinding.instance.addPostFrameCallback((_) { + if (_scrollController.hasClients) { + _scrollController.animateTo( + _scrollController.position.maxScrollExtent, + duration: const Duration(milliseconds: 300), + curve: Curves.easeOut, + ); + } + }); + } + + void _showTutorInfo() { + showModalBottomSheet( + context: context, + isScrollControlled: true, + backgroundColor: Colors.transparent, + builder: (context) => Container( + height: MediaQuery.of(context).size.height * 0.7, + decoration: const BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.vertical(top: Radius.circular(20)), + ), + child: Column( + children: [ + Container( + width: 40, + height: 4, + margin: const EdgeInsets.symmetric(vertical: 12), + decoration: BoxDecoration( + color: Colors.grey[300], + borderRadius: BorderRadius.circular(2), + ), + ), + Expanded( + child: Padding( + padding: const EdgeInsets.all(20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Text( + widget.tutor.avatar, + style: const TextStyle(fontSize: 40), + ), + const SizedBox(width: 16), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + widget.tutor.name, + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + Text( + widget.tutor.type.displayName, + style: TextStyle( + fontSize: 14, + color: widget.tutor.type.color, + ), + ), + ], + ), + ), + ], + ), + const SizedBox(height: 20), + Text( + '个性特点', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: widget.tutor.type.color, + ), + ), + const SizedBox(height: 8), + Text( + widget.tutor.personality, + style: const TextStyle(fontSize: 14), + ), + const SizedBox(height: 20), + Text( + '专业领域', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: widget.tutor.type.color, + ), + ), + const SizedBox(height: 8), + Wrap( + spacing: 8, + runSpacing: 8, + children: widget.tutor.specialties.map((specialty) { + return Container( + padding: const EdgeInsets.symmetric( + horizontal: 12, + vertical: 6, + ), + decoration: BoxDecoration( + color: widget.tutor.type.color.withOpacity(0.1), + borderRadius: BorderRadius.circular(16), + border: Border.all( + color: widget.tutor.type.color.withOpacity(0.3), + ), + ), + child: Text( + specialty, + style: TextStyle( + fontSize: 12, + color: widget.tutor.type.color, + ), + ), + ); + }).toList(), + ), + ], + ), + ), + ), + ], + ), + ), + ); + } + + String _formatTime(DateTime time) { + return '${time.hour.toString().padLeft(2, '0')}:${time.minute.toString().padLeft(2, '0')}'; + } + + @override + void dispose() { + _messageController.dispose(); + _scrollController.dispose(); + super.dispose(); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/screens/pronunciation_list_screen.dart b/client/lib/features/speaking/screens/pronunciation_list_screen.dart new file mode 100644 index 0000000..cace849 --- /dev/null +++ b/client/lib/features/speaking/screens/pronunciation_list_screen.dart @@ -0,0 +1,449 @@ +import 'package:flutter/material.dart'; +import '../models/pronunciation_item.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../services/speaking_service.dart'; +import '../providers/speaking_provider.dart'; +import 'pronunciation_practice_screen.dart'; + +class PronunciationListScreen extends StatefulWidget { + final PronunciationType type; + + const PronunciationListScreen({ + super.key, + required this.type, + }); + + @override + State createState() => _PronunciationListScreenState(); +} + +class _PronunciationListScreenState extends State { + List _items = []; + DifficultyLevel? _selectedDifficulty; + String? _selectedCategory; + bool _loading = true; + String? _error; + + @override + void initState() { + super.initState(); + _loadItems(); + } + + void _loadItems() { + setState(() { + _loading = true; + _error = null; + }); + + final service = SpeakingService(); + service.getPronunciationItems(widget.type, limit: 50).then((resp) { + if (resp.success && resp.data != null) { + setState(() { + _items = resp.data!; + _loading = false; + }); + _applyFilters(); + } else { + setState(() { + _error = resp.message; + _loading = false; + }); + } + }).catchError((e) { + setState(() { + _error = e.toString(); + _loading = false; + }); + }); + } + + void _applyFilters() { + List filteredItems = List.of(_items); + + if (_selectedDifficulty != null) { + filteredItems = filteredItems + .where((item) => item.difficulty == _selectedDifficulty) + .toList(); + } + + if (_selectedCategory != null) { + filteredItems = filteredItems + .where((item) => item.category == _selectedCategory) + .toList(); + } + + setState(() { + _items = filteredItems; + }); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F7FA), + appBar: AppBar( + title: Text(widget.type.displayName), + backgroundColor: Colors.white, + foregroundColor: Colors.black, + elevation: 0, + actions: [ + IconButton( + icon: const Icon(Icons.filter_list), + onPressed: _showFilterDialog, + ), + ], + ), + body: Column( + children: [ + _buildHeader(), + _buildFilterChips(), + Expanded( + child: _loading + ? const Center(child: CircularProgressIndicator()) + : _error != null + ? Center(child: Text(_error!, style: const TextStyle(color: Colors.red))) + : _buildItemList(), + ), + ], + ), + ); + } + + Widget _buildHeader() { + return Container( + width: double.infinity, + padding: const EdgeInsets.all(20), + decoration: const BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.only( + bottomLeft: Radius.circular(20), + bottomRight: Radius.circular(20), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + widget.type.displayName, + style: const TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + Text( + widget.type.description, + style: const TextStyle( + fontSize: 16, + color: Colors.grey, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Text( + widget.type.icon, + style: const TextStyle(fontSize: 32), + ), + const SizedBox(width: 12), + Expanded( + child: Text( + '共 ${_items.length} 个练习项目', + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildFilterChips() { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 20, vertical: 12), + child: SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + if (_selectedDifficulty != null) + _buildFilterChip( + '${_selectedDifficulty!.displayName} (${_selectedDifficulty!.code})', + () { + setState(() { + _selectedDifficulty = null; + _applyFilters(); + }); + }, + true, + ), + if (_selectedCategory != null) + _buildFilterChip( + _selectedCategory!, + () { + setState(() { + _selectedCategory = null; + _applyFilters(); + }); + }, + true, + ), + if (_selectedDifficulty == null && _selectedCategory == null) + const Text( + '点击右上角筛选按钮进行筛选', + style: TextStyle( + color: Colors.grey, + fontSize: 14, + ), + ), + ], + ), + ), + ); + } + + Widget _buildFilterChip(String label, VoidCallback onDeleted, bool showDelete) { + return Container( + margin: const EdgeInsets.only(right: 8), + child: Chip( + label: Text(label), + onDeleted: showDelete ? onDeleted : null, + backgroundColor: Colors.blue.withOpacity(0.1), + deleteIconColor: Colors.blue, + ), + ); + } + + Widget _buildItemList() { + if (_items.isEmpty) { + return const Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.search_off, + size: 64, + color: Colors.grey, + ), + SizedBox(height: 16), + Text( + '没有找到符合条件的练习项目', + style: TextStyle( + fontSize: 16, + color: Colors.grey, + ), + ), + ], + ), + ); + } + + return ListView.builder( + padding: const EdgeInsets.all(20), + itemCount: _items.length, + itemBuilder: (context, index) { + return _buildItemCard(_items[index]); + }, + ); + } + + Widget _buildItemCard(PronunciationItem item) { + return Container( + margin: const EdgeInsets.only(bottom: 12), + child: Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: InkWell( + borderRadius: BorderRadius.circular(12), + onTap: () { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => PronunciationPracticeScreen(item: item), + ), + ); + }, + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + item.text, + style: const TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ), + _buildDifficultyBadge(item.difficulty), + ], + ), + if (item.type != PronunciationType.sentence && item.phonetic.isNotEmpty) ...[ + const SizedBox(height: 8), + Text( + item.phonetic, + style: const TextStyle( + fontSize: 16, + color: Colors.blue, + fontFamily: 'monospace', + ), + ), + ], + const SizedBox(height: 8), + Row( + children: [ + Icon( + Icons.category, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 4), + Text( + item.category, + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const Spacer(), + Icon( + Icons.tips_and_updates, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 4), + Text( + '${item.tips.length} 个提示', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ), + ], + ), + ), + ), + ), + ); + } + + Widget _buildDifficultyBadge(DifficultyLevel difficulty) { + Color color; + switch (difficulty) { + case DifficultyLevel.beginner: + color = Colors.green; + break; + case DifficultyLevel.intermediate: + color = Colors.orange; + break; + case DifficultyLevel.advanced: + color = Colors.red; + break; + } + + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: color.withOpacity(0.3)), + ), + child: Text( + difficulty.displayName, + style: TextStyle( + fontSize: 12, + color: color, + fontWeight: FontWeight.bold, + ), + ), + ); + } + + void _showFilterDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('筛选条件'), + content: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text('难度级别：'), + const SizedBox(height: 8), + Wrap( + spacing: 8, + children: DifficultyLevel.values.map((difficulty) { + return FilterChip( + label: Text(difficulty.displayName), + selected: _selectedDifficulty == difficulty, + onSelected: (selected) { + setState(() { + _selectedDifficulty = selected ? difficulty : null; + }); + }, + ); + }).toList(), + ), + const SizedBox(height: 16), + const Text('分类：'), + const SizedBox(height: 8), + Wrap( + spacing: 8, + children: _getCategories().map((category) { + return FilterChip( + label: Text(category), + selected: _selectedCategory == category, + onSelected: (selected) { + setState(() { + _selectedCategory = selected ? category : null; + }); + }, + ); + }).toList(), + ), + ], + ), + actions: [ + TextButton( + onPressed: () { + setState(() { + _selectedDifficulty = null; + _selectedCategory = null; + }); + Navigator.pop(context); + _applyFilters(); + }, + child: const Text('清除'), + ), + TextButton( + onPressed: () { + Navigator.pop(context); + _applyFilters(); + }, + child: const Text('确定'), + ), + ], + ), + ); + } + + List _getCategories() { + final set = {}; + for (final item in _items) { + if (item.category.isNotEmpty) set.add(item.category); + } + return set.toList(); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/screens/pronunciation_practice_screen.dart b/client/lib/features/speaking/screens/pronunciation_practice_screen.dart new file mode 100644 index 0000000..ea50795 --- /dev/null +++ b/client/lib/features/speaking/screens/pronunciation_practice_screen.dart @@ -0,0 +1,869 @@ +import 'package:flutter/material.dart'; +import '../models/pronunciation_item.dart'; +import '../services/speech_recognition_service.dart'; + +class PronunciationPracticeScreen extends StatefulWidget { + final PronunciationItem item; + + const PronunciationPracticeScreen({ + super.key, + required this.item, + }); + + @override + State createState() => _PronunciationPracticeScreenState(); +} + +class _PronunciationPracticeScreenState extends State + with TickerProviderStateMixin { + bool _isRecording = false; + bool _isPlaying = false; + bool _hasRecorded = false; + double _currentScore = 0.0; + String _feedback = ''; + int _attempts = 0; + + late AnimationController _waveController; + late AnimationController _scoreController; + late Animation _waveAnimation; + late Animation _scoreAnimation; + + final SpeechRecognitionService _speechService = SpeechRecognitionService(); + PronunciationResult? _lastResult; + String _recognizedText = ''; + double _currentVolume = 0.0; + + @override + void initState() { + super.initState(); + _initAnimations(); + _initSpeechRecognition(); + } + + void _initSpeechRecognition() { + // 监听音量变化 + _speechService.volumeStream.listen((volume) { + if (mounted) { + setState(() { + _currentVolume = volume; + }); + } + }); + + // 监听识别结果 + _speechService.recognitionStream.listen((text) { + if (mounted) { + setState(() { + _recognizedText = text; + }); + } + }); + } + + void _initAnimations() { + _waveController = AnimationController( + duration: const Duration(milliseconds: 1500), + vsync: this, + ); + + _scoreController = AnimationController( + duration: const Duration(milliseconds: 1000), + vsync: this, + ); + + _waveAnimation = Tween( + begin: 0.0, + end: 1.0, + ).animate(CurvedAnimation( + parent: _waveController, + curve: Curves.easeInOut, + )); + + _scoreAnimation = Tween( + begin: 0.0, + end: 1.0, + ).animate(CurvedAnimation( + parent: _scoreController, + curve: Curves.elasticOut, + )); + } + + @override + void dispose() { + _waveController.dispose(); + _scoreController.dispose(); + _speechService.stopListening(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F7FA), + appBar: AppBar( + title: Text(widget.item.type.displayName), + backgroundColor: Colors.white, + foregroundColor: Colors.black, + elevation: 0, + actions: [ + IconButton( + icon: const Icon(Icons.info_outline), + onPressed: _showTipsDialog, + ), + ], + ), + body: SingleChildScrollView( + padding: const EdgeInsets.all(20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildTextCard(), + const SizedBox(height: 20), + if (widget.item.type != PronunciationType.sentence && widget.item.phonetic.isNotEmpty) + _buildPhoneticCard(), + const SizedBox(height: 20), + _buildRecordingArea(), + const SizedBox(height: 20), + if (_hasRecorded) _buildScoreCard(), + const SizedBox(height: 20), + _buildTipsCard(), + ], + ), + ), + ); + } + + Widget _buildTextCard() { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Container( + width: double.infinity, + padding: const EdgeInsets.all(24), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Text( + widget.item.type.icon, + style: const TextStyle(fontSize: 24), + ), + const SizedBox(width: 12), + Text( + widget.item.category, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + fontWeight: FontWeight.w500, + ), + ), + const Spacer(), + _buildDifficultyBadge(widget.item.difficulty), + ], + ), + const SizedBox(height: 16), + Text( + widget.item.text, + style: const TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + height: 1.3, + ), + ), + ], + ), + ), + ); + } + + Widget _buildPhoneticCard() { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Container( + width: double.infinity, + padding: const EdgeInsets.all(20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + const Icon( + Icons.record_voice_over, + color: Colors.blue, + ), + const SizedBox(width: 8), + const Text( + '音标', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const Spacer(), + IconButton( + icon: Icon( + _isPlaying ? Icons.stop : Icons.play_arrow, + color: Colors.blue, + ), + onPressed: _playStandardAudio, + ), + ], + ), + const SizedBox(height: 12), + Text( + widget.item.phonetic, + style: const TextStyle( + fontSize: 20, + color: Colors.blue, + fontFamily: 'monospace', + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ), + ); + } + + Widget _buildRecordingArea() { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Container( + width: double.infinity, + padding: const EdgeInsets.all(24), + child: Column( + children: [ + const Text( + '点击录音按钮开始练习', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 24), + AnimatedBuilder( + animation: _waveAnimation, + builder: (context, child) { + return Container( + width: 120, + height: 120, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: _isRecording ? Colors.red.withOpacity(0.1) : Colors.blue.withOpacity(0.1), + border: Border.all( + color: _isRecording ? Colors.red : Colors.blue, + width: 2, + ), + ), + child: Stack( + alignment: Alignment.center, + children: [ + if (_isRecording) + ...List.generate(3, (index) { + return AnimatedContainer( + duration: Duration(milliseconds: 500 + index * 200), + width: 120 + (index * 20) * _waveAnimation.value, + height: 120 + (index * 20) * _waveAnimation.value, + decoration: BoxDecoration( + shape: BoxShape.circle, + border: Border.all( + color: Colors.red.withOpacity(0.3 - index * 0.1), + width: 1, + ), + ), + ); + }), + IconButton( + iconSize: 48, + icon: Icon( + _isRecording ? Icons.stop : Icons.mic, + color: _isRecording ? Colors.red : Colors.blue, + ), + onPressed: _toggleRecording, + ), + ], + ), + ); + }, + ), + const SizedBox(height: 16), + Text( + _isRecording ? '录音中...' : '点击开始录音', + style: TextStyle( + fontSize: 14, + color: _isRecording ? Colors.red : Colors.grey, + ), + ), + if (_isRecording) ...[ + const SizedBox(height: 12), + // 音量指示器 + Container( + width: 200, + height: 4, + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(2), + color: Colors.grey[300], + ), + child: FractionallySizedBox( + alignment: Alignment.centerLeft, + widthFactor: _currentVolume, + child: Container( + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(2), + color: Colors.red, + ), + ), + ), + ), + const SizedBox(height: 8), + Text( + '音量: ${(_currentVolume * 100).toInt()}%', + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + if (_recognizedText.isNotEmpty) ...[ + const SizedBox(height: 12), + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + border: Border.all(color: Colors.blue.withOpacity(0.3)), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '识别结果:', + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.bold, + color: Colors.blue, + ), + ), + const SizedBox(height: 4), + Text( + _recognizedText, + style: const TextStyle( + fontSize: 14, + color: Colors.black87, + ), + ), + ], + ), + ), + ], + if (_attempts > 0) ...[ + const SizedBox(height: 12), + Text( + '已练习 $_attempts 次', + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ], + ), + ), + ); + } + + Widget _buildScoreCard() { + return AnimatedBuilder( + animation: _scoreAnimation, + builder: (context, child) { + return Transform.scale( + scale: 0.8 + 0.2 * _scoreAnimation.value, + child: Card( + elevation: 4, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Container( + width: double.infinity, + padding: const EdgeInsets.all(24), + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(16), + gradient: LinearGradient( + colors: [ + _getScoreColor().withOpacity(0.1), + _getScoreColor().withOpacity(0.05), + ], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + ), + child: Column( + children: [ + Row( + children: [ + Icon( + Icons.score, + color: _getScoreColor(), + ), + const SizedBox(width: 8), + const Text( + '发音评分', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 16), + Row( + mainAxisAlignment: MainAxisAlignment.center, + crossAxisAlignment: CrossAxisAlignment.baseline, + textBaseline: TextBaseline.alphabetic, + children: [ + Text( + '${(_currentScore * _scoreAnimation.value).toInt()}', + style: TextStyle( + fontSize: 48, + fontWeight: FontWeight.bold, + color: _getScoreColor(), + ), + ), + Text( + '/100', + style: TextStyle( + fontSize: 24, + color: _getScoreColor(), + ), + ), + ], + ), + const SizedBox(height: 8), + Text( + _getScoreText(), + style: TextStyle( + fontSize: 16, + color: _getScoreColor(), + fontWeight: FontWeight.w500, + ), + ), + if (_lastResult != null) ...[ + const SizedBox(height: 16), + // 准确度显示 + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '准确度: ${_lastResult!.accuracy.displayName}', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: _getAccuracyColor(_lastResult!.accuracy), + ), + ), + Text( + _lastResult!.accuracy.emoji, + style: const TextStyle(fontSize: 20), + ), + ], + ), + const SizedBox(height: 12), + // 详细分析 + if (_lastResult!.detailedAnalysis.isNotEmpty) ...[ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '详细分析:', + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.bold, + color: Colors.blue, + ), + ), + const SizedBox(height: 4), + Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: _lastResult!.detailedAnalysis.entries.map((entry) { + return Padding( + padding: const EdgeInsets.only(bottom: 2), + child: Text( + '${entry.key}: ${entry.value.toInt()}%', + style: const TextStyle( + fontSize: 12, + color: Colors.black87, + ), + ), + ); + }).toList(), + ), + ], + ), + ), + const SizedBox(height: 8), + ], + // 改进建议 + if (_lastResult!.suggestions.isNotEmpty) ...[ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.orange.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '改进建议:', + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.bold, + color: Colors.orange, + ), + ), + const SizedBox(height: 4), + ...(_lastResult!.suggestions.take(2).map((suggestion) => + Padding( + padding: const EdgeInsets.only(bottom: 2), + child: Text( + '• $suggestion', + style: const TextStyle( + fontSize: 12, + color: Colors.black87, + ), + ), + ), + )), + ], + ), + ), + const SizedBox(height: 8), + ], + // 反馈 + if (_feedback.isNotEmpty) ...[ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Text( + _feedback, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + textAlign: TextAlign.center, + ), + ), + ], + ], + const SizedBox(height: 16), + ElevatedButton( + onPressed: _toggleRecording, + style: ElevatedButton.styleFrom( + backgroundColor: Colors.blue, + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 12), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + child: const Text('再次练习'), + ), + ], + ), + ), + ), + ); + }, + ); + } + + Widget _buildTipsCard() { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Container( + width: double.infinity, + padding: const EdgeInsets.all(20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Row( + children: [ + Icon( + Icons.lightbulb_outline, + color: Colors.orange, + ), + SizedBox(width: 8), + Text( + '发音提示', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 12), + ...widget.item.tips.map((tip) => Padding( + padding: const EdgeInsets.only(bottom: 8), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '• ', + style: TextStyle( + color: Colors.orange, + fontWeight: FontWeight.bold, + ), + ), + Expanded( + child: Text( + tip, + style: const TextStyle( + fontSize: 14, + height: 1.4, + ), + ), + ), + ], + ), + )), + ], + ), + ), + ); + } + + Widget _buildDifficultyBadge(DifficultyLevel difficulty) { + Color color; + switch (difficulty) { + case DifficultyLevel.beginner: + color = Colors.green; + break; + case DifficultyLevel.intermediate: + color = Colors.orange; + break; + case DifficultyLevel.advanced: + color = Colors.red; + break; + } + + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: color.withOpacity(0.3)), + ), + child: Text( + '${difficulty.displayName} ${difficulty.code}', + style: TextStyle( + fontSize: 12, + color: color, + fontWeight: FontWeight.bold, + ), + ), + ); + } + + Color _getScoreColor() { + if (_currentScore >= 80) return Colors.green; + if (_currentScore >= 60) return Colors.orange; + return Colors.red; + } + + String _getScoreText() { + if (_currentScore >= 90) return '优秀！'; + if (_currentScore >= 80) return '良好'; + if (_currentScore >= 70) return '一般'; + if (_currentScore >= 60) return '需要改进'; + return '继续努力'; + } + + Color _getAccuracyColor(AccuracyLevel accuracy) { + switch (accuracy) { + case AccuracyLevel.excellent: + return Colors.green; + case AccuracyLevel.good: + return Colors.blue; + case AccuracyLevel.fair: + return Colors.orange; + case AccuracyLevel.needsImprovement: + return Colors.amber; + case AccuracyLevel.poor: + return Colors.red; + } + } + + void _playStandardAudio() { + setState(() { + _isPlaying = !_isPlaying; + }); + + // TODO: 实现音频播放功能 + // 这里应该播放标准发音音频 + + // 模拟播放时间 + if (_isPlaying) { + Future.delayed(const Duration(seconds: 2), () { + if (mounted) { + setState(() { + _isPlaying = false; + }); + } + }); + } + } + + void _toggleRecording() async { + if (_isRecording) { + // 停止录音 + setState(() { + _isRecording = false; + }); + _waveController.stop(); + _waveController.reset(); + + await _speechService.stopListening(); + _analyzeRecording(); + } else { + // 开始录音 + final hasPermission = await _speechService.checkMicrophonePermission(); + if (!hasPermission) { + final granted = await _speechService.requestMicrophonePermission(); + if (!granted) { + _showPermissionDialog(); + return; + } + } + + final started = await _speechService.startListening(); + if (started) { + setState(() { + _isRecording = true; + _recognizedText = ''; + }); + _waveController.repeat(); + } + } + } + + void _analyzeRecording() async { + try { + final result = await _speechService.analyzePronunciation( + _recognizedText, + widget.item, + ); + + setState(() { + _attempts++; + _lastResult = result; + _currentScore = result.score; + _hasRecorded = true; + _feedback = result.feedback; + }); + + _scoreController.forward(); + } catch (e) { + // 如果分析失败，显示错误信息 + setState(() { + _feedback = '分析失败，请重试'; + _hasRecorded = false; + }); + } + } + + String _generateFeedback() { + List feedbacks = [ + '发音基本准确，注意语调的变化', + '重音位置正确，继续保持', + '音素发音清晰，语速可以稍微放慢', + '整体表现不错，注意连读的处理', + '发音标准，语调自然', + ]; + return feedbacks[DateTime.now().millisecond % feedbacks.length]; + } + + void _showTipsDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('发音提示'), + content: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: widget.item.tips.map((tip) => Padding( + padding: const EdgeInsets.only(bottom: 8), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '• ', + style: TextStyle( + color: Colors.orange, + fontWeight: FontWeight.bold, + ), + ), + Expanded( + child: Text( + tip, + style: const TextStyle(fontSize: 14), + ), + ), + ], + ), + )).toList(), + ), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('知道了'), + ), + ], + ), + ); + } + + void _showPermissionDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('需要麦克风权限'), + content: const Text('为了进行发音练习，需要访问您的麦克风。请在设置中允许麦克风权限。'), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + TextButton( + onPressed: () { + Navigator.pop(context); + // TODO: 打开应用设置页面 + }, + child: const Text('去设置'), + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/screens/scenario_practice_screen.dart b/client/lib/features/speaking/screens/scenario_practice_screen.dart new file mode 100644 index 0000000..ed1df8c --- /dev/null +++ b/client/lib/features/speaking/screens/scenario_practice_screen.dart @@ -0,0 +1,470 @@ +import 'package:flutter/material.dart'; +import '../models/conversation_scenario.dart'; + +/// 场景练习页面 +class ScenarioPracticeScreen extends StatefulWidget { + final ConversationScenario scenario; + + const ScenarioPracticeScreen({ + Key? key, + required this.scenario, + }) : super(key: key); + + @override + State createState() => _ScenarioPracticeScreenState(); +} + +class _ScenarioPracticeScreenState extends State { + int _currentStepIndex = 0; + List _userResponses = []; + bool _isCompleted = false; + + @override + void initState() { + super.initState(); + _userResponses = List.filled(widget.scenario.steps.length, ''); + } + + ScenarioStep get _currentStep => widget.scenario.steps[_currentStepIndex]; + + void _selectOption(String option) { + setState(() { + _userResponses[_currentStepIndex] = option; + }); + } + + void _nextStep() { + if (_currentStepIndex < widget.scenario.steps.length - 1) { + setState(() { + _currentStepIndex++; + }); + } else { + setState(() { + _isCompleted = true; + }); + _showCompletionDialog(); + } + } + + void _previousStep() { + if (_currentStepIndex > 0) { + setState(() { + _currentStepIndex--; + }); + } + } + + void _showCompletionDialog() { + showDialog( + context: context, + barrierDismissible: false, + builder: (context) => AlertDialog( + title: const Text('🎉 恭喜完成！'), + content: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Text('您已成功完成「${widget.scenario.title}」场景练习！'), + const SizedBox(height: 16), + const Text('继续练习可以提高您的英语口语水平。'), + ], + ), + actions: [ + TextButton( + onPressed: () { + Navigator.of(context).pop(); // 关闭对话框 + Navigator.of(context).pop(); // 返回主页 + }, + child: const Text('返回主页'), + ), + ElevatedButton( + onPressed: () { + Navigator.of(context).pop(); // 关闭对话框 + _restartScenario(); + }, + child: const Text('重新练习'), + ), + ], + ), + ); + } + + void _restartScenario() { + setState(() { + _currentStepIndex = 0; + _userResponses = List.filled(widget.scenario.steps.length, ''); + _isCompleted = false; + }); + } + + void _showScenarioInfo() { + showModalBottomSheet( + context: context, + isScrollControlled: true, + builder: (context) => DraggableScrollableSheet( + initialChildSize: 0.7, + maxChildSize: 0.9, + minChildSize: 0.5, + builder: (context, scrollController) => Container( + padding: const EdgeInsets.all(20), + decoration: const BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.vertical(top: Radius.circular(20)), + ), + child: SingleChildScrollView( + controller: scrollController, + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Text( + widget.scenario.type.icon, + style: const TextStyle(fontSize: 32), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + widget.scenario.title, + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + Text( + widget.scenario.subtitle, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + ], + ), + ), + ], + ), + const SizedBox(height: 20), + Text( + widget.scenario.description, + style: const TextStyle(fontSize: 16), + ), + const SizedBox(height: 20), + const Text( + '学习目标', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + ...widget.scenario.objectives.map( + (objective) => Padding( + padding: const EdgeInsets.only(bottom: 4), + child: Row( + children: [ + const Icon(Icons.check_circle, + color: Colors.green, size: 16), + const SizedBox(width: 8), + Expanded(child: Text(objective)), + ], + ), + ), + ), + const SizedBox(height: 20), + const Text( + '关键短语', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + Wrap( + spacing: 8, + runSpacing: 8, + children: widget.scenario.keyPhrases.map( + (phrase) => Container( + padding: const EdgeInsets.symmetric( + horizontal: 12, + vertical: 6, + ), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.1), + borderRadius: BorderRadius.circular(16), + border: Border.all(color: Colors.blue.withOpacity(0.3)), + ), + child: Text( + phrase, + style: const TextStyle( + fontSize: 12, + color: Colors.blue, + ), + ), + ), + ).toList(), + ), + ], + ), + ), + ), + ), + ); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + widget.scenario.title, + style: const TextStyle(fontSize: 16), + ), + Text( + '步骤 ${_currentStepIndex + 1}/${widget.scenario.steps.length}', + style: const TextStyle(fontSize: 12, color: Colors.grey), + ), + ], + ), + actions: [ + IconButton( + onPressed: _showScenarioInfo, + icon: const Icon(Icons.info_outline), + ), + ], + ), + body: Column( + children: [ + // 进度条 + LinearProgressIndicator( + value: (_currentStepIndex + 1) / widget.scenario.steps.length, + backgroundColor: Colors.grey[300], + valueColor: const AlwaysStoppedAnimation(Colors.blue), + ), + Expanded( + child: Padding( + padding: const EdgeInsets.all(20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 步骤标题 + Container( + width: double.infinity, + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + _currentStep.title, + style: const TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Colors.blue, + ), + ), + const SizedBox(height: 4), + Text( + _currentStep.description, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + ], + ), + ), + const SizedBox(height: 20), + + // 对话内容 + Expanded( + child: Container( + width: double.infinity, + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: _currentStep.role == 'npc' + ? Colors.grey[100] + : Colors.blue[50], + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: _currentStep.role == 'npc' + ? Colors.grey.withOpacity(0.3) + : Colors.blue.withOpacity(0.3), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + CircleAvatar( + radius: 16, + backgroundColor: _currentStep.role == 'npc' + ? Colors.grey + : Colors.blue, + child: Text( + _currentStep.role == 'npc' ? 'NPC' : 'YOU', + style: const TextStyle( + fontSize: 10, + color: Colors.white, + fontWeight: FontWeight.bold, + ), + ), + ), + const SizedBox(width: 12), + Text( + _currentStep.role == 'npc' ? '对方说：' : '您说：', + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 12), + Text( + _currentStep.content, + style: const TextStyle(fontSize: 16), + ), + ], + ), + ), + ), + + const SizedBox(height: 20), + + // 选项 + if (_currentStep.options.isNotEmpty) ...[ + const Text( + '请选择您的回应：', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + ...(_currentStep.options.asMap().entries.map( + (entry) { + final index = entry.key; + final option = entry.value; + final isSelected = _userResponses[_currentStepIndex] == option; + + return Padding( + padding: const EdgeInsets.only(bottom: 8), + child: GestureDetector( + onTap: () => _selectOption(option), + child: Container( + width: double.infinity, + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: isSelected + ? Colors.blue.withOpacity(0.1) + : Colors.white, + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: isSelected + ? Colors.blue + : Colors.grey.withOpacity(0.3), + width: isSelected ? 2 : 1, + ), + ), + child: Row( + children: [ + Container( + width: 24, + height: 24, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: isSelected + ? Colors.blue + : Colors.grey[300], + ), + child: Center( + child: Text( + String.fromCharCode(65 + index), // A, B, C + style: TextStyle( + color: isSelected + ? Colors.white + : Colors.grey[600], + fontWeight: FontWeight.bold, + fontSize: 12, + ), + ), + ), + ), + const SizedBox(width: 12), + Expanded( + child: Text( + option, + style: TextStyle( + fontSize: 14, + color: isSelected + ? Colors.blue + : Colors.black, + ), + ), + ), + ], + ), + ), + ), + ); + }, + )), + ], + ], + ), + ), + ), + + // 底部按钮 + Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, -2), + ), + ], + ), + child: Row( + children: [ + if (_currentStepIndex > 0) + Expanded( + child: OutlinedButton( + onPressed: _previousStep, + child: const Text('上一步'), + ), + ), + if (_currentStepIndex > 0) const SizedBox(width: 12), + Expanded( + child: ElevatedButton( + onPressed: _userResponses[_currentStepIndex].isNotEmpty || + _currentStep.options.isEmpty + ? _nextStep + : null, + child: Text( + _currentStepIndex == widget.scenario.steps.length - 1 + ? '完成练习' + : '下一步', + ), + ), + ), + ], + ), + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/screens/speaking_conversation_screen.dart b/client/lib/features/speaking/screens/speaking_conversation_screen.dart new file mode 100644 index 0000000..4992187 --- /dev/null +++ b/client/lib/features/speaking/screens/speaking_conversation_screen.dart @@ -0,0 +1,537 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../models/speaking_scenario.dart'; +import '../models/conversation.dart'; +import '../providers/speaking_provider.dart'; + +class SpeakingConversationScreen extends StatefulWidget { + final SpeakingTask task; + + const SpeakingConversationScreen({ + super.key, + required this.task, + }); + + @override + State createState() => _SpeakingConversationScreenState(); +} + +class _SpeakingConversationScreenState extends State { + final ScrollController _scrollController = ScrollController(); + final TextEditingController _textController = TextEditingController(); + bool _isTextMode = false; + + @override + void initState() { + super.initState(); + WidgetsBinding.instance.addPostFrameCallback((_) { + context.read().startConversation(widget.task.id); + }); + } + + @override + void dispose() { + _scrollController.dispose(); + _textController.dispose(); + super.dispose(); + } + + void _scrollToBottom() { + WidgetsBinding.instance.addPostFrameCallback((_) { + if (_scrollController.hasClients) { + _scrollController.animateTo( + _scrollController.position.maxScrollExtent, + duration: const Duration(milliseconds: 300), + curve: Curves.easeOut, + ); + } + }); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: Text(widget.task.title), + actions: [ + Consumer( + builder: (context, provider, child) { + return IconButton( + icon: Icon( + provider.currentConversation?.status == ConversationStatus.active + ? Icons.pause + : Icons.stop, + ), + onPressed: () { + if (provider.currentConversation?.status == ConversationStatus.active) { + provider.pauseConversation(); + } else { + _showEndConversationDialog(); + } + }, + ); + }, + ), + ], + ), + body: Consumer( + builder: (context, provider, child) { + final conversation = provider.currentConversation; + + if (conversation == null) { + return const Center( + child: CircularProgressIndicator(), + ); + } + + return Column( + children: [ + // 任务信息卡片 + _buildTaskInfoCard(), + + // 对话状态指示器 + _buildStatusIndicator(conversation.status), + + // 消息列表 + Expanded( + child: _buildMessageList(conversation.messages), + ), + + // 输入区域 + _buildInputArea(provider), + ], + ); + }, + ), + ); + } + + Widget _buildTaskInfoCard() { + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Theme.of(context).primaryColor.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: Theme.of(context).primaryColor.withOpacity(0.3), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.chat, + color: Theme.of(context).primaryColor, + size: 20, + ), + const SizedBox(width: 8), + Text( + widget.task.scenario.displayName, + style: TextStyle( + color: Theme.of(context).primaryColor, + fontWeight: FontWeight.bold, + ), + ), + const Spacer(), + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.2), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + widget.task.difficulty.displayName, + style: TextStyle( + color: Colors.blue, + fontSize: 12, + fontWeight: FontWeight.w500, + ), + ), + ), + ], + ), + const SizedBox(height: 8), + Text( + widget.task.description, + style: TextStyle( + color: Colors.grey[700], + fontSize: 14, + ), + ), + if (widget.task.objectives.isNotEmpty) ...[ + const SizedBox(height: 8), + Text( + '目标: ${widget.task.objectives.join('、')}', + style: TextStyle( + color: Colors.grey[600], + fontSize: 12, + ), + ), + ] + ], + ), + ); + } + + Widget _buildStatusIndicator(ConversationStatus status) { + Color statusColor; + String statusText; + IconData statusIcon; + + switch (status) { + case ConversationStatus.active: + statusColor = Colors.green; + statusText = '对话进行中'; + statusIcon = Icons.mic; + break; + case ConversationStatus.paused: + statusColor = Colors.orange; + statusText = '对话已暂停'; + statusIcon = Icons.pause; + break; + case ConversationStatus.completed: + statusColor = Colors.blue; + statusText = '对话已完成'; + statusIcon = Icons.check_circle; + break; + case ConversationStatus.cancelled: + statusColor = Colors.red; + statusText = '对话已取消'; + statusIcon = Icons.cancel; + break; + } + + return Container( + padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8), + color: statusColor.withOpacity(0.1), + child: Row( + children: [ + Icon( + statusIcon, + color: statusColor, + size: 16, + ), + const SizedBox(width: 8), + Text( + statusText, + style: TextStyle( + color: statusColor, + fontSize: 12, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ); + } + + Widget _buildMessageList(List messages) { + WidgetsBinding.instance.addPostFrameCallback((_) => _scrollToBottom()); + + return ListView.builder( + controller: _scrollController, + padding: const EdgeInsets.symmetric(horizontal: 16), + itemCount: messages.length, + itemBuilder: (context, index) { + final message = messages[index]; + return _buildMessageBubble(message); + }, + ); + } + + Widget _buildMessageBubble(ConversationMessage message) { + final isUser = message.type == MessageType.user; + + return Container( + margin: const EdgeInsets.symmetric(vertical: 4), + child: Row( + mainAxisAlignment: isUser ? MainAxisAlignment.end : MainAxisAlignment.start, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + if (!isUser) ...[ + CircleAvatar( + radius: 16, + backgroundColor: Theme.of(context).primaryColor, + child: const Icon( + Icons.smart_toy, + color: Colors.white, + size: 16, + ), + ), + const SizedBox(width: 8), + ], + Flexible( + child: Container( + padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 12), + decoration: BoxDecoration( + color: isUser + ? Theme.of(context).primaryColor + : Colors.grey[200], + borderRadius: BorderRadius.circular(18).copyWith( + bottomLeft: isUser ? const Radius.circular(18) : const Radius.circular(4), + bottomRight: isUser ? const Radius.circular(4) : const Radius.circular(18), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + message.content, + style: TextStyle( + color: isUser ? Colors.white : Colors.black87, + fontSize: 16, + ), + ), + const SizedBox(height: 4), + Row( + mainAxisSize: MainAxisSize.min, + children: [ + if (message.audioUrl != null) + Icon( + Icons.volume_up, + size: 12, + color: isUser ? Colors.white70 : Colors.grey[600], + ), + if (message.audioUrl != null) const SizedBox(width: 4), + Text( + _formatTime(message.timestamp), + style: TextStyle( + color: isUser ? Colors.white70 : Colors.grey[600], + fontSize: 10, + ), + ), + if (message.confidence != null && isUser) ...[ + const SizedBox(width: 8), + Icon( + Icons.mic, + size: 12, + color: _getConfidenceColor(message.confidence!), + ), + const SizedBox(width: 2), + Text( + '${(message.confidence! * 100).toInt()}%', + style: TextStyle( + color: _getConfidenceColor(message.confidence!), + fontSize: 10, + ), + ), + ] + ], + ), + ], + ), + ), + ), + if (isUser) ...[ + const SizedBox(width: 8), + CircleAvatar( + radius: 16, + backgroundColor: Colors.grey[300], + child: Icon( + Icons.person, + color: Colors.grey[600], + size: 16, + ), + ), + ] + ], + ), + ); + } + + Widget _buildInputArea(SpeakingProvider provider) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Theme.of(context).cardColor, + border: Border( + top: BorderSide( + color: Colors.grey.withOpacity(0.2), + ), + ), + ), + child: Column( + children: [ + // 模式切换 + Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + SegmentedButton( + segments: const [ + ButtonSegment( + value: false, + label: Text('语音'), + icon: Icon(Icons.mic), + ), + ButtonSegment( + value: true, + label: Text('文字'), + icon: Icon(Icons.keyboard), + ), + ], + selected: {_isTextMode}, + onSelectionChanged: (Set selection) { + setState(() { + _isTextMode = selection.first; + }); + }, + ), + ], + ), + const SizedBox(height: 16), + + // 输入控件 + if (_isTextMode) + _buildTextInput(provider) + else + _buildVoiceInput(provider), + ], + ), + ); + } + + Widget _buildTextInput(SpeakingProvider provider) { + return Row( + children: [ + Expanded( + child: TextField( + controller: _textController, + decoration: InputDecoration( + hintText: '输入你的回复...', + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(24), + ), + contentPadding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 12, + ), + ), + maxLines: null, + textInputAction: TextInputAction.send, + onSubmitted: (text) => _sendTextMessage(provider, text), + ), + ), + const SizedBox(width: 8), + FloatingActionButton( + mini: true, + onPressed: () => _sendTextMessage(provider, _textController.text), + child: const Icon(Icons.send), + ), + ], + ); + } + + Widget _buildVoiceInput(SpeakingProvider provider) { + return Column( + children: [ + // 录音按钮 + GestureDetector( + onTapDown: (_) => provider.startRecording(), + onTapUp: (_) => provider.stopRecording(), + onTapCancel: () => provider.stopRecording(), + child: Container( + width: 80, + height: 80, + decoration: BoxDecoration( + color: provider.isRecording + ? Colors.red + : Theme.of(context).primaryColor, + shape: BoxShape.circle, + boxShadow: [ + BoxShadow( + color: (provider.isRecording ? Colors.red : Theme.of(context).primaryColor) + .withOpacity(0.3), + blurRadius: 10, + spreadRadius: provider.isRecording ? 5 : 0, + ), + ], + ), + child: Icon( + provider.isRecording ? Icons.stop : Icons.mic, + color: Colors.white, + size: 32, + ), + ), + ), + const SizedBox(height: 16), + + // 录音提示 + Text( + provider.isRecording ? '松开发送' : '按住说话', + style: TextStyle( + color: Colors.grey[600], + fontSize: 14, + ), + ), + + // 录音时长 + if (provider.isRecording) + Padding( + padding: const EdgeInsets.only(top: 8), + child: Text( + _formatRecordingDuration(const Duration(seconds: 0)), + style: const TextStyle( + color: Colors.red, + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ) + ], + ); + } + + void _sendTextMessage(SpeakingProvider provider, String text) { + if (text.trim().isEmpty) return; + + provider.sendMessage(text.trim()); + _textController.clear(); + } + + void _showEndConversationDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('结束对话'), + content: const Text('确定要结束当前对话吗？对话记录将被保存。'), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + TextButton( + onPressed: () { + Navigator.pop(context); + context.read().endConversation(); + Navigator.pop(context); + }, + child: const Text('确定'), + ), + ], + ), + ); + } + + String _formatTime(DateTime time) { + return '${time.hour.toString().padLeft(2, '0')}:${time.minute.toString().padLeft(2, '0')}'; + } + + String _formatRecordingDuration(Duration duration) { + final minutes = duration.inMinutes; + final seconds = duration.inSeconds % 60; + return '${minutes.toString().padLeft(2, '0')}:${seconds.toString().padLeft(2, '0')}'; + } + + Color _getConfidenceColor(double confidence) { + if (confidence >= 0.8) { + return Colors.green; + } else if (confidence >= 0.6) { + return Colors.orange; + } else { + return Colors.red; + } + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/screens/speaking_history_screen.dart b/client/lib/features/speaking/screens/speaking_history_screen.dart new file mode 100644 index 0000000..fc006e4 --- /dev/null +++ b/client/lib/features/speaking/screens/speaking_history_screen.dart @@ -0,0 +1,676 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../models/conversation.dart'; +import '../models/speaking_scenario.dart'; +import '../providers/speaking_provider.dart'; + +class SpeakingHistoryScreen extends StatefulWidget { + const SpeakingHistoryScreen({super.key}); + + @override + State createState() => _SpeakingHistoryScreenState(); +} + +class _SpeakingHistoryScreenState extends State { + String _selectedFilter = 'all'; + String _searchQuery = ''; + final TextEditingController _searchController = TextEditingController(); + List _conversations = []; + bool _isLoading = false; + String? _error; + + @override + void initState() { + super.initState(); + _loadConversations(); + } + + Future _loadConversations() async { + setState(() { + _isLoading = true; + _error = null; + }); + + try { + final conversations = await context.read().loadConversationHistory(); + setState(() { + _conversations = conversations; + _isLoading = false; + }); + } catch (e) { + setState(() { + _error = e.toString(); + _isLoading = false; + }); + } + } + + @override + void dispose() { + _searchController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('对话历史'), + actions: [ + IconButton( + icon: const Icon(Icons.search), + onPressed: _showSearchDialog, + ), + ], + ), + body: Column( + children: [ + // 筛选器 + _buildFilterBar(), + + // 历史列表 + Expanded( + child: _isLoading + ? const Center(child: CircularProgressIndicator()) + : _error != null + ? _buildErrorState(_error!, _loadConversations) + : _conversations.isEmpty + ? _buildEmptyState() + : _buildHistoryList(_filterHistory(_conversations)), + ), + ], + ), + ); + } + + Widget _buildFilterBar() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Theme.of(context).cardColor, + border: Border( + bottom: BorderSide( + color: Colors.grey.withOpacity(0.2), + ), + ), + ), + child: Row( + children: [ + Expanded( + child: SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + _buildFilterChip('all', '全部'), + const SizedBox(width: 8), + _buildFilterChip('completed', '已完成'), + const SizedBox(width: 8), + _buildFilterChip('today', '今天'), + const SizedBox(width: 8), + _buildFilterChip('week', '本周'), + const SizedBox(width: 8), + _buildFilterChip('month', '本月'), + ], + ), + ), + ), + if (_searchQuery.isNotEmpty) + Padding( + padding: const EdgeInsets.only(left: 8), + child: IconButton( + icon: const Icon(Icons.clear), + onPressed: () { + setState(() { + _searchQuery = ''; + _searchController.clear(); + }); + }, + ), + ), + ], + ), + ); + } + + Widget _buildFilterChip(String value, String label) { + final isSelected = _selectedFilter == value; + + return FilterChip( + label: Text(label), + selected: isSelected, + onSelected: (selected) { + setState(() { + _selectedFilter = value; + }); + }, + selectedColor: Theme.of(context).primaryColor.withOpacity(0.2), + checkmarkColor: Theme.of(context).primaryColor, + ); + } + + Widget _buildHistoryList(List conversations) { + return ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: conversations.length, + itemBuilder: (context, index) { + final conversation = conversations[index]; + return _buildConversationCard(conversation); + }, + ); + } + + Widget _buildConversationCard(Conversation conversation) { + return Card( + margin: const EdgeInsets.only(bottom: 12), + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: InkWell( + onTap: () => _showConversationDetail(conversation), + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题行 + Row( + children: [ + Container( + padding: const EdgeInsets.all(8), + decoration: BoxDecoration( + color: _getStatusColor(conversation.status).withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Icon( + _getStatusIcon(conversation.status), + color: _getStatusColor(conversation.status), + size: 16, + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '对话练习', + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + _formatDateTime(conversation.startTime), + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ), + Icon( + Icons.arrow_forward_ios, + size: 16, + color: Colors.grey[400], + ), + ], + ), + const SizedBox(height: 12), + + // 统计信息 + Row( + children: [ + _buildStatChip( + Icons.chat_bubble_outline, + '${conversation.messages.length} 条消息', + Colors.blue, + ), + const SizedBox(width: 12), + _buildStatChip( + Icons.access_time, + _formatDuration(conversation.totalDuration ~/ 60), + Colors.green, + ), + + ], + ), + + // 最后一条消息预览 + if (conversation.messages.isNotEmpty) + Padding( + padding: const EdgeInsets.only(top: 12), + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Icon( + conversation.messages.last.type == MessageType.user + ? Icons.person + : Icons.smart_toy, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 8), + Expanded( + child: Text( + conversation.messages.last.content, + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ), + ], + ), + ), + ), + ], + ), + ), + ), + ); + } + + Widget _buildStatChip(IconData icon, String text, Color color) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + icon, + size: 12, + color: color, + ), + const SizedBox(width: 4), + Text( + text, + style: TextStyle( + fontSize: 12, + color: color, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ); + } + + Widget _buildEmptyState() { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.history, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '还没有对话记录', + style: TextStyle( + fontSize: 18, + color: Colors.grey[600], + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 8), + Text( + '开始你的第一次口语练习吧！', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + ), + ], + ), + ); + } + + Widget _buildErrorState(String error, VoidCallback? retry) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '加载失败', + style: TextStyle( + fontSize: 18, + color: Colors.grey[600], + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 8), + Text( + error, + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + textAlign: TextAlign.center, + ), + if (retry != null) + Padding( + padding: const EdgeInsets.only(top: 16), + child: ElevatedButton( + onPressed: retry, + child: const Text('重试'), + ), + ), + ], + ), + ); + } + + List _filterHistory(List conversations) { + var filtered = conversations; + + // 按状态筛选 + if (_selectedFilter == 'completed') { + filtered = filtered.where((c) => c.status == ConversationStatus.completed).toList(); + } + + // 按时间筛选 + final now = DateTime.now(); + if (_selectedFilter == 'today') { + filtered = filtered.where((c) { + final startOfDay = DateTime(now.year, now.month, now.day); + return c.startTime.isAfter(startOfDay); + }).toList(); + } else if (_selectedFilter == 'week') { + final startOfWeek = now.subtract(Duration(days: now.weekday - 1)); + final startOfWeekDay = DateTime(startOfWeek.year, startOfWeek.month, startOfWeek.day); + filtered = filtered.where((c) => c.startTime.isAfter(startOfWeekDay)).toList(); + } else if (_selectedFilter == 'month') { + final startOfMonth = DateTime(now.year, now.month, 1); + filtered = filtered.where((c) => c.startTime.isAfter(startOfMonth)).toList(); + } + + // 按搜索关键词筛选 + if (_searchQuery.isNotEmpty) { + filtered = filtered.where((c) { + final query = _searchQuery.toLowerCase(); + return c.messages.any((m) => m.content.toLowerCase().contains(query)); + }).toList(); + } + + // 按时间倒序排列 + filtered.sort((a, b) => b.startTime.compareTo(a.startTime)); + + return filtered; + } + + void _showSearchDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('搜索对话'), + content: TextField( + controller: _searchController, + decoration: const InputDecoration( + hintText: '输入关键词...', + border: OutlineInputBorder(), + ), + autofocus: true, + onSubmitted: (value) { + setState(() { + _searchQuery = value; + }); + Navigator.pop(context); + }, + ), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + TextButton( + onPressed: () { + setState(() { + _searchQuery = _searchController.text; + }); + Navigator.pop(context); + }, + child: const Text('搜索'), + ), + ], + ), + ); + } + + void _showConversationDetail(Conversation conversation) { + showModalBottomSheet( + context: context, + isScrollControlled: true, + shape: const RoundedRectangleBorder( + borderRadius: BorderRadius.vertical(top: Radius.circular(20)), + ), + builder: (context) => DraggableScrollableSheet( + initialChildSize: 0.7, + maxChildSize: 0.9, + minChildSize: 0.5, + builder: (context, scrollController) { + return Container( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 拖拽指示器 + Center( + child: Container( + width: 40, + height: 4, + decoration: BoxDecoration( + color: Colors.grey[300], + borderRadius: BorderRadius.circular(2), + ), + ), + ), + const SizedBox(height: 16), + + // 标题 + Text( + '对话详情', + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + + // 基本信息 + Row( + children: [ + Text( + _formatDateTime(conversation.startTime), + style: TextStyle( + color: Colors.grey[600], + fontSize: 14, + ), + ), + const SizedBox(width: 16), + Text( + _formatDuration(conversation.totalDuration ~/ 60), + style: TextStyle( + color: Colors.grey[600], + fontSize: 14, + ), + ), + + ], + ), + const SizedBox(height: 16), + + // 消息列表 + Expanded( + child: ListView.builder( + controller: scrollController, + itemCount: conversation.messages.length, + itemBuilder: (context, index) { + final message = conversation.messages[index]; + return _buildMessageItem(message); + }, + ), + ), + ], + ), + ); + }, + ), + ); + } + + Widget _buildMessageItem(ConversationMessage message) { + final isUser = message.type == MessageType.user; + + return Container( + margin: const EdgeInsets.symmetric(vertical: 4), + child: Row( + mainAxisAlignment: isUser ? MainAxisAlignment.end : MainAxisAlignment.start, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + if (!isUser) + Padding( + padding: const EdgeInsets.only(right: 8), + child: CircleAvatar( + radius: 16, + backgroundColor: Theme.of(context).primaryColor, + child: const Icon( + Icons.smart_toy, + color: Colors.white, + size: 16, + ), + ), + ), + Flexible( + child: Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8), + decoration: BoxDecoration( + color: isUser + ? Theme.of(context).primaryColor + : Colors.grey[200], + borderRadius: BorderRadius.circular(12).copyWith( + bottomLeft: isUser ? const Radius.circular(12) : const Radius.circular(4), + bottomRight: isUser ? const Radius.circular(4) : const Radius.circular(12), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + message.content, + style: TextStyle( + color: isUser ? Colors.white : Colors.black87, + fontSize: 14, + ), + ), + const SizedBox(height: 4), + Text( + _formatTime(message.timestamp), + style: TextStyle( + color: isUser ? Colors.white70 : Colors.grey[600], + fontSize: 10, + ), + ), + ], + ), + ), + ), + if (isUser) + Padding( + padding: const EdgeInsets.only(left: 8), + child: CircleAvatar( + radius: 16, + backgroundColor: Colors.grey[300], + child: Icon( + Icons.person, + color: Colors.grey[600], + size: 16, + ), + ), + ), + ], + ), + ); + } + + Color _getStatusColor(ConversationStatus status) { + switch (status) { + case ConversationStatus.active: + return Colors.green; + case ConversationStatus.paused: + return Colors.orange; + case ConversationStatus.completed: + return Colors.blue; + case ConversationStatus.cancelled: + return Colors.red; + } + } + + IconData _getStatusIcon(ConversationStatus status) { + switch (status) { + case ConversationStatus.active: + return Icons.play_circle; + case ConversationStatus.paused: + return Icons.pause_circle; + case ConversationStatus.completed: + return Icons.check_circle; + case ConversationStatus.cancelled: + return Icons.cancel; + } + } + + String _formatDateTime(DateTime dateTime) { + final now = DateTime.now(); + final difference = now.difference(dateTime); + + if (difference.inDays == 0) { + return '今天 ${_formatTime(dateTime)}'; + } else if (difference.inDays == 1) { + return '昨天 ${_formatTime(dateTime)}'; + } else if (difference.inDays < 7) { + return '${difference.inDays}天前'; + } else { + return '${dateTime.month}/${dateTime.day} ${_formatTime(dateTime)}'; + } + } + + String _formatTime(DateTime time) { + return '${time.hour.toString().padLeft(2, '0')}:${time.minute.toString().padLeft(2, '0')}'; + } + + String _formatDuration(int minutes) { + if (minutes < 60) { + return '${minutes}分钟'; + } else { + final hours = minutes ~/ 60; + final remainingMinutes = minutes % 60; + if (remainingMinutes == 0) { + return '${hours}小时'; + } else { + return '${hours}小时${remainingMinutes}分钟'; + } + } + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/screens/speaking_home_screen.dart b/client/lib/features/speaking/screens/speaking_home_screen.dart new file mode 100644 index 0000000..369c194 --- /dev/null +++ b/client/lib/features/speaking/screens/speaking_home_screen.dart @@ -0,0 +1,565 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/ai_tutor.dart'; +import '../data/ai_tutor_data.dart'; +import '../screens/ai_conversation_screen.dart'; +import '../models/conversation_scenario.dart'; +import '../data/scenario_data.dart'; +import '../providers/speaking_provider.dart'; +import '../screens/scenario_practice_screen.dart'; +import '../models/pronunciation_item.dart'; +import '../screens/pronunciation_list_screen.dart'; +import '../models/pronunciation_assessment.dart'; + +/// 口语练习主页面 +class SpeakingHomeScreen extends ConsumerStatefulWidget { + const SpeakingHomeScreen({super.key}); + + @override + ConsumerState createState() => _SpeakingHomeScreenState(); +} + +class _SpeakingHomeScreenState extends ConsumerState { + @override + void initState() { + super.initState(); + // 加载推荐场景 + WidgetsBinding.instance.addPostFrameCallback((_) { + ref.read(speakingTasksProvider.notifier).loadRecommendedTasks(); + }); + } + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + backgroundColor: Colors.transparent, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back, color: Colors.black87), + onPressed: () => Navigator.of(context).pop(), + ), + title: const Text( + '口语练习', + style: TextStyle( + color: Colors.black87, + fontSize: 18, + fontWeight: FontWeight.w600, + ), + ), + centerTitle: true, + ), + body: SingleChildScrollView( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildAITutors(), + const SizedBox(height: 20), + _buildScenarios(), + const SizedBox(height: 20), + _buildPronunciationPractice(), + const SizedBox(height: 20), + _buildSpeakingProgress(), + const SizedBox(height: 100), // 底部导航栏空间 + ], + ), + ), + ), + ); + } + + Widget _buildAITutors() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + 'AI对话伙伴', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + GridView.builder( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount( + crossAxisCount: 2, + crossAxisSpacing: 12, + mainAxisSpacing: 12, + childAspectRatio: 1.2, + ), + itemCount: AITutorData.getAllTutors().length, + itemBuilder: (context, index) { + final tutor = AITutorData.getAllTutors()[index]; + return _buildTutorCard(tutor); + }, + ), + ], + ), + ); + } + + Widget _buildTutorCard(AITutor tutor) { + return GestureDetector( + onTap: () { + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => AIConversationScreen(tutor: tutor), + ), + ); + }, + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: tutor.type.color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: tutor.type.color.withOpacity(0.3)), + ), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Text( + tutor.avatar, + style: const TextStyle(fontSize: 32), + ), + const SizedBox(height: 8), + Text( + tutor.type.displayName, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: tutor.type.color, + ), + ), + const SizedBox(height: 4), + Text( + tutor.type.description, + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ); + } + + Widget _buildScenarios() { + final tasksState = ref.watch(speakingTasksProvider); + + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '对话场景', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + tasksState.isLoading + ? const Center( + child: Padding( + padding: EdgeInsets.all(20.0), + child: CircularProgressIndicator(), + ), + ) + : tasksState.error != null + ? Center( + child: Column( + children: [ + Text( + '加载失败: ${tasksState.error}', + style: const TextStyle(color: Colors.red), + ), + const SizedBox(height: 8), + TextButton( + onPressed: () { + ref.read(speakingTasksProvider.notifier).loadRecommendedTasks(); + }, + child: const Text('重试'), + ), + ], + ), + ) + : tasksState.tasks.isEmpty + ? Center( + child: Column( + children: [ + Icon( + Icons.chat_bubble_outline, + size: 48, + color: Colors.grey[400], + ), + const SizedBox(height: 12), + Text( + '暂无可用场景', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + Text( + '使用静态数据作为备选', + style: TextStyle( + fontSize: 12, + color: Colors.grey[500], + ), + ), + ], + ), + ) + : Column( + children: tasksState.tasks.take(5).map((task) { + // 将SpeakingTask转换为ConversationScenario显示 + final scenario = ConversationScenario( + id: task.id, + title: task.title, + subtitle: task.description, + description: task.description, + duration: '${task.estimatedDuration}分钟', + level: _mapDifficultyToLevel(task.difficulty.name), + type: ScenarioType.business, + objectives: task.objectives, + keyPhrases: task.keyPhrases, + steps: [], + createdAt: task.createdAt, + ); + return Padding( + padding: const EdgeInsets.only(bottom: 12), + child: _buildScenarioItem(scenario), + ); + }).toList(), + ), + ], + ), + ); + } + + Widget _buildScenarioItem(ConversationScenario scenario) { + return GestureDetector( + onTap: () { + Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => ScenarioPracticeScreen(scenario: scenario), + ), + ); + }, + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Container( + width: 40, + height: 40, + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(20), + ), + child: Center( + child: Text( + scenario.type.icon, + style: const TextStyle(fontSize: 20), + ), + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + scenario.title, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + ), + ), + Text( + scenario.subtitle, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ), + ), + Column( + children: [ + Text( + scenario.duration, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + Container( + padding: const EdgeInsets.symmetric(horizontal: 6, vertical: 2), + decoration: BoxDecoration( + color: const Color(0xFF2196F3), + borderRadius: BorderRadius.circular(4), + ), + child: Text( + scenario.level, + style: const TextStyle( + fontSize: 10, + color: Colors.white, + ), + ), + ), + ], + ), + ], + ), + ), + ); + } + + Widget _buildPronunciationPractice() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '发音练习', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildPronunciationCard( + '单词发音', + '音素练习', + Icons.hearing, + Colors.blue, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildPronunciationCard( + '句子朗读', + '语调练习', + Icons.graphic_eq, + Colors.green, + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildPronunciationCard( + String title, + String subtitle, + IconData icon, + Color color, + ) { + return GestureDetector( + onTap: () { + PronunciationType type; + if (title == '单词发音') { + type = PronunciationType.word; + } else { + type = PronunciationType.sentence; + } + + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => PronunciationListScreen(type: type), + ), + ); + }, + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: color.withOpacity(0.3)), + ), + child: Column( + children: [ + Icon( + icon, + color: color, + size: 32, + ), + const SizedBox(height: 8), + Text( + title, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: color, + ), + ), + const SizedBox(height: 4), + Text( + subtitle, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ); + } + + Widget _buildSpeakingProgress() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '口语统计', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Consumer( + builder: (context, ref, _) { + final service = ref.watch(speakingServiceProvider); + return FutureBuilder( + future: service.getUserSpeakingStatistics(), + builder: (context, snapshot) { + if (!snapshot.hasData) { + return const Center(child: CircularProgressIndicator()); + } + final stats = snapshot.data!.data; + return Row( + mainAxisAlignment: MainAxisAlignment.spaceAround, + children: [ + _buildProgressItem('${stats?.totalSessions ?? 0}', '对话次数', Icons.chat_bubble), + _buildProgressItem('${stats != null ? stats.skillAnalysis.criteriaScores[PronunciationCriteria.accuracy]?.toStringAsFixed(0) ?? '0' : '0'}%', '发音准确度', Icons.mic), + _buildProgressItem('${stats?.averageScore.toStringAsFixed(0) ?? '0'}', '平均分', Icons.trending_up), + ], + ); + }, + ); + }, + ), + ], + ), + ); + } + + Widget _buildProgressItem(String value, String label, IconData icon) { + return Column( + children: [ + Icon( + icon, + color: const Color(0xFF2196F3), + size: 24, + ), + const SizedBox(height: 8), + Text( + value, + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + const SizedBox(height: 4), + Text( + label, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ); + } + + String _mapDifficultyToLevel(String? difficulty) { + if (difficulty == null) return 'B1'; + switch (difficulty.toLowerCase()) { + case 'beginner': + case 'elementary': + return 'A1'; + case 'intermediate': + return 'B1'; + case 'upper-intermediate': + case 'upperintermediate': + return 'B2'; + case 'advanced': + return 'C1'; + default: + return 'B1'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/screens/speaking_result_screen.dart b/client/lib/features/speaking/screens/speaking_result_screen.dart new file mode 100644 index 0000000..91862b3 --- /dev/null +++ b/client/lib/features/speaking/screens/speaking_result_screen.dart @@ -0,0 +1,746 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../providers/speaking_provider.dart'; + +class SpeakingResultScreen extends StatefulWidget { + final Map evaluation; + final String conversationId; + + const SpeakingResultScreen({ + super.key, + required this.evaluation, + required this.conversationId, + }); + + @override + State createState() => _SpeakingResultScreenState(); +} + +class _SpeakingResultScreenState extends State + with TickerProviderStateMixin { + late AnimationController _animationController; + late Animation _fadeAnimation; + late Animation _slideAnimation; + + bool _showDetails = false; + + @override + void initState() { + super.initState(); + _animationController = AnimationController( + duration: const Duration(milliseconds: 800), + vsync: this, + ); + + _fadeAnimation = Tween( + begin: 0.0, + end: 1.0, + ).animate(CurvedAnimation( + parent: _animationController, + curve: Curves.easeInOut, + )); + + _slideAnimation = Tween( + begin: const Offset(0, 0.3), + end: Offset.zero, + ).animate(CurvedAnimation( + parent: _animationController, + curve: Curves.easeOutBack, + )); + + _animationController.forward(); + } + + @override + void dispose() { + _animationController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('练习结果'), + actions: [ + IconButton( + icon: const Icon(Icons.share), + onPressed: _shareResult, + ), + ], + ), + body: AnimatedBuilder( + animation: _animationController, + builder: (context, child) { + return FadeTransition( + opacity: _fadeAnimation, + child: SlideTransition( + position: _slideAnimation, + child: _buildContent(), + ), + ); + }, + ), + bottomNavigationBar: _buildBottomActions(), + ); + } + + Widget _buildContent() { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 总分卡片 + _buildOverallScoreCard(), + const SizedBox(height: 20), + + // 详细评分 + _buildDetailedScores(), + const SizedBox(height: 20), + + // 反馈和建议 + _buildFeedbackSection(), + const SizedBox(height: 20), + + // 进步对比 + _buildProgressComparison(), + const SizedBox(height: 20), + + // 录音回放 + _buildAudioPlayback(), + const SizedBox(height: 100), // 为底部按钮留空间 + ], + ), + ); + } + + Widget _buildOverallScoreCard() { + return Container( + width: double.infinity, + padding: const EdgeInsets.all(24), + decoration: BoxDecoration( + gradient: LinearGradient( + begin: Alignment.topLeft, + end: Alignment.bottomRight, + colors: [ + _getScoreColor(widget.evaluation['overallScore'] as double? ?? 0.0), + _getScoreColor(widget.evaluation['overallScore'] as double? ?? 0.0).withOpacity(0.8), + ], + ), + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: _getScoreColor(widget.evaluation['overallScore'] as double? ?? 0.0).withOpacity(0.3), + blurRadius: 20, + offset: const Offset(0, 8), + ), + ], + ), + child: Column( + children: [ + const Text( + '总体评分', + style: TextStyle( + color: Colors.white, + fontSize: 16, + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 12), + Text( + '${(widget.evaluation['overallScore'] as double? ?? 0.0).toStringAsFixed(1)}', + style: const TextStyle( + color: Colors.white, + fontSize: 48, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + Text( + _getScoreLevel(widget.evaluation['overallScore'] as double? ?? 0.0), + style: const TextStyle( + color: Colors.white, + fontSize: 18, + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 16), + Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + _getScoreIcon(widget.evaluation['overallScore'] as double? ?? 0.0), + color: Colors.white, + size: 24, + ), + const SizedBox(width: 8), + Text( + _getScoreMessage(widget.evaluation['overallScore'] as double? ?? 0.0), + style: const TextStyle( + color: Colors.white, + fontSize: 14, + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildDetailedScores() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '详细评分', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + TextButton( + onPressed: () { + setState(() { + _showDetails = !_showDetails; + }); + }, + child: Text( + _showDetails ? '收起' : '展开', + style: TextStyle( + color: Theme.of(context).primaryColor, + ), + ), + ), + ], + ), + const SizedBox(height: 16), + ...(widget.evaluation['criteriaScores'] as Map? ?? {}).entries.map( + (entry) => _buildScoreItem( + _getCriteriaDisplayName(entry.key.toString()), + entry.value, + ), + ), + if (_showDetails) ...[ + const SizedBox(height: 16), + const Divider(), + const SizedBox(height: 16), + _buildDetailedAnalysis(), + ], + ], + ), + ); + } + + Widget _buildScoreItem(String title, double score) { + final percentage = score / 100; + + return Padding( + padding: const EdgeInsets.symmetric(vertical: 8), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + title, + style: const TextStyle( + fontWeight: FontWeight.w500, + ), + ), + Text( + '${score.toStringAsFixed(1)}分', + style: TextStyle( + fontWeight: FontWeight.w600, + color: _getScoreColor(score), + ), + ), + ], + ), + const SizedBox(height: 8), + LinearProgressIndicator( + value: percentage, + backgroundColor: Colors.grey[200], + valueColor: AlwaysStoppedAnimation( + _getScoreColor(score), + ), + ), + ], + ), + ); + } + + Widget _buildDetailedAnalysis() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '详细分析', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + if ((widget.evaluation['strengths'] as List? ?? []).isNotEmpty) ...[ + _buildAnalysisSection( + '表现优秀', + widget.evaluation['strengths'] as List? ?? [], + Colors.green, + Icons.check_circle, + ), + const SizedBox(height: 12), + ], + if ((widget.evaluation['weaknesses'] as List? ?? []).isNotEmpty) ...[ + _buildAnalysisSection( + '需要改进', + widget.evaluation['weaknesses'] as List? ?? [], + Colors.orange, + Icons.warning, + ), + const SizedBox(height: 12), + ], + if ((widget.evaluation['commonErrors'] as List? ?? []).isNotEmpty) + _buildAnalysisSection( + '常见错误', + widget.evaluation['commonErrors'] as List? ?? [], + Colors.red, + Icons.error, + ), + ], + ); + } + + Widget _buildAnalysisSection( + String title, + List items, + Color color, + IconData icon, + ) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + icon, + color: color, + size: 16, + ), + const SizedBox(width: 8), + Text( + title, + style: TextStyle( + fontWeight: FontWeight.w600, + color: color, + ), + ), + ], + ), + const SizedBox(height: 8), + ...items.map((item) => Padding( + padding: const EdgeInsets.symmetric(vertical: 2), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Container( + margin: const EdgeInsets.only(top: 6), + width: 4, + height: 4, + decoration: BoxDecoration( + color: color, + shape: BoxShape.circle, + ), + ), + const SizedBox(width: 8), + Expanded( + child: Text( + item, + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + ), + ), + ], + ), + )), + ], + ); + } + + Widget _buildFeedbackSection() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '改进建议', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + if ((widget.evaluation['suggestions'] as List? ?? []).isNotEmpty) + ...(widget.evaluation['suggestions'] as List? ?? []).map( + (suggestion) => _buildSuggestionItem(suggestion), + ) + else + const Text( + '表现很好，继续保持！', + style: TextStyle( + color: Colors.grey, + fontStyle: FontStyle.italic, + ), + ), + ], + ), + ); + } + + Widget _buildSuggestionItem(String suggestion) { + return Container( + margin: const EdgeInsets.only(bottom: 12), + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.blue[50], + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: Colors.blue[200]!, + width: 1, + ), + ), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Icon( + Icons.lightbulb_outline, + color: Colors.blue[600], + size: 20, + ), + const SizedBox(width: 12), + Expanded( + child: Text( + suggestion, + style: TextStyle( + fontSize: 14, + color: Colors.blue[800], + ), + ), + ), + ], + ), + ); + } + + Widget _buildProgressComparison() { + return Consumer( + builder: (context, provider, child) { + final previousScore = _getPreviousScore(provider); + if (previousScore == null) { + return const SizedBox.shrink(); + } + + final improvement = (widget.evaluation['overallScore'] as double? ?? 0.0) - previousScore; + + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '进步对比', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildComparisonItem( + '上次得分', + previousScore.toStringAsFixed(1), + Colors.grey, + ), + ), + const SizedBox(width: 16), + Expanded( + child: _buildComparisonItem( + '本次得分', + (widget.evaluation['overallScore'] as double? ?? 0.0).toStringAsFixed(1), + _getScoreColor(widget.evaluation['overallScore'] as double? ?? 0.0), + ), + ), + const SizedBox(width: 16), + Expanded( + child: _buildComparisonItem( + '进步幅度', + '${improvement >= 0 ? '+' : ''}${improvement.toStringAsFixed(1)}', + improvement >= 0 ? Colors.green : Colors.red, + ), + ), + ], + ), + ], + ), + ); + }, + ); + } + + Widget _buildComparisonItem(String title, String value, Color color) { + return Column( + children: [ + Text( + title, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 8), + Text( + value, + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: color, + ), + textAlign: TextAlign.center, + ), + ], + ); + } + + Widget _buildAudioPlayback() { + if (widget.evaluation['audioUrl'] == null) { + return const SizedBox.shrink(); + } + + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '录音回放', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + IconButton( + onPressed: _playAudio, + icon: const Icon(Icons.play_arrow), + style: IconButton.styleFrom( + backgroundColor: Theme.of(context).primaryColor, + foregroundColor: Colors.white, + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '点击播放你的录音', + style: TextStyle( + fontWeight: FontWeight.w500, + ), + ), + Text( + '时长: ${_formatDuration(Duration(seconds: widget.evaluation['duration'] as int? ?? 0))}', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ), + IconButton( + onPressed: _downloadAudio, + icon: const Icon(Icons.download), + ), + ], + ), + ], + ), + ); + } + + Widget _buildBottomActions() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.1), + blurRadius: 10, + offset: const Offset(0, -2), + ), + ], + ), + child: Row( + children: [ + Expanded( + child: OutlinedButton( + onPressed: _practiceAgain, + child: const Text('再次练习'), + ), + ), + const SizedBox(width: 12), + Expanded( + child: ElevatedButton( + onPressed: _continueNext, + child: const Text('继续下一个'), + ), + ), + ], + ), + ); + } + + // 辅助方法 + Color _getScoreColor(double score) { + if (score >= 90) return Colors.green; + if (score >= 80) return Colors.blue; + if (score >= 70) return Colors.orange; + return Colors.red; + } + + String _getScoreLevel(double score) { + if (score >= 90) return '优秀'; + if (score >= 80) return '良好'; + if (score >= 70) return '一般'; + return '需要改进'; + } + + IconData _getScoreIcon(double score) { + if (score >= 90) return Icons.emoji_events; + if (score >= 80) return Icons.thumb_up; + if (score >= 70) return Icons.trending_up; + return Icons.trending_down; + } + + String _getScoreMessage(double score) { + if (score >= 90) return '表现出色！'; + if (score >= 80) return '表现良好！'; + if (score >= 70) return '继续努力！'; + return '需要更多练习'; + } + + String _getCriteriaDisplayName(String criteria) { + const criteriaNames = { + 'pronunciation': '发音', + 'fluency': '流利度', + 'grammar': '语法', + 'vocabulary': '词汇', + 'comprehension': '理解力', + }; + return criteriaNames[criteria] ?? criteria; + } + + double? _getPreviousScore(SpeakingProvider provider) { + // 简化实现，实际应该从历史记录中获取 + return 75.0; + } + + String _formatDuration(Duration duration) { + final minutes = duration.inMinutes; + final seconds = duration.inSeconds % 60; + return '${minutes.toString().padLeft(2, '0')}:${seconds.toString().padLeft(2, '0')}'; + } + + void _shareResult() { + // 实现分享功能 + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('分享功能开发中...')), + ); + } + + void _playAudio() { + // 实现音频播放 + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('播放录音...')), + ); + } + + void _downloadAudio() { + // 实现音频下载 + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('下载录音...')), + ); + } + + void _practiceAgain() { + Navigator.of(context).pop(); + Navigator.of(context).pop(); + } + + void _continueNext() { + Navigator.of(context).pop(); + Navigator.of(context).pop(); + // 可以导航到下一个练习 + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/screens/speaking_screen.dart b/client/lib/features/speaking/screens/speaking_screen.dart new file mode 100644 index 0000000..01595d6 --- /dev/null +++ b/client/lib/features/speaking/screens/speaking_screen.dart @@ -0,0 +1,449 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../providers/speaking_provider.dart'; +import '../models/speaking_scenario.dart'; +import 'speaking_conversation_screen.dart'; +import 'speaking_history_screen.dart'; +import 'speaking_stats_screen.dart'; + +class SpeakingScreen extends StatefulWidget { + const SpeakingScreen({super.key}); + + @override + State createState() => _SpeakingScreenState(); +} + +class _SpeakingScreenState extends State + with SingleTickerProviderStateMixin { + late TabController _tabController; + String _selectedDifficulty = 'all'; + String _selectedScenario = 'all'; + String _searchQuery = ''; + + @override + void initState() { + super.initState(); + _tabController = TabController(length: 3, vsync: this); + WidgetsBinding.instance.addPostFrameCallback((_) { + context.read().loadTasks(); + }); + } + + @override + void dispose() { + _tabController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('口语练习'), + backgroundColor: Colors.blue.shade50, + foregroundColor: Colors.blue.shade800, + elevation: 0, + bottom: TabBar( + controller: _tabController, + labelColor: Colors.blue.shade800, + unselectedLabelColor: Colors.grey, + indicatorColor: Colors.blue.shade600, + tabs: const [ + Tab( + icon: Icon(Icons.chat_bubble_outline), + text: '练习', + ), + Tab( + icon: Icon(Icons.history), + text: '历史', + ), + Tab( + icon: Icon(Icons.analytics_outlined), + text: '统计', + ), + ], + ), + ), + body: TabBarView( + controller: _tabController, + children: [ + _buildPracticeTab(), + const SpeakingHistoryScreen(), + const SpeakingStatsScreen(), + ], + ), + ); + } + + Widget _buildPracticeTab() { + return Consumer( + builder: (context, provider, child) { + if (provider.isLoading) { + return const Center( + child: CircularProgressIndicator(), + ); + } + + if (provider.error != null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 64, + color: Colors.grey.shade400, + ), + const SizedBox(height: 16), + Text( + '加载失败', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Colors.grey.shade600, + ), + ), + const SizedBox(height: 8), + Text( + provider.error!, + style: TextStyle( + color: Colors.grey.shade500, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 16), + ElevatedButton( + onPressed: () => provider.loadTasks(), + child: const Text('重试'), + ), + ], + ), + ); + } + + final filteredTasks = _filterTasks(provider.tasks); + + return Column( + children: [ + _buildFilterSection(), + Expanded( + child: filteredTasks.isEmpty + ? _buildEmptyState() + : _buildTaskList(filteredTasks), + ), + ], + ); + }, + ); + } + + Widget _buildFilterSection() { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.grey.shade200, + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + // 搜索框 + TextField( + decoration: InputDecoration( + hintText: '搜索练习内容...', + prefixIcon: const Icon(Icons.search), + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(12), + borderSide: BorderSide.none, + ), + filled: true, + fillColor: Colors.grey.shade100, + contentPadding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 12, + ), + ), + onChanged: (value) { + setState(() { + _searchQuery = value; + }); + }, + ), + const SizedBox(height: 12), + // 筛选器 + Row( + children: [ + Expanded( + child: _buildFilterDropdown( + '难度', + _selectedDifficulty, + [ + {'value': 'all', 'label': '全部'}, + {'value': 'beginner', 'label': '初级'}, + {'value': 'intermediate', 'label': '中级'}, + {'value': 'advanced', 'label': '高级'}, + ], + (value) { + setState(() { + _selectedDifficulty = value; + }); + }, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildFilterDropdown( + '场景', + _selectedScenario, + [ + {'value': 'all', 'label': '全部'}, + {'value': 'dailyConversation', 'label': '日常对话'}, + {'value': 'businessMeeting', 'label': '商务会议'}, + {'value': 'travel', 'label': '旅行'}, + {'value': 'academic', 'label': '学术讨论'}, + ], + (value) { + setState(() { + _selectedScenario = value; + }); + }, + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildFilterDropdown( + String label, + String value, + List> options, + Function(String) onChanged, + ) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 4), + decoration: BoxDecoration( + border: Border.all(color: Colors.grey.shade300), + borderRadius: BorderRadius.circular(8), + ), + child: DropdownButtonHideUnderline( + child: DropdownButton( + value: value, + isExpanded: true, + hint: Text(label), + items: options.map((option) { + return DropdownMenuItem( + value: option['value'], + child: Text(option['label']!), + ); + }).toList(), + onChanged: (newValue) { + if (newValue != null) { + onChanged(newValue); + } + }, + ), + ), + ); + } + + Widget _buildEmptyState() { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.chat_bubble_outline, + size: 64, + color: Colors.grey.shade400, + ), + const SizedBox(height: 16), + Text( + '暂无练习内容', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: Colors.grey.shade600, + ), + ), + const SizedBox(height: 8), + Text( + '请尝试调整筛选条件', + style: TextStyle( + color: Colors.grey.shade500, + ), + ), + ], + ), + ); + } + + Widget _buildTaskList(List tasks) { + return ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: tasks.length, + itemBuilder: (context, index) { + final task = tasks[index]; + return _buildTaskCard(task); + }, + ); + } + + Widget _buildTaskCard(SpeakingTask task) { + return Card( + margin: const EdgeInsets.only(bottom: 12), + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: InkWell( + borderRadius: BorderRadius.circular(12), + onTap: () => _startTask(task), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + padding: const EdgeInsets.all(8), + decoration: BoxDecoration( + color: Colors.blue.shade100, + borderRadius: BorderRadius.circular(8), + ), + child: Icon( + Icons.chat, + color: Colors.blue.shade600, + size: 20, + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + task.title, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + task.description, + style: TextStyle( + fontSize: 14, + color: Colors.grey.shade600, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ], + ), + ), + ], + ), + const SizedBox(height: 12), + Row( + children: [ + _buildTaskTag( + _getDifficultyLabel(task.difficulty), + Colors.blue, + ), + const SizedBox(width: 8), + _buildTaskTag( + _getScenarioLabel(task.scenario), + Colors.green, + ), + const Spacer(), + Text( + '${task.estimatedDuration}分钟', + style: TextStyle( + fontSize: 12, + color: Colors.grey.shade500, + ), + ), + ], + ), + ], + ), + ), + ), + ); + } + + Widget _buildTaskTag(String label, Color color) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: color.withOpacity(0.3), + width: 1, + ), + ), + child: Text( + label, + style: TextStyle( + fontSize: 12, + color: color, + fontWeight: FontWeight.w500, + ), + ), + ); + } + + List _filterTasks(List tasks) { + return tasks.where((task) { + // 搜索过滤 + if (_searchQuery.isNotEmpty) { + final query = _searchQuery.toLowerCase(); + if (!task.title.toLowerCase().contains(query) && + !task.description.toLowerCase().contains(query)) { + return false; + } + } + + // 难度过滤 + if (_selectedDifficulty != 'all' && + task.difficulty.toString().split('.').last != _selectedDifficulty) { + return false; + } + + // 场景过滤 + if (_selectedScenario != 'all' && + task.scenario.toString().split('.').last != _selectedScenario) { + return false; + } + + return true; + }).toList(); + } + + String _getDifficultyLabel(SpeakingDifficulty difficulty) { + return difficulty.displayName; + } + + String _getScenarioLabel(SpeakingScenario scenario) { + return scenario.displayName; + } + + void _startTask(SpeakingTask task) { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => SpeakingConversationScreen(task: task), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/screens/speaking_stats_screen.dart b/client/lib/features/speaking/screens/speaking_stats_screen.dart new file mode 100644 index 0000000..dc51b49 --- /dev/null +++ b/client/lib/features/speaking/screens/speaking_stats_screen.dart @@ -0,0 +1,1140 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import 'package:fl_chart/fl_chart.dart'; +import '../models/speaking_stats.dart'; +import '../providers/speaking_provider.dart'; + +class SpeakingStatsScreen extends StatefulWidget { + const SpeakingStatsScreen({super.key}); + + @override + State createState() => _SpeakingStatsScreenState(); +} + +class _SpeakingStatsScreenState extends State + with SingleTickerProviderStateMixin { + late TabController _tabController; + String _selectedPeriod = '7days'; + + @override + void initState() { + super.initState(); + _tabController = TabController(length: 3, vsync: this); + WidgetsBinding.instance.addPostFrameCallback((_) { + context.read().loadStats(); + }); + } + + @override + void dispose() { + _tabController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('口语统计'), + bottom: TabBar( + controller: _tabController, + tabs: const [ + Tab(text: '总览'), + Tab(text: '进度'), + Tab(text: '分析'), + ], + ), + ), + body: Consumer( + builder: (context, provider, child) { + if (provider.isLoading) { + return const Center( + child: CircularProgressIndicator(), + ); + } + + if (provider.error != null) { + return _buildErrorState(provider.error!); + } + + if (provider.stats == null) { + return _buildEmptyState(); + } + + return TabBarView( + controller: _tabController, + children: [ + _buildOverviewTab(provider.stats!), + _buildProgressTab(provider.stats!), + _buildAnalysisTab(provider.stats!), + ], + ); + }, + ), + ); + } + + Widget _buildOverviewTab(SpeakingStats stats) { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 时间筛选 + _buildPeriodSelector(), + const SizedBox(height: 20), + + // 核心指标卡片 + _buildMetricsCards(stats), + const SizedBox(height: 20), + + // 最近活动 + _buildRecentActivity(stats), + const SizedBox(height: 20), + + // 技能分布 + _buildSkillDistribution(stats), + ], + ), + ); + } + + Widget _buildProgressTab(SpeakingStats stats) { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 进度图表 + _buildProgressChart(stats), + const SizedBox(height: 20), + + // 学习目标 + _buildLearningGoals(stats), + const SizedBox(height: 20), + + // 成就徽章 + _buildAchievements(), + ], + ), + ); + } + + Widget _buildAnalysisTab(SpeakingStats stats) { + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 技能分析 + _buildSkillAnalysis(stats), + const SizedBox(height: 20), + + // 改进建议 + _buildImprovementSuggestions(stats), + const SizedBox(height: 20), + + // 学习习惯分析 + _buildLearningHabits(stats), + ], + ), + ); + } + + Widget _buildPeriodSelector() { + return Container( + padding: const EdgeInsets.all(4), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(12), + ), + child: Row( + children: [ + _buildPeriodButton('7days', '7天'), + _buildPeriodButton('30days', '30天'), + _buildPeriodButton('90days', '90天'), + _buildPeriodButton('all', '全部'), + ], + ), + ); + } + + Widget _buildPeriodButton(String value, String label) { + final isSelected = _selectedPeriod == value; + + return Expanded( + child: GestureDetector( + onTap: () { + setState(() { + _selectedPeriod = value; + }); + }, + child: Container( + padding: const EdgeInsets.symmetric(vertical: 8), + decoration: BoxDecoration( + color: isSelected ? Colors.white : Colors.transparent, + borderRadius: BorderRadius.circular(8), + boxShadow: isSelected + ? [ + BoxShadow( + color: Colors.black.withOpacity(0.1), + blurRadius: 4, + offset: const Offset(0, 2), + ), + ] + : null, + ), + child: Text( + label, + textAlign: TextAlign.center, + style: TextStyle( + fontWeight: isSelected ? FontWeight.w600 : FontWeight.normal, + color: isSelected ? Theme.of(context).primaryColor : Colors.grey[600], + ), + ), + ), + ), + ); + } + + Widget _buildMetricsCards(SpeakingStats stats) { + return Column( + children: [ + Row( + children: [ + Expanded( + child: _buildMetricCard( + '总会话', + '${stats.totalSessions}', + Icons.chat_bubble_outline, + Colors.blue, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildMetricCard( + '总时长', + '${stats.totalMinutes}分钟', + Icons.access_time, + Colors.green, + ), + ), + ], + ), + const SizedBox(height: 12), + Row( + children: [ + Expanded( + child: _buildMetricCard( + '平均分', + '${stats.averageScore.toStringAsFixed(1)}', + Icons.star, + Colors.orange, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildMetricCard( + '连续天数', + '${_calculateStreakDays(stats)}天', + Icons.local_fire_department, + Colors.red, + ), + ), + ], + ), + ], + ); + } + + Widget _buildMetricCard(String title, String value, IconData icon, Color color) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + padding: const EdgeInsets.all(8), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Icon( + icon, + color: color, + size: 20, + ), + ), + const Spacer(), + Icon( + Icons.trending_up, + color: Colors.grey[400], + size: 16, + ), + ], + ), + const SizedBox(height: 12), + Text( + value, + style: const TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + title, + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ), + ); + } + + Widget _buildRecentActivity(SpeakingStats stats) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '最近活动', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + if (stats.progressData.isNotEmpty) + ...stats.progressData.take(5).map((data) => _buildActivityItem(data)) + else + const Text( + '暂无活动记录', + style: TextStyle(color: Colors.grey), + ), + ], + ), + ); + } + + Widget _buildActivityItem(SpeakingProgressData data) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 8), + child: Row( + children: [ + Container( + width: 8, + height: 8, + decoration: BoxDecoration( + color: Theme.of(context).primaryColor, + shape: BoxShape.circle, + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '完成 ${data.sessionCount} 次对话', + style: const TextStyle( + fontWeight: FontWeight.w500, + ), + ), + Text( + '${_formatDate(data.date)} • 平均分 ${data.averageScore.toStringAsFixed(1)}', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ), + Text( + '${data.totalMinutes}分钟', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ); + } + + Widget _buildSkillDistribution(SpeakingStats stats) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '技能分布', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + if (stats.skillAnalysis != null) + ...stats.skillAnalysis!.criteriaScores.entries.map( + (entry) => _buildSkillBar(entry.key.toString(), entry.value), + ) + else + const Text( + '暂无技能数据', + style: TextStyle(color: Colors.grey), + ), + ], + ), + ); + } + + Widget _buildSkillBar(String skill, double score) { + final percentage = score / 100; + + return Padding( + padding: const EdgeInsets.symmetric(vertical: 8), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + _getSkillDisplayName(skill), + style: const TextStyle( + fontWeight: FontWeight.w500, + ), + ), + Text( + '${score.toStringAsFixed(1)}%', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + const SizedBox(height: 4), + LinearProgressIndicator( + value: percentage, + backgroundColor: Colors.grey[200], + valueColor: AlwaysStoppedAnimation( + _getSkillColor(percentage), + ), + ), + ], + ), + ); + } + + Widget _buildProgressChart(SpeakingStats stats) { + return Container( + height: 300, + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '学习进度', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Expanded( + child: LineChart( + LineChartData( + gridData: FlGridData(show: false), + titlesData: FlTitlesData( + leftTitles: AxisTitles( + sideTitles: SideTitles( + showTitles: true, + reservedSize: 40, + getTitlesWidget: (value, meta) { + return Text( + value.toInt().toString(), + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ); + }, + ), + ), + bottomTitles: AxisTitles( + sideTitles: SideTitles( + showTitles: true, + reservedSize: 30, + getTitlesWidget: (value, meta) { + if (value.toInt() < stats.progressData.length) { + final data = stats.progressData[value.toInt()]; + return Text( + '${data.date.month}/${data.date.day}', + style: TextStyle( + fontSize: 10, + color: Colors.grey[600], + ), + ); + } + return const Text(''); + }, + ), + ), + rightTitles: const AxisTitles( + sideTitles: SideTitles(showTitles: false), + ), + topTitles: const AxisTitles( + sideTitles: SideTitles(showTitles: false), + ), + ), + borderData: FlBorderData(show: false), + lineBarsData: [ + LineChartBarData( + spots: stats.progressData + .asMap() + .entries + .map((entry) => FlSpot( + entry.key.toDouble(), + entry.value.averageScore, + )) + .toList(), + isCurved: true, + color: Theme.of(context).primaryColor, + barWidth: 3, + dotData: const FlDotData(show: false), + belowBarData: BarAreaData( + show: true, + color: Theme.of(context).primaryColor.withOpacity(0.1), + ), + ), + ], + ), + ), + ), + ], + ), + ); + } + + Widget _buildLearningGoals(SpeakingStats stats) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '学习目标', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + _buildGoalItem( + '每周练习', + '${stats.totalSessions}', + '7', + Icons.calendar_today, + ), + const SizedBox(height: 12), + _buildGoalItem( + '平均分数', + '${stats.averageScore.toStringAsFixed(1)}', + '85.0', + Icons.star, + ), + ], + ), + ); + } + + Widget _buildGoalItem(String title, String current, String target, IconData icon) { + final currentValue = double.tryParse(current) ?? 0; + final targetValue = double.tryParse(target) ?? 1; + final progress = (currentValue / targetValue).clamp(0.0, 1.0); + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + icon, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 8), + Text( + title, + style: const TextStyle( + fontWeight: FontWeight.w500, + ), + ), + const Spacer(), + Text( + '$current / $target', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + const SizedBox(height: 8), + LinearProgressIndicator( + value: progress, + backgroundColor: Colors.grey[200], + valueColor: AlwaysStoppedAnimation( + progress >= 1.0 ? Colors.green : Theme.of(context).primaryColor, + ), + ), + ], + ); + } + + Widget _buildAchievements() { + final achievements = [ + {'title': '初学者', 'description': '完成第一次对话', 'earned': true}, + {'title': '坚持者', 'description': '连续7天练习', 'earned': true}, + {'title': '进步者', 'description': '平均分达到80分', 'earned': false}, + {'title': '专家', 'description': '平均分达到90分', 'earned': false}, + ]; + + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '成就徽章', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + GridView.builder( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount( + crossAxisCount: 2, + childAspectRatio: 3, + crossAxisSpacing: 12, + mainAxisSpacing: 12, + ), + itemCount: achievements.length, + itemBuilder: (context, index) { + final achievement = achievements[index]; + return _buildAchievementItem(achievement); + }, + ), + ], + ), + ); + } + + Widget _buildAchievementItem(Map achievement) { + final earned = achievement['earned'] as bool; + + return Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: earned ? Colors.orange.withOpacity(0.1) : Colors.grey[100], + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: earned ? Colors.orange : Colors.grey[300]!, + width: 1, + ), + ), + child: Row( + children: [ + Icon( + earned ? Icons.emoji_events : Icons.lock, + color: earned ? Colors.orange : Colors.grey[400], + size: 20, + ), + const SizedBox(width: 8), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Text( + achievement['title'] as String, + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.w600, + color: earned ? Colors.orange : Colors.grey[600], + ), + ), + Text( + achievement['description'] as String, + style: TextStyle( + fontSize: 10, + color: earned ? Colors.orange[700] : Colors.grey[500], + ), + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + ], + ), + ), + ], + ), + ); + } + + Widget _buildSkillAnalysis(SpeakingStats stats) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '技能分析', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + if (stats.skillAnalysis != null) ...[ + _buildAnalysisSection( + '优势技能', + stats.skillAnalysis!.strengths, + Colors.green, + Icons.trending_up, + ), + const SizedBox(height: 16), + _buildAnalysisSection( + '待改进技能', + stats.skillAnalysis!.weaknesses, + Colors.orange, + Icons.trending_down, + ), + ] else + const Text( + '暂无分析数据', + style: TextStyle(color: Colors.grey), + ), + ], + ), + ); + } + + Widget _buildAnalysisSection( + String title, + List items, + Color color, + IconData icon, + ) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + icon, + color: color, + size: 16, + ), + const SizedBox(width: 8), + Text( + title, + style: TextStyle( + fontWeight: FontWeight.w600, + color: color, + ), + ), + ], + ), + const SizedBox(height: 8), + if (items.isNotEmpty) + ...items.map((item) => Padding( + padding: const EdgeInsets.symmetric(vertical: 2), + child: Row( + children: [ + Container( + width: 4, + height: 4, + decoration: BoxDecoration( + color: color, + shape: BoxShape.circle, + ), + ), + const SizedBox(width: 8), + Expanded( + child: Text( + item, + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + ), + ), + ], + ), + )) + else + Text( + '暂无数据', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + ), + ], + ); + } + + Widget _buildImprovementSuggestions(SpeakingStats stats) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '改进建议', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + if (stats.skillAnalysis?.recommendations.isNotEmpty ?? false) + ...stats.skillAnalysis!.recommendations.map( + (suggestion) => _buildSuggestionItem(suggestion), + ) + else + const Text( + '暂无建议', + style: TextStyle(color: Colors.grey), + ), + ], + ), + ); + } + + Widget _buildSuggestionItem(String suggestion) { + return Container( + margin: const EdgeInsets.only(bottom: 12), + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.blue[50], + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: Colors.blue[200]!, + width: 1, + ), + ), + child: Row( + children: [ + Icon( + Icons.lightbulb_outline, + color: Colors.blue[600], + size: 20, + ), + const SizedBox(width: 12), + Expanded( + child: Text( + suggestion, + style: TextStyle( + fontSize: 14, + color: Colors.blue[800], + ), + ), + ), + ], + ), + ); + } + + Widget _buildLearningHabits(SpeakingStats stats) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '学习习惯', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + _buildHabitItem( + '最活跃时间', + _getMostActiveTime(stats), + Icons.access_time, + ), + const SizedBox(height: 12), + _buildHabitItem( + '平均会话时长', + '${_getAverageSessionDuration(stats)}分钟', + Icons.timer, + ), + const SizedBox(height: 12), + _buildHabitItem( + '学习频率', + '${_getLearningFrequency(stats)}次/周', + Icons.repeat, + ), + ], + ), + ); + } + + Widget _buildHabitItem(String title, String value, IconData icon) { + return Row( + children: [ + Icon( + icon, + color: Colors.grey[600], + size: 20, + ), + const SizedBox(width: 12), + Expanded( + child: Text( + title, + style: const TextStyle( + fontWeight: FontWeight.w500, + ), + ), + ), + Text( + value, + style: TextStyle( + color: Colors.grey[600], + fontWeight: FontWeight.w500, + ), + ), + ], + ); + } + + Widget _buildErrorState(String error) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '加载失败', + style: TextStyle( + fontSize: 18, + color: Colors.grey[600], + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 8), + Text( + error, + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 16), + ElevatedButton( + onPressed: () { + context.read().loadStats(); + }, + child: const Text('重试'), + ), + ], + ), + ); + } + + Widget _buildEmptyState() { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.bar_chart, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '暂无统计数据', + style: TextStyle( + fontSize: 18, + color: Colors.grey[600], + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 8), + Text( + '开始练习后即可查看统计信息', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + ), + ], + ), + ); + } + + // 辅助方法 + int _calculateStreakDays(SpeakingStats stats) { + // 简化实现，实际应该根据连续学习天数计算 + return stats.progressData.length; + } + + String _getSkillDisplayName(String skill) { + const skillNames = { + 'pronunciation': '发音', + 'fluency': '流利度', + 'grammar': '语法', + 'vocabulary': '词汇', + 'comprehension': '理解力', + }; + return skillNames[skill] ?? skill; + } + + Color _getSkillColor(double percentage) { + if (percentage >= 0.8) return Colors.green; + if (percentage >= 0.6) return Colors.orange; + return Colors.red; + } + + String _formatDate(DateTime date) { + return '${date.month}月${date.day}日'; + } + + String _getMostActiveTime(SpeakingStats stats) { + // 简化实现，实际应该分析学习时间分布 + return '上午 10:00'; + } + + int _getAverageSessionDuration(SpeakingStats stats) { + if (stats.progressData.isEmpty) return 0; + final totalMinutes = stats.progressData + .map((data) => data.totalMinutes) + .reduce((a, b) => a + b); + return totalMinutes ~/ stats.progressData.length; + } + + double _getLearningFrequency(SpeakingStats stats) { + // 简化实现，实际应该根据时间范围计算 + return stats.progressData.length / 4.0; // 假设数据跨度4周 + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/services/speaking_service.dart b/client/lib/features/speaking/services/speaking_service.dart new file mode 100644 index 0000000..ca96036 --- /dev/null +++ b/client/lib/features/speaking/services/speaking_service.dart @@ -0,0 +1,331 @@ +import '../../../core/models/api_response.dart'; +import '../../../core/services/enhanced_api_service.dart'; +import '../models/speaking_scenario.dart'; +import '../models/conversation.dart'; +import '../models/speaking_stats.dart'; +import '../models/pronunciation_assessment.dart'; +import '../models/pronunciation_item.dart'; + +/// 口语训练服务 +class SpeakingService { + static final SpeakingService _instance = SpeakingService._internal(); + factory SpeakingService() => _instance; + SpeakingService._internal(); + + final EnhancedApiService _enhancedApiService = EnhancedApiService(); + + // 缓存时长配置 + static const Duration _shortCacheDuration = Duration(minutes: 5); + static const Duration _longCacheDuration = Duration(hours: 1); + + /// 获取口语场景列表 + Future>> getSpeakingScenarios({ + SpeakingScenario? scenario, + SpeakingDifficulty? difficulty, + int page = 1, + int limit = 20, + }) async { + try { + final response = await _enhancedApiService.get>( + '/speaking/scenarios', + queryParameters: { + 'page': page, + 'page_size': limit, + if (scenario != null) 'category': scenario.name, + if (difficulty != null) 'level': difficulty.name, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final scenarios = data['scenarios'] as List?; + if (scenarios == null) return []; + return scenarios.map((json) => SpeakingTask.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(message: '获取成功', data: response.data!); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取口语场景失败: $e'); + } + } + + /// 获取单个口语场景详情 + Future> getSpeakingScenario(String scenarioId) async { + try { + final response = await _enhancedApiService.get( + '/speaking/scenarios/$scenarioId', + cacheDuration: _longCacheDuration, + fromJson: (data) => SpeakingTask.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(message: '获取成功', data: response.data!); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取口语场景详情失败: $e'); + } + } + + /// 开始口语对话 + Future> startConversation(String scenarioId) async { + try { + final response = await _enhancedApiService.post( + '/speaking/records', + data: {'scenario_id': scenarioId}, + fromJson: (data) => Conversation.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(message: '对话开始成功', data: response.data!); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '开始对话失败: $e'); + } + } + + /// 获取用户口语历史 + Future>> getUserSpeakingHistory({ + int page = 1, + int limit = 20, + }) async { + try { + final response = await _enhancedApiService.get>( + '/speaking/records', + queryParameters: { + 'page': page, + 'page_size': limit, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final records = data['records'] as List?; + if (records == null) return []; + return records.map((json) => Conversation.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(message: '获取历史记录成功', data: response.data!); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取历史记录失败: $e'); + } + } + + /// 获取用户口语统计 + Future> getUserSpeakingStatistics() async { + try { + final response = await _enhancedApiService.get( + '/speaking/stats', + cacheDuration: _shortCacheDuration, + fromJson: (data) => SpeakingStats.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return ApiResponse.success(message: '获取统计数据成功', data: response.data!); + } + + // API失败时返回默认统计数据 + final stats = SpeakingStats( + totalSessions: 45, + totalMinutes: 320, + averageScore: 85.5, + scenarioStats: { + SpeakingScenario.dailyConversation: 8, + SpeakingScenario.businessMeeting: 5, + SpeakingScenario.jobInterview: 3, + SpeakingScenario.shopping: 4, + SpeakingScenario.restaurant: 3, + SpeakingScenario.travel: 2, + SpeakingScenario.academic: 2, + SpeakingScenario.socializing: 1, + }, + difficultyStats: { + SpeakingDifficulty.beginner: 10, + SpeakingDifficulty.intermediate: 15, + SpeakingDifficulty.advanced: 8, + }, + progressData: [], + skillAnalysis: SpeakingSkillAnalysis( + criteriaScores: { + PronunciationCriteria.accuracy: 85.0, + PronunciationCriteria.fluency: 82.0, + PronunciationCriteria.completeness: 88.0, + PronunciationCriteria.prosody: 80.0, + }, + commonErrors: {}, + strengths: ['发音准确'], + weaknesses: ['语调需要改进'], + recommendations: ['多练习语调'], + improvementRate: 0.05, + lastAnalyzed: DateTime.now(), + ), + lastUpdated: DateTime.now(), + ); + + return ApiResponse.success(message: '获取统计数据成功', data: stats); + } catch (e) { + return ApiResponse.error(message: '获取统计数据失败: $e'); + } + } + + /// 获取推荐任务 + Future>> getRecommendedTasks() async { + try { + final response = await _enhancedApiService.get>( + '/speaking/scenarios/recommendations', + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final scenarios = data['scenarios'] as List?; + if (scenarios == null) return []; + return scenarios.map((json) => SpeakingTask.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(message: '获取推荐任务成功', data: response.data!); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取推荐任务失败: $e'); + } + } + + /// 获取热门任务 + Future>> getPopularTasks() async { + try { + // 热门任务可以通过获取场景列表并按某种排序获得 + final response = await _enhancedApiService.get>( + '/speaking/scenarios', + queryParameters: { + 'page': 1, + 'page_size': 10, + 'sort': 'popular', // 如果后端支持排序 + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final scenarios = data['scenarios'] as List?; + if (scenarios == null) return []; + return scenarios.map((json) => SpeakingTask.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(message: '获取热门任务成功', data: response.data!); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取热门任务失败: $e'); + } + } + + /// 获取发音练习项目（通过词汇后端数据映射） + Future>> getPronunciationItems( + PronunciationType type, { + int limit = 50, + }) async { + try { + final response = await _enhancedApiService.get>( + '/vocabulary/study/today', + queryParameters: { + 'limit': limit, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + dynamic root = data; + if (root is Map && root.containsKey('data')) { + root = root['data']; + } + + List list = const []; + if (root is List) { + list = root; + } else if (root is Map) { + final words = root['words']; + if (words is List) { + list = words; + } + } + + final items = []; + + for (final w in list) { + final id = w['id'].toString(); + final level = (w['level'] ?? '').toString(); + final audioUrl = (w['audio_url'] ?? w['audio_us_url'] ?? w['audio_uk_url'] ?? '').toString(); + final phonetic = (w['phonetic'] ?? w['phonetic_us'] ?? w['phonetic_uk'] ?? '').toString(); + final createdAtStr = (w['created_at'] ?? DateTime.now().toIso8601String()).toString(); + final createdAt = DateTime.tryParse(createdAtStr) ?? DateTime.now(); + + DifficultyLevel mapLevel(String l) { + switch (l) { + case 'beginner': + case 'elementary': + return DifficultyLevel.beginner; + case 'intermediate': + return DifficultyLevel.intermediate; + case 'advanced': + case 'expert': + return DifficultyLevel.advanced; + default: + return DifficultyLevel.intermediate; + } + } + + if (type == PronunciationType.word) { + items.add(PronunciationItem( + id: id, + text: (w['word'] ?? '').toString(), + phonetic: phonetic, + audioUrl: audioUrl, + type: PronunciationType.word, + difficulty: mapLevel(level), + category: level.isEmpty ? '词汇练习' : level, + tips: const [], + createdAt: createdAt, + )); + } else if (type == PronunciationType.sentence) { + final examples = (w['examples'] as List?) ?? []; + for (var i = 0; i < examples.length; i++) { + final ex = examples[i] as Map; + final exAudio = (ex['audio_url'] ?? '').toString(); + final exCreated = DateTime.tryParse((ex['created_at'] ?? createdAtStr).toString()) ?? createdAt; + items.add(PronunciationItem( + id: '${id}_ex_$i', + text: (ex['sentence'] ?? ex['sentence_en'] ?? '').toString(), + phonetic: '', + audioUrl: exAudio, + type: PronunciationType.sentence, + difficulty: mapLevel(level), + category: '例句', + tips: const [], + createdAt: exCreated, + )); + } + } + } + + return items; + }, + ); + + if (response.success && response.data != null) { + return ApiResponse.success(message: '获取发音练习成功', data: response.data!); + } else { + return ApiResponse.error(message: response.message); + } + } catch (e) { + return ApiResponse.error(message: '获取发音练习失败: $e'); + } + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/services/speech_recognition_service.dart b/client/lib/features/speaking/services/speech_recognition_service.dart new file mode 100644 index 0000000..2ed7947 --- /dev/null +++ b/client/lib/features/speaking/services/speech_recognition_service.dart @@ -0,0 +1,316 @@ +import 'dart:async'; +import 'dart:math'; +import '../models/pronunciation_item.dart'; + +/// 语音识别和评分服务 +class SpeechRecognitionService { + static final SpeechRecognitionService _instance = SpeechRecognitionService._internal(); + factory SpeechRecognitionService() => _instance; + SpeechRecognitionService._internal(); + + bool _isListening = false; + StreamController? _volumeController; + StreamController? _recognitionController; + + /// 获取音量流 + Stream get volumeStream => _volumeController?.stream ?? const Stream.empty(); + + /// 获取识别结果流 + Stream get recognitionStream => _recognitionController?.stream ?? const Stream.empty(); + + /// 是否正在监听 + bool get isListening => _isListening; + + /// 开始语音识别 + Future startListening() async { + if (_isListening) return false; + + try { + _isListening = true; + _volumeController = StreamController.broadcast(); + _recognitionController = StreamController.broadcast(); + + // TODO: 实现真实的语音识别 + // 这里应该调用语音识别API，如Google Speech-to-Text、百度语音识别等 + + // 模拟音量变化 + _simulateVolumeChanges(); + + return true; + } catch (e) { + _isListening = false; + return false; + } + } + + /// 停止语音识别 + Future stopListening() async { + if (!_isListening) return; + + _isListening = false; + await _volumeController?.close(); + await _recognitionController?.close(); + _volumeController = null; + _recognitionController = null; + } + + /// 分析发音并评分 + Future analyzePronunciation( + String recordedText, + PronunciationItem targetItem, + ) async { + // TODO: 实现真实的发音分析 + // 这里应该调用发音评估API，如科大讯飞语音评测、腾讯云语音评测等 + + // 模拟分析过程 + await Future.delayed(const Duration(milliseconds: 1500)); + + return _simulateAnalysis(recordedText, targetItem); + } + + /// 模拟音量变化 + void _simulateVolumeChanges() { + Timer.periodic(const Duration(milliseconds: 100), (timer) { + if (!_isListening) { + timer.cancel(); + return; + } + + // 生成随机音量值 + final volume = Random().nextDouble() * 0.8 + 0.1; + _volumeController?.add(volume); + }); + } + + /// 模拟发音分析 + PronunciationResult _simulateAnalysis(String recordedText, PronunciationItem targetItem) { + final random = Random(); + + // 基础分数 + double baseScore = 60.0 + random.nextDouble() * 30; + + // 根据文本相似度调整分数 + final similarity = _calculateSimilarity(recordedText.toLowerCase(), targetItem.text.toLowerCase()); + final adjustedScore = baseScore + (similarity * 20); + + // 确保分数在合理范围内 + final finalScore = adjustedScore.clamp(0.0, 100.0); + + return PronunciationResult( + score: finalScore, + accuracy: _getAccuracyLevel(finalScore), + feedback: _generateFeedback(finalScore, targetItem), + detailedAnalysis: _generateDetailedAnalysis(finalScore, targetItem), + suggestions: _generateSuggestions(finalScore, targetItem), + recognizedText: recordedText, + ); + } + + /// 计算文本相似度 + double _calculateSimilarity(String text1, String text2) { + if (text1 == text2) return 1.0; + + final words1 = text1.split(' '); + final words2 = text2.split(' '); + + int matches = 0; + final maxLength = max(words1.length, words2.length); + + for (int i = 0; i < min(words1.length, words2.length); i++) { + if (words1[i] == words2[i]) { + matches++; + } + } + + return matches / maxLength; + } + + /// 获取准确度等级 + AccuracyLevel _getAccuracyLevel(double score) { + if (score >= 90) return AccuracyLevel.excellent; + if (score >= 80) return AccuracyLevel.good; + if (score >= 70) return AccuracyLevel.fair; + if (score >= 60) return AccuracyLevel.needsImprovement; + return AccuracyLevel.poor; + } + + /// 生成反馈 + String _generateFeedback(double score, PronunciationItem item) { + if (score >= 90) { + return '发音非常标准！语调和节奏都很自然。'; + } else if (score >= 80) { + return '发音很好，只需要在个别音素上稍作调整。'; + } else if (score >= 70) { + return '发音基本正确，建议多练习重音和语调。'; + } else if (score >= 60) { + return '发音需要改进，请注意音素的准确性。'; + } else { + return '发音需要大幅改进，建议从基础音素开始练习。'; + } + } + + /// 生成详细分析 + Map _generateDetailedAnalysis(double score, PronunciationItem item) { + final random = Random(); + final baseVariation = (score - 70) / 30; // 基于总分的变化 + + return { + '音素准确度': (70 + baseVariation * 20 + random.nextDouble() * 10).clamp(0, 100), + '语调自然度': (65 + baseVariation * 25 + random.nextDouble() * 15).clamp(0, 100), + '语速适中度': (75 + baseVariation * 15 + random.nextDouble() * 10).clamp(0, 100), + '重音正确度': (70 + baseVariation * 20 + random.nextDouble() * 10).clamp(0, 100), + '流畅度': (60 + baseVariation * 30 + random.nextDouble() * 15).clamp(0, 100), + }; + } + + /// 生成改进建议 + List _generateSuggestions(double score, PronunciationItem item) { + List suggestions = []; + + if (score < 80) { + suggestions.addAll([ + '多听标准发音，模仿语调变化', + '注意重音位置，突出重读音节', + ]); + } + + if (score < 70) { + suggestions.addAll([ + '放慢语速，确保每个音素清晰', + '练习困难音素的发音方法', + ]); + } + + if (score < 60) { + suggestions.addAll([ + '从基础音标开始系统学习', + '使用镜子观察口型变化', + ]); + } + + // 根据练习类型添加特定建议 + switch (item.type) { + case PronunciationType.word: + suggestions.add('分解单词，逐个音节练习'); + break; + case PronunciationType.sentence: + suggestions.add('注意句子的语调起伏和停顿'); + break; + case PronunciationType.phrase: + suggestions.add('练习短语内部的连读现象'); + break; + case PronunciationType.phoneme: + suggestions.add('重点练习该音素的舌位和口型'); + break; + } + + return suggestions; + } + + /// 获取发音提示 + List getPronunciationTips(PronunciationItem item) { + return item.tips; + } + + /// 播放标准发音 + Future playStandardAudio(String audioUrl) async { + // TODO: 实现音频播放功能 + // 这里应该使用音频播放插件，如audioplayers + + // 模拟播放时间 + await Future.delayed(const Duration(seconds: 2)); + } + + /// 检查麦克风权限 + Future checkMicrophonePermission() async { + // TODO: 实现权限检查 + // 这里应该使用权限插件，如permission_handler + + // 模拟权限检查 + return true; + } + + /// 请求麦克风权限 + Future requestMicrophonePermission() async { + // TODO: 实现权限请求 + // 这里应该使用权限插件，如permission_handler + + // 模拟权限请求 + return true; + } +} + +/// 发音分析结果 +class PronunciationResult { + final double score; + final AccuracyLevel accuracy; + final String feedback; + final Map detailedAnalysis; + final List suggestions; + final String recognizedText; + + PronunciationResult({ + required this.score, + required this.accuracy, + required this.feedback, + required this.detailedAnalysis, + required this.suggestions, + required this.recognizedText, + }); +} + +/// 准确度等级 +enum AccuracyLevel { + excellent, + good, + fair, + needsImprovement, + poor, +} + +extension AccuracyLevelExtension on AccuracyLevel { + String get displayName { + switch (this) { + case AccuracyLevel.excellent: + return '优秀'; + case AccuracyLevel.good: + return '良好'; + case AccuracyLevel.fair: + return '一般'; + case AccuracyLevel.needsImprovement: + return '需要改进'; + case AccuracyLevel.poor: + return '较差'; + } + } + + String get description { + switch (this) { + case AccuracyLevel.excellent: + return '发音非常标准，语调自然'; + case AccuracyLevel.good: + return '发音准确，略有改进空间'; + case AccuracyLevel.fair: + return '发音基本正确，需要练习'; + case AccuracyLevel.needsImprovement: + return '发音有明显问题，需要改进'; + case AccuracyLevel.poor: + return '发音问题较多，需要系统练习'; + } + } + + String get emoji { + switch (this) { + case AccuracyLevel.excellent: + return '🌟'; + case AccuracyLevel.good: + return '👍'; + case AccuracyLevel.fair: + return '👌'; + case AccuracyLevel.needsImprovement: + return '📈'; + case AccuracyLevel.poor: + return '💪'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/widgets/speaking_filter_bar.dart b/client/lib/features/speaking/widgets/speaking_filter_bar.dart new file mode 100644 index 0000000..adedc1e --- /dev/null +++ b/client/lib/features/speaking/widgets/speaking_filter_bar.dart @@ -0,0 +1,244 @@ +import 'package:flutter/material.dart'; +import '../models/speaking_scenario.dart'; + +class SpeakingFilterBar extends StatelessWidget { + final SpeakingScenario? selectedScenario; + final SpeakingDifficulty? selectedDifficulty; + final String sortBy; + final ValueChanged onScenarioChanged; + final ValueChanged onDifficultyChanged; + final ValueChanged onSortChanged; + + const SpeakingFilterBar({ + super.key, + this.selectedScenario, + this.selectedDifficulty, + required this.sortBy, + required this.onScenarioChanged, + required this.onDifficultyChanged, + required this.onSortChanged, + }); + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8), + decoration: BoxDecoration( + color: Theme.of(context).cardColor, + border: Border( + bottom: BorderSide( + color: Colors.grey.withOpacity(0.2), + width: 1, + ), + ), + ), + child: Column( + children: [ + // 筛选器行 + Row( + children: [ + // 场景筛选 + Expanded( + child: _buildScenarioFilter(context), + ), + const SizedBox(width: 12), + + // 难度筛选 + Expanded( + child: _buildDifficultyFilter(context), + ), + const SizedBox(width: 12), + + // 排序筛选 + Expanded( + child: _buildSortFilter(context), + ), + ], + ), + + // 清除筛选按钮 + if (selectedScenario != null || selectedDifficulty != null || sortBy != 'recommended') + Padding( + padding: const EdgeInsets.only(top: 8), + child: Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + TextButton.icon( + onPressed: _clearFilters, + icon: const Icon(Icons.clear, size: 16), + label: const Text('清除筛选'), + style: TextButton.styleFrom( + foregroundColor: Colors.grey[600], + textStyle: const TextStyle(fontSize: 12), + ), + ), + ], + ), + ), + ], + ), + ); + } + + Widget _buildScenarioFilter(BuildContext context) { + return PopupMenuButton( + initialValue: selectedScenario, + onSelected: onScenarioChanged, + child: Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8), + decoration: BoxDecoration( + border: Border.all(color: Colors.grey.withOpacity(0.3)), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Icon( + Icons.category_outlined, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 8), + Expanded( + child: Text( + selectedScenario?.displayName ?? '场景', + style: TextStyle( + fontSize: 12, + color: selectedScenario != null ? Colors.black87 : Colors.grey[600], + ), + overflow: TextOverflow.ellipsis, + ), + ), + Icon( + Icons.arrow_drop_down, + size: 16, + color: Colors.grey[600], + ), + ], + ), + ), + itemBuilder: (context) => [ + const PopupMenuItem( + value: null, + child: Text('全部场景'), + ), + ...SpeakingScenario.values.map( + (scenario) => PopupMenuItem( + value: scenario, + child: Text(scenario.displayName), + ), + ), + ], + ); + } + + Widget _buildDifficultyFilter(BuildContext context) { + return PopupMenuButton( + initialValue: selectedDifficulty, + onSelected: onDifficultyChanged, + child: Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8), + decoration: BoxDecoration( + border: Border.all(color: Colors.grey.withOpacity(0.3)), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Icon( + Icons.trending_up, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 8), + Expanded( + child: Text( + selectedDifficulty?.displayName ?? '难度', + style: TextStyle( + fontSize: 12, + color: selectedDifficulty != null ? Colors.black87 : Colors.grey[600], + ), + overflow: TextOverflow.ellipsis, + ), + ), + Icon( + Icons.arrow_drop_down, + size: 16, + color: Colors.grey[600], + ), + ], + ), + ), + itemBuilder: (context) => [ + const PopupMenuItem( + value: null, + child: Text('全部难度'), + ), + ...SpeakingDifficulty.values.map( + (difficulty) => PopupMenuItem( + value: difficulty, + child: Text(difficulty.displayName), + ), + ), + ], + ); + } + + Widget _buildSortFilter(BuildContext context) { + final sortOptions = { + 'recommended': '推荐', + 'difficulty': '难度', + 'duration': '时长', + 'popularity': '热度', + }; + + return PopupMenuButton( + initialValue: sortBy, + onSelected: onSortChanged, + child: Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8), + decoration: BoxDecoration( + border: Border.all(color: Colors.grey.withOpacity(0.3)), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Icon( + Icons.sort, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 8), + Expanded( + child: Text( + sortOptions[sortBy] ?? '排序', + style: TextStyle( + fontSize: 12, + color: Colors.black87, + ), + overflow: TextOverflow.ellipsis, + ), + ), + Icon( + Icons.arrow_drop_down, + size: 16, + color: Colors.grey[600], + ), + ], + ), + ), + itemBuilder: (context) => sortOptions.entries + .map( + (entry) => PopupMenuItem( + value: entry.key, + child: Text(entry.value), + ), + ) + .toList(), + ); + } + + void _clearFilters() { + onScenarioChanged(null); + onDifficultyChanged(null); + onSortChanged('recommended'); + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/widgets/speaking_stats_card.dart b/client/lib/features/speaking/widgets/speaking_stats_card.dart new file mode 100644 index 0000000..2bdae43 --- /dev/null +++ b/client/lib/features/speaking/widgets/speaking_stats_card.dart @@ -0,0 +1,308 @@ +import 'package:flutter/material.dart'; +import '../models/speaking_stats.dart'; + +class SpeakingStatsCard extends StatelessWidget { + final SpeakingStats? stats; + final bool isLoading; + final VoidCallback? onTap; + + const SpeakingStatsCard({ + super.key, + this.stats, + this.isLoading = false, + this.onTap, + }); + + @override + Widget build(BuildContext context) { + return Card( + margin: const EdgeInsets.symmetric(horizontal: 16, vertical: 8), + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(12), + child: Container( + padding: const EdgeInsets.all(16), + child: isLoading ? _buildLoadingState() : _buildStatsContent(), + ), + ), + ); + } + + Widget _buildLoadingState() { + return const SizedBox( + height: 120, + child: Center( + child: CircularProgressIndicator(), + ), + ); + } + + Widget _buildStatsContent() { + if (stats == null) { + return _buildEmptyState(); + } + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题行 + Row( + children: [ + const Icon( + Icons.mic, + color: Colors.blue, + size: 20, + ), + const SizedBox(width: 8), + const Text( + '口语练习统计', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const Spacer(), + if (onTap != null) + Icon( + Icons.arrow_forward_ios, + size: 16, + color: Colors.grey[600], + ), + ], + ), + const SizedBox(height: 16), + + // 统计数据网格 + Row( + children: [ + Expanded( + child: _buildStatItem( + '总会话', + stats!.totalSessions.toString(), + Icons.chat_bubble_outline, + Colors.blue, + ), + ), + Expanded( + child: _buildStatItem( + '总时长', + _formatDuration(stats!.totalMinutes), + Icons.access_time, + Colors.green, + ), + ), + Expanded( + child: _buildStatItem( + '平均分', + stats!.averageScore.toStringAsFixed(1), + Icons.star, + Colors.orange, + ), + ), + ], + ), + const SizedBox(height: 16), + + // 进度条 + _buildProgressSection(), + ], + ); + } + + Widget _buildEmptyState() { + return SizedBox( + height: 120, + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.mic_off, + size: 48, + color: Colors.grey[400], + ), + const SizedBox(height: 8), + Text( + '还没有口语练习记录', + style: TextStyle( + color: Colors.grey[600], + fontSize: 14, + ), + ), + const SizedBox(height: 4), + Text( + '开始你的第一次对话吧！', + style: TextStyle( + color: Colors.grey[500], + fontSize: 12, + ), + ), + ], + ), + ); + } + + Widget _buildStatItem( + String label, + String value, + IconData icon, + Color color, + ) { + return Column( + children: [ + Container( + padding: const EdgeInsets.all(8), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Icon( + icon, + color: color, + size: 20, + ), + ), + const SizedBox(height: 8), + Text( + value, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + label, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ); + } + + Widget _buildProgressSection() { + if (stats?.progressData == null || stats!.progressData.isEmpty) { + return const SizedBox.shrink(); + } + + // 获取最近的进度数据 + final recentProgress = stats!.progressData.last; + final progressPercentage = (recentProgress.averageScore / 100).clamp(0.0, 1.0); + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '最近表现', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + ), + ), + Text( + '${recentProgress.averageScore.toStringAsFixed(1)}分', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + const SizedBox(height: 8), + LinearProgressIndicator( + value: progressPercentage, + backgroundColor: Colors.grey[200], + valueColor: AlwaysStoppedAnimation( + _getScoreColor(recentProgress.averageScore), + ), + ), + const SizedBox(height: 8), + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + _getScoreLevel(recentProgress.averageScore), + style: TextStyle( + fontSize: 12, + color: _getScoreColor(recentProgress.averageScore), + fontWeight: FontWeight.w500, + ), + ), + Text( + _formatDate(recentProgress.date), + style: TextStyle( + fontSize: 12, + color: Colors.grey[500], + ), + ), + ], + ), + ], + ); + } + + String _formatDuration(int minutes) { + if (minutes < 60) { + return '${minutes}分钟'; + } else { + final hours = minutes ~/ 60; + final remainingMinutes = minutes % 60; + if (remainingMinutes == 0) { + return '${hours}小时'; + } else { + return '${hours}小时${remainingMinutes}分钟'; + } + } + } + + String _formatDate(DateTime date) { + final now = DateTime.now(); + final difference = now.difference(date).inDays; + + if (difference == 0) { + return '今天'; + } else if (difference == 1) { + return '昨天'; + } else if (difference < 7) { + return '${difference}天前'; + } else { + return '${date.month}/${date.day}'; + } + } + + Color _getScoreColor(double score) { + if (score >= 90) { + return Colors.green; + } else if (score >= 80) { + return Colors.lightGreen; + } else if (score >= 70) { + return Colors.orange; + } else if (score >= 60) { + return Colors.deepOrange; + } else { + return Colors.red; + } + } + + String _getScoreLevel(double score) { + if (score >= 90) { + return '优秀'; + } else if (score >= 80) { + return '良好'; + } else if (score >= 70) { + return '中等'; + } else if (score >= 60) { + return '及格'; + } else { + return '需要提高'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/speaking/widgets/speaking_task_card.dart b/client/lib/features/speaking/widgets/speaking_task_card.dart new file mode 100644 index 0000000..753600a --- /dev/null +++ b/client/lib/features/speaking/widgets/speaking_task_card.dart @@ -0,0 +1,225 @@ +import 'package:flutter/material.dart'; +import '../models/speaking_scenario.dart'; + +class SpeakingTaskCard extends StatelessWidget { + final SpeakingTask task; + final VoidCallback? onTap; + final VoidCallback? onFavorite; + + const SpeakingTaskCard({ + super.key, + required this.task, + this.onTap, + this.onFavorite, + }); + + @override + Widget build(BuildContext context) { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题和收藏按钮 + Row( + children: [ + Expanded( + child: Text( + task.title, + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ), + IconButton( + icon: Icon( + task.isFavorite ? Icons.favorite : Icons.favorite_border, + color: task.isFavorite ? Colors.red : Colors.grey, + ), + onPressed: onFavorite, + tooltip: task.isFavorite ? '取消收藏' : '收藏', + ), + ], + ), + + const SizedBox(height: 8), + + // 描述 + Text( + task.description, + style: Theme.of(context).textTheme.bodyMedium?.copyWith( + color: Colors.grey[600], + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + + const SizedBox(height: 12), + + // 标签行 + Row( + children: [ + // 场景标签 + _buildTag( + context, + task.scenario.displayName, + Colors.blue, + ), + const SizedBox(width: 8), + + // 难度标签 + _buildTag( + context, + task.difficulty.displayName, + _getDifficultyColor(task.difficulty), + ), + + const Spacer(), + + // 推荐标签 + if (task.isRecommended) + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: Colors.orange.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: Colors.orange.withOpacity(0.3), + ), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + Icons.star, + size: 12, + color: Colors.orange[700], + ), + const SizedBox(width: 4), + Text( + '推荐', + style: TextStyle( + fontSize: 10, + color: Colors.orange[700], + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ), + ], + ), + + const SizedBox(height: 12), + + // 底部信息 + Row( + children: [ + Icon( + Icons.access_time, + size: 16, + color: Colors.grey[500], + ), + const SizedBox(width: 4), + Text( + '${task.estimatedDuration}分钟', + style: Theme.of(context).textTheme.bodySmall?.copyWith( + color: Colors.grey[600], + ), + ), + + const SizedBox(width: 16), + + Icon( + Icons.people_outline, + size: 16, + color: Colors.grey[500], + ), + const SizedBox(width: 4), + Text( + '${task.completionCount}人完成', + style: Theme.of(context).textTheme.bodySmall?.copyWith( + color: Colors.grey[600], + ), + ), + + const Spacer(), + + // 开始按钮 + ElevatedButton( + onPressed: onTap, + style: ElevatedButton.styleFrom( + padding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 8, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(20), + ), + ), + child: const Text( + '开始练习', + style: TextStyle(fontSize: 12), + ), + ), + ], + ), + ], + ), + ), + ), + ); + } + + Widget _buildTag(BuildContext context, String text, Color color) { + return Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: color.withOpacity(0.3), + ), + ), + child: Text( + text, + style: TextStyle( + fontSize: 10, + color: color, + fontWeight: FontWeight.w500, + ), + ), + ); + } + + Color _getDifficultyColor(SpeakingDifficulty difficulty) { + switch (difficulty) { + case SpeakingDifficulty.beginner: + return Colors.green; + case SpeakingDifficulty.elementary: + return Colors.lightGreen; + case SpeakingDifficulty.intermediate: + return Colors.orange; + case SpeakingDifficulty.upperIntermediate: + return Colors.deepOrange; + case SpeakingDifficulty.advanced: + return Colors.red; + } + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/data/vocabulary_book_factory.dart b/client/lib/features/vocabulary/data/vocabulary_book_factory.dart new file mode 100644 index 0000000..722fff9 --- /dev/null +++ b/client/lib/features/vocabulary/data/vocabulary_book_factory.dart @@ -0,0 +1,660 @@ +import '../models/vocabulary_book_model.dart'; +import '../models/vocabulary_book_category.dart'; +import '../models/word_model.dart'; + +/// 词书数据工厂类 +class VocabularyBookFactory { + /// 创建所有系统词书 + static List createAllSystemBooks() { + final List books = []; + + // 学段基础词汇 + books.addAll(_createAcademicStageBooks()); + + // 国内应试类词汇 + books.addAll(_createDomesticTestBooks()); + + // 出国考试类词汇 + books.addAll(_createInternationalTestBooks()); + + // 职业与专业类词汇 + books.addAll(_createProfessionalBooks()); + + // 功能型词库 + books.addAll(_createFunctionalBooks()); + + return books; + } + + /// 创建学段基础词汇书 + static List _createAcademicStageBooks() { + final now = DateTime.now(); + + return [ + VocabularyBook( + id: 'academic_primary_core', + name: '小学英语核心词汇', + description: '小学阶段必备的1000-1500个核心词汇，涵盖基础场景和日常用语', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.beginner, + coverImageUrl: 'assets/images/vocabulary_books/primary_school.png', + totalWords: 1200, + isPublic: true, + tags: ['小学', '基础', '核心词汇', '日常用语'], + category: '学段基础词汇', + mainCategory: VocabularyBookMainCategory.academicStage, + subCategory: AcademicStageCategory.primarySchool.name, + targetLevels: ['小学1-6年级'], + estimatedDays: 60, + dailyWordCount: 20, + downloadCount: 15420, + rating: 4.8, + reviewCount: 2341, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'academic_junior_high', + name: '初中英语词汇', + description: '初中阶段1500-2500词，结合教材要求，为中考做准备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.elementary, + coverImageUrl: 'assets/images/vocabulary_books/junior_high.png', + totalWords: 2000, + isPublic: true, + tags: ['初中', '中考', '教材配套'], + category: '学段基础词汇', + mainCategory: VocabularyBookMainCategory.academicStage, + subCategory: AcademicStageCategory.juniorHigh.name, + targetLevels: ['初中1-3年级'], + estimatedDays: 100, + dailyWordCount: 20, + downloadCount: 23156, + rating: 4.7, + reviewCount: 3892, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'academic_senior_high', + name: '高中英语词汇', + description: '高中阶段2500-3500词，涵盖课标与高考高频词汇', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + coverImageUrl: 'assets/images/vocabulary_books/senior_high.png', + totalWords: 3200, + isPublic: true, + tags: ['高中', '高考', '课标词汇', '高频词'], + category: '学段基础词汇', + mainCategory: VocabularyBookMainCategory.academicStage, + subCategory: AcademicStageCategory.seniorHigh.name, + targetLevels: ['高中1-3年级'], + estimatedDays: 160, + dailyWordCount: 20, + downloadCount: 34782, + rating: 4.9, + reviewCount: 5673, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'academic_university', + name: '大学英语教材词汇', + description: '大学英语精读/泛读配套词汇，提升学术英语水平', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + coverImageUrl: 'assets/images/vocabulary_books/university.png', + totalWords: 4500, + isPublic: true, + tags: ['大学', '学术英语', '精读', '泛读'], + category: '学段基础词汇', + mainCategory: VocabularyBookMainCategory.academicStage, + subCategory: AcademicStageCategory.university.name, + targetLevels: ['大学1-4年级'], + estimatedDays: 225, + dailyWordCount: 20, + downloadCount: 18934, + rating: 4.6, + reviewCount: 2847, + createdAt: now, + updatedAt: now, + ), + ]; + } + + /// 创建国内应试类词汇书 + static List _createDomesticTestBooks() { + final now = DateTime.now(); + + return [ + VocabularyBook( + id: 'domestic_cet4', + name: '大学英语四级词汇', + description: 'CET-4核心词汇，助力四级考试高分通过', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + coverImageUrl: 'assets/images/vocabulary_books/cet4.png', + totalWords: 4500, + isPublic: true, + tags: ['四级', 'CET-4', '考试必备'], + category: '国内应试类词汇', + mainCategory: VocabularyBookMainCategory.domesticTest, + subCategory: DomesticTestCategory.cet4.name, + targetLevels: ['大学生'], + estimatedDays: 90, + dailyWordCount: 50, + downloadCount: 89234, + rating: 4.8, + reviewCount: 12456, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'domestic_cet6', + name: '大学英语六级词汇', + description: 'CET-6核心词汇，突破六级考试难关', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + coverImageUrl: 'assets/images/vocabulary_books/cet6.png', + totalWords: 5500, + isPublic: true, + tags: ['六级', 'CET-6', '高级词汇'], + category: '国内应试类词汇', + mainCategory: VocabularyBookMainCategory.domesticTest, + subCategory: DomesticTestCategory.cet6.name, + targetLevels: ['大学生'], + estimatedDays: 110, + dailyWordCount: 50, + downloadCount: 67891, + rating: 4.7, + reviewCount: 9823, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'domestic_postgraduate', + name: '考研英语核心词汇', + description: '考研英语必备词汇，涵盖英语一和英语二', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + coverImageUrl: 'assets/images/vocabulary_books/postgraduate.png', + totalWords: 5500, + isPublic: true, + tags: ['考研', '研究生', '英语一', '英语二'], + category: '国内应试类词汇', + mainCategory: VocabularyBookMainCategory.domesticTest, + subCategory: DomesticTestCategory.postgraduate.name, + targetLevels: ['本科生', '考研学生'], + estimatedDays: 120, + dailyWordCount: 45, + downloadCount: 45672, + rating: 4.9, + reviewCount: 7234, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'domestic_tem4', + name: '英语专业四级词汇', + description: 'TEM-4专业词汇，英语专业学生必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + coverImageUrl: 'assets/images/vocabulary_books/tem4.png', + totalWords: 6000, + isPublic: true, + tags: ['专四', 'TEM-4', '英语专业'], + category: '国内应试类词汇', + mainCategory: VocabularyBookMainCategory.domesticTest, + subCategory: DomesticTestCategory.tem4.name, + targetLevels: ['英语专业学生'], + estimatedDays: 100, + dailyWordCount: 60, + downloadCount: 23456, + rating: 4.6, + reviewCount: 3421, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'domestic_tem8', + name: '英语专业八级词汇', + description: 'TEM-8高级词汇，英语专业最高水平认证', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.expert, + coverImageUrl: 'assets/images/vocabulary_books/tem8.png', + totalWords: 8000, + isPublic: true, + tags: ['专八', 'TEM-8', '高级词汇'], + category: '国内应试类词汇', + mainCategory: VocabularyBookMainCategory.domesticTest, + subCategory: DomesticTestCategory.tem8.name, + targetLevels: ['英语专业学生'], + estimatedDays: 160, + dailyWordCount: 50, + downloadCount: 18923, + rating: 4.8, + reviewCount: 2567, + createdAt: now, + updatedAt: now, + ), + ]; + } + + /// 创建出国考试类词汇书 + static List _createInternationalTestBooks() { + final now = DateTime.now(); + + return [ + VocabularyBook( + id: 'international_ielts_academic', + name: '雅思学术类词汇', + description: 'IELTS Academic核心词汇，助力雅思高分', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + coverImageUrl: 'assets/images/vocabulary_books/ielts_academic.png', + totalWords: 6500, + isPublic: true, + tags: ['雅思', 'IELTS', '学术类', '出国留学'], + category: '出国考试类词汇', + mainCategory: VocabularyBookMainCategory.internationalTest, + subCategory: InternationalTestCategory.ieltsAcademic.name, + targetLevels: ['出国留学生'], + estimatedDays: 130, + dailyWordCount: 50, + downloadCount: 56789, + rating: 4.8, + reviewCount: 8934, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'international_ielts_general', + name: '雅思培训类词汇', + description: 'IELTS General Training词汇，移民必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + coverImageUrl: 'assets/images/vocabulary_books/ielts_general.png', + totalWords: 5500, + isPublic: true, + tags: ['雅思', 'IELTS', '培训类', '移民'], + category: '出国考试类词汇', + mainCategory: VocabularyBookMainCategory.internationalTest, + subCategory: InternationalTestCategory.ieltsGeneral.name, + targetLevels: ['移民申请者'], + estimatedDays: 110, + dailyWordCount: 50, + downloadCount: 34567, + rating: 4.7, + reviewCount: 5432, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'international_toefl', + name: '托福词汇', + description: 'TOEFL iBT核心词汇，美国留学必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + coverImageUrl: 'assets/images/vocabulary_books/toefl.png', + totalWords: 7000, + isPublic: true, + tags: ['托福', 'TOEFL', 'iBT', '美国留学'], + category: '出国考试类词汇', + mainCategory: VocabularyBookMainCategory.internationalTest, + subCategory: InternationalTestCategory.toeflIbt.name, + targetLevels: ['美国留学生'], + estimatedDays: 140, + dailyWordCount: 50, + downloadCount: 67234, + rating: 4.9, + reviewCount: 9876, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'international_gre', + name: 'GRE词汇', + description: 'GRE核心词汇，研究生申请必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.expert, + coverImageUrl: 'assets/images/vocabulary_books/gre.png', + totalWords: 8500, + isPublic: true, + tags: ['GRE', '研究生申请', '学术词汇'], + category: '出国考试类词汇', + mainCategory: VocabularyBookMainCategory.internationalTest, + subCategory: InternationalTestCategory.gre.name, + targetLevels: ['研究生申请者'], + estimatedDays: 170, + dailyWordCount: 50, + downloadCount: 43210, + rating: 4.7, + reviewCount: 6543, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'international_gmat', + name: 'GMAT词汇', + description: 'GMAT商科词汇，MBA申请必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.expert, + coverImageUrl: 'assets/images/vocabulary_books/gmat.png', + totalWords: 7500, + isPublic: true, + tags: ['GMAT', 'MBA', '商科', '管理类'], + category: '出国考试类词汇', + mainCategory: VocabularyBookMainCategory.internationalTest, + subCategory: InternationalTestCategory.gmat.name, + targetLevels: ['MBA申请者'], + estimatedDays: 150, + dailyWordCount: 50, + downloadCount: 32109, + rating: 4.6, + reviewCount: 4321, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'international_sat', + name: 'SAT词汇', + description: 'SAT核心词汇，美本申请必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + coverImageUrl: 'assets/images/vocabulary_books/sat.png', + totalWords: 6000, + isPublic: true, + tags: ['SAT', '美本申请', '高中生'], + category: '出国考试类词汇', + mainCategory: VocabularyBookMainCategory.internationalTest, + subCategory: InternationalTestCategory.sat.name, + targetLevels: ['高中生', '美本申请者'], + estimatedDays: 120, + dailyWordCount: 50, + downloadCount: 28765, + rating: 4.8, + reviewCount: 3987, + createdAt: now, + updatedAt: now, + ), + ]; + } + + /// 创建职业与专业类词汇书 + static List _createProfessionalBooks() { + final now = DateTime.now(); + + return [ + VocabularyBook( + id: 'professional_business', + name: '商务英语词汇', + description: '商务场景核心词汇，职场沟通必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + coverImageUrl: 'assets/images/vocabulary_books/business.png', + totalWords: 3500, + isPublic: true, + tags: ['商务英语', '职场', '商务沟通'], + category: '职业与专业类词汇', + mainCategory: VocabularyBookMainCategory.professional, + subCategory: ProfessionalCategory.businessEnglish.name, + targetLevels: ['职场人士'], + estimatedDays: 70, + dailyWordCount: 50, + downloadCount: 45678, + rating: 4.7, + reviewCount: 6789, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'professional_bec_higher', + name: 'BEC高级词汇', + description: 'BEC Higher商务英语高级词汇', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + coverImageUrl: 'assets/images/vocabulary_books/bec_higher.png', + totalWords: 4500, + isPublic: true, + tags: ['BEC', '高级', '商务英语证书'], + category: '职业与专业类词汇', + mainCategory: VocabularyBookMainCategory.professional, + subCategory: ProfessionalCategory.becHigher.name, + targetLevels: ['商务人士'], + estimatedDays: 90, + dailyWordCount: 50, + downloadCount: 23456, + rating: 4.8, + reviewCount: 3456, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'professional_medical', + name: '医学英语词汇', + description: '医学专业词汇，医护人员必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.expert, + coverImageUrl: 'assets/images/vocabulary_books/medical.png', + totalWords: 5500, + isPublic: true, + tags: ['医学', '医护', '专业词汇'], + category: '职业与专业类词汇', + mainCategory: VocabularyBookMainCategory.professional, + subCategory: ProfessionalCategory.medical.name, + targetLevels: ['医护人员', '医学生'], + estimatedDays: 110, + dailyWordCount: 50, + downloadCount: 18765, + rating: 4.9, + reviewCount: 2345, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'professional_legal', + name: '法律英语词汇', + description: '法律专业词汇，法律从业者必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.expert, + coverImageUrl: 'assets/images/vocabulary_books/legal.png', + totalWords: 4800, + isPublic: true, + tags: ['法律', '法务', '专业词汇'], + category: '职业与专业类词汇', + mainCategory: VocabularyBookMainCategory.professional, + subCategory: ProfessionalCategory.legal.name, + targetLevels: ['法律从业者', '法学生'], + estimatedDays: 96, + dailyWordCount: 50, + downloadCount: 15432, + rating: 4.6, + reviewCount: 1987, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'professional_it', + name: 'IT英语词汇', + description: '计算机科学与软件工程词汇', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + coverImageUrl: 'assets/images/vocabulary_books/it.png', + totalWords: 4200, + isPublic: true, + tags: ['IT', '计算机', '软件工程', '人工智能'], + category: '职业与专业类词汇', + mainCategory: VocabularyBookMainCategory.professional, + subCategory: ProfessionalCategory.computerScience.name, + targetLevels: ['程序员', 'IT从业者'], + estimatedDays: 84, + dailyWordCount: 50, + downloadCount: 34567, + rating: 4.8, + reviewCount: 5432, + createdAt: now, + updatedAt: now, + ), + ]; + } + + /// 创建功能型词库 + static List _createFunctionalBooks() { + final now = DateTime.now(); + + return [ + VocabularyBook( + id: 'functional_roots_affixes', + name: '词根词缀词汇', + description: '通过词根词缀快速扩展词汇量，掌握记忆技巧', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + coverImageUrl: 'assets/images/vocabulary_books/roots_affixes.png', + totalWords: 3000, + isPublic: true, + tags: ['词根词缀', '记忆技巧', '词汇扩展'], + category: '功能型词库', + mainCategory: VocabularyBookMainCategory.functional, + subCategory: FunctionalCategory.rootsAffixes.name, + targetLevels: ['中级以上学习者'], + estimatedDays: 60, + dailyWordCount: 50, + downloadCount: 67890, + rating: 4.9, + reviewCount: 8765, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'functional_synonyms_antonyms', + name: '同义词反义词库', + description: '丰富表达方式，提升写作和口语水平', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + coverImageUrl: 'assets/images/vocabulary_books/synonyms.png', + totalWords: 2500, + isPublic: true, + tags: ['同义词', '反义词', '写作', '口语'], + category: '功能型词库', + mainCategory: VocabularyBookMainCategory.functional, + subCategory: FunctionalCategory.synonymsAntonyms.name, + targetLevels: ['中级以上学习者'], + estimatedDays: 50, + dailyWordCount: 50, + downloadCount: 45678, + rating: 4.7, + reviewCount: 6543, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'functional_academic_writing', + name: '学术写作搭配库', + description: '学术写作常用搭配，提升论文写作水平', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + coverImageUrl: 'assets/images/vocabulary_books/academic_writing.png', + totalWords: 2000, + isPublic: true, + tags: ['学术写作', '搭配', '论文', 'Collocations'], + category: '功能型词库', + mainCategory: VocabularyBookMainCategory.functional, + subCategory: FunctionalCategory.academicWritingCollocations.name, + targetLevels: ['研究生', '学者'], + estimatedDays: 40, + dailyWordCount: 50, + downloadCount: 23456, + rating: 4.8, + reviewCount: 3210, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'functional_daily_spoken', + name: '日常口语搭配库', + description: '日常口语常用搭配，提升口语表达自然度', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.elementary, + coverImageUrl: 'assets/images/vocabulary_books/daily_spoken.png', + totalWords: 1800, + isPublic: true, + tags: ['日常口语', '搭配', '口语表达'], + category: '功能型词库', + mainCategory: VocabularyBookMainCategory.functional, + subCategory: FunctionalCategory.dailySpokenCollocations.name, + targetLevels: ['初级以上学习者'], + estimatedDays: 36, + dailyWordCount: 50, + downloadCount: 56789, + rating: 4.6, + reviewCount: 7654, + createdAt: now, + updatedAt: now, + ), + VocabularyBook( + id: 'functional_daily_life', + name: '日常生活英语', + description: '旅游、点餐、购物、出行、租房等生活场景词汇', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.elementary, + coverImageUrl: 'assets/images/vocabulary_books/daily_life.png', + totalWords: 2200, + isPublic: true, + tags: ['日常生活', '旅游', '购物', '出行', '租房'], + category: '功能型词库', + mainCategory: VocabularyBookMainCategory.functional, + subCategory: FunctionalCategory.dailyLifeEnglish.name, + targetLevels: ['生活英语学习者'], + estimatedDays: 44, + dailyWordCount: 50, + downloadCount: 78901, + rating: 4.8, + reviewCount: 9876, + createdAt: now, + updatedAt: now, + ), + ]; + } + + /// 根据主分类获取词书列表 + static List getBooksByMainCategory(VocabularyBookMainCategory category) { + final allBooks = createAllSystemBooks(); + return allBooks.where((book) => book.mainCategory == category).toList(); + } + + /// 根据子分类获取词书列表 + static List getBooksBySubCategory(String subCategory) { + final allBooks = createAllSystemBooks(); + return allBooks.where((book) => book.subCategory == subCategory).toList(); + } + + /// 获取推荐词书（基于下载量和评分） + static List getRecommendedBooks({int limit = 10}) { + final allBooks = createAllSystemBooks(); + allBooks.sort((a, b) { + // 综合评分：下载量权重0.3，评分权重0.7 + final scoreA = (a.downloadCount / 100000) * 0.3 + a.rating * 0.7; + final scoreB = (b.downloadCount / 100000) * 0.3 + b.rating * 0.7; + return scoreB.compareTo(scoreA); + }); + return allBooks.take(limit).toList(); + } + + /// 根据难度获取词书列表 + static List getBooksByDifficulty(VocabularyBookDifficulty difficulty) { + final allBooks = createAllSystemBooks(); + return allBooks.where((book) => book.difficulty == difficulty).toList(); + } + + /// 搜索词书 + static List searchBooks(String query) { + final allBooks = createAllSystemBooks(); + final lowerQuery = query.toLowerCase(); + + return allBooks.where((book) { + return book.name.toLowerCase().contains(lowerQuery) || + (book.description?.toLowerCase().contains(lowerQuery) ?? false) || + book.tags.any((tag) => tag.toLowerCase().contains(lowerQuery)); + }).toList(); + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/daily_stats_model.dart b/client/lib/features/vocabulary/models/daily_stats_model.dart new file mode 100644 index 0000000..1787ff3 --- /dev/null +++ b/client/lib/features/vocabulary/models/daily_stats_model.dart @@ -0,0 +1,16 @@ +class DailyStats { + final int wordsLearned; + final int studyTimeMinutes; + + DailyStats({ + required this.wordsLearned, + required this.studyTimeMinutes, + }); + + factory DailyStats.fromJson(Map json) { + return DailyStats( + wordsLearned: (json['wordsLearned'] as num?)?.toInt() ?? 0, + studyTimeMinutes: (json['studyTimeMinutes'] as num?)?.toInt() ?? 0, + ); + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/learning_session_model.dart b/client/lib/features/vocabulary/models/learning_session_model.dart new file mode 100644 index 0000000..d26108f --- /dev/null +++ b/client/lib/features/vocabulary/models/learning_session_model.dart @@ -0,0 +1,141 @@ +import 'package:json_annotation/json_annotation.dart'; + +part 'learning_session_model.g.dart'; + +/// 学习难度 +enum StudyDifficulty { + @JsonValue('forgot') + forgot, // 完全忘记 + @JsonValue('hard') + hard, // 困难 + @JsonValue('good') + good, // 一般 + @JsonValue('easy') + easy, // 容易 + @JsonValue('perfect') + perfect, // 完美 +} + +/// 学习会话 +@JsonSerializable() +class LearningSession { + @JsonKey(fromJson: _idFromJson) + final String id; + @JsonKey(name: 'user_id', fromJson: _userIdFromJson) + final String userId; + @JsonKey(name: 'book_id') + final String bookId; + @JsonKey(name: 'daily_goal') + final int dailyGoal; + @JsonKey(name: 'new_words_count') + final int newWordsCount; + @JsonKey(name: 'review_count') + final int reviewCount; + @JsonKey(name: 'mastered_count') + final int masteredCount; + @JsonKey(name: 'started_at') + final DateTime startedAt; + @JsonKey(name: 'completed_at') + final DateTime? completedAt; + + const LearningSession({ + required this.id, + required this.userId, + required this.bookId, + required this.dailyGoal, + this.newWordsCount = 0, + this.reviewCount = 0, + this.masteredCount = 0, + required this.startedAt, + this.completedAt, + }); + + factory LearningSession.fromJson(Map json) => + _$LearningSessionFromJson(json); + Map toJson() => _$LearningSessionToJson(this); + + static String _idFromJson(dynamic value) => value.toString(); + static String _userIdFromJson(dynamic value) => value.toString(); +} + +/// 今日学习任务 +@JsonSerializable() +class DailyLearningTasks { + @JsonKey(name: 'newWords') + final List newWords; // 新单词ID列表 + @JsonKey(name: 'reviewWords', fromJson: _reviewWordsFromJson) + final List reviewWords; // 复习单词进度列表 + @JsonKey(name: 'masteredCount') + final int masteredCount; // 已掌握数量 + @JsonKey(name: 'totalWords') + final int totalWords; // 总单词数 + final double progress; // 整体进度百分比 + + const DailyLearningTasks({ + required this.newWords, + required this.reviewWords, + required this.masteredCount, + required this.totalWords, + required this.progress, + }); + + factory DailyLearningTasks.fromJson(Map json) => + _$DailyLearningTasksFromJson(json); + Map toJson() => _$DailyLearningTasksToJson(this); + + /// 待学习总数 + int get totalTasks => newWords.length + reviewWords.length; + + /// 是否完成 + bool get isCompleted => totalTasks == 0; + + static List _reviewWordsFromJson(dynamic value) { + if (value == null) return []; + if (value is List) return value; + return []; + } +} + +/// 学习统计 +@JsonSerializable() +class LearningStatistics { + final int todayNewWords; // 今日新学单词数 + final int todayReview; // 今日复习单词数 + final int todayMastered; // 今日掌握单词数 + final int totalLearned; // 总学习单词数 + final int totalMastered; // 总掌握单词数 + final double avgProficiency; // 平均熟练度 + final int streakDays; // 连续学习天数 + + const LearningStatistics({ + required this.todayNewWords, + required this.todayReview, + required this.todayMastered, + required this.totalLearned, + required this.totalMastered, + required this.avgProficiency, + required this.streakDays, + }); + + factory LearningStatistics.fromJson(Map json) => + _$LearningStatisticsFromJson(json); + Map toJson() => _$LearningStatisticsToJson(this); +} + +/// 学习结果 +@JsonSerializable() +class StudyResult { + final String wordId; + final StudyDifficulty difficulty; + final int studyTime; // 学习时长（毫秒） + + const StudyResult({ + required this.wordId, + required this.difficulty, + required this.studyTime, + }); + + factory StudyResult.fromJson(Map json) => + _$StudyResultFromJson(json); + Map toJson() => _$StudyResultToJson(this); +} diff --git a/client/lib/features/vocabulary/models/learning_session_model.g.dart b/client/lib/features/vocabulary/models/learning_session_model.g.dart new file mode 100644 index 0000000..e5ee044 --- /dev/null +++ b/client/lib/features/vocabulary/models/learning_session_model.g.dart @@ -0,0 +1,98 @@ +// GENERATED CODE - DO NOT MODIFY BY HAND + +part of 'learning_session_model.dart'; + +// ************************************************************************** +// JsonSerializableGenerator +// ************************************************************************** + +LearningSession _$LearningSessionFromJson(Map json) => + LearningSession( + id: LearningSession._idFromJson(json['id']), + userId: LearningSession._userIdFromJson(json['user_id']), + bookId: json['book_id'] as String, + dailyGoal: (json['daily_goal'] as num).toInt(), + newWordsCount: (json['new_words_count'] as num?)?.toInt() ?? 0, + reviewCount: (json['review_count'] as num?)?.toInt() ?? 0, + masteredCount: (json['mastered_count'] as num?)?.toInt() ?? 0, + startedAt: DateTime.parse(json['started_at'] as String), + completedAt: json['completed_at'] == null + ? null + : DateTime.parse(json['completed_at'] as String), + ); + +Map _$LearningSessionToJson(LearningSession instance) => + { + 'id': instance.id, + 'user_id': instance.userId, + 'book_id': instance.bookId, + 'daily_goal': instance.dailyGoal, + 'new_words_count': instance.newWordsCount, + 'review_count': instance.reviewCount, + 'mastered_count': instance.masteredCount, + 'started_at': instance.startedAt.toIso8601String(), + 'completed_at': instance.completedAt?.toIso8601String(), + }; + +DailyLearningTasks _$DailyLearningTasksFromJson(Map json) => + DailyLearningTasks( + newWords: (json['newWords'] as List) + .map((e) => (e as num).toInt()) + .toList(), + reviewWords: DailyLearningTasks._reviewWordsFromJson(json['reviewWords']), + masteredCount: (json['masteredCount'] as num).toInt(), + totalWords: (json['totalWords'] as num).toInt(), + progress: (json['progress'] as num).toDouble(), + ); + +Map _$DailyLearningTasksToJson(DailyLearningTasks instance) => + { + 'newWords': instance.newWords, + 'reviewWords': instance.reviewWords, + 'masteredCount': instance.masteredCount, + 'totalWords': instance.totalWords, + 'progress': instance.progress, + }; + +LearningStatistics _$LearningStatisticsFromJson(Map json) => + LearningStatistics( + todayNewWords: (json['todayNewWords'] as num).toInt(), + todayReview: (json['todayReview'] as num).toInt(), + todayMastered: (json['todayMastered'] as num).toInt(), + totalLearned: (json['totalLearned'] as num).toInt(), + totalMastered: (json['totalMastered'] as num).toInt(), + avgProficiency: (json['avgProficiency'] as num).toDouble(), + streakDays: (json['streakDays'] as num).toInt(), + ); + +Map _$LearningStatisticsToJson(LearningStatistics instance) => + { + 'todayNewWords': instance.todayNewWords, + 'todayReview': instance.todayReview, + 'todayMastered': instance.todayMastered, + 'totalLearned': instance.totalLearned, + 'totalMastered': instance.totalMastered, + 'avgProficiency': instance.avgProficiency, + 'streakDays': instance.streakDays, + }; + +StudyResult _$StudyResultFromJson(Map json) => StudyResult( + wordId: json['wordId'] as String, + difficulty: $enumDecode(_$StudyDifficultyEnumMap, json['difficulty']), + studyTime: (json['studyTime'] as num).toInt(), + ); + +Map _$StudyResultToJson(StudyResult instance) => + { + 'wordId': instance.wordId, + 'difficulty': _$StudyDifficultyEnumMap[instance.difficulty]!, + 'studyTime': instance.studyTime, + }; + +const _$StudyDifficultyEnumMap = { + StudyDifficulty.forgot: 'forgot', + StudyDifficulty.hard: 'hard', + StudyDifficulty.good: 'good', + StudyDifficulty.easy: 'easy', + StudyDifficulty.perfect: 'perfect', +}; diff --git a/client/lib/features/vocabulary/models/learning_stats_model.dart b/client/lib/features/vocabulary/models/learning_stats_model.dart new file mode 100644 index 0000000..f5f5e9e --- /dev/null +++ b/client/lib/features/vocabulary/models/learning_stats_model.dart @@ -0,0 +1,713 @@ +/// 学习统计数据 +class LearningStats { + /// 用户ID + final String userId; + + /// 总学习天数 + final int totalStudyDays; + + /// 连续学习天数 + final int currentStreak; + + /// 最长连续学习天数 + final int maxStreak; + + /// 总学习单词数 + final int totalWordsLearned; + + /// 总复习单词数 + final int totalWordsReviewed; + + /// 总学习时间（分钟） + final int totalStudyTimeMinutes; + + /// 平均每日学习单词数 + final double averageDailyWords; + + /// 平均每日学习时间（分钟） + final double averageDailyMinutes; + + /// 学习准确率 + final double accuracyRate; + + /// 完成的词汇书数量 + final int completedBooks; + + /// 当前学习的词汇书数量 + final int currentBooks; + + /// 掌握的单词数 + final int masteredWords; + + /// 学习中的单词数 + final int learningWords; + + /// 需要复习的单词数 + final int reviewWords; + + /// 本周学习统计 + final WeeklyStats weeklyStats; + + /// 本月学习统计 + final MonthlyStats monthlyStats; + + /// 学习等级 + final int level; + + /// 当前等级经验值 + final int currentExp; + + /// 升级所需经验值 + final int nextLevelExp; + + /// 最后学习时间 + final DateTime? lastStudyTime; + + /// 创建时间 + final DateTime createdAt; + + /// 更新时间 + final DateTime updatedAt; + + /// 每日学习记录 + final List dailyRecords; + + /// 学习成就 + final List achievements; + + /// 排行榜信息 + final Leaderboard? leaderboard; + + const LearningStats({ + required this.userId, + required this.totalStudyDays, + required this.currentStreak, + required this.maxStreak, + required this.totalWordsLearned, + required this.totalWordsReviewed, + required this.totalStudyTimeMinutes, + required this.averageDailyWords, + required this.averageDailyMinutes, + required this.accuracyRate, + required this.completedBooks, + required this.currentBooks, + required this.masteredWords, + required this.learningWords, + required this.reviewWords, + required this.weeklyStats, + required this.monthlyStats, + required this.level, + required this.currentExp, + required this.nextLevelExp, + this.lastStudyTime, + required this.createdAt, + required this.updatedAt, + required this.dailyRecords, + required this.achievements, + this.leaderboard, + }); + + factory LearningStats.fromJson(Map json) { + return LearningStats( + userId: json['userId'] as String, + totalStudyDays: json['totalStudyDays'] as int, + currentStreak: json['currentStreak'] as int, + maxStreak: json['maxStreak'] as int, + totalWordsLearned: json['totalWordsLearned'] as int, + totalWordsReviewed: json['totalWordsReviewed'] as int, + totalStudyTimeMinutes: json['totalStudyTimeMinutes'] as int, + averageDailyWords: (json['averageDailyWords'] as num).toDouble(), + averageDailyMinutes: (json['averageDailyMinutes'] as num).toDouble(), + accuracyRate: (json['accuracyRate'] as num).toDouble(), + completedBooks: json['completedBooks'] as int, + currentBooks: json['currentBooks'] as int, + masteredWords: json['masteredWords'] as int, + learningWords: json['learningWords'] as int, + reviewWords: json['reviewWords'] as int, + weeklyStats: WeeklyStats.fromJson(json['weeklyStats'] as Map), + monthlyStats: MonthlyStats.fromJson(json['monthlyStats'] as Map), + level: json['level'] as int, + currentExp: json['currentExp'] as int, + nextLevelExp: json['nextLevelExp'] as int, + lastStudyTime: json['lastStudyTime'] != null + ? DateTime.parse(json['lastStudyTime'] as String) + : null, + createdAt: DateTime.parse(json['createdAt'] as String), + updatedAt: DateTime.parse(json['updatedAt'] as String), + dailyRecords: (json['dailyRecords'] as List?) + ?.map((e) => DailyStudyRecord.fromJson(e as Map)) + .toList() ?? [], + achievements: (json['achievements'] as List?) + ?.map((e) => Achievement.fromJson(e as Map)) + .toList() ?? [], + leaderboard: json['leaderboard'] != null + ? Leaderboard.fromJson(json['leaderboard'] as Map) + : null, + ); + } + + Map toJson() { + return { + 'userId': userId, + 'totalStudyDays': totalStudyDays, + 'currentStreak': currentStreak, + 'maxStreak': maxStreak, + 'totalWordsLearned': totalWordsLearned, + 'totalWordsReviewed': totalWordsReviewed, + 'totalStudyTimeMinutes': totalStudyTimeMinutes, + 'averageDailyWords': averageDailyWords, + 'averageDailyMinutes': averageDailyMinutes, + 'accuracyRate': accuracyRate, + 'completedBooks': completedBooks, + 'currentBooks': currentBooks, + 'masteredWords': masteredWords, + 'learningWords': learningWords, + 'reviewWords': reviewWords, + 'weeklyStats': weeklyStats.toJson(), + 'monthlyStats': monthlyStats.toJson(), + 'level': level, + 'currentExp': currentExp, + 'nextLevelExp': nextLevelExp, + 'lastStudyTime': lastStudyTime?.toIso8601String(), + 'createdAt': createdAt.toIso8601String(), + 'updatedAt': updatedAt.toIso8601String(), + 'dailyRecords': dailyRecords.map((e) => e.toJson()).toList(), + 'achievements': achievements.map((e) => e.toJson()).toList(), + 'leaderboard': leaderboard?.toJson(), + }; + } + + LearningStats copyWith({ + String? userId, + int? totalStudyDays, + int? currentStreak, + int? maxStreak, + int? totalWordsLearned, + int? totalWordsReviewed, + int? totalStudyTimeMinutes, + double? averageDailyWords, + double? averageDailyMinutes, + double? accuracyRate, + int? completedBooks, + int? currentBooks, + int? masteredWords, + int? learningWords, + int? reviewWords, + WeeklyStats? weeklyStats, + MonthlyStats? monthlyStats, + int? level, + int? currentExp, + int? nextLevelExp, + DateTime? lastStudyTime, + DateTime? createdAt, + DateTime? updatedAt, + List? dailyRecords, + List? achievements, + Leaderboard? leaderboard, + }) { + return LearningStats( + userId: userId ?? this.userId, + totalStudyDays: totalStudyDays ?? this.totalStudyDays, + currentStreak: currentStreak ?? this.currentStreak, + maxStreak: maxStreak ?? this.maxStreak, + totalWordsLearned: totalWordsLearned ?? this.totalWordsLearned, + totalWordsReviewed: totalWordsReviewed ?? this.totalWordsReviewed, + totalStudyTimeMinutes: totalStudyTimeMinutes ?? this.totalStudyTimeMinutes, + averageDailyWords: averageDailyWords ?? this.averageDailyWords, + averageDailyMinutes: averageDailyMinutes ?? this.averageDailyMinutes, + accuracyRate: accuracyRate ?? this.accuracyRate, + completedBooks: completedBooks ?? this.completedBooks, + currentBooks: currentBooks ?? this.currentBooks, + masteredWords: masteredWords ?? this.masteredWords, + learningWords: learningWords ?? this.learningWords, + reviewWords: reviewWords ?? this.reviewWords, + weeklyStats: weeklyStats ?? this.weeklyStats, + monthlyStats: monthlyStats ?? this.monthlyStats, + level: level ?? this.level, + currentExp: currentExp ?? this.currentExp, + nextLevelExp: nextLevelExp ?? this.nextLevelExp, + lastStudyTime: lastStudyTime ?? this.lastStudyTime, + createdAt: createdAt ?? this.createdAt, + updatedAt: updatedAt ?? this.updatedAt, + dailyRecords: dailyRecords ?? this.dailyRecords, + achievements: achievements ?? this.achievements, + leaderboard: leaderboard ?? this.leaderboard, + ); + } + + /// 获取学习进度百分比 + double get progressPercentage { + if (nextLevelExp == 0) return 0.0; + return currentExp / nextLevelExp; + } + + /// 获取总学习时间（小时） + double get totalStudyHours { + return totalStudyTimeMinutes / 60.0; + } + + /// 获取平均每日学习时间（小时） + double get averageDailyHours { + return averageDailyMinutes / 60.0; + } +} + +/// 周学习统计 +class WeeklyStats { + /// 本周学习天数 + final int studyDays; + + /// 本周学习单词数 + final int wordsLearned; + + /// 本周复习单词数 + final int wordsReviewed; + + /// 本周学习时间（分钟） + final int studyTimeMinutes; + + /// 本周准确率 + final double accuracyRate; + + /// 每日学习记录 + final List dailyRecords; + + const WeeklyStats({ + required this.studyDays, + required this.wordsLearned, + required this.wordsReviewed, + required this.studyTimeMinutes, + required this.accuracyRate, + required this.dailyRecords, + }); + + factory WeeklyStats.fromJson(Map json) { + return WeeklyStats( + studyDays: json['studyDays'] as int, + wordsLearned: json['wordsLearned'] as int, + wordsReviewed: json['wordsReviewed'] as int, + studyTimeMinutes: json['studyTimeMinutes'] as int, + accuracyRate: (json['accuracyRate'] as num).toDouble(), + dailyRecords: (json['dailyRecords'] as List?) + ?.map((e) => DailyStudyRecord.fromJson(e as Map)) + .toList() ?? [], + ); + } + + Map toJson() { + return { + 'studyDays': studyDays, + 'wordsLearned': wordsLearned, + 'wordsReviewed': wordsReviewed, + 'studyTimeMinutes': studyTimeMinutes, + 'accuracyRate': accuracyRate, + 'dailyRecords': dailyRecords.map((e) => e.toJson()).toList(), + }; + } + + /// 获取本周学习时间（小时） + double get studyHours { + return studyTimeMinutes / 60.0; + } +} + +/// 月学习统计 +class MonthlyStats { + /// 本月学习天数 + final int studyDays; + + /// 本月学习单词数 + final int wordsLearned; + + /// 本月复习单词数 + final int wordsReviewed; + + /// 本月学习时间（分钟） + final int studyTimeMinutes; + + /// 本月准确率 + final double accuracyRate; + + /// 本月完成的词汇书数 + final int completedBooks; + + /// 周统计记录 + final List weeklyRecords; + + const MonthlyStats({ + required this.studyDays, + required this.wordsLearned, + required this.wordsReviewed, + required this.studyTimeMinutes, + required this.accuracyRate, + required this.completedBooks, + required this.weeklyRecords, + }); + + factory MonthlyStats.fromJson(Map json) { + return MonthlyStats( + studyDays: json['studyDays'] as int, + wordsLearned: json['wordsLearned'] as int, + wordsReviewed: json['wordsReviewed'] as int, + studyTimeMinutes: json['studyTimeMinutes'] as int, + accuracyRate: (json['accuracyRate'] as num).toDouble(), + completedBooks: json['completedBooks'] as int, + weeklyRecords: (json['weeklyRecords'] as List?) + ?.map((e) => WeeklyStats.fromJson(e as Map)) + .toList() ?? [], + ); + } + + Map toJson() { + return { + 'studyDays': studyDays, + 'wordsLearned': wordsLearned, + 'wordsReviewed': wordsReviewed, + 'studyTimeMinutes': studyTimeMinutes, + 'accuracyRate': accuracyRate, + 'completedBooks': completedBooks, + 'weeklyRecords': weeklyRecords.map((e) => e.toJson()).toList(), + }; + } + + /// 获取本月学习时间（小时） + double get studyHours { + return studyTimeMinutes / 60.0; + } +} + +/// 每日学习记录 +class DailyStudyRecord { + /// 日期 + final DateTime date; + + /// 学习单词数 + final int wordsLearned; + + /// 复习单词数 + final int wordsReviewed; + + /// 学习时间（分钟） + final int studyTimeMinutes; + + /// 准确率 + final double accuracyRate; + + /// 完成的测试数 + final int testsCompleted; + + /// 获得的经验值 + final int expGained; + + /// 学习的词汇书ID列表 + final List vocabularyBookIds; + + const DailyStudyRecord({ + required this.date, + required this.wordsLearned, + required this.wordsReviewed, + required this.studyTimeMinutes, + required this.accuracyRate, + required this.testsCompleted, + required this.expGained, + required this.vocabularyBookIds, + }); + + factory DailyStudyRecord.fromJson(Map json) { + // 支持两种命名格式：驼峰命名和蛇形命名 + return DailyStudyRecord( + date: DateTime.parse(json['date'] as String), + wordsLearned: (json['wordsLearned'] ?? json['words_learned'] ?? json['new_words_learned'] ?? 0) as int, + wordsReviewed: (json['wordsReviewed'] ?? json['words_reviewed'] ?? 0) as int, + studyTimeMinutes: (json['studyTimeMinutes'] ?? json['total_study_time_seconds'] != null + ? (json['total_study_time_seconds'] as int) ~/ 60 + : 0) as int, + accuracyRate: ((json['accuracyRate'] ?? json['average_accuracy'] ?? 0) as num).toDouble(), + testsCompleted: (json['testsCompleted'] ?? json['session_count'] ?? 0) as int, + expGained: (json['expGained'] ?? json['experience_gained'] ?? 0) as int, + vocabularyBookIds: (json['vocabularyBookIds'] as List?) + ?.map((e) => e as String) + .toList() ?? [], + ); + } + + Map toJson() { + return { + 'date': date.toIso8601String(), + 'wordsLearned': wordsLearned, + 'wordsReviewed': wordsReviewed, + 'studyTimeMinutes': studyTimeMinutes, + 'accuracyRate': accuracyRate, + 'testsCompleted': testsCompleted, + 'expGained': expGained, + 'vocabularyBookIds': vocabularyBookIds, + }; + } + + /// 获取学习时间（小时） + double get studyHours { + return studyTimeMinutes / 60.0; + } +} + +/// 学习成就 +class Achievement { + /// 成就ID + final String id; + + /// 成就名称 + final String name; + + /// 成就描述 + final String description; + + /// 成就图标 + final String icon; + + /// 成就类型 + final AchievementType type; + + /// 是否已解锁 + final bool isUnlocked; + + /// 解锁时间 + final DateTime? unlockedAt; + + /// 进度值 + final int progress; + + /// 目标值 + final int target; + + /// 奖励经验值 + final int rewardExp; + + const Achievement({ + required this.id, + required this.name, + required this.description, + required this.icon, + required this.type, + required this.isUnlocked, + this.unlockedAt, + required this.progress, + required this.target, + required this.rewardExp, + }); + + factory Achievement.fromJson(Map json) { + return Achievement( + id: json['id'] as String, + name: json['name'] as String, + description: json['description'] as String, + icon: json['icon'] as String, + type: AchievementType.values.firstWhere( + (e) => e.name == json['type'], + orElse: () => AchievementType.special, + ), + isUnlocked: json['isUnlocked'] as bool, + unlockedAt: json['unlockedAt'] != null + ? DateTime.parse(json['unlockedAt'] as String) + : null, + progress: json['progress'] as int, + target: json['target'] as int, + rewardExp: json['rewardExp'] as int, + ); + } + + Map toJson() { + return { + 'id': id, + 'name': name, + 'description': description, + 'icon': icon, + 'type': type.name, + 'isUnlocked': isUnlocked, + 'unlockedAt': unlockedAt?.toIso8601String(), + 'progress': progress, + 'target': target, + 'rewardExp': rewardExp, + }; + } + + /// 复制并修改部分属性 + Achievement copyWith({ + String? id, + String? name, + String? description, + String? icon, + AchievementType? type, + bool? isUnlocked, + DateTime? unlockedAt, + int? progress, + int? target, + int? rewardExp, + }) { + return Achievement( + id: id ?? this.id, + name: name ?? this.name, + description: description ?? this.description, + icon: icon ?? this.icon, + type: type ?? this.type, + isUnlocked: isUnlocked ?? this.isUnlocked, + unlockedAt: unlockedAt ?? this.unlockedAt, + progress: progress ?? this.progress, + target: target ?? this.target, + rewardExp: rewardExp ?? this.rewardExp, + ); + } + + /// 获取进度百分比 + double get progressPercentage { + if (target == 0) return 0.0; + return (progress / target).clamp(0.0, 1.0); + } +} + +/// 成就类型 +enum AchievementType { + /// 学习天数 + studyDays, + /// 学习单词数 + wordsLearned, + /// 连续学习 + streak, + /// 完成词汇书 + booksCompleted, + /// 测试成绩 + testScore, + /// 学习时间 + studyTime, + /// 特殊成就 + special, +} + +/// 学习排行榜 +class Leaderboard { + /// 排行榜类型 + final LeaderboardType type; + + /// 时间范围 + final LeaderboardPeriod period; + + /// 排行榜条目 + final List entries; + + /// 用户排名 + final int? userRank; + + /// 更新时间 + final DateTime updatedAt; + + const Leaderboard({ + required this.type, + required this.period, + required this.entries, + this.userRank, + required this.updatedAt, + }); + + factory Leaderboard.fromJson(Map json) { + return Leaderboard( + type: LeaderboardType.values.firstWhere( + (e) => e.name == json['type'], + orElse: () => LeaderboardType.wordsLearned, + ), + period: LeaderboardPeriod.values.firstWhere( + (e) => e.name == json['period'], + orElse: () => LeaderboardPeriod.weekly, + ), + entries: (json['entries'] as List?) + ?.map((e) => LeaderboardEntry.fromJson(e as Map)) + .toList() ?? [], + userRank: json['userRank'] as int?, + updatedAt: DateTime.parse(json['updatedAt'] as String), + ); + } + + Map toJson() { + return { + 'type': type.name, + 'period': period.name, + 'entries': entries.map((e) => e.toJson()).toList(), + 'userRank': userRank, + 'updatedAt': updatedAt.toIso8601String(), + }; + } +} + +/// 排行榜条目 +class LeaderboardEntry { + /// 排名 + final int rank; + + /// 用户ID + final String userId; + + /// 用户名 + final String username; + + /// 用户头像 + final String? avatar; + + /// 分数 + final int score; + + /// 等级 + final int level; + + const LeaderboardEntry({ + required this.rank, + required this.userId, + required this.username, + this.avatar, + required this.score, + required this.level, + }); + + factory LeaderboardEntry.fromJson(Map json) { + return LeaderboardEntry( + rank: json['rank'] as int, + userId: json['userId'] as String, + username: json['username'] as String, + avatar: json['avatar'] as String?, + score: json['score'] as int, + level: json['level'] as int, + ); + } + + Map toJson() { + return { + 'rank': rank, + 'userId': userId, + 'username': username, + 'avatar': avatar, + 'score': score, + 'level': level, + }; + } +} + +/// 排行榜类型 +enum LeaderboardType { + /// 学习单词数 + wordsLearned, + /// 连续学习天数 + streak, + /// 学习时间 + studyTime, + /// 测试分数 + testScore, +} + +/// 排行榜时间范围 +enum LeaderboardPeriod { + /// 每日 + daily, + /// 每周 + weekly, + /// 每月 + monthly, + /// 全部时间 + allTime, +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/review_models.dart b/client/lib/features/vocabulary/models/review_models.dart new file mode 100644 index 0000000..a9f6cea --- /dev/null +++ b/client/lib/features/vocabulary/models/review_models.dart @@ -0,0 +1,53 @@ +/// 复习模式 +enum ReviewMode { + adaptive, // 智能适应 + sequential, // 顺序复习 + random, // 随机复习 + difficulty, // 按难度复习 +} + +/// 复习结果 +class ReviewResult { + final String wordId; + final bool isCorrect; + final DateTime timestamp; + final Duration reviewTime; + + ReviewResult({ + required this.wordId, + required this.isCorrect, + required this.timestamp, + required this.reviewTime, + }); +} + +/// 复习会话 +class ReviewSession { + final String id; + final DateTime startTime; + final int targetCount; + final ReviewMode mode; + DateTime? endTime; + Map results = {}; + + ReviewSession({ + required this.id, + required this.startTime, + required this.targetCount, + required this.mode, + this.endTime, + }); + + double get accuracy { + if (results.isEmpty) return 0.0; + final correctCount = results.values.where((r) => r.isCorrect).length; + return correctCount / results.length; + } + + Duration get totalTime { + final end = endTime ?? DateTime.now(); + return end.difference(startTime); + } + + bool get isCompleted => results.length >= targetCount; +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/study_plan_model.dart b/client/lib/features/vocabulary/models/study_plan_model.dart new file mode 100644 index 0000000..13a4039 --- /dev/null +++ b/client/lib/features/vocabulary/models/study_plan_model.dart @@ -0,0 +1,134 @@ +import 'package:freezed_annotation/freezed_annotation.dart'; +import 'vocabulary_book_model.dart'; + +part 'study_plan_model.freezed.dart'; +part 'study_plan_model.g.dart'; + +/// 学习计划模型 +@freezed +class StudyPlan with _$StudyPlan { + const factory StudyPlan({ + required String id, + required String name, + String? description, + required String userId, + required StudyPlanType type, + required StudyPlanStatus status, + required DateTime startDate, + required DateTime endDate, + required int dailyTarget, + @Default([]) List vocabularyBookIds, + @Default([]) List vocabularyBooks, + @Default(0) int totalWords, + @Default(0) int completedWords, + @Default(0) int currentStreak, + @Default(0) int maxStreak, + @Default([]) List milestones, + @Default({}) Map dailyProgress, + required DateTime createdAt, + required DateTime updatedAt, + }) = _StudyPlan; + + factory StudyPlan.fromJson(Map json) => _$StudyPlanFromJson(json); +} + +/// 学习计划类型 +enum StudyPlanType { + @JsonValue('daily') + daily, + @JsonValue('weekly') + weekly, + @JsonValue('monthly') + monthly, + @JsonValue('custom') + custom, + @JsonValue('exam_prep') + examPrep, +} + +/// 学习计划状态 +enum StudyPlanStatus { + @JsonValue('active') + active, + @JsonValue('paused') + paused, + @JsonValue('completed') + completed, + @JsonValue('cancelled') + cancelled, +} + +/// 学习计划里程碑 +@freezed +class StudyPlanMilestone with _$StudyPlanMilestone { + const factory StudyPlanMilestone({ + required String id, + required String title, + String? description, + required int targetWords, + required DateTime targetDate, + @Default(false) bool isCompleted, + DateTime? completedAt, + @Default(0) int currentProgress, + }) = _StudyPlanMilestone; + + factory StudyPlanMilestone.fromJson(Map json) => _$StudyPlanMilestoneFromJson(json); +} + +/// 学习计划统计 +@freezed +class StudyPlanStats with _$StudyPlanStats { + const factory StudyPlanStats({ + required String planId, + @Default(0) int totalDays, + @Default(0) int studiedDays, + @Default(0) int totalWords, + @Default(0) int learnedWords, + @Default(0) int reviewedWords, + @Default(0) int currentStreak, + @Default(0) int maxStreak, + @Default(0.0) double completionRate, + @Default(0.0) double averageDailyWords, + @Default(0) int remainingDays, + @Default(0) int remainingWords, + DateTime? lastStudyDate, + @Default([]) List dailyRecords, + }) = _StudyPlanStats; + + factory StudyPlanStats.fromJson(Map json) => _$StudyPlanStatsFromJson(json); +} + +/// 每日学习记录 +@freezed +class DailyStudyRecord with _$DailyStudyRecord { + const factory DailyStudyRecord({ + required DateTime date, + @Default(0) int wordsLearned, + @Default(0) int wordsReviewed, + @Default(0) int studyTimeMinutes, + @Default(false) bool targetAchieved, + @Default([]) List vocabularyBookIds, + }) = _DailyStudyRecord; + + factory DailyStudyRecord.fromJson(Map json) => _$DailyStudyRecordFromJson(json); +} + +/// 学习计划模板 +@freezed +class StudyPlanTemplate with _$StudyPlanTemplate { + const factory StudyPlanTemplate({ + required String id, + required String name, + required String description, + required StudyPlanType type, + required int durationDays, + required int dailyTarget, + @Default([]) List recommendedBookIds, + @Default([]) List milestones, + @Default(0) int difficulty, + @Default([]) List tags, + @Default(false) bool isPopular, + }) = _StudyPlanTemplate; + + factory StudyPlanTemplate.fromJson(Map json) => _$StudyPlanTemplateFromJson(json); +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/study_session_model.dart b/client/lib/features/vocabulary/models/study_session_model.dart new file mode 100644 index 0000000..22bab27 --- /dev/null +++ b/client/lib/features/vocabulary/models/study_session_model.dart @@ -0,0 +1,398 @@ +import 'package:json_annotation/json_annotation.dart'; +import 'word_model.dart'; + +part 'study_session_model.g.dart'; + +/// 学习模式 +enum StudyMode { + @JsonValue('new_words') + newWords, // 学习新单词 + @JsonValue('review') + review, // 复习单词 + @JsonValue('mixed') + mixed, // 混合模式 + @JsonValue('test') + test, // 测试模式 + @JsonValue('quick_review') + quickReview, // 快速复习 +} + +/// 练习类型 +enum ExerciseType { + @JsonValue('word_meaning') + wordMeaning, // 单词释义 + @JsonValue('meaning_word') + meaningWord, // 释义选单词 + @JsonValue('spelling') + spelling, // 拼写练习 + @JsonValue('listening') + listening, // 听力练习 + @JsonValue('sentence_completion') + sentenceCompletion, // 句子填空 + @JsonValue('synonym_antonym') + synonymAntonym, // 同义词反义词 + @JsonValue('image_word') + imageWord, // 图片识词 +} + +/// 答题结果 +enum AnswerResult { + @JsonValue('correct') + correct, + @JsonValue('wrong') + wrong, + @JsonValue('skipped') + skipped, +} + +/// 学习会话 +@JsonSerializable() +class StudySession { + /// 会话ID + final String id; + + /// 用户ID + final String userId; + + /// 词汇书ID + final String? vocabularyBookId; + + /// 学习模式 + final StudyMode mode; + + /// 目标单词数 + final int targetWordCount; + + /// 实际学习单词数 + final int actualWordCount; + + /// 正确答题数 + final int correctAnswers; + + /// 错误答题数 + final int wrongAnswers; + + /// 跳过答题数 + final int skippedAnswers; + + /// 学习时长（秒） + final int durationSeconds; + + /// 准确率 + final double accuracy; + + /// 获得经验值 + final int experienceGained; + + /// 获得积分 + final int pointsGained; + + /// 是否完成 + final bool isCompleted; + + /// 开始时间 + final DateTime startedAt; + + /// 结束时间 + final DateTime? endedAt; + + /// 创建时间 + final DateTime createdAt; + + const StudySession({ + required this.id, + required this.userId, + this.vocabularyBookId, + required this.mode, + required this.targetWordCount, + this.actualWordCount = 0, + this.correctAnswers = 0, + this.wrongAnswers = 0, + this.skippedAnswers = 0, + this.durationSeconds = 0, + this.accuracy = 0.0, + this.experienceGained = 0, + this.pointsGained = 0, + this.isCompleted = false, + required this.startedAt, + this.endedAt, + required this.createdAt, + }); + + factory StudySession.fromJson(Map json) => _$StudySessionFromJson(json); + Map toJson() => _$StudySessionToJson(this); + + StudySession copyWith({ + String? id, + String? userId, + String? vocabularyBookId, + StudyMode? mode, + int? targetWordCount, + int? actualWordCount, + int? correctAnswers, + int? wrongAnswers, + int? skippedAnswers, + int? durationSeconds, + double? accuracy, + int? experienceGained, + int? pointsGained, + bool? isCompleted, + DateTime? startedAt, + DateTime? endedAt, + DateTime? createdAt, + }) { + return StudySession( + id: id ?? this.id, + userId: userId ?? this.userId, + vocabularyBookId: vocabularyBookId ?? this.vocabularyBookId, + mode: mode ?? this.mode, + targetWordCount: targetWordCount ?? this.targetWordCount, + actualWordCount: actualWordCount ?? this.actualWordCount, + correctAnswers: correctAnswers ?? this.correctAnswers, + wrongAnswers: wrongAnswers ?? this.wrongAnswers, + skippedAnswers: skippedAnswers ?? this.skippedAnswers, + durationSeconds: durationSeconds ?? this.durationSeconds, + accuracy: accuracy ?? this.accuracy, + experienceGained: experienceGained ?? this.experienceGained, + pointsGained: pointsGained ?? this.pointsGained, + isCompleted: isCompleted ?? this.isCompleted, + startedAt: startedAt ?? this.startedAt, + endedAt: endedAt ?? this.endedAt, + createdAt: createdAt ?? this.createdAt, + ); + } + + /// 总答题数 + int get totalAnswers => correctAnswers + wrongAnswers + skippedAnswers; + + /// 计算准确率 + double calculateAccuracy() { + if (totalAnswers == 0) return 0.0; + return correctAnswers / totalAnswers; + } + + /// 学习时长（分钟） + double get durationMinutes => durationSeconds / 60.0; +} + +/// 单词练习记录 +@JsonSerializable() +class WordExerciseRecord { + /// 记录ID + final String id; + + /// 学习会话ID + final String sessionId; + + /// 单词ID + final String wordId; + + /// 练习类型 + final ExerciseType exerciseType; + + /// 用户答案 + final String userAnswer; + + /// 正确答案 + final String correctAnswer; + + /// 答题结果 + final AnswerResult result; + + /// 答题时间（秒） + final int responseTimeSeconds; + + /// 提示次数 + final int hintCount; + + /// 单词信息 + final Word? word; + + /// 答题时间 + final DateTime answeredAt; + + const WordExerciseRecord({ + required this.id, + required this.sessionId, + required this.wordId, + required this.exerciseType, + required this.userAnswer, + required this.correctAnswer, + required this.result, + required this.responseTimeSeconds, + this.hintCount = 0, + this.word, + required this.answeredAt, + }); + + factory WordExerciseRecord.fromJson(Map json) => _$WordExerciseRecordFromJson(json); + Map toJson() => _$WordExerciseRecordToJson(this); + + WordExerciseRecord copyWith({ + String? id, + String? sessionId, + String? wordId, + ExerciseType? exerciseType, + String? userAnswer, + String? correctAnswer, + AnswerResult? result, + int? responseTimeSeconds, + int? hintCount, + Word? word, + DateTime? answeredAt, + }) { + return WordExerciseRecord( + id: id ?? this.id, + sessionId: sessionId ?? this.sessionId, + wordId: wordId ?? this.wordId, + exerciseType: exerciseType ?? this.exerciseType, + userAnswer: userAnswer ?? this.userAnswer, + correctAnswer: correctAnswer ?? this.correctAnswer, + result: result ?? this.result, + responseTimeSeconds: responseTimeSeconds ?? this.responseTimeSeconds, + hintCount: hintCount ?? this.hintCount, + word: word ?? this.word, + answeredAt: answeredAt ?? this.answeredAt, + ); + } + + /// 是否正确 + bool get isCorrect => result == AnswerResult.correct; + + /// 是否错误 + bool get isWrong => result == AnswerResult.wrong; + + /// 是否跳过 + bool get isSkipped => result == AnswerResult.skipped; + + /// 答题时间（分钟） + double get responseTimeMinutes => responseTimeSeconds / 60.0; +} + +/// 学习统计 +@JsonSerializable() +class StudyStatistics { + /// 统计ID + final String id; + + /// 用户ID + @JsonKey(name: 'user_id') + final String userId; + + /// 统计日期 + final DateTime date; + + /// 学习会话数 + @JsonKey(name: 'session_count') + final int sessionCount; + + /// 学习单词数 + @JsonKey(name: 'words_studied') + final int wordsStudied; + + /// 新学单词数 + @JsonKey(name: 'new_words_learned') + final int newWordsLearned; + + /// 复习单词数 + @JsonKey(name: 'words_reviewed') + final int wordsReviewed; + + /// 掌握单词数 + @JsonKey(name: 'words_mastered') + final int wordsMastered; + + /// 学习时长（秒） + @JsonKey(name: 'total_study_time_seconds') + final int totalStudyTimeSeconds; + + /// 正确答题数 + @JsonKey(name: 'correct_answers') + final int correctAnswers; + + /// 错误答题数 + @JsonKey(name: 'wrong_answers') + final int wrongAnswers; + + /// 平均准确率 + @JsonKey(name: 'average_accuracy') + final double averageAccuracy; + + /// 获得经验值 + @JsonKey(name: 'experience_gained') + final int experienceGained; + + /// 获得积分 + @JsonKey(name: 'points_gained') + final int pointsGained; + + /// 连续学习天数 + @JsonKey(name: 'streak_days') + final int streakDays; + + const StudyStatistics({ + required this.id, + required this.userId, + required this.date, + this.sessionCount = 0, + this.wordsStudied = 0, + this.newWordsLearned = 0, + this.wordsReviewed = 0, + this.wordsMastered = 0, + this.totalStudyTimeSeconds = 0, + this.correctAnswers = 0, + this.wrongAnswers = 0, + this.averageAccuracy = 0.0, + this.experienceGained = 0, + this.pointsGained = 0, + this.streakDays = 0, + }); + + factory StudyStatistics.fromJson(Map json) => _$StudyStatisticsFromJson(json); + Map toJson() => _$StudyStatisticsToJson(this); + + StudyStatistics copyWith({ + String? id, + String? userId, + DateTime? date, + int? sessionCount, + int? wordsStudied, + int? newWordsLearned, + int? wordsReviewed, + int? wordsMastered, + int? totalStudyTimeSeconds, + int? correctAnswers, + int? wrongAnswers, + double? averageAccuracy, + int? experienceGained, + int? pointsGained, + int? streakDays, + }) { + return StudyStatistics( + id: id ?? this.id, + userId: userId ?? this.userId, + date: date ?? this.date, + sessionCount: sessionCount ?? this.sessionCount, + wordsStudied: wordsStudied ?? this.wordsStudied, + newWordsLearned: newWordsLearned ?? this.newWordsLearned, + wordsReviewed: wordsReviewed ?? this.wordsReviewed, + wordsMastered: wordsMastered ?? this.wordsMastered, + totalStudyTimeSeconds: totalStudyTimeSeconds ?? this.totalStudyTimeSeconds, + correctAnswers: correctAnswers ?? this.correctAnswers, + wrongAnswers: wrongAnswers ?? this.wrongAnswers, + averageAccuracy: averageAccuracy ?? this.averageAccuracy, + experienceGained: experienceGained ?? this.experienceGained, + pointsGained: pointsGained ?? this.pointsGained, + streakDays: streakDays ?? this.streakDays, + ); + } + + /// 总答题数 + int get totalAnswers => correctAnswers + wrongAnswers; + + /// 学习时长（分钟） + double get totalStudyTimeMinutes => totalStudyTimeSeconds / 60.0; + + /// 学习时长（小时） + double get totalStudyTimeHours => totalStudyTimeSeconds / 3600.0; +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/study_session_model.g.dart b/client/lib/features/vocabulary/models/study_session_model.g.dart new file mode 100644 index 0000000..fd07046 --- /dev/null +++ b/client/lib/features/vocabulary/models/study_session_model.g.dart @@ -0,0 +1,145 @@ +// GENERATED CODE - DO NOT MODIFY BY HAND + +part of 'study_session_model.dart'; + +// ************************************************************************** +// JsonSerializableGenerator +// ************************************************************************** + +StudySession _$StudySessionFromJson(Map json) => StudySession( + id: json['id'] as String, + userId: json['userId'] as String, + vocabularyBookId: json['vocabularyBookId'] as String?, + mode: $enumDecode(_$StudyModeEnumMap, json['mode']), + targetWordCount: (json['targetWordCount'] as num).toInt(), + actualWordCount: (json['actualWordCount'] as num?)?.toInt() ?? 0, + correctAnswers: (json['correctAnswers'] as num?)?.toInt() ?? 0, + wrongAnswers: (json['wrongAnswers'] as num?)?.toInt() ?? 0, + skippedAnswers: (json['skippedAnswers'] as num?)?.toInt() ?? 0, + durationSeconds: (json['durationSeconds'] as num?)?.toInt() ?? 0, + accuracy: (json['accuracy'] as num?)?.toDouble() ?? 0.0, + experienceGained: (json['experienceGained'] as num?)?.toInt() ?? 0, + pointsGained: (json['pointsGained'] as num?)?.toInt() ?? 0, + isCompleted: json['isCompleted'] as bool? ?? false, + startedAt: DateTime.parse(json['startedAt'] as String), + endedAt: json['endedAt'] == null + ? null + : DateTime.parse(json['endedAt'] as String), + createdAt: DateTime.parse(json['createdAt'] as String), + ); + +Map _$StudySessionToJson(StudySession instance) => + { + 'id': instance.id, + 'userId': instance.userId, + 'vocabularyBookId': instance.vocabularyBookId, + 'mode': _$StudyModeEnumMap[instance.mode]!, + 'targetWordCount': instance.targetWordCount, + 'actualWordCount': instance.actualWordCount, + 'correctAnswers': instance.correctAnswers, + 'wrongAnswers': instance.wrongAnswers, + 'skippedAnswers': instance.skippedAnswers, + 'durationSeconds': instance.durationSeconds, + 'accuracy': instance.accuracy, + 'experienceGained': instance.experienceGained, + 'pointsGained': instance.pointsGained, + 'isCompleted': instance.isCompleted, + 'startedAt': instance.startedAt.toIso8601String(), + 'endedAt': instance.endedAt?.toIso8601String(), + 'createdAt': instance.createdAt.toIso8601String(), + }; + +const _$StudyModeEnumMap = { + StudyMode.newWords: 'new_words', + StudyMode.review: 'review', + StudyMode.mixed: 'mixed', + StudyMode.test: 'test', + StudyMode.quickReview: 'quick_review', +}; + +WordExerciseRecord _$WordExerciseRecordFromJson(Map json) => + WordExerciseRecord( + id: json['id'] as String, + sessionId: json['sessionId'] as String, + wordId: json['wordId'] as String, + exerciseType: $enumDecode(_$ExerciseTypeEnumMap, json['exerciseType']), + userAnswer: json['userAnswer'] as String, + correctAnswer: json['correctAnswer'] as String, + result: $enumDecode(_$AnswerResultEnumMap, json['result']), + responseTimeSeconds: (json['responseTimeSeconds'] as num).toInt(), + hintCount: (json['hintCount'] as num?)?.toInt() ?? 0, + word: json['word'] == null + ? null + : Word.fromJson(json['word'] as Map), + answeredAt: DateTime.parse(json['answeredAt'] as String), + ); + +Map _$WordExerciseRecordToJson(WordExerciseRecord instance) => + { + 'id': instance.id, + 'sessionId': instance.sessionId, + 'wordId': instance.wordId, + 'exerciseType': _$ExerciseTypeEnumMap[instance.exerciseType]!, + 'userAnswer': instance.userAnswer, + 'correctAnswer': instance.correctAnswer, + 'result': _$AnswerResultEnumMap[instance.result]!, + 'responseTimeSeconds': instance.responseTimeSeconds, + 'hintCount': instance.hintCount, + 'word': instance.word, + 'answeredAt': instance.answeredAt.toIso8601String(), + }; + +const _$ExerciseTypeEnumMap = { + ExerciseType.wordMeaning: 'word_meaning', + ExerciseType.meaningWord: 'meaning_word', + ExerciseType.spelling: 'spelling', + ExerciseType.listening: 'listening', + ExerciseType.sentenceCompletion: 'sentence_completion', + ExerciseType.synonymAntonym: 'synonym_antonym', + ExerciseType.imageWord: 'image_word', +}; + +const _$AnswerResultEnumMap = { + AnswerResult.correct: 'correct', + AnswerResult.wrong: 'wrong', + AnswerResult.skipped: 'skipped', +}; + +StudyStatistics _$StudyStatisticsFromJson(Map json) => + StudyStatistics( + id: json['id'] as String, + userId: json['user_id'] as String, + date: DateTime.parse(json['date'] as String), + sessionCount: (json['session_count'] as num?)?.toInt() ?? 0, + wordsStudied: (json['words_studied'] as num?)?.toInt() ?? 0, + newWordsLearned: (json['new_words_learned'] as num?)?.toInt() ?? 0, + wordsReviewed: (json['words_reviewed'] as num?)?.toInt() ?? 0, + wordsMastered: (json['words_mastered'] as num?)?.toInt() ?? 0, + totalStudyTimeSeconds: + (json['total_study_time_seconds'] as num?)?.toInt() ?? 0, + correctAnswers: (json['correct_answers'] as num?)?.toInt() ?? 0, + wrongAnswers: (json['wrong_answers'] as num?)?.toInt() ?? 0, + averageAccuracy: (json['average_accuracy'] as num?)?.toDouble() ?? 0.0, + experienceGained: (json['experience_gained'] as num?)?.toInt() ?? 0, + pointsGained: (json['points_gained'] as num?)?.toInt() ?? 0, + streakDays: (json['streak_days'] as num?)?.toInt() ?? 0, + ); + +Map _$StudyStatisticsToJson(StudyStatistics instance) => + { + 'id': instance.id, + 'user_id': instance.userId, + 'date': instance.date.toIso8601String(), + 'session_count': instance.sessionCount, + 'words_studied': instance.wordsStudied, + 'new_words_learned': instance.newWordsLearned, + 'words_reviewed': instance.wordsReviewed, + 'words_mastered': instance.wordsMastered, + 'total_study_time_seconds': instance.totalStudyTimeSeconds, + 'correct_answers': instance.correctAnswers, + 'wrong_answers': instance.wrongAnswers, + 'average_accuracy': instance.averageAccuracy, + 'experience_gained': instance.experienceGained, + 'points_gained': instance.pointsGained, + 'streak_days': instance.streakDays, + }; diff --git a/client/lib/features/vocabulary/models/vocabulary_book_category.dart b/client/lib/features/vocabulary/models/vocabulary_book_category.dart new file mode 100644 index 0000000..055fbe2 --- /dev/null +++ b/client/lib/features/vocabulary/models/vocabulary_book_category.dart @@ -0,0 +1,409 @@ +import 'package:json_annotation/json_annotation.dart'; + +/// 词汇书主分类 +enum VocabularyBookMainCategory { + @JsonValue('academic_stage') + academicStage, // 学段基础词汇 + + @JsonValue('domestic_test') + domesticTest, // 国内应试类词汇 + + @JsonValue('international_test') + internationalTest, // 出国考试类词汇 + + @JsonValue('professional') + professional, // 职业与专业类词汇 + + @JsonValue('functional') + functional, // 功能型词库 +} + +/// 学段基础词汇子分类 +enum AcademicStageCategory { + @JsonValue('primary_school') + primarySchool, // 小学英语词汇 + + @JsonValue('junior_high') + juniorHigh, // 初中英语词汇 + + @JsonValue('senior_high') + seniorHigh, // 高中英语词汇 + + @JsonValue('university') + university, // 大学英语教材词汇 +} + +/// 国内应试类词汇子分类 +enum DomesticTestCategory { + @JsonValue('cet4') + cet4, // 大学四级 + + @JsonValue('cet6') + cet6, // 大学六级 + + @JsonValue('postgraduate') + postgraduate, // 考研英语核心词汇 + + @JsonValue('tem4') + tem4, // 专四 + + @JsonValue('tem8') + tem8, // 专八 + + @JsonValue('adult_bachelor') + adultBachelor, // 专升本 + + @JsonValue('doctoral') + doctoral, // 考博词汇 + + @JsonValue('pets') + pets, // 全国等级考试英语词汇 + + @JsonValue('self_study') + selfStudy, // 成人本科/自考英语词汇 +} + +/// 出国考试类词汇子分类 +enum InternationalTestCategory { + @JsonValue('ielts_academic') + ieltsAcademic, // 雅思学术类 + + @JsonValue('ielts_general') + ieltsGeneral, // 雅思培训类 + + @JsonValue('toefl_ibt') + toeflIbt, // 托福iBT + + @JsonValue('toeic') + toeic, // 托业 + + @JsonValue('gre') + gre, // GRE + + @JsonValue('gmat') + gmat, // GMAT + + @JsonValue('sat') + sat, // SAT + + @JsonValue('ssat') + ssat, // SSAT + + @JsonValue('act') + act, // ACT + + @JsonValue('cambridge_ket') + cambridgeKet, // 剑桥KET + + @JsonValue('cambridge_pet') + cambridgePet, // 剑桥PET + + @JsonValue('cambridge_fce') + cambridgeFce, // 剑桥FCE + + @JsonValue('cambridge_cae') + cambridgeCae, // 剑桥CAE + + @JsonValue('cambridge_cpe') + cambridgeCpe, // 剑桥CPE +} + +/// 职业与专业类词汇子分类 +enum ProfessionalCategory { + @JsonValue('business_english') + businessEnglish, // 商务英语 + + @JsonValue('bec_preliminary') + becPreliminary, // BEC初级 + + @JsonValue('bec_vantage') + becVantage, // BEC中级 + + @JsonValue('bec_higher') + becHigher, // BEC高级 + + @JsonValue('mba') + mba, // MBA + + @JsonValue('finance') + finance, // 金融 + + @JsonValue('accounting') + accounting, // 会计 + + @JsonValue('economics') + economics, // 经济学 + + @JsonValue('cpa') + cpa, // CPA + + @JsonValue('cfa') + cfa, // CFA + + @JsonValue('medical') + medical, // 医学英语 + + @JsonValue('legal') + legal, // 法律英语 + + @JsonValue('engineering') + engineering, // 工程英语 + + @JsonValue('computer_science') + computerScience, // 计算机科学 + + @JsonValue('artificial_intelligence') + artificialIntelligence, // 人工智能 + + @JsonValue('software_engineering') + softwareEngineering, // 软件工程 + + @JsonValue('academic_english') + academicEnglish, // 学术英语(EAP) + + @JsonValue('aviation') + aviation, // 航空 + + @JsonValue('tourism') + tourism, // 旅游 + + @JsonValue('media') + media, // 新闻传媒 +} + +/// 功能型词库子分类 +enum FunctionalCategory { + @JsonValue('roots_affixes') + rootsAffixes, // 词根词缀词汇 + + @JsonValue('synonyms_antonyms') + synonymsAntonyms, // 同义词/反义词 + + @JsonValue('daily_spoken_collocations') + dailySpokenCollocations, // 日常口语常用搭配库 + + @JsonValue('academic_spoken_collocations') + academicSpokenCollocations, // 学术口语常用搭配库 + + @JsonValue('academic_writing_collocations') + academicWritingCollocations, // 学术写作常用搭配库 + + @JsonValue('daily_life_english') + dailyLifeEnglish, // 日常生活英语 + + @JsonValue('travel_english') + travelEnglish, // 旅游英语 + + @JsonValue('dining_english') + diningEnglish, // 点餐英语 + + @JsonValue('shopping_english') + shoppingEnglish, // 购物英语 + + @JsonValue('transportation_english') + transportationEnglish, // 出行英语 + + @JsonValue('housing_english') + housingEnglish, // 租房英语 +} + +/// 词汇书分类工具类 +class VocabularyBookCategoryHelper { + /// 获取主分类的中文名称 + static String getMainCategoryName(VocabularyBookMainCategory category) { + switch (category) { + case VocabularyBookMainCategory.academicStage: + return '学段基础词汇'; + case VocabularyBookMainCategory.domesticTest: + return '国内应试类词汇'; + case VocabularyBookMainCategory.internationalTest: + return '出国考试类词汇'; + case VocabularyBookMainCategory.professional: + return '职业与专业类词汇'; + case VocabularyBookMainCategory.functional: + return '功能型词库'; + } + } + + /// 获取学段基础词汇子分类的中文名称 + static String getAcademicStageCategoryName(AcademicStageCategory category) { + switch (category) { + case AcademicStageCategory.primarySchool: + return '小学英语词汇'; + case AcademicStageCategory.juniorHigh: + return '初中英语词汇'; + case AcademicStageCategory.seniorHigh: + return '高中英语词汇'; + case AcademicStageCategory.university: + return '大学英语教材词汇'; + } + } + + /// 获取国内应试类词汇子分类的中文名称 + static String getDomesticTestCategoryName(DomesticTestCategory category) { + switch (category) { + case DomesticTestCategory.cet4: + return '大学四级(CET-4)'; + case DomesticTestCategory.cet6: + return '大学六级(CET-6)'; + case DomesticTestCategory.postgraduate: + return '考研英语核心词汇'; + case DomesticTestCategory.tem4: + return '专四(TEM-4)'; + case DomesticTestCategory.tem8: + return '专八(TEM-8)'; + case DomesticTestCategory.adultBachelor: + return '专升本词汇'; + case DomesticTestCategory.doctoral: + return '考博词汇'; + case DomesticTestCategory.pets: + return '全国等级考试英语词汇'; + case DomesticTestCategory.selfStudy: + return '成人本科/自考英语词汇'; + } + } + + /// 获取出国考试类词汇子分类的中文名称 + static String getInternationalTestCategoryName(InternationalTestCategory category) { + switch (category) { + case InternationalTestCategory.ieltsAcademic: + return '雅思学术类(IELTS Academic)'; + case InternationalTestCategory.ieltsGeneral: + return '雅思培训类(IELTS General)'; + case InternationalTestCategory.toeflIbt: + return '托福(TOEFL iBT)'; + case InternationalTestCategory.toeic: + return '托业(TOEIC)'; + case InternationalTestCategory.gre: + return 'GRE词汇'; + case InternationalTestCategory.gmat: + return 'GMAT词汇'; + case InternationalTestCategory.sat: + return 'SAT词汇'; + case InternationalTestCategory.ssat: + return 'SSAT词汇'; + case InternationalTestCategory.act: + return 'ACT词汇'; + case InternationalTestCategory.cambridgeKet: + return '剑桥KET'; + case InternationalTestCategory.cambridgePet: + return '剑桥PET'; + case InternationalTestCategory.cambridgeFce: + return '剑桥FCE'; + case InternationalTestCategory.cambridgeCae: + return '剑桥CAE'; + case InternationalTestCategory.cambridgeCpe: + return '剑桥CPE'; + } + } + + /// 获取职业与专业类词汇子分类的中文名称 + static String getProfessionalCategoryName(ProfessionalCategory category) { + switch (category) { + case ProfessionalCategory.businessEnglish: + return '商务英语'; + case ProfessionalCategory.becPreliminary: + return 'BEC初级'; + case ProfessionalCategory.becVantage: + return 'BEC中级'; + case ProfessionalCategory.becHigher: + return 'BEC高级'; + case ProfessionalCategory.mba: + return 'MBA词汇'; + case ProfessionalCategory.finance: + return '金融词汇'; + case ProfessionalCategory.accounting: + return '会计词汇'; + case ProfessionalCategory.economics: + return '经济学词汇'; + case ProfessionalCategory.cpa: + return 'CPA词汇'; + case ProfessionalCategory.cfa: + return 'CFA词汇'; + case ProfessionalCategory.medical: + return '医学英语'; + case ProfessionalCategory.legal: + return '法律英语'; + case ProfessionalCategory.engineering: + return '工程英语'; + case ProfessionalCategory.computerScience: + return '计算机科学'; + case ProfessionalCategory.artificialIntelligence: + return '人工智能'; + case ProfessionalCategory.softwareEngineering: + return '软件工程'; + case ProfessionalCategory.academicEnglish: + return '学术英语(EAP)'; + case ProfessionalCategory.aviation: + return '航空英语'; + case ProfessionalCategory.tourism: + return '旅游英语'; + case ProfessionalCategory.media: + return '新闻传媒英语'; + } + } + + /// 获取功能型词库子分类的中文名称 + static String getFunctionalCategoryName(FunctionalCategory category) { + switch (category) { + case FunctionalCategory.rootsAffixes: + return '词根词缀词汇'; + case FunctionalCategory.synonymsAntonyms: + return '同义词/反义词'; + case FunctionalCategory.dailySpokenCollocations: + return '日常口语常用搭配库'; + case FunctionalCategory.academicSpokenCollocations: + return '学术口语常用搭配库'; + case FunctionalCategory.academicWritingCollocations: + return '学术写作常用搭配库'; + case FunctionalCategory.dailyLifeEnglish: + return '日常生活英语'; + case FunctionalCategory.travelEnglish: + return '旅游英语'; + case FunctionalCategory.diningEnglish: + return '点餐英语'; + case FunctionalCategory.shoppingEnglish: + return '购物英语'; + case FunctionalCategory.transportationEnglish: + return '出行英语'; + case FunctionalCategory.housingEnglish: + return '租房英语'; + } + } + + /// 根据主分类获取对应的子分类列表 + static List getSubCategories(VocabularyBookMainCategory mainCategory) { + switch (mainCategory) { + case VocabularyBookMainCategory.academicStage: + return AcademicStageCategory.values.map((e) => getAcademicStageCategoryName(e)).toList(); + case VocabularyBookMainCategory.domesticTest: + return DomesticTestCategory.values.map((e) => getDomesticTestCategoryName(e)).toList(); + case VocabularyBookMainCategory.internationalTest: + return InternationalTestCategory.values.map((e) => getInternationalTestCategoryName(e)).toList(); + case VocabularyBookMainCategory.professional: + return ProfessionalCategory.values.map((e) => getProfessionalCategoryName(e)).toList(); + case VocabularyBookMainCategory.functional: + return FunctionalCategory.values.map((e) => getFunctionalCategoryName(e)).toList(); + } + } + + /// 从中文名称映射到主分类枚举 + static VocabularyBookMainCategory? getMainCategoryFromName(String? categoryName) { + if (categoryName == null) return null; + + switch (categoryName) { + case '学段基础词汇': + return VocabularyBookMainCategory.academicStage; + case '国内应试类词汇': + return VocabularyBookMainCategory.domesticTest; + case '出国考试类词汇': + return VocabularyBookMainCategory.internationalTest; + case '职业与专业类词汇': + return VocabularyBookMainCategory.professional; + case '功能型词库': + return VocabularyBookMainCategory.functional; + default: + return null; + } + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/vocabulary_book_factory.dart b/client/lib/features/vocabulary/models/vocabulary_book_factory.dart new file mode 100644 index 0000000..6333eaf --- /dev/null +++ b/client/lib/features/vocabulary/models/vocabulary_book_factory.dart @@ -0,0 +1,440 @@ +import 'vocabulary_book_model.dart'; +import 'vocabulary_book_category.dart'; + +/// 词汇书工厂类，用于生成各种分类的词汇书数据 +class VocabularyBookFactory { + + /// 获取推荐词汇书 + static List getRecommendedBooks({int limit = 8}) { + final allBooks = []; + + // 添加学段基础词汇 + allBooks.addAll(getAcademicStageBooks().take(2)); + + // 添加国内考试词汇 + allBooks.addAll(getDomesticTestBooks().take(2)); + + // 添加国际考试词汇 + allBooks.addAll(getInternationalTestBooks().take(2)); + + // 添加职业专业词汇 + allBooks.addAll(getProfessionalBooks().take(1)); + + // 添加功能型词汇 + allBooks.addAll(getFunctionalBooks().take(1)); + + return allBooks.take(limit).toList(); + } + + /// 获取学段基础词汇书 + static List getAcademicStageBooks() { + return [ + // 小学词汇 + VocabularyBook( + id: 'primary_basic', + name: '小学英语基础词汇', + description: '小学阶段必备英语词汇，涵盖日常生活和学习场景', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.beginner, + mainCategory: VocabularyBookMainCategory.academicStage, + subCategory: 'primary', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/primary_vocab.jpg', + totalWords: 800, + tags: ['小学', '基础', '日常'], + targetLevels: ['小学1-3年级', '小学4-6年级'], + estimatedDays: 40, + dailyWordCount: 20, + downloadCount: 25000, + rating: 4.9, + reviewCount: 2500, + createdAt: DateTime.now().subtract(const Duration(days: 500)), + updatedAt: DateTime.now().subtract(const Duration(days: 10)), + ), + + // 初中词汇 + VocabularyBook( + id: 'middle_school_core', + name: '初中英语核心词汇', + description: '初中阶段核心词汇，为中考打下坚实基础', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.elementary, + mainCategory: VocabularyBookMainCategory.academicStage, + subCategory: 'middle_school', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/middle_vocab.jpg', + totalWords: 1600, + tags: ['初中', '中考', '核心'], + targetLevels: ['初一', '初二', '初三'], + estimatedDays: 60, + dailyWordCount: 30, + downloadCount: 35000, + rating: 4.8, + reviewCount: 3500, + createdAt: DateTime.now().subtract(const Duration(days: 450)), + updatedAt: DateTime.now().subtract(const Duration(days: 15)), + ), + + // 高中词汇 + VocabularyBook( + id: 'high_school_essential', + name: '高中英语必备词汇', + description: '高中阶段必备词汇，涵盖高考重点词汇', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + mainCategory: VocabularyBookMainCategory.academicStage, + subCategory: 'high_school', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/high_vocab.jpg', + totalWords: 3500, + tags: ['高中', '高考', '必备'], + targetLevels: ['高一', '高二', '高三'], + estimatedDays: 100, + dailyWordCount: 35, + downloadCount: 45000, + rating: 4.7, + reviewCount: 4500, + createdAt: DateTime.now().subtract(const Duration(days: 400)), + updatedAt: DateTime.now().subtract(const Duration(days: 20)), + ), + + // 大学词汇 + VocabularyBook( + id: 'college_advanced', + name: '大学英语进阶词汇', + description: '大学阶段进阶词汇，提升学术英语水平', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + mainCategory: VocabularyBookMainCategory.academicStage, + subCategory: 'college', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/college_vocab.jpg', + totalWords: 5000, + tags: ['大学', '学术', '进阶'], + targetLevels: ['大一', '大二', '大三', '大四'], + estimatedDays: 120, + dailyWordCount: 40, + downloadCount: 30000, + rating: 4.6, + reviewCount: 3000, + createdAt: DateTime.now().subtract(const Duration(days: 350)), + updatedAt: DateTime.now().subtract(const Duration(days: 25)), + ), + ]; + } + + /// 获取国内考试词汇书 + static List getDomesticTestBooks() { + return [ + // 四级词汇 + VocabularyBook( + id: 'cet4_core', + name: '大学英语四级词汇', + description: '四级考试核心词汇，系统化备考', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + mainCategory: VocabularyBookMainCategory.domesticTest, + subCategory: 'cet4', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/cet4_vocab.jpg', + totalWords: 4000, + tags: ['四级', '考试', '核心'], + targetLevels: ['四级425+', '四级500+'], + estimatedDays: 80, + dailyWordCount: 50, + downloadCount: 50000, + rating: 4.8, + reviewCount: 5000, + createdAt: DateTime.now().subtract(const Duration(days: 300)), + updatedAt: DateTime.now().subtract(const Duration(days: 5)), + ), + + // 六级词汇 + VocabularyBook( + id: 'cet6_advanced', + name: '大学英语六级词汇', + description: '六级考试高级词汇，突破高分', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + mainCategory: VocabularyBookMainCategory.domesticTest, + subCategory: 'cet6', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/cet6_vocab.jpg', + totalWords: 2500, + tags: ['六级', '高级', '突破'], + targetLevels: ['六级425+', '六级500+'], + estimatedDays: 60, + dailyWordCount: 45, + downloadCount: 40000, + rating: 4.7, + reviewCount: 4000, + createdAt: DateTime.now().subtract(const Duration(days: 280)), + updatedAt: DateTime.now().subtract(const Duration(days: 8)), + ), + + // 考研词汇 + VocabularyBook( + id: 'postgraduate_essential', + name: '考研英语核心词汇', + description: '考研英语必备词汇，全面覆盖考点', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + mainCategory: VocabularyBookMainCategory.domesticTest, + subCategory: 'postgraduate', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/postgrad_vocab.jpg', + totalWords: 5500, + tags: ['考研', '核心', '全面'], + targetLevels: ['考研英语一', '考研英语二'], + estimatedDays: 120, + dailyWordCount: 45, + downloadCount: 60000, + rating: 4.9, + reviewCount: 6000, + createdAt: DateTime.now().subtract(const Duration(days: 250)), + updatedAt: DateTime.now().subtract(const Duration(days: 3)), + ), + + // 专四词汇 + VocabularyBook( + id: 'tem4_professional', + name: '英语专业四级词汇', + description: '专四考试专业词汇，英语专业必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + mainCategory: VocabularyBookMainCategory.domesticTest, + subCategory: 'tem4', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/tem4_vocab.jpg', + totalWords: 8000, + tags: ['专四', '专业', '英语'], + targetLevels: ['英语专业大二'], + estimatedDays: 150, + dailyWordCount: 55, + downloadCount: 25000, + rating: 4.6, + reviewCount: 2500, + createdAt: DateTime.now().subtract(const Duration(days: 200)), + updatedAt: DateTime.now().subtract(const Duration(days: 12)), + ), + ]; + } + + /// 获取国际考试词汇书 + static List getInternationalTestBooks() { + return [ + // 托福词汇 + VocabularyBook( + id: 'toefl_core', + name: '托福核心词汇', + description: '托福考试必备核心词汇，涵盖学术和日常用语', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.advanced, + mainCategory: VocabularyBookMainCategory.internationalTest, + subCategory: 'toefl', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/toefl_vocab.jpg', + totalWords: 5000, + tags: ['托福', '学术', '高级'], + targetLevels: ['托福80+', '托福100+'], + estimatedDays: 100, + dailyWordCount: 50, + downloadCount: 35000, + rating: 4.8, + reviewCount: 3500, + createdAt: DateTime.now().subtract(const Duration(days: 365)), + updatedAt: DateTime.now().subtract(const Duration(days: 30)), + ), + + // 雅思词汇 + VocabularyBook( + id: 'ielts_essential', + name: '雅思核心词汇', + description: '雅思考试核心词汇，按话题分类整理', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + mainCategory: VocabularyBookMainCategory.internationalTest, + subCategory: 'ielts', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/ielts_vocab.jpg', + totalWords: 4000, + tags: ['雅思', '分类', '中级'], + targetLevels: ['雅思6.0', '雅思7.0'], + estimatedDays: 80, + dailyWordCount: 50, + downloadCount: 42000, + rating: 4.7, + reviewCount: 4200, + createdAt: DateTime.now().subtract(const Duration(days: 300)), + updatedAt: DateTime.now().subtract(const Duration(days: 15)), + ), + + // GRE词汇 + VocabularyBook( + id: 'gre_advanced', + name: 'GRE高级词汇', + description: 'GRE考试高难度词汇，学术研究必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.expert, + mainCategory: VocabularyBookMainCategory.internationalTest, + subCategory: 'gre', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/gre_vocab.jpg', + totalWords: 6000, + tags: ['GRE', '高难度', '学术'], + targetLevels: ['GRE 320+', 'GRE 330+'], + estimatedDays: 150, + dailyWordCount: 40, + downloadCount: 20000, + rating: 4.5, + reviewCount: 2000, + createdAt: DateTime.now().subtract(const Duration(days: 180)), + updatedAt: DateTime.now().subtract(const Duration(days: 7)), + ), + ]; + } + + /// 获取职业专业词汇书 + static List getProfessionalBooks() { + return [ + // 商务英语 + VocabularyBook( + id: 'business_english', + name: '商务英语词汇', + description: '商务场景专业词汇，职场必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + mainCategory: VocabularyBookMainCategory.professional, + subCategory: 'business', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/business_vocab.jpg', + totalWords: 2000, + tags: ['商务', '职场', '专业'], + targetLevels: ['职场新人', '商务精英'], + estimatedDays: 50, + dailyWordCount: 40, + downloadCount: 18000, + rating: 4.6, + reviewCount: 1800, + createdAt: DateTime.now().subtract(const Duration(days: 120)), + updatedAt: DateTime.now().subtract(const Duration(days: 5)), + ), + + // IT技术词汇 + VocabularyBook( + id: 'it_technical', + name: 'IT技术词汇', + description: '信息技术专业词汇，程序员必备', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + mainCategory: VocabularyBookMainCategory.professional, + subCategory: 'it', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/it_vocab.jpg', + totalWords: 1500, + tags: ['IT', '技术', '程序员'], + targetLevels: ['初级程序员', '高级工程师'], + estimatedDays: 40, + dailyWordCount: 35, + downloadCount: 15000, + rating: 4.7, + reviewCount: 1500, + createdAt: DateTime.now().subtract(const Duration(days: 100)), + updatedAt: DateTime.now().subtract(const Duration(days: 8)), + ), + ]; + } + + /// 获取功能型词汇书 + static List getFunctionalBooks() { + return [ + // 词根词缀 + VocabularyBook( + id: 'roots_affixes', + name: '词根词缀大全', + description: '掌握词根词缀，快速扩展词汇量', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.intermediate, + mainCategory: VocabularyBookMainCategory.functional, + subCategory: 'roots_affixes', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/roots_vocab.jpg', + totalWords: 800, + tags: ['词根', '词缀', '技巧'], + targetLevels: ['中级学习者', '高级学习者'], + estimatedDays: 30, + dailyWordCount: 25, + downloadCount: 22000, + rating: 4.8, + reviewCount: 2200, + createdAt: DateTime.now().subtract(const Duration(days: 90)), + updatedAt: DateTime.now().subtract(const Duration(days: 3)), + ), + + // 日常口语 + VocabularyBook( + id: 'daily_speaking', + name: '日常口语词汇', + description: '日常交流必备词汇，提升口语表达', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.elementary, + mainCategory: VocabularyBookMainCategory.functional, + subCategory: 'speaking', + coverImageUrl: 'https://ai-public.mastergo.com/ai/img_res/speaking_vocab.jpg', + totalWords: 1200, + tags: ['口语', '日常', '交流'], + targetLevels: ['初级', '中级'], + estimatedDays: 35, + dailyWordCount: 35, + downloadCount: 28000, + rating: 4.9, + reviewCount: 2800, + createdAt: DateTime.now().subtract(const Duration(days: 80)), + updatedAt: DateTime.now().subtract(const Duration(days: 2)), + ), + ]; + } + + /// 根据主分类获取词汇书 + static List getBooksByMainCategory(VocabularyBookMainCategory category) { + switch (category) { + case VocabularyBookMainCategory.academicStage: + return getAcademicStageBooks(); + case VocabularyBookMainCategory.domesticTest: + return getDomesticTestBooks(); + case VocabularyBookMainCategory.internationalTest: + return getInternationalTestBooks(); + case VocabularyBookMainCategory.professional: + return getProfessionalBooks(); + case VocabularyBookMainCategory.functional: + return getFunctionalBooks(); + } + } + + /// 根据子分类获取词汇书 + static List getBooksBySubCategory(String subCategory) { + final allBooks = []; + allBooks.addAll(getAcademicStageBooks()); + allBooks.addAll(getDomesticTestBooks()); + allBooks.addAll(getInternationalTestBooks()); + allBooks.addAll(getProfessionalBooks()); + allBooks.addAll(getFunctionalBooks()); + + return allBooks.where((book) => book.subCategory == subCategory).toList(); + } + + /// 根据难度获取词汇书 + static List getBooksByDifficulty(VocabularyBookDifficulty difficulty) { + final allBooks = []; + allBooks.addAll(getAcademicStageBooks()); + allBooks.addAll(getDomesticTestBooks()); + allBooks.addAll(getInternationalTestBooks()); + allBooks.addAll(getProfessionalBooks()); + allBooks.addAll(getFunctionalBooks()); + + return allBooks.where((book) => book.difficulty == difficulty).toList(); + } + + /// 搜索词汇书 + static List searchBooks(String query) { + final allBooks = []; + allBooks.addAll(getAcademicStageBooks()); + allBooks.addAll(getDomesticTestBooks()); + allBooks.addAll(getInternationalTestBooks()); + allBooks.addAll(getProfessionalBooks()); + allBooks.addAll(getFunctionalBooks()); + + final lowerQuery = query.toLowerCase(); + return allBooks.where((book) { + return book.name.toLowerCase().contains(lowerQuery) || + book.description?.toLowerCase().contains(lowerQuery) == true || + book.tags.any((tag) => tag.toLowerCase().contains(lowerQuery)); + }).toList(); + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/vocabulary_book_model.dart b/client/lib/features/vocabulary/models/vocabulary_book_model.dart new file mode 100644 index 0000000..f991565 --- /dev/null +++ b/client/lib/features/vocabulary/models/vocabulary_book_model.dart @@ -0,0 +1,388 @@ +import 'package:json_annotation/json_annotation.dart'; +import 'word_model.dart'; +import 'vocabulary_book_category.dart'; + +part 'vocabulary_book_model.g.dart'; + +/// 词汇书类型 +enum VocabularyBookType { + @JsonValue('system') + system, // 系统词汇书 + @JsonValue('custom') + custom, // 用户自定义词汇书 + @JsonValue('shared') + shared, // 共享词汇书 +} + +/// 词汇书难度 +enum VocabularyBookDifficulty { + @JsonValue('beginner') + beginner, + @JsonValue('elementary') + elementary, + @JsonValue('intermediate') + intermediate, + @JsonValue('advanced') + advanced, + @JsonValue('expert') + expert, +} + +/// 词汇书模型 +@JsonSerializable() +class VocabularyBook { + /// 词汇书ID + final String id; + + /// 词汇书名称 + final String name; + + /// 词汇书描述 + final String? description; + + /// 词汇书类型 + @JsonKey(defaultValue: VocabularyBookType.system) + final VocabularyBookType type; + + /// 难度等级 + @JsonKey(name: 'level') + final VocabularyBookDifficulty difficulty; + + /// 封面图片URL + @JsonKey(name: 'cover_image') + final String? coverImageUrl; + + /// 单词总数 + @JsonKey(name: 'total_words') + final int totalWords; + + /// 创建者ID + @JsonKey(name: 'creator_id') + final String? creatorId; + + /// 创建者名称 + @JsonKey(name: 'creator_name') + final String? creatorName; + + /// 是否公开 + @JsonKey(name: 'is_public', defaultValue: false) + final bool isPublic; + + /// 标签列表 + @JsonKey(defaultValue: []) + final List tags; + + /// 分类 + final String? category; + + /// 主分类 + @JsonKey(name: 'main_category') + final VocabularyBookMainCategory? mainCategory; + + /// 子分类（JSON字符串，根据主分类解析为对应的子分类枚举） + @JsonKey(name: 'sub_category') + final String? subCategory; + + /// 适用等级 + @JsonKey(name: 'target_levels', defaultValue: []) + final List targetLevels; + + /// 预计学习天数 + @JsonKey(name: 'estimated_days', defaultValue: 30) + final int estimatedDays; + + /// 每日学习单词数 + @JsonKey(name: 'daily_word_count', defaultValue: 20) + final int dailyWordCount; + + /// 下载次数 + @JsonKey(name: 'download_count', defaultValue: 0) + final int downloadCount; + + /// 评分 (1-5) + @JsonKey(defaultValue: 0.0) + final double rating; + + /// 评价数量 + @JsonKey(name: 'review_count', defaultValue: 0) + final int reviewCount; + + /// 创建时间 + @JsonKey(name: 'created_at') + final DateTime createdAt; + + /// 更新时间 + @JsonKey(name: 'updated_at') + final DateTime updatedAt; + + const VocabularyBook({ + required this.id, + required this.name, + this.description, + required this.type, + required this.difficulty, + this.coverImageUrl, + required this.totalWords, + this.creatorId, + this.creatorName, + this.isPublic = false, + this.tags = const [], + this.category, + this.mainCategory, + this.subCategory, + this.targetLevels = const [], + this.estimatedDays = 30, + this.dailyWordCount = 20, + this.downloadCount = 0, + this.rating = 0.0, + this.reviewCount = 0, + required this.createdAt, + required this.updatedAt, + }); + + factory VocabularyBook.fromJson(Map json) { + final book = _$VocabularyBookFromJson(json); + // 如果有category字符串但没有mainCategory，则从category映射 + if (book.category != null && book.mainCategory == null) { + return book.copyWith( + mainCategory: VocabularyBookCategoryHelper.getMainCategoryFromName(book.category), + ); + } + return book; + } + + Map toJson() => _$VocabularyBookToJson(this); + + VocabularyBook copyWith({ + String? id, + String? name, + String? description, + VocabularyBookType? type, + VocabularyBookDifficulty? difficulty, + String? coverImageUrl, + int? totalWords, + String? creatorId, + String? creatorName, + bool? isPublic, + List? tags, + String? category, + VocabularyBookMainCategory? mainCategory, + String? subCategory, + List? targetLevels, + int? estimatedDays, + int? dailyWordCount, + int? downloadCount, + double? rating, + int? reviewCount, + DateTime? createdAt, + DateTime? updatedAt, + }) { + return VocabularyBook( + id: id ?? this.id, + name: name ?? this.name, + description: description ?? this.description, + type: type ?? this.type, + difficulty: difficulty ?? this.difficulty, + coverImageUrl: coverImageUrl ?? this.coverImageUrl, + totalWords: totalWords ?? this.totalWords, + creatorId: creatorId ?? this.creatorId, + creatorName: creatorName ?? this.creatorName, + isPublic: isPublic ?? this.isPublic, + tags: tags ?? this.tags, + category: category ?? this.category, + mainCategory: mainCategory ?? this.mainCategory, + subCategory: subCategory ?? this.subCategory, + targetLevels: targetLevels ?? this.targetLevels, + estimatedDays: estimatedDays ?? this.estimatedDays, + dailyWordCount: dailyWordCount ?? this.dailyWordCount, + downloadCount: downloadCount ?? this.downloadCount, + rating: rating ?? this.rating, + reviewCount: reviewCount ?? this.reviewCount, + createdAt: createdAt ?? this.createdAt, + updatedAt: updatedAt ?? this.updatedAt, + ); + } +} + +/// 用户词汇书学习进度 +@JsonSerializable() +class UserVocabularyBookProgress { + /// 进度ID + @JsonKey(fromJson: _idFromJson) + final String id; + + /// 用户ID + @JsonKey(name: 'user_id', fromJson: _userIdFromJson) + final String userId; + + /// 词汇书ID + @JsonKey(name: 'book_id') + final String vocabularyBookId; + + /// 已学习单词数 + @JsonKey(name: 'learned_words') + final int learnedWords; + + /// 已掌握单词数 + @JsonKey(name: 'mastered_words') + final int masteredWords; + + /// 学习进度百分比 (0-100) + @JsonKey(name: 'progress_percentage') + final double progressPercentage; + + /// 连续学习天数 + @JsonKey(name: 'streak_days') + final int streakDays; + + /// 总学习天数 + @JsonKey(name: 'total_study_days') + final int totalStudyDays; + + /// 平均每日学习单词数 + @JsonKey(name: 'average_daily_words') + final double averageDailyWords; + + /// 预计完成时间 + @JsonKey(name: 'estimated_completion_date') + final DateTime? estimatedCompletionDate; + + /// 是否已完成 + @JsonKey(name: 'is_completed') + final bool isCompleted; + + /// 完成时间 + @JsonKey(name: 'completed_at') + final DateTime? completedAt; + + /// 开始学习时间 + @JsonKey(name: 'started_at') + final DateTime startedAt; + + /// 最后学习时间 + @JsonKey(name: 'last_studied_at') + final DateTime? lastStudiedAt; + + const UserVocabularyBookProgress({ + required this.id, + required this.userId, + required this.vocabularyBookId, + this.learnedWords = 0, + this.masteredWords = 0, + this.progressPercentage = 0.0, + this.streakDays = 0, + this.totalStudyDays = 0, + this.averageDailyWords = 0.0, + this.estimatedCompletionDate, + this.isCompleted = false, + this.completedAt, + required this.startedAt, + this.lastStudiedAt, + }); + + factory UserVocabularyBookProgress.fromJson(Map json) => _$UserVocabularyBookProgressFromJson(json); + Map toJson() => _$UserVocabularyBookProgressToJson(this); + + /// 类型转换方法 + static String _idFromJson(dynamic value) => value?.toString() ?? '0'; + static String _userIdFromJson(dynamic value) => value?.toString() ?? '0'; + + UserVocabularyBookProgress copyWith({ + String? id, + String? userId, + String? vocabularyBookId, + int? learnedWords, + int? masteredWords, + double? progressPercentage, + int? streakDays, + int? totalStudyDays, + double? averageDailyWords, + DateTime? estimatedCompletionDate, + bool? isCompleted, + DateTime? completedAt, + DateTime? startedAt, + DateTime? lastStudiedAt, + }) { + return UserVocabularyBookProgress( + id: id ?? this.id, + userId: userId ?? this.userId, + vocabularyBookId: vocabularyBookId ?? this.vocabularyBookId, + learnedWords: learnedWords ?? this.learnedWords, + masteredWords: masteredWords ?? this.masteredWords, + progressPercentage: progressPercentage ?? this.progressPercentage, + streakDays: streakDays ?? this.streakDays, + totalStudyDays: totalStudyDays ?? this.totalStudyDays, + averageDailyWords: averageDailyWords ?? this.averageDailyWords, + estimatedCompletionDate: estimatedCompletionDate ?? this.estimatedCompletionDate, + isCompleted: isCompleted ?? this.isCompleted, + completedAt: completedAt ?? this.completedAt, + startedAt: startedAt ?? this.startedAt, + lastStudiedAt: lastStudiedAt ?? this.lastStudiedAt, + ); + } +} + +/// 词汇书单词关联 +@JsonSerializable() +class VocabularyBookWord { + /// 关联ID + @JsonKey(name: 'id', fromJson: _idFromJson) + final String id; + + /// 词汇书ID + @JsonKey(name: 'book_id') + final String vocabularyBookId; + + /// 单词ID + @JsonKey(name: 'vocabulary_id') + final String wordId; + + /// 在词汇书中的顺序 + @JsonKey(name: 'sort_order', defaultValue: 0) + final int order; + + /// 单词信息 + final Word? word; + + /// 添加时间 + @JsonKey(name: 'created_at') + final DateTime addedAt; + + const VocabularyBookWord({ + required this.id, + required this.vocabularyBookId, + required this.wordId, + required this.order, + this.word, + required this.addedAt, + }); + + /// 处理id字段的类型转换（后端可能返回int或string） + static String _idFromJson(dynamic value) { + if (value is int) { + return value.toString(); + } + return value.toString(); + } + + factory VocabularyBookWord.fromJson(Map json) => _$VocabularyBookWordFromJson(json); + Map toJson() => _$VocabularyBookWordToJson(this); + + VocabularyBookWord copyWith({ + String? id, + String? vocabularyBookId, + String? wordId, + int? order, + Word? word, + DateTime? addedAt, + }) { + return VocabularyBookWord( + id: id ?? this.id, + vocabularyBookId: vocabularyBookId ?? this.vocabularyBookId, + wordId: wordId ?? this.wordId, + order: order ?? this.order, + word: word ?? this.word, + addedAt: addedAt ?? this.addedAt, + ); + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/vocabulary_book_model.g.dart b/client/lib/features/vocabulary/models/vocabulary_book_model.g.dart new file mode 100644 index 0000000..3458e32 --- /dev/null +++ b/client/lib/features/vocabulary/models/vocabulary_book_model.g.dart @@ -0,0 +1,158 @@ +// GENERATED CODE - DO NOT MODIFY BY HAND + +part of 'vocabulary_book_model.dart'; + +// ************************************************************************** +// JsonSerializableGenerator +// ************************************************************************** + +VocabularyBook _$VocabularyBookFromJson(Map json) => + VocabularyBook( + id: json['id'] as String, + name: json['name'] as String, + description: json['description'] as String?, + type: $enumDecodeNullable(_$VocabularyBookTypeEnumMap, json['type']) ?? + VocabularyBookType.system, + difficulty: $enumDecode(_$VocabularyBookDifficultyEnumMap, json['level']), + coverImageUrl: json['cover_image'] as String?, + totalWords: (json['total_words'] as num).toInt(), + creatorId: json['creator_id'] as String?, + creatorName: json['creator_name'] as String?, + isPublic: json['is_public'] as bool? ?? false, + tags: + (json['tags'] as List?)?.map((e) => e as String).toList() ?? + [], + category: json['category'] as String?, + mainCategory: $enumDecodeNullable( + _$VocabularyBookMainCategoryEnumMap, json['main_category']), + subCategory: json['sub_category'] as String?, + targetLevels: (json['target_levels'] as List?) + ?.map((e) => e as String) + .toList() ?? + [], + estimatedDays: (json['estimated_days'] as num?)?.toInt() ?? 30, + dailyWordCount: (json['daily_word_count'] as num?)?.toInt() ?? 20, + downloadCount: (json['download_count'] as num?)?.toInt() ?? 0, + rating: (json['rating'] as num?)?.toDouble() ?? 0.0, + reviewCount: (json['review_count'] as num?)?.toInt() ?? 0, + createdAt: DateTime.parse(json['created_at'] as String), + updatedAt: DateTime.parse(json['updated_at'] as String), + ); + +Map _$VocabularyBookToJson(VocabularyBook instance) => + { + 'id': instance.id, + 'name': instance.name, + 'description': instance.description, + 'type': _$VocabularyBookTypeEnumMap[instance.type]!, + 'level': _$VocabularyBookDifficultyEnumMap[instance.difficulty]!, + 'cover_image': instance.coverImageUrl, + 'total_words': instance.totalWords, + 'creator_id': instance.creatorId, + 'creator_name': instance.creatorName, + 'is_public': instance.isPublic, + 'tags': instance.tags, + 'category': instance.category, + 'main_category': + _$VocabularyBookMainCategoryEnumMap[instance.mainCategory], + 'sub_category': instance.subCategory, + 'target_levels': instance.targetLevels, + 'estimated_days': instance.estimatedDays, + 'daily_word_count': instance.dailyWordCount, + 'download_count': instance.downloadCount, + 'rating': instance.rating, + 'review_count': instance.reviewCount, + 'created_at': instance.createdAt.toIso8601String(), + 'updated_at': instance.updatedAt.toIso8601String(), + }; + +const _$VocabularyBookTypeEnumMap = { + VocabularyBookType.system: 'system', + VocabularyBookType.custom: 'custom', + VocabularyBookType.shared: 'shared', +}; + +const _$VocabularyBookDifficultyEnumMap = { + VocabularyBookDifficulty.beginner: 'beginner', + VocabularyBookDifficulty.elementary: 'elementary', + VocabularyBookDifficulty.intermediate: 'intermediate', + VocabularyBookDifficulty.advanced: 'advanced', + VocabularyBookDifficulty.expert: 'expert', +}; + +const _$VocabularyBookMainCategoryEnumMap = { + VocabularyBookMainCategory.academicStage: 'academic_stage', + VocabularyBookMainCategory.domesticTest: 'domestic_test', + VocabularyBookMainCategory.internationalTest: 'international_test', + VocabularyBookMainCategory.professional: 'professional', + VocabularyBookMainCategory.functional: 'functional', +}; + +UserVocabularyBookProgress _$UserVocabularyBookProgressFromJson( + Map json) => + UserVocabularyBookProgress( + id: UserVocabularyBookProgress._idFromJson(json['id']), + userId: UserVocabularyBookProgress._userIdFromJson(json['user_id']), + vocabularyBookId: json['book_id'] as String, + learnedWords: (json['learned_words'] as num?)?.toInt() ?? 0, + masteredWords: (json['mastered_words'] as num?)?.toInt() ?? 0, + progressPercentage: + (json['progress_percentage'] as num?)?.toDouble() ?? 0.0, + streakDays: (json['streak_days'] as num?)?.toInt() ?? 0, + totalStudyDays: (json['total_study_days'] as num?)?.toInt() ?? 0, + averageDailyWords: + (json['average_daily_words'] as num?)?.toDouble() ?? 0.0, + estimatedCompletionDate: json['estimated_completion_date'] == null + ? null + : DateTime.parse(json['estimated_completion_date'] as String), + isCompleted: json['is_completed'] as bool? ?? false, + completedAt: json['completed_at'] == null + ? null + : DateTime.parse(json['completed_at'] as String), + startedAt: DateTime.parse(json['started_at'] as String), + lastStudiedAt: json['last_studied_at'] == null + ? null + : DateTime.parse(json['last_studied_at'] as String), + ); + +Map _$UserVocabularyBookProgressToJson( + UserVocabularyBookProgress instance) => + { + 'id': instance.id, + 'user_id': instance.userId, + 'book_id': instance.vocabularyBookId, + 'learned_words': instance.learnedWords, + 'mastered_words': instance.masteredWords, + 'progress_percentage': instance.progressPercentage, + 'streak_days': instance.streakDays, + 'total_study_days': instance.totalStudyDays, + 'average_daily_words': instance.averageDailyWords, + 'estimated_completion_date': + instance.estimatedCompletionDate?.toIso8601String(), + 'is_completed': instance.isCompleted, + 'completed_at': instance.completedAt?.toIso8601String(), + 'started_at': instance.startedAt.toIso8601String(), + 'last_studied_at': instance.lastStudiedAt?.toIso8601String(), + }; + +VocabularyBookWord _$VocabularyBookWordFromJson(Map json) => + VocabularyBookWord( + id: VocabularyBookWord._idFromJson(json['id']), + vocabularyBookId: json['book_id'] as String, + wordId: json['vocabulary_id'] as String, + order: (json['sort_order'] as num?)?.toInt() ?? 0, + word: json['word'] == null + ? null + : Word.fromJson(json['word'] as Map), + addedAt: DateTime.parse(json['created_at'] as String), + ); + +Map _$VocabularyBookWordToJson(VocabularyBookWord instance) => + { + 'id': instance.id, + 'book_id': instance.vocabularyBookId, + 'vocabulary_id': instance.wordId, + 'sort_order': instance.order, + 'word': instance.word, + 'created_at': instance.addedAt.toIso8601String(), + }; diff --git a/client/lib/features/vocabulary/models/word_book_model.dart b/client/lib/features/vocabulary/models/word_book_model.dart new file mode 100644 index 0000000..118eba6 --- /dev/null +++ b/client/lib/features/vocabulary/models/word_book_model.dart @@ -0,0 +1,205 @@ +import 'word_model.dart'; + +/// 生词本模型 +class WordBook { + final String id; + final String name; + final String? description; + final String userId; + final List wordIds; + final List words; + final WordBookType type; + final int wordCount; + final DateTime createdAt; + final DateTime updatedAt; + + WordBook({ + required this.id, + required this.name, + this.description, + required this.userId, + List? wordIds, + List? words, + this.type = WordBookType.personal, + this.wordCount = 0, + required this.createdAt, + required this.updatedAt, + }) : wordIds = wordIds ?? [], + words = words ?? []; + + factory WordBook.fromJson(Map json) { + return WordBook( + id: json['id'] as String, + name: json['name'] as String, + description: json['description'] as String?, + userId: json['user_id'] as String, + wordIds: (json['word_ids'] as List?)?.map((e) => e as String).toList(), + words: (json['words'] as List?)?.map((e) => Word.fromJson(e as Map)).toList(), + type: WordBookType.values.firstWhere( + (e) => e.toString().split('.').last == json['type'], + orElse: () => WordBookType.personal, + ), + wordCount: json['word_count'] as int? ?? 0, + createdAt: DateTime.parse(json['created_at'] as String), + updatedAt: DateTime.parse(json['updated_at'] as String), + ); + } + + Map toJson() { + return { + 'id': id, + 'name': name, + 'description': description, + 'user_id': userId, + 'word_ids': wordIds, + 'words': words.map((e) => e.toJson()).toList(), + 'type': type.toString().split('.').last, + 'word_count': wordCount, + 'created_at': createdAt.toIso8601String(), + 'updated_at': updatedAt.toIso8601String(), + }; + } + + WordBook copyWith({ + String? id, + String? name, + String? description, + String? userId, + List? wordIds, + List? words, + WordBookType? type, + int? wordCount, + DateTime? createdAt, + DateTime? updatedAt, + }) { + return WordBook( + id: id ?? this.id, + name: name ?? this.name, + description: description ?? this.description, + userId: userId ?? this.userId, + wordIds: wordIds ?? this.wordIds, + words: words ?? this.words, + type: type ?? this.type, + wordCount: wordCount ?? this.wordCount, + createdAt: createdAt ?? this.createdAt, + updatedAt: updatedAt ?? this.updatedAt, + ); + } +} + +/// 生词本类型 +enum WordBookType { + personal, + shared, + system, +} + +/// 生词本条目 +class WordBookEntry { + final String id; + final String wordBookId; + final String wordId; + final Word word; + final String? note; + final List tags; + final int reviewCount; + final int correctCount; + final DateTime? lastReviewAt; + final DateTime addedAt; + + WordBookEntry({ + required this.id, + required this.wordBookId, + required this.wordId, + required this.word, + this.note, + List? tags, + this.reviewCount = 0, + this.correctCount = 0, + this.lastReviewAt, + required this.addedAt, + }) : tags = tags ?? []; + + factory WordBookEntry.fromJson(Map json) { + return WordBookEntry( + id: json['id'] as String, + wordBookId: json['word_book_id'] as String, + wordId: json['word_id'] as String, + word: Word.fromJson(json['word'] as Map), + note: json['note'] as String?, + tags: (json['tags'] as List?)?.map((e) => e as String).toList(), + reviewCount: json['review_count'] as int? ?? 0, + correctCount: json['correct_count'] as int? ?? 0, + lastReviewAt: json['last_review_at'] != null ? DateTime.parse(json['last_review_at'] as String) : null, + addedAt: DateTime.parse(json['added_at'] as String), + ); + } + + Map toJson() { + return { + 'id': id, + 'word_book_id': wordBookId, + 'word_id': wordId, + 'word': word.toJson(), + 'note': note, + 'tags': tags, + 'review_count': reviewCount, + 'correct_count': correctCount, + 'last_review_at': lastReviewAt?.toIso8601String(), + 'added_at': addedAt.toIso8601String(), + }; + } +} + +/// 生词本统计 +class WordBookStats { + final String wordBookId; + final int totalWords; + final int masteredWords; + final int reviewingWords; + final int newWords; + final double masteryRate; + final DateTime? lastStudyAt; + final int studyDays; + final int totalReviews; + + WordBookStats({ + required this.wordBookId, + this.totalWords = 0, + this.masteredWords = 0, + this.reviewingWords = 0, + this.newWords = 0, + this.masteryRate = 0, + this.lastStudyAt, + this.studyDays = 0, + this.totalReviews = 0, + }); + + factory WordBookStats.fromJson(Map json) { + return WordBookStats( + wordBookId: json['word_book_id'] as String, + totalWords: json['total_words'] as int? ?? 0, + masteredWords: json['mastered_words'] as int? ?? 0, + reviewingWords: json['reviewing_words'] as int? ?? 0, + newWords: json['new_words'] as int? ?? 0, + masteryRate: (json['mastery_rate'] as num?)?.toDouble() ?? 0, + lastStudyAt: json['last_study_at'] != null ? DateTime.parse(json['last_study_at'] as String) : null, + studyDays: json['study_days'] as int? ?? 0, + totalReviews: json['total_reviews'] as int? ?? 0, + ); + } + + Map toJson() { + return { + 'word_book_id': wordBookId, + 'total_words': totalWords, + 'mastered_words': masteredWords, + 'reviewing_words': reviewingWords, + 'new_words': newWords, + 'mastery_rate': masteryRate, + 'last_study_at': lastStudyAt?.toIso8601String(), + 'study_days': studyDays, + 'total_reviews': totalReviews, + }; + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/word_book_stats_model.dart b/client/lib/features/vocabulary/models/word_book_stats_model.dart new file mode 100644 index 0000000..781e23f --- /dev/null +++ b/client/lib/features/vocabulary/models/word_book_stats_model.dart @@ -0,0 +1,25 @@ +class WordBookStats { + final int totalWords; + final int masteredWords; + final int learningWords; + final int reviewingWords; + final double masteryRate; + + WordBookStats({ + required this.totalWords, + required this.masteredWords, + required this.learningWords, + required this.reviewingWords, + required this.masteryRate, + }); + + factory WordBookStats.fromJson(Map json) { + return WordBookStats( + totalWords: (json['totalWords'] as num?)?.toInt() ?? 0, + masteredWords: (json['masteredWords'] as num?)?.toInt() ?? 0, + learningWords: (json['learningWords'] as num?)?.toInt() ?? 0, + reviewingWords: (json['reviewingWords'] as num?)?.toInt() ?? 0, + masteryRate: (json['masteryRate'] as num?)?.toDouble() ?? 0.0, + ); + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/word_model.dart b/client/lib/features/vocabulary/models/word_model.dart new file mode 100644 index 0000000..c3c8a30 --- /dev/null +++ b/client/lib/features/vocabulary/models/word_model.dart @@ -0,0 +1,519 @@ +import 'package:json_annotation/json_annotation.dart'; + +part 'word_model.g.dart'; + +/// 单词难度等级 +enum WordDifficulty { + @JsonValue('beginner') + beginner, + @JsonValue('elementary') + elementary, + @JsonValue('intermediate') + intermediate, + @JsonValue('advanced') + advanced, + @JsonValue('expert') + expert, +} + +/// 单词类型 +enum WordType { + @JsonValue('noun') + noun, + @JsonValue('verb') + verb, + @JsonValue('adjective') + adjective, + @JsonValue('adverb') + adverb, + @JsonValue('preposition') + preposition, + @JsonValue('conjunction') + conjunction, + @JsonValue('interjection') + interjection, + @JsonValue('pronoun') + pronoun, + @JsonValue('article') + article, + @JsonValue('phrase') + phrase, +} + +/// 学习状态 +enum LearningStatus { + @JsonValue('new') + newWord, + @JsonValue('learning') + learning, + @JsonValue('reviewing') + reviewing, + @JsonValue('mastered') + mastered, + @JsonValue('forgotten') + forgotten, +} + +/// 单词模型 +@JsonSerializable() +class Word { + /// 单词ID + @JsonKey(name: 'id', fromJson: _idFromJson) + final String id; + + /// 处理id字段的类型转换（后端返回int64） + static String _idFromJson(dynamic value) { + if (value is int) { + return value.toString(); + } + return value.toString(); + } + + /// 单词 + final String word; + + /// 音标 + final String? phonetic; + + /// 音频URL + @JsonKey(name: 'audio_url') + final String? audioUrl; + + /// 词性和释义列表 + @JsonKey(defaultValue: []) + final List definitions; + + /// 例句列表 + @JsonKey(defaultValue: []) + final List examples; + + /// 同义词 + @JsonKey(defaultValue: []) + final List synonyms; + + /// 反义词 + @JsonKey(defaultValue: []) + final List antonyms; + + /// 词根词缀 + final WordEtymology? etymology; + + /// 难度等级 + @JsonKey(name: 'difficulty', fromJson: _difficultyFromJson) + final WordDifficulty difficulty; + + /// 频率等级 (1-5) + @JsonKey(defaultValue: 0) + final int frequency; + + /// 图片URL + @JsonKey(name: 'image_url') + final String? imageUrl; + + /// 记忆技巧 + @JsonKey(name: 'memory_tip') + final String? memoryTip; + + /// 创建时间 + @JsonKey(name: 'created_at') + final DateTime createdAt; + + /// 更新时间 + @JsonKey(name: 'updated_at') + final DateTime updatedAt; + + const Word({ + required this.id, + required this.word, + this.phonetic, + this.audioUrl, + required this.definitions, + this.examples = const [], + this.synonyms = const [], + this.antonyms = const [], + this.etymology, + required this.difficulty, + required this.frequency, + this.imageUrl, + this.memoryTip, + required this.createdAt, + required this.updatedAt, + }); + + factory Word.fromJson(Map json) => _$WordFromJson(json); + Map toJson() => _$WordToJson(this); + + /// 处理difficulty字段（后端可能为null、空字符串或其他值） + static WordDifficulty _difficultyFromJson(dynamic value) { + if (value == null || value == '') return WordDifficulty.beginner; + + final stringValue = value.toString().toLowerCase(); + switch (stringValue) { + case 'beginner': + case '1': + return WordDifficulty.beginner; + case 'elementary': + case '2': + return WordDifficulty.elementary; + case 'intermediate': + case '3': + return WordDifficulty.intermediate; + case 'advanced': + case '4': + return WordDifficulty.advanced; + case 'expert': + case '5': + return WordDifficulty.expert; + default: + return WordDifficulty.beginner; // 默认为初级 + } + } + + Word copyWith({ + String? id, + String? word, + String? phonetic, + String? audioUrl, + List? definitions, + List? examples, + List? synonyms, + List? antonyms, + WordEtymology? etymology, + WordDifficulty? difficulty, + int? frequency, + String? imageUrl, + String? memoryTip, + DateTime? createdAt, + DateTime? updatedAt, + }) { + return Word( + id: id ?? this.id, + word: word ?? this.word, + phonetic: phonetic ?? this.phonetic, + audioUrl: audioUrl ?? this.audioUrl, + definitions: definitions ?? this.definitions, + examples: examples ?? this.examples, + synonyms: synonyms ?? this.synonyms, + antonyms: antonyms ?? this.antonyms, + etymology: etymology ?? this.etymology, + difficulty: difficulty ?? this.difficulty, + frequency: frequency ?? this.frequency, + imageUrl: imageUrl ?? this.imageUrl, + memoryTip: memoryTip ?? this.memoryTip, + createdAt: createdAt ?? this.createdAt, + updatedAt: updatedAt ?? this.updatedAt, + ); + } +} + +/// 单词释义 +@JsonSerializable() +class WordDefinition { + /// 词性 + @JsonKey(name: 'type', fromJson: _typeFromJson) + final WordType type; + + /// 释义 + final String definition; + + /// 中文翻译 + @JsonKey(name: 'translation', fromJson: _translationFromJson) + final String translation; + + /// 使用频率 (1-5) + @JsonKey(defaultValue: 3) + final int frequency; + + const WordDefinition({ + required this.type, + required this.definition, + required this.translation, + this.frequency = 3, + }); + + /// 处理type字段（后端可能为null或空字符串） + static WordType _typeFromJson(dynamic value) { + if (value == null || value == '') return WordType.noun; + + final stringValue = value.toString().toLowerCase(); + switch (stringValue) { + case 'noun': + case 'n': + return WordType.noun; + case 'verb': + case 'v': + return WordType.verb; + case 'adjective': + case 'adj': + return WordType.adjective; + case 'adverb': + case 'adv': + return WordType.adverb; + case 'preposition': + case 'prep': + return WordType.preposition; + case 'conjunction': + case 'conj': + return WordType.conjunction; + case 'interjection': + case 'interj': + return WordType.interjection; + case 'pronoun': + case 'pron': + return WordType.pronoun; + case 'article': + case 'art': + return WordType.article; + case 'phrase': + return WordType.phrase; + default: + return WordType.noun; // 默认为名词 + } + } + + /// 处理translation字段（后端可能为null） + static String _translationFromJson(dynamic value) { + if (value == null) return ''; + return value.toString(); + } + + factory WordDefinition.fromJson(Map json) => _$WordDefinitionFromJson(json); + Map toJson() => _$WordDefinitionToJson(this); + + WordDefinition copyWith({ + WordType? type, + String? definition, + String? translation, + int? frequency, + }) { + return WordDefinition( + type: type ?? this.type, + definition: definition ?? this.definition, + translation: translation ?? this.translation, + frequency: frequency ?? this.frequency, + ); + } +} + +/// 单词例句 +@JsonSerializable() +class WordExample { + /// 例句 + @JsonKey(name: 'example', fromJson: _sentenceFromJson) + final String sentence; + + /// 中文翻译 + @JsonKey(name: 'translation', fromJson: _exampleTranslationFromJson) + final String translation; + + /// 音频URL + @JsonKey(name: 'audio_url') + final String? audioUrl; + + /// 来源 + final String? source; + + const WordExample({ + required this.sentence, + required this.translation, + this.audioUrl, + this.source, + }); + + /// 处理example字段（映射到sentence） + static String _sentenceFromJson(dynamic value) { + if (value == null) return ''; + return value.toString(); + } + + /// 处理translation字段（后端可能为null） + static String _exampleTranslationFromJson(dynamic value) { + if (value == null) return ''; + return value.toString(); + } + + factory WordExample.fromJson(Map json) => _$WordExampleFromJson(json); + Map toJson() => _$WordExampleToJson(this); + + WordExample copyWith({ + String? sentence, + String? translation, + String? audioUrl, + String? source, + }) { + return WordExample( + sentence: sentence ?? this.sentence, + translation: translation ?? this.translation, + audioUrl: audioUrl ?? this.audioUrl, + source: source ?? this.source, + ); + } +} + +/// 词根词缀 +@JsonSerializable() +class WordEtymology { + /// 词根 + final List roots; + + /// 前缀 + final List prefixes; + + /// 后缀 + final List suffixes; + + /// 词源说明 + final String? origin; + + const WordEtymology({ + this.roots = const [], + this.prefixes = const [], + this.suffixes = const [], + this.origin, + }); + + factory WordEtymology.fromJson(Map json) => _$WordEtymologyFromJson(json); + Map toJson() => _$WordEtymologyToJson(this); + + WordEtymology copyWith({ + List? roots, + List? prefixes, + List? suffixes, + String? origin, + }) { + return WordEtymology( + roots: roots ?? this.roots, + prefixes: prefixes ?? this.prefixes, + suffixes: suffixes ?? this.suffixes, + origin: origin ?? this.origin, + ); + } +} + +/// 用户单词学习记录 +@JsonSerializable() +class UserWordProgress { + /// 记录ID + @JsonKey(fromJson: _idFromJson) + final String id; + + /// 用户ID + @JsonKey(name: 'user_id', fromJson: _userIdFromJson) + final String userId; + + /// 单词ID + @JsonKey(name: 'vocabulary_id', fromJson: _wordIdFromJson) + final String wordId; + + /// 学习状态 + final LearningStatus status; + + /// 学习次数 + @JsonKey(name: 'study_count') + final int studyCount; + + /// 正确次数 + @JsonKey(name: 'correct_count') + final int correctCount; + + /// 错误次数 + @JsonKey(name: 'wrong_count') + final int wrongCount; + + /// 熟练度 (0-100) + final int proficiency; + + /// 下次复习时间 + @JsonKey(name: 'next_review_at') + final DateTime? nextReviewAt; + + /// 复习间隔 (天) + @JsonKey(name: 'review_interval') + final int reviewInterval; + + /// 首次学习时间 + @JsonKey(name: 'first_studied_at') + final DateTime firstStudiedAt; + + /// 最后学习时间 + @JsonKey(name: 'last_studied_at') + final DateTime lastStudiedAt; + + /// 掌握时间 + @JsonKey(name: 'mastered_at') + final DateTime? masteredAt; + + const UserWordProgress({ + required this.id, + required this.userId, + required this.wordId, + required this.status, + this.studyCount = 0, + this.correctCount = 0, + this.wrongCount = 0, + this.proficiency = 0, + this.nextReviewAt, + this.reviewInterval = 1, + required this.firstStudiedAt, + required this.lastStudiedAt, + this.masteredAt, + }); + + factory UserWordProgress.fromJson(Map json) => _$UserWordProgressFromJson(json); + Map toJson() => _$UserWordProgressToJson(this); + + UserWordProgress copyWith({ + String? id, + String? userId, + String? wordId, + LearningStatus? status, + int? studyCount, + int? correctCount, + int? wrongCount, + int? proficiency, + DateTime? nextReviewAt, + int? reviewInterval, + DateTime? firstStudiedAt, + DateTime? lastStudiedAt, + DateTime? masteredAt, + }) { + return UserWordProgress( + id: id ?? this.id, + userId: userId ?? this.userId, + wordId: wordId ?? this.wordId, + status: status ?? this.status, + studyCount: studyCount ?? this.studyCount, + correctCount: correctCount ?? this.correctCount, + wrongCount: wrongCount ?? this.wrongCount, + proficiency: proficiency ?? this.proficiency, + nextReviewAt: nextReviewAt ?? this.nextReviewAt, + reviewInterval: reviewInterval ?? this.reviewInterval, + firstStudiedAt: firstStudiedAt ?? this.firstStudiedAt, + lastStudiedAt: lastStudiedAt ?? this.lastStudiedAt, + masteredAt: masteredAt ?? this.masteredAt, + ); + } + + /// 计算学习准确率 + double get accuracy { + if (studyCount == 0) return 0.0; + return correctCount / studyCount; + } + + /// 是否需要复习 + bool get needsReview { + if (nextReviewAt == null) return false; + return DateTime.now().isAfter(nextReviewAt!); + } + + /// 是否为新单词 + bool get isNew => status == LearningStatus.newWord; + + /// 是否已掌握 + bool get isMastered => status == LearningStatus.mastered; + + /// 类型转换方法 + static String _idFromJson(dynamic value) => value.toString(); + static String _userIdFromJson(dynamic value) => value.toString(); + static String _wordIdFromJson(dynamic value) => value.toString(); +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/models/word_model.g.dart b/client/lib/features/vocabulary/models/word_model.g.dart new file mode 100644 index 0000000..944a124 --- /dev/null +++ b/client/lib/features/vocabulary/models/word_model.g.dart @@ -0,0 +1,179 @@ +// GENERATED CODE - DO NOT MODIFY BY HAND + +part of 'word_model.dart'; + +// ************************************************************************** +// JsonSerializableGenerator +// ************************************************************************** + +Word _$WordFromJson(Map json) => Word( + id: Word._idFromJson(json['id']), + word: json['word'] as String, + phonetic: json['phonetic'] as String?, + audioUrl: json['audio_url'] as String?, + definitions: (json['definitions'] as List?) + ?.map((e) => WordDefinition.fromJson(e as Map)) + .toList() ?? + [], + examples: (json['examples'] as List?) + ?.map((e) => WordExample.fromJson(e as Map)) + .toList() ?? + [], + synonyms: (json['synonyms'] as List?) + ?.map((e) => e as String) + .toList() ?? + [], + antonyms: (json['antonyms'] as List?) + ?.map((e) => e as String) + .toList() ?? + [], + etymology: json['etymology'] == null + ? null + : WordEtymology.fromJson(json['etymology'] as Map), + difficulty: Word._difficultyFromJson(json['difficulty']), + frequency: (json['frequency'] as num?)?.toInt() ?? 0, + imageUrl: json['image_url'] as String?, + memoryTip: json['memory_tip'] as String?, + createdAt: DateTime.parse(json['created_at'] as String), + updatedAt: DateTime.parse(json['updated_at'] as String), + ); + +Map _$WordToJson(Word instance) => { + 'id': instance.id, + 'word': instance.word, + 'phonetic': instance.phonetic, + 'audio_url': instance.audioUrl, + 'definitions': instance.definitions, + 'examples': instance.examples, + 'synonyms': instance.synonyms, + 'antonyms': instance.antonyms, + 'etymology': instance.etymology, + 'difficulty': _$WordDifficultyEnumMap[instance.difficulty]!, + 'frequency': instance.frequency, + 'image_url': instance.imageUrl, + 'memory_tip': instance.memoryTip, + 'created_at': instance.createdAt.toIso8601String(), + 'updated_at': instance.updatedAt.toIso8601String(), + }; + +const _$WordDifficultyEnumMap = { + WordDifficulty.beginner: 'beginner', + WordDifficulty.elementary: 'elementary', + WordDifficulty.intermediate: 'intermediate', + WordDifficulty.advanced: 'advanced', + WordDifficulty.expert: 'expert', +}; + +WordDefinition _$WordDefinitionFromJson(Map json) => + WordDefinition( + type: WordDefinition._typeFromJson(json['type']), + definition: json['definition'] as String, + translation: WordDefinition._translationFromJson(json['translation']), + frequency: (json['frequency'] as num?)?.toInt() ?? 3, + ); + +Map _$WordDefinitionToJson(WordDefinition instance) => + { + 'type': _$WordTypeEnumMap[instance.type]!, + 'definition': instance.definition, + 'translation': instance.translation, + 'frequency': instance.frequency, + }; + +const _$WordTypeEnumMap = { + WordType.noun: 'noun', + WordType.verb: 'verb', + WordType.adjective: 'adjective', + WordType.adverb: 'adverb', + WordType.preposition: 'preposition', + WordType.conjunction: 'conjunction', + WordType.interjection: 'interjection', + WordType.pronoun: 'pronoun', + WordType.article: 'article', + WordType.phrase: 'phrase', +}; + +WordExample _$WordExampleFromJson(Map json) => WordExample( + sentence: WordExample._sentenceFromJson(json['example']), + translation: WordExample._exampleTranslationFromJson(json['translation']), + audioUrl: json['audio_url'] as String?, + source: json['source'] as String?, + ); + +Map _$WordExampleToJson(WordExample instance) => + { + 'example': instance.sentence, + 'translation': instance.translation, + 'audio_url': instance.audioUrl, + 'source': instance.source, + }; + +WordEtymology _$WordEtymologyFromJson(Map json) => + WordEtymology( + roots: + (json['roots'] as List?)?.map((e) => e as String).toList() ?? + const [], + prefixes: (json['prefixes'] as List?) + ?.map((e) => e as String) + .toList() ?? + const [], + suffixes: (json['suffixes'] as List?) + ?.map((e) => e as String) + .toList() ?? + const [], + origin: json['origin'] as String?, + ); + +Map _$WordEtymologyToJson(WordEtymology instance) => + { + 'roots': instance.roots, + 'prefixes': instance.prefixes, + 'suffixes': instance.suffixes, + 'origin': instance.origin, + }; + +UserWordProgress _$UserWordProgressFromJson(Map json) => + UserWordProgress( + id: UserWordProgress._idFromJson(json['id']), + userId: UserWordProgress._userIdFromJson(json['user_id']), + wordId: UserWordProgress._wordIdFromJson(json['vocabulary_id']), + status: $enumDecode(_$LearningStatusEnumMap, json['status']), + studyCount: (json['study_count'] as num?)?.toInt() ?? 0, + correctCount: (json['correct_count'] as num?)?.toInt() ?? 0, + wrongCount: (json['wrong_count'] as num?)?.toInt() ?? 0, + proficiency: (json['proficiency'] as num?)?.toInt() ?? 0, + nextReviewAt: json['next_review_at'] == null + ? null + : DateTime.parse(json['next_review_at'] as String), + reviewInterval: (json['review_interval'] as num?)?.toInt() ?? 1, + firstStudiedAt: DateTime.parse(json['first_studied_at'] as String), + lastStudiedAt: DateTime.parse(json['last_studied_at'] as String), + masteredAt: json['mastered_at'] == null + ? null + : DateTime.parse(json['mastered_at'] as String), + ); + +Map _$UserWordProgressToJson(UserWordProgress instance) => + { + 'id': instance.id, + 'user_id': instance.userId, + 'vocabulary_id': instance.wordId, + 'status': _$LearningStatusEnumMap[instance.status]!, + 'study_count': instance.studyCount, + 'correct_count': instance.correctCount, + 'wrong_count': instance.wrongCount, + 'proficiency': instance.proficiency, + 'next_review_at': instance.nextReviewAt?.toIso8601String(), + 'review_interval': instance.reviewInterval, + 'first_studied_at': instance.firstStudiedAt.toIso8601String(), + 'last_studied_at': instance.lastStudiedAt.toIso8601String(), + 'mastered_at': instance.masteredAt?.toIso8601String(), + }; + +const _$LearningStatusEnumMap = { + LearningStatus.newWord: 'new', + LearningStatus.learning: 'learning', + LearningStatus.reviewing: 'reviewing', + LearningStatus.mastered: 'mastered', + LearningStatus.forgotten: 'forgotten', +}; diff --git a/client/lib/features/vocabulary/providers/vocabulary_provider.dart b/client/lib/features/vocabulary/providers/vocabulary_provider.dart new file mode 100644 index 0000000..e51e32d --- /dev/null +++ b/client/lib/features/vocabulary/providers/vocabulary_provider.dart @@ -0,0 +1,485 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/word_model.dart'; +import '../models/vocabulary_book_model.dart'; +import '../models/study_session_model.dart'; +import '../models/daily_stats_model.dart'; +import '../services/vocabulary_service.dart'; +import '../../../core/network/api_client.dart'; +import '../../../core/services/storage_service.dart'; +import '../services/learning_stats_service.dart'; +import '../models/learning_stats_model.dart'; + +/// 词汇状态 +class VocabularyState { + final bool isLoading; + final String? error; + final List systemBooks; + final List userBooks; + final List> categories; + final List todayWords; + final List reviewWords; + final StudyStatistics? todayStatistics; + final StudySession? currentSession; + final DailyStats? dailyStats; + final Map? overallStats; + final int weeklyWordsStudied; + + const VocabularyState({ + this.isLoading = false, + this.error, + this.systemBooks = const [], + this.userBooks = const [], + this.categories = const [], + this.todayWords = const [], + this.reviewWords = const [], + this.todayStatistics, + this.currentSession, + this.dailyStats, + this.overallStats, + this.weeklyWordsStudied = 0, + }); + + VocabularyState copyWith({ + bool? isLoading, + String? error, + List? systemBooks, + List? userBooks, + List>? categories, + List? todayWords, + List? reviewWords, + StudyStatistics? todayStatistics, + StudySession? currentSession, + DailyStats? dailyStats, + Map? overallStats, + int? weeklyWordsStudied, + }) { + return VocabularyState( + isLoading: isLoading ?? this.isLoading, + error: error, + systemBooks: systemBooks ?? this.systemBooks, + userBooks: userBooks ?? this.userBooks, + categories: categories ?? this.categories, + todayWords: todayWords ?? this.todayWords, + reviewWords: reviewWords ?? this.reviewWords, + todayStatistics: todayStatistics ?? this.todayStatistics, + currentSession: currentSession ?? this.currentSession, + dailyStats: dailyStats ?? this.dailyStats, + overallStats: overallStats ?? this.overallStats, + weeklyWordsStudied: weeklyWordsStudied ?? this.weeklyWordsStudied, + ); + } +} + +/// 词汇状态管理 +class VocabularyNotifier extends StateNotifier { + final VocabularyService _vocabularyService; + + VocabularyNotifier(this._vocabularyService) : super(const VocabularyState()); + + /// 加载系统词汇书 + Future loadSystemVocabularyBooks({ + VocabularyBookDifficulty? difficulty, + String? category, + }) async { + try { + state = state.copyWith(isLoading: true, error: null); + + final books = await _vocabularyService.getSystemVocabularyBooks( + difficulty: difficulty, + category: category, + limit: 100, // 加载所有词汇书 + ); + + state = state.copyWith( + isLoading: false, + systemBooks: books, + ); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } + + /// 加载词汇书分类 + Future loadVocabularyBookCategories() async { + try { + state = state.copyWith(isLoading: true, error: null); + + final categories = await _vocabularyService.getVocabularyBookCategories(); + + state = state.copyWith( + isLoading: false, + categories: categories, + ); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } + + /// 加载用户词汇书 + Future loadUserVocabularyBooks() async { + try { + state = state.copyWith(isLoading: true, error: null); + + final books = await _vocabularyService.getUserVocabularyBooks(); + + state = state.copyWith( + isLoading: false, + userBooks: books, + ); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } + + /// 加载今日学习单词 + Future loadTodayStudyWords({String? userId}) async { + try { + state = state.copyWith(isLoading: true, error: null); + + final words = await _vocabularyService.getTodayStudyWords(); + print('今日单词加载完成，数量: ${words.length}'); + + StudyStatistics statistics; + try { + statistics = await _vocabularyService.getStudyStatistics(DateTime.now()); + print('学习统计加载成功: wordsStudied=${statistics.wordsStudied}, newWords=${statistics.newWordsLearned}'); + } catch (e) { + print('学习统计加载失败: $e，使用默认值'); + // 接口不可用时，构造默认的今日统计 + final now = DateTime.now(); + final correct = (words.length * 0.8).round(); + final wrong = words.length - correct; + statistics = StudyStatistics( + id: 'local_${now.toIso8601String().split('T').first}', + userId: 'current_user', + date: now, + sessionCount: 1, + wordsStudied: words.length, + newWordsLearned: words.length, + wordsReviewed: 0, + wordsMastered: 0, + totalStudyTimeSeconds: words.length * 30, + correctAnswers: correct, + wrongAnswers: wrong, + averageAccuracy: words.isEmpty ? 0.0 : correct / (correct + wrong), + experienceGained: words.length * 5, + pointsGained: words.length * 2, + streakDays: 1, + ); + } + + // 额外加载每日词汇统计（wordsLearned、studyTimeMinutes） + DailyStats? dailyStats; + if (userId != null && userId.isNotEmpty) { + try { + dailyStats = await _vocabularyService.getDailyVocabularyStats(userId: userId); + print('每日词汇统计加载成功: wordsLearned=${dailyStats.wordsLearned}'); + } catch (e) { + print('每日词汇统计加载失败: $e'); + // ignore, 使用StudyStatistics中的wordsStudied作为兜底 + dailyStats = DailyStats( + wordsLearned: statistics.wordsStudied, + studyTimeMinutes: (statistics.totalStudyTimeSeconds / 60).round(), + ); + } + } + + state = state.copyWith( + isLoading: false, + todayWords: words, + todayStatistics: statistics, + dailyStats: dailyStats, + ); + print('状态更新完成: todayWords=${words.length}, statistics.wordsStudied=${statistics.wordsStudied}'); + } catch (e) { + print('loadTodayStudyWords失败: $e'); + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } + + /// 加载用户词汇整体统计（总学习词汇数、准确率等） + Future loadUserVocabularyOverallStats() async { + try { + state = state.copyWith(isLoading: true, error: null); + final stats = await _vocabularyService.getUserVocabularyStats(); + print('整体统计加载成功: $stats'); + state = state.copyWith(isLoading: false, overallStats: stats); + } catch (e) { + print('整体统计加载失败: $e'); + state = state.copyWith(isLoading: false, error: e.toString()); + } + } + + /// 加载本周学习统计（累计学习单词数） + Future loadWeeklyStudyStats() async { + try { + final now = DateTime.now(); + final startOfWeek = now.subtract(Duration(days: now.weekday - 1)); // 周一 + final endOfWeek = startOfWeek.add(const Duration(days: 6)); // 周日 + print('加载本周统计: $startOfWeek 到 $endOfWeek'); + final list = await _vocabularyService.getStudyStatisticsHistory( + startDate: DateTime(startOfWeek.year, startOfWeek.month, startOfWeek.day), + endDate: DateTime(endOfWeek.year, endOfWeek.month, endOfWeek.day), + ); + print('本周统计数据: ${list.length} 天'); + final total = list.fold(0, (sum, s) => sum + (s.wordsStudied)); + print('本周累计学习: $total 个单词'); + state = state.copyWith(weeklyWordsStudied: total); + } catch (e) { + print('本周统计加载失败: $e'); + // 出错时保持为0 + } + } + + /// 加载复习单词 + Future loadReviewWords() async { + try { + state = state.copyWith(isLoading: true, error: null); + + final words = await _vocabularyService.getReviewWords(); + + state = state.copyWith( + isLoading: false, + reviewWords: words, + ); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } + + /// 添加词汇书到用户 + Future addVocabularyBookToUser(String bookId) async { + try { + await _vocabularyService.addVocabularyBookToUser(bookId); + // 重新加载用户词汇书 + await loadUserVocabularyBooks(); + } catch (e) { + state = state.copyWith(error: e.toString()); + } + } + + /// 开始学习会话 + Future startStudySession({ + required StudyMode mode, + String? vocabularyBookId, + required int targetWordCount, + }) async { + try { + state = state.copyWith(isLoading: true, error: null); + + final session = await _vocabularyService.startStudySession( + mode: mode, + vocabularyBookId: vocabularyBookId, + targetWordCount: targetWordCount, + ); + + state = state.copyWith( + isLoading: false, + currentSession: session, + ); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } + + /// 结束学习会话 + Future endStudySession({ + required String sessionId, + required int durationSeconds, + required List exercises, + }) async { + try { + await _vocabularyService.endStudySession( + sessionId, + durationSeconds: durationSeconds, + exercises: exercises, + ); + + state = state.copyWith(currentSession: null); + + // 重新加载今日数据 + await loadTodayStudyWords(); + } catch (e) { + state = state.copyWith(error: e.toString()); + } + } + + /// 更新单词学习进度 + Future updateWordProgress({ + required String wordId, + required LearningStatus status, + required bool isCorrect, + int responseTime = 0, + }) async { + try { + await _vocabularyService.updateUserWordProgress( + wordId: wordId, + status: status, + isCorrect: isCorrect, + responseTime: responseTime, + ); + } catch (e) { + state = state.copyWith(error: e.toString()); + } + } + + /// 清除错误 + void clearError() { + state = state.copyWith(error: null); + } +} + +/// 词汇服务提供者 +final vocabularyServiceProvider = FutureProvider((ref) async { + final apiClient = ApiClient.instance; + final storageService = await StorageService.getInstance(); + return VocabularyService( + apiClient: apiClient, + storageService: storageService, + ); +}); + +/// 词汇状态提供者（使用 StateNotifierProvider 以支持状态更新） +final vocabularyProvider = StateNotifierProvider.autoDispose((ref) { + // 同步创建 Notifier，延迟加载数据 + final vocabularyService = ref.watch(vocabularyServiceProvider).value; + if (vocabularyService == null) { + // 如果服务未就绪，返回空状态的 Notifier + throw Exception('词汇服务未就绪'); + } + + final notifier = VocabularyNotifier(vocabularyService); + + // 在后台异步加载系统词汇书和分类 + Future.wait([ + notifier.loadSystemVocabularyBooks(), + notifier.loadVocabularyBookCategories(), + ]); + + return notifier; +}); + +/// 当前学习会话提供者 +final currentStudySessionProvider = Provider((ref) { + final state = ref.watch(vocabularyProvider); + return state.currentSession; +}); + +/// 今日学习统计提供者 +final todayStatisticsProvider = Provider((ref) { + final state = ref.watch(vocabularyProvider); + return state.todayStatistics; +}); + +/// 每日词汇统计提供者 +final dailyVocabularyStatsProvider = Provider((ref) { + final state = ref.watch(vocabularyProvider); + return state.dailyStats; +}); + +/// 用户词汇整体统计提供者 +final overallVocabularyStatsProvider = Provider?>( + (ref) { + final state = ref.watch(vocabularyProvider); + return state.overallStats; + }, +); + +/// 本周累计学习单词数提供者 +final weeklyWordsStudiedProvider = Provider((ref) { + final state = ref.watch(vocabularyProvider); + return state.weeklyWordsStudied; +}); + +/// 用户词汇书提供者 +final userVocabularyBooksProvider = Provider>((ref) { + final state = ref.watch(vocabularyProvider); + return state.userBooks; +}); + +/// 系统词汇书提供者 +final systemVocabularyBooksProvider = Provider>((ref) { + final state = ref.watch(vocabularyProvider); + return state.systemBooks; +}); + +/// 今日单词提供者 +final todayWordsProvider = Provider>((ref) { + final state = ref.watch(vocabularyProvider); + return state.todayWords; +}); + +/// 复习单词提供者 +final reviewWordsProvider = Provider>((ref) { + final state = ref.watch(vocabularyProvider); + return state.reviewWords; +}); + +/// 词汇书学习统计 +class BookStudyStats { + final String bookId; + final int studyDays; + final double averageAccuracy; + + const BookStudyStats({ + required this.bookId, + required this.studyDays, + required this.averageAccuracy, + }); +} + +/// 学习统计服务提供者 +final learningStatsServiceProvider = FutureProvider((ref) async { + final apiClient = ApiClient.instance; + final storageService = await StorageService.getInstance(); + return LearningStatsService(apiClient: apiClient, storageService: storageService); +}); + +/// 用户学习统计提供者 +final learningStatsProvider = FutureProvider((ref) async { + final service = await ref.watch(learningStatsServiceProvider.future); + return service.getUserStats(); +}); + +/// 指定词汇书的学习统计（学习天数、平均准确率） +final bookStudyStatsProvider = FutureProvider.autoDispose.family((ref, bookId) async { + final service = await ref.watch(learningStatsServiceProvider.future); + final records = await service.getDailyRecords(); + final filtered = records.where((r) => r.vocabularyBookIds.contains(bookId)).toList(); + final studyDays = filtered.length; + double avgAccuracy = 0.0; + if (filtered.isNotEmpty) { + final totalWeight = filtered.fold(0, (sum, r) => sum + (r.wordsLearned + r.wordsReviewed)); + if (totalWeight > 0) { + final weightedSum = filtered.fold(0.0, (sum, r) => sum + r.accuracyRate * (r.wordsLearned + r.wordsReviewed)); + avgAccuracy = weightedSum / totalWeight; + } else { + avgAccuracy = filtered.fold(0.0, (sum, r) => sum + r.accuracyRate) / filtered.length; + } + } + return BookStudyStats(bookId: bookId, studyDays: studyDays, averageAccuracy: avgAccuracy); +}); + +/// 词汇书学习进度（百分比、已学/已掌握数量） +final vocabularyBookProgressProvider = FutureProvider.autoDispose.family((ref, bookId) async { + final service = await ref.watch(vocabularyServiceProvider.future); + return service.getVocabularyBookProgress(bookId); +}); \ No newline at end of file diff --git a/client/lib/features/vocabulary/screens/ai_recommendation_screen.dart b/client/lib/features/vocabulary/screens/ai_recommendation_screen.dart new file mode 100644 index 0000000..64b58c2 --- /dev/null +++ b/client/lib/features/vocabulary/screens/ai_recommendation_screen.dart @@ -0,0 +1,519 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/utils/responsive_utils.dart'; +import '../../../shared/widgets/custom_app_bar.dart'; +import '../../../shared/widgets/loading_widget.dart'; + +class AIRecommendationScreen extends ConsumerStatefulWidget { + const AIRecommendationScreen({super.key}); + + @override + ConsumerState createState() => _AIRecommendationScreenState(); +} + +class _AIRecommendationScreenState extends ConsumerState { + bool _isLoading = false; + List _recommendations = []; + + @override + void initState() { + super.initState(); + _loadRecommendations(); + } + + Future _loadRecommendations() async { + setState(() { + _isLoading = true; + }); + + // 模拟AI推荐数据加载 + await Future.delayed(const Duration(milliseconds: 1000)); + + setState(() { + _recommendations = _generateRecommendations(); + _isLoading = false; + }); + } + + List _generateRecommendations() { + return [ + RecommendationItem( + type: RecommendationType.vocabulary, + title: '商务英语词汇强化', + description: '基于您的学习历史，建议加强商务场景词汇学习', + priority: 'high', + estimatedTime: '15分钟', + icon: Icons.business_center, + color: Colors.blue, + action: '开始学习', + details: [ + '包含50个高频商务词汇', + '涵盖会议、谈判、报告等场景', + '配有真实商务对话示例', + ], + ), + RecommendationItem( + type: RecommendationType.review, + title: '复习昨日学习内容', + description: '您有8个单词需要复习，趁热打铁效果更佳', + priority: 'high', + estimatedTime: '10分钟', + icon: Icons.refresh, + color: Colors.orange, + action: '立即复习', + details: [ + '8个单词待复习', + '基于遗忘曲线算法推荐', + '巩固记忆效果显著', + ], + ), + RecommendationItem( + type: RecommendationType.test, + title: '词汇测试挑战', + description: '测试您的词汇掌握程度，发现薄弱环节', + priority: 'medium', + estimatedTime: '20分钟', + icon: Icons.quiz, + color: Colors.green, + action: '开始测试', + details: [ + '30道精选测试题', + '多种题型组合', + '即时反馈和解析', + ], + ), + RecommendationItem( + type: RecommendationType.plan, + title: '制定本周学习计划', + description: '为您量身定制的学习计划，提高学习效率', + priority: 'medium', + estimatedTime: '5分钟', + icon: Icons.schedule, + color: Colors.purple, + action: '查看计划', + details: [ + '个性化学习路径', + '合理安排学习时间', + '目标导向的学习方案', + ], + ), + RecommendationItem( + type: RecommendationType.weakness, + title: '语法薄弱点强化', + description: '针对您在时态方面的薄弱点进行专项训练', + priority: 'low', + estimatedTime: '25分钟', + icon: Icons.trending_up, + color: Colors.red, + action: '开始训练', + details: [ + '时态专项练习', + '常见错误纠正', + '实用例句训练', + ], + ), + ]; + } + + @override + Widget build(BuildContext context) { + final isMobile = ResponsiveUtils.isMobile(context); + + return Scaffold( + appBar: CustomAppBar( + title: 'AI助手推荐', + ), + body: _isLoading + ? const LoadingWidget() + : _buildContent(context, isMobile), + ); + } + + Widget _buildContent(BuildContext context, bool isMobile) { + return RefreshIndicator( + onRefresh: _loadRecommendations, + child: SingleChildScrollView( + padding: EdgeInsets.all(isMobile ? 16.0 : 24.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildHeader(context, isMobile), + const SizedBox(height: 24), + _buildRecommendationsList(context, isMobile), + ], + ), + ), + ); + } + + Widget _buildHeader(BuildContext context, bool isMobile) { + return Container( + padding: EdgeInsets.all(isMobile ? 20.0 : 24.0), + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [Colors.purple.shade400, Colors.blue.shade500], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.purple.withOpacity(0.3), + blurRadius: 8, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.white.withOpacity(0.2), + borderRadius: BorderRadius.circular(12), + ), + child: Icon( + Icons.psychology, + color: Colors.white, + size: isMobile ? 28 : 32, + ), + ), + const SizedBox(width: 16), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + 'AI智能推荐', + style: TextStyle( + color: Colors.white, + fontSize: isMobile ? 20 : 24, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + '基于您的学习数据智能分析', + style: TextStyle( + color: Colors.white.withOpacity(0.9), + fontSize: isMobile ? 14 : 16, + ), + ), + ], + ), + ), + ], + ), + const SizedBox(height: 16), + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.white.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Icon( + Icons.lightbulb, + color: Colors.yellow.shade300, + size: 20, + ), + const SizedBox(width: 8), + Expanded( + child: Text( + '今日为您推荐了 ${_recommendations.length} 项学习内容', + style: TextStyle( + color: Colors.white, + fontSize: isMobile ? 13 : 15, + ), + ), + ), + ], + ), + ), + ], + ), + ); + } + + Widget _buildRecommendationsList(BuildContext context, bool isMobile) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '推荐内容', + style: TextStyle( + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + const SizedBox(height: 16), + ListView.separated( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + itemCount: _recommendations.length, + separatorBuilder: (context, index) => const SizedBox(height: 16), + itemBuilder: (context, index) { + return _buildRecommendationCard( + context, + _recommendations[index], + isMobile, + ); + }, + ), + ], + ); + } + + Widget _buildRecommendationCard( + BuildContext context, + RecommendationItem item, + bool isMobile, + ) { + return Card( + elevation: 3, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: InkWell( + onTap: () => _handleRecommendationTap(item), + borderRadius: BorderRadius.circular(16), + child: Padding( + padding: EdgeInsets.all(isMobile ? 16.0 : 20.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: item.color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Icon( + item.icon, + color: item.color, + size: isMobile ? 24 : 28, + ), + ), + const SizedBox(width: 16), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + item.title, + style: TextStyle( + fontSize: isMobile ? 16 : 18, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + ), + _buildPriorityBadge(item.priority), + ], + ), + const SizedBox(height: 4), + Row( + children: [ + Icon( + Icons.access_time, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 4), + Text( + item.estimatedTime, + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ), + ], + ), + ), + ], + ), + const SizedBox(height: 16), + Text( + item.description, + style: TextStyle( + fontSize: isMobile ? 14 : 16, + color: Colors.grey[700], + height: 1.4, + ), + ), + const SizedBox(height: 16), + ExpansionTile( + title: const Text( + '查看详情', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + ), + ), + tilePadding: EdgeInsets.zero, + childrenPadding: const EdgeInsets.only(top: 8), + children: [ + ...item.details.map((detail) => Padding( + padding: const EdgeInsets.only(bottom: 4), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Container( + margin: const EdgeInsets.only(top: 6), + width: 4, + height: 4, + decoration: BoxDecoration( + color: item.color, + shape: BoxShape.circle, + ), + ), + const SizedBox(width: 8), + Expanded( + child: Text( + detail, + style: TextStyle( + fontSize: 13, + color: Colors.grey[600], + ), + ), + ), + ], + ), + )), + ], + ), + const SizedBox(height: 16), + SizedBox( + width: double.infinity, + child: ElevatedButton( + onPressed: () => _handleRecommendationTap(item), + style: ElevatedButton.styleFrom( + backgroundColor: item.color, + foregroundColor: Colors.white, + padding: EdgeInsets.symmetric( + vertical: isMobile ? 12 : 16, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: Text( + item.action, + style: TextStyle( + fontSize: isMobile ? 14 : 16, + fontWeight: FontWeight.w600, + ), + ), + ), + ), + ], + ), + ), + ), + ); + } + + Widget _buildPriorityBadge(String priority) { + Color color; + String text; + + switch (priority) { + case 'high': + color = Colors.red; + text = '高优先级'; + break; + case 'medium': + color = Colors.orange; + text = '中优先级'; + break; + case 'low': + color = Colors.green; + text = '低优先级'; + break; + default: + color = Colors.grey; + text = '普通'; + } + + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: color, width: 1), + ), + child: Text( + text, + style: TextStyle( + fontSize: 12, + color: color, + fontWeight: FontWeight.w500, + ), + ), + ); + } + + void _handleRecommendationTap(RecommendationItem item) { + switch (item.type) { + case RecommendationType.vocabulary: + Navigator.of(context).pushNamed('/vocabulary/daily-words'); + break; + case RecommendationType.review: + Navigator.of(context).pushNamed('/vocabulary/review'); + break; + case RecommendationType.test: + Navigator.of(context).pushNamed('/vocabulary/test'); + break; + case RecommendationType.plan: + Navigator.of(context).pushNamed('/vocabulary/study-plan'); + break; + case RecommendationType.weakness: + // 处理薄弱点强化 + break; + } + } +} + +enum RecommendationType { + vocabulary, + review, + test, + plan, + weakness, +} + +class RecommendationItem { + final RecommendationType type; + final String title; + final String description; + final String priority; + final String estimatedTime; + final IconData icon; + final Color color; + final String action; + final List details; + + const RecommendationItem({ + required this.type, + required this.title, + required this.description, + required this.priority, + required this.estimatedTime, + required this.icon, + required this.color, + required this.action, + required this.details, + }); +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/screens/daily_words_screen.dart b/client/lib/features/vocabulary/screens/daily_words_screen.dart new file mode 100644 index 0000000..cca9724 --- /dev/null +++ b/client/lib/features/vocabulary/screens/daily_words_screen.dart @@ -0,0 +1,851 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/utils/responsive_utils.dart'; +import '../../../shared/widgets/custom_app_bar.dart'; +import '../../../shared/widgets/loading_widget.dart'; +import '../../../shared/widgets/error_widget.dart' as custom; +import '../models/word_model.dart'; +import '../models/vocabulary_book_model.dart'; +import '../providers/vocabulary_provider.dart'; +import '../../auth/providers/auth_provider.dart'; +import 'word_learning_screen.dart'; +import '../../../core/services/audio_service.dart'; +import '../../../shared/services/word_book_service.dart' as shared; +import '../services/vocabulary_service.dart'; +import '../../../core/services/storage_service.dart'; +import '../../../core/network/api_client.dart'; + +class DailyWordsScreen extends ConsumerStatefulWidget { + const DailyWordsScreen({super.key}); + + @override + ConsumerState createState() => _DailyWordsScreenState(); +} + +class _DailyWordsScreenState extends ConsumerState { + bool _isLoading = false; + List _dailyWords = []; + int _currentIndex = 0; + // 已学习的单词ID集合（从后端获取或学习后更新） + Set _learnedWordIds = {}; + // 今日学习统计（从后端获取） + int _todayStudiedCount = 0; + int _todayNewWords = 0; + int _todayReviewWords = 0; + // 音频服务 + final AudioService _audioService = AudioService(); + // 生词本服务 + shared.WordBookService? _wordBookService; + // 收藏的单词ID集合 + Set _favoriteWordIds = {}; + + @override + void initState() { + super.initState(); + _initializeServices(); + _loadDailyWords(); + _loadTodayStatistics(); // 加载今日学习统计 + } + + Future _initializeServices() async { + try { + await _audioService.initialize(); + _wordBookService = shared.WordBookService(); + await _loadFavoriteWords(); + } catch (e) { + print('初始化服务失败: $e'); + } + } + + Future _loadFavoriteWords() async { + if (_wordBookService == null) return; + try { + // 从后端获取生词本列表 + final result = await _wordBookService!.getFavoriteWords(pageSize: 1000); + final List words = result['words'] ?? []; + setState(() { + _favoriteWordIds = words.map((w) => w['vocabulary_id'] as int).toSet(); + }); + print('✅ 已加载 ${_favoriteWordIds.length} 个收藏单词'); + } catch (e) { + print('加载收藏单词失败: $e'); + } + } + + @override + void dispose() { + _audioService.dispose(); + super.dispose(); + } + + Future _loadDailyWords() async { + setState(() { + _isLoading = true; + }); + + try { + print('=== 加载今日单词 ==='); + + // 使用与首页一样的接口获取今日单词 + final apiClient = ApiClient.instance; + final storageService = await StorageService.getInstance(); + final vocabularyService = VocabularyService( + apiClient: apiClient, + storageService: storageService, + ); + + // 调用getTodayStudyWords方法，获取今日学习单词（完整信息） + final words = await vocabularyService.getTodayStudyWords(limit: 50); + + setState(() { + _dailyWords = words; + _isLoading = false; + }); + print('✅ 今日单词加载完成，数量: ${words.length}'); + } catch (e) { + print('❌ 加载今日单词异常: $e'); + setState(() { + _dailyWords = []; + _isLoading = false; + }); + } + } + + /// 加载今日学习统计 + Future _loadTodayStatistics() async { + try { + final apiClient = ApiClient.instance; + final response = await apiClient.get('/learning/today/statistics'); + + if (response.statusCode == 200 && response.data['code'] == 200) { + final data = response.data['data']; + setState(() { + _todayStudiedCount = (data['todayTotalStudied'] ?? 0).toInt(); + _todayNewWords = (data['todayNewWords'] ?? 0).toInt(); + _todayReviewWords = (data['todayReviewWords'] ?? 0).toInt(); + }); + print('✅ 今日学习统计: 新词$_todayNewWords + 复习$_todayReviewWords = 总计$_todayStudiedCount'); + } + } catch (e) { + print('❌ 加载今日学习统计失败: $e'); + } + } + + void _startLearning() async { + if (_dailyWords.isEmpty) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('暂无单词可学习')), + ); + return; + } + + // 创建一个临时的词汇书用于学习 + final vocabularyBook = VocabularyBook( + id: 'daily_words', + name: '今日单词', + description: '今日推荐学习的单词', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.beginner, + totalWords: _dailyWords.length, + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ); + + final result = await Navigator.of(context).push>( + MaterialPageRoute( + builder: (context) => WordLearningScreen( + vocabularyBook: vocabularyBook, + specificWords: _dailyWords, + mode: LearningMode.normal, + ), + ), + ); + + // 从学习页面返回后更新进度 + if (result != null && result is Map) { + _updateProgressFromLearningResult({'answers': result}); + _loadTodayStatistics(); // 重新加载今日统计（从后端获取最新数据） + } + } + + void _startReviewMode() async { + // 获取已学习的单词 + final learnedWords = _dailyWords.where((word) => _learnedWordIds.contains(word.id)).toList(); + + if (learnedWords.isEmpty) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('暂无已学单词可复习')), + ); + return; + } + + // 创建一个临时的词汇书用于复习 + final vocabularyBook = VocabularyBook( + id: 'daily_words_review', + name: '今日单词复习', + description: '复习今日已学的单词', + type: VocabularyBookType.system, + difficulty: VocabularyBookDifficulty.beginner, + totalWords: learnedWords.length, + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ); + + final result = await Navigator.of(context).push>( + MaterialPageRoute( + builder: (context) => WordLearningScreen( + vocabularyBook: vocabularyBook, + specificWords: learnedWords, + mode: LearningMode.review, + ), + ), + ); + + // 从复习页面返回后更新状态 + if (result != null && result is Map) { + _updateProgressFromReviewResult({'answers': result}); + _loadTodayStatistics(); // 重新加载今日统计 + } + } + + void _markAsLearned(int index) { + setState(() { + if (index < _dailyWords.length) { + _learnedWordIds.add(_dailyWords[index].id); + } + }); + } + + void _updateProgressFromLearningResult(Map result) { + final answers = result['answers'] as Map? ?? {}; + + setState(() { + // 将答对的单词ID添加到已学习集合 + answers.forEach((wordId, isCorrect) { + if (isCorrect) { + _learnedWordIds.add(wordId); + } + }); + }); + + final learnedWordsCount = _learnedWordIds.length; + + // 显示学习结果提示 + final totalWords = answers.length; + if (totalWords > 0) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('学习完成！掌握了 $learnedWordsCount/$totalWords 个单词'), + backgroundColor: Colors.green, + duration: const Duration(seconds: 3), + ), + ); + } + } + + void _updateProgressFromReviewResult(Map result) { + final answers = result['answers'] as Map? ?? {}; + final correctCount = answers.values.where((answer) => answer == true).length; + final totalCount = answers.length; + + // 显示复习结果提示 + if (totalCount > 0) { + final accuracy = (correctCount / totalCount * 100).round(); + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('复习完成！正确率：$accuracy% ($correctCount/$totalCount)'), + backgroundColor: accuracy >= 80 ? Colors.green : Colors.orange, + duration: const Duration(seconds: 3), + ), + ); + } + } + + @override + Widget build(BuildContext context) { + final isMobile = ResponsiveUtils.isMobile(context); + + return Scaffold( + appBar: CustomAppBar( + title: '今日复习', + ), + body: _isLoading + ? const LoadingWidget() + : _buildContent(context, isMobile), + ); + } + + Widget _buildEmptyState(BuildContext context, bool isMobile) { + return Center( + child: Padding( + padding: EdgeInsets.all(isMobile ? 32.0 : 48.0), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.book_outlined, + size: isMobile ? 80 : 100, + color: Colors.grey[400], + ), + const SizedBox(height: 24), + Text( + '暂无今日单词', + style: TextStyle( + fontSize: isMobile ? 20 : 24, + fontWeight: FontWeight.bold, + color: Colors.grey[700], + ), + ), + const SizedBox(height: 12), + Text( + '今天还没有推荐的学习单词', + style: TextStyle( + fontSize: isMobile ? 14 : 16, + color: Colors.grey[600], + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 32), + ElevatedButton.icon( + onPressed: _loadDailyWords, + icon: const Icon(Icons.refresh), + label: const Text('重新加载'), + style: ElevatedButton.styleFrom( + padding: EdgeInsets.symmetric( + horizontal: isMobile ? 24 : 32, + vertical: isMobile ? 12 : 16, + ), + ), + ), + ], + ), + ), + ); + } + + Widget _buildContent(BuildContext context, bool isMobile) { + return SingleChildScrollView( + padding: EdgeInsets.all(isMobile ? 16.0 : 24.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 学习统计（始终显示） + _buildProgressSection(context, isMobile), + const SizedBox(height: 24), + + // 如果有今日推荐单词，显示操作按钮和单词列表 + if (_dailyWords.isNotEmpty) ...[ + _buildActionButtons(context, isMobile), + const SizedBox(height: 24), + _buildWordsList(context, isMobile), + ] else ...[ + // 没有今日需要复习的单词时的提示 + Center( + child: Padding( + padding: const EdgeInsets.all(32.0), + child: Column( + children: [ + Icon( + Icons.check_circle_outline, + size: 64, + color: Colors.green[400], + ), + const SizedBox(height: 16), + Text( + '今天没有需要复习的单词', + style: TextStyle( + fontSize: 16, + color: Colors.grey[700], + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 8), + Text( + '继续保持！去词汇书页面学习新单词吧', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ), + ], + ], + ), + ); + } + + Widget _buildProgressSection(BuildContext context, bool isMobile) { + return Container( + padding: EdgeInsets.all(isMobile ? 16.0 : 20.0), + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [Colors.blue.shade400, Colors.blue.shade600], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.blue.withOpacity(0.3), + blurRadius: 8, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.today, + color: Colors.white, + size: isMobile ? 24 : 28, + ), + const SizedBox(width: 12), + Text( + '今日学习进度', + style: TextStyle( + color: Colors.white, + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '$_todayStudiedCount 个单词', + style: TextStyle( + color: Colors.white, + fontSize: isMobile ? 16 : 18, + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 4), + Text( + '新词 $_todayNewWords + 复习 $_todayReviewWords', + style: TextStyle( + color: Colors.white.withOpacity(0.9), + fontSize: isMobile ? 12 : 14, + ), + ), + ], + ), + ), + const SizedBox(width: 16), + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.white.withOpacity(0.2), + shape: BoxShape.circle, + ), + child: Icon( + Icons.check_circle, + color: Colors.white, + size: isMobile ? 32 : 40, + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildActionButtons(BuildContext context, bool isMobile) { + return Row( + children: [ + Expanded( + child: ElevatedButton.icon( + onPressed: _startLearning, + icon: const Icon(Icons.play_arrow), + label: const Text('开始学习'), + style: ElevatedButton.styleFrom( + backgroundColor: Colors.green, + foregroundColor: Colors.white, + padding: EdgeInsets.symmetric( + vertical: isMobile ? 12 : 16, + horizontal: isMobile ? 16 : 24, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + ), + ), + const SizedBox(width: 12), + Expanded( + child: OutlinedButton.icon( + onPressed: _startReviewMode, + icon: const Icon(Icons.refresh), + label: const Text('复习模式'), + style: OutlinedButton.styleFrom( + foregroundColor: Colors.blue, + padding: EdgeInsets.symmetric( + vertical: isMobile ? 12 : 16, + horizontal: isMobile ? 16 : 24, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + ), + ), + ], + ); + } + + Widget _buildWordsList(BuildContext context, bool isMobile) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '单词列表', + style: TextStyle( + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + const SizedBox(height: 16), + ListView.separated( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + itemCount: _dailyWords.length, + separatorBuilder: (context, index) => const SizedBox(height: 12), + itemBuilder: (context, index) { + return _buildWordCard(context, _dailyWords[index], index, isMobile); + }, + ), + ], + ); + } + + Widget _buildWordCard(BuildContext context, Word word, int index, bool isMobile) { + final isLearned = _learnedWordIds.contains(word.id); + + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: Padding( + padding: EdgeInsets.all(isMobile ? 16.0 : 20.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Text( + word.word, + style: TextStyle( + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + color: isLearned ? Colors.green : Colors.grey[800], + ), + ), + const SizedBox(width: 8), + if (isLearned) + Icon( + Icons.check_circle, + color: Colors.green, + size: isMobile ? 20 : 24, + ), + ], + ), + const SizedBox(height: 4), + if (word.phonetic != null) + Text( + word.phonetic!, + style: TextStyle( + fontSize: isMobile ? 14 : 16, + color: Colors.blue[600], + fontStyle: FontStyle.italic, + ), + ), + ], + ), + ), + Row( + children: [ + IconButton( + onPressed: () => _playWordAudio(word), + icon: const Icon(Icons.volume_up), + color: Colors.blue, + tooltip: '播放发音', + ), + IconButton( + onPressed: () => _toggleFavorite(word), + icon: Icon( + _favoriteWordIds.contains(int.tryParse(word.id)) + ? Icons.favorite + : Icons.favorite_border, + ), + color: Colors.red, + tooltip: _favoriteWordIds.contains(int.tryParse(word.id)) ? '取消收藏' : '收藏单词', + ), + ], + ), + ], + ), + const SizedBox(height: 12), + if (word.definitions.isNotEmpty) + Text( + word.definitions.first.translation, + style: TextStyle( + fontSize: isMobile ? 14 : 16, + color: Colors.grey[700], + ), + ), + const SizedBox(height: 8), + if (word.examples.isNotEmpty) + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + border: Border.all(color: Colors.grey[200]!), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + word.examples.first.sentence, + style: TextStyle( + fontSize: isMobile ? 13 : 15, + fontStyle: FontStyle.italic, + color: Colors.grey[800], + ), + ), + const SizedBox(height: 4), + Text( + word.examples.first.translation, + style: TextStyle( + fontSize: isMobile ? 12 : 14, + color: Colors.grey[600], + ), + ), + ], + ), + ), + const SizedBox(height: 12), + Row( + children: [ + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: _getDifficultyColor(word.difficulty).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: _getDifficultyColor(word.difficulty), + width: 1, + ), + ), + child: Text( + _getDifficultyText(word.difficulty), + style: TextStyle( + fontSize: 12, + color: _getDifficultyColor(word.difficulty), + fontWeight: FontWeight.w500, + ), + ), + ), + const SizedBox(width: 8), + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + _getCategoryText(word.definitions.isNotEmpty ? word.definitions.first.type : WordType.noun), + style: const TextStyle( + fontSize: 12, + color: Colors.blue, + fontWeight: FontWeight.w500, + ), + ), + ), + const Spacer(), + if (!isLearned) + TextButton( + onPressed: () => _markAsLearned(index), + child: const Text('标记已学'), + ), + ], + ), + ], + ), + ), + ); + } + + Color _getDifficultyColor(WordDifficulty difficulty) { + switch (difficulty) { + case WordDifficulty.beginner: + return Colors.green; + case WordDifficulty.elementary: + return Colors.lightGreen; + case WordDifficulty.intermediate: + return Colors.orange; + case WordDifficulty.advanced: + return Colors.red; + case WordDifficulty.expert: + return Colors.purple; + } + } + + String _getDifficultyText(WordDifficulty difficulty) { + switch (difficulty) { + case WordDifficulty.beginner: + return '初级'; + case WordDifficulty.elementary: + return '基础'; + case WordDifficulty.intermediate: + return '中级'; + case WordDifficulty.advanced: + return '高级'; + case WordDifficulty.expert: + return '专家'; + } + } + + String _getCategoryText(WordType type) { + switch (type) { + case WordType.noun: + return '名词'; + case WordType.verb: + return '动词'; + case WordType.adjective: + return '形容词'; + case WordType.adverb: + return '副词'; + case WordType.preposition: + return '介词'; + case WordType.conjunction: + return '连词'; + case WordType.interjection: + return '感叹词'; + case WordType.pronoun: + return '代词'; + case WordType.article: + return '冠词'; + case WordType.phrase: + return '短语'; + } + } + + Future _playWordAudio(Word word) async { + try { + if (word.audioUrl != null && word.audioUrl!.isNotEmpty) { + await _audioService.playAudio(word.audioUrl!); + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Row( + children: [ + const Icon(Icons.volume_up, color: Colors.white, size: 20), + const SizedBox(width: 8), + Text('正在播放: ${word.word}'), + ], + ), + duration: const Duration(seconds: 2), + backgroundColor: Colors.blue, + ), + ); + } + } else { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('该单词暂无音频'), + duration: Duration(seconds: 2), + ), + ); + } + } + } catch (e) { + print('播放音频失败: $e'); + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('播放失败'), + duration: Duration(seconds: 2), + ), + ); + } + } + } + + Future _toggleFavorite(Word word) async { + if (_wordBookService == null) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('生词本服务正在初始化，请稍后再试'), + duration: Duration(seconds: 2), + backgroundColor: Colors.orange, + ), + ); + } + return; + } + + try { + // 调用后端 API 切换收藏状态 + final wordId = int.tryParse(word.id); + if (wordId == null) { + throw Exception('无效的单词 ID'); + } + + final result = await _wordBookService!.toggleFavorite(wordId); + final isFavorite = result['is_favorite'] as bool; + + setState(() { + if (isFavorite) { + _favoriteWordIds.add(wordId); + } else { + _favoriteWordIds.remove(wordId); + } + }); + + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text(isFavorite ? '已添加到生词本: ${word.word}' : '已从生词本移除: ${word.word}'), + duration: const Duration(seconds: 2), + backgroundColor: isFavorite ? Colors.green : Colors.orange, + ), + ); + } + } catch (e) { + print('操作生词本失败: $e'); + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('操作失败: ${e.toString()}'), + duration: const Duration(seconds: 2), + backgroundColor: Colors.red, + ), + ); + } + } + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/screens/smart_review_screen.dart b/client/lib/features/vocabulary/screens/smart_review_screen.dart new file mode 100644 index 0000000..f242b09 --- /dev/null +++ b/client/lib/features/vocabulary/screens/smart_review_screen.dart @@ -0,0 +1,542 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/vocabulary_book_model.dart'; +import '../models/review_models.dart'; +import '../models/word_model.dart'; +import '../providers/vocabulary_provider.dart'; +import 'dart:math'; + +class SmartReviewScreen extends ConsumerStatefulWidget { + final VocabularyBook? vocabularyBook; + final ReviewMode reviewMode; + final int dailyTarget; + + const SmartReviewScreen({ + super.key, + this.vocabularyBook, + this.reviewMode = ReviewMode.adaptive, + this.dailyTarget = 20, + }); + + @override + ConsumerState createState() => _SmartReviewScreenState(); +} + +class _SmartReviewScreenState extends ConsumerState { + List _reviewWords = []; + int _currentIndex = 0; + bool _isLoading = true; + bool _showAnswer = false; + Map _reviewResults = {}; // 0: 不记得, 1: 模糊, 2: 记得 + + @override + void initState() { + super.initState(); + _loadWords(); + } + + Future _loadWords() async { + setState(() => _isLoading = true); + + try { + final notifier = ref.read(vocabularyProvider.notifier); + await notifier.loadReviewWords(); + + final state = ref.read(vocabularyProvider); + final words = state.reviewWords; + + if (words.isEmpty) { + // 如果没有复习词汇，生成示例数据 + _reviewWords = _generateSampleWords(); + } else { + _reviewWords = words.take(widget.dailyTarget).toList(); + } + } catch (e) { + _reviewWords = _generateSampleWords(); + } + + setState(() => _isLoading = false); + } + + List _generateSampleWords() { + final sampleData = [ + {'word': 'abandon', 'phonetic': '/əˈbændən/', 'translation': '放弃；遗弃'}, + {'word': 'ability', 'phonetic': '/əˈbɪləti/', 'translation': '能力；才能'}, + {'word': 'abroad', 'phonetic': '/əˈbrɔːd/', 'translation': '在国外；到国外'}, + {'word': 'absence', 'phonetic': '/ˈæbsəns/', 'translation': '缺席；缺乏'}, + {'word': 'absolute', 'phonetic': '/ˈæbsəluːt/', 'translation': '绝对的；完全的'}, + {'word': 'absorb', 'phonetic': '/əbˈsɔːrb/', 'translation': '吸收；吸引'}, + {'word': 'abstract', 'phonetic': '/ˈæbstrækt/', 'translation': '抽象的；抽象概念'}, + {'word': 'abundant', 'phonetic': '/əˈbʌndənt/', 'translation': '丰富的；充裕的'}, + {'word': 'academic', 'phonetic': '/ˌækəˈdemɪk/', 'translation': '学术的；学院的'}, + {'word': 'accept', 'phonetic': '/əkˈsept/', 'translation': '接受；承认'}, + ]; + + return List.generate( + widget.dailyTarget.clamp(1, sampleData.length), + (index) { + final data = sampleData[index % sampleData.length]; + return Word( + id: '${index + 1}', + word: data['word']!, + phonetic: data['phonetic'], + difficulty: WordDifficulty.intermediate, + frequency: 1000, + definitions: [ + WordDefinition( + type: WordType.noun, + definition: 'Example definition', + translation: data['translation']!, + ), + ], + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ); + }, + ); + } + + @override + Widget build(BuildContext context) { + if (_isLoading) { + return Scaffold( + appBar: AppBar( + title: const Text('智能复习'), + ), + body: const Center( + child: CircularProgressIndicator(), + ), + ); + } + + if (_currentIndex >= _reviewWords.length) { + return _buildCompleteScreen(); + } + + return Scaffold( + appBar: AppBar( + title: Text('智能复习 (${_currentIndex + 1}/${_reviewWords.length})'), + actions: [ + TextButton( + onPressed: _showExitConfirmDialog, + child: const Text( + '退出', + style: TextStyle(color: Colors.white), + ), + ), + ], + ), + body: _buildReviewCard(), + ); + } + + Widget _buildReviewCard() { + final word = _reviewWords[_currentIndex]; + final translation = word.definitions.isNotEmpty + ? word.definitions.first.translation + : '示例释义'; + + return Column( + children: [ + // 进度条 + LinearProgressIndicator( + value: (_currentIndex + 1) / _reviewWords.length, + backgroundColor: Colors.grey[200], + valueColor: const AlwaysStoppedAnimation(Color(0xFF9C27B0)), + ), + Expanded( + child: Center( + child: SingleChildScrollView( + padding: const EdgeInsets.all(24), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + // 卡片 + Container( + width: double.infinity, + padding: const EdgeInsets.all(32), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(20), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.1), + blurRadius: 20, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + children: [ + // 单词 + Text( + word.word, + style: const TextStyle( + fontSize: 42, + fontWeight: FontWeight.bold, + color: Color(0xFF9C27B0), + ), + ), + if (word.phonetic != null) ...[ + const SizedBox(height: 12), + Text( + word.phonetic!, + style: const TextStyle( + fontSize: 20, + color: Colors.grey, + fontStyle: FontStyle.italic, + ), + ), + ], + const SizedBox(height: 32), + // 音频按钮 + IconButton( + onPressed: () => _playAudio(word.word), + icon: const Icon( + Icons.volume_up, + size: 48, + color: Color(0xFF9C27B0), + ), + ), + const SizedBox(height: 32), + // 答案区域 + AnimatedContainer( + duration: const Duration(milliseconds: 300), + curve: Curves.easeInOut, + height: _showAnswer ? null : 0, + child: _showAnswer + ? Column( + children: [ + const Divider(), + const SizedBox(height: 16), + const Text( + '释义', + style: TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + const SizedBox(height: 8), + Text( + translation, + style: const TextStyle( + fontSize: 24, + fontWeight: FontWeight.w600, + ), + textAlign: TextAlign.center, + ), + ], + ) + : const SizedBox.shrink(), + ), + ], + ), + ), + const SizedBox(height: 32), + // 提示文本 + if (!_showAnswer) + const Text( + '回忆这个单词的意思，然后点击“显示答案”', + style: TextStyle( + fontSize: 14, + color: Colors.grey, + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ), + ), + // 底部按钮 + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, -2), + ), + ], + ), + child: SafeArea( + child: _showAnswer + ? Row( + children: [ + Expanded( + child: _buildResultButton( + label: '不记得', + color: Colors.red, + result: 0, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildResultButton( + label: '模糊', + color: Colors.orange, + result: 1, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildResultButton( + label: '记得', + color: Colors.green, + result: 2, + ), + ), + ], + ) + : ElevatedButton( + onPressed: () { + setState(() { + _showAnswer = true; + }); + }, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF9C27B0), + padding: const EdgeInsets.symmetric(vertical: 16), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: const Text( + '显示答案', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ), + ), + ), + ], + ); + } + + Widget _buildResultButton({ + required String label, + required Color color, + required int result, + }) { + return ElevatedButton( + onPressed: () => _recordResult(result), + style: ElevatedButton.styleFrom( + backgroundColor: color, + padding: const EdgeInsets.symmetric(vertical: 12), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: Text( + label, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + ), + ), + ); + } + + void _recordResult(int result) { + setState(() { + _reviewResults[_currentIndex] = result; + _showAnswer = false; + _currentIndex++; + }); + } + + Widget _buildCompleteScreen() { + final remembered = _reviewResults.values.where((r) => r == 2).length; + final fuzzy = _reviewResults.values.where((r) => r == 1).length; + final forgotten = _reviewResults.values.where((r) => r == 0).length; + + return Scaffold( + appBar: AppBar( + title: const Text('复习完成'), + automaticallyImplyLeading: false, + ), + body: Center( + child: Padding( + padding: const EdgeInsets.all(24), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Container( + width: 120, + height: 120, + decoration: BoxDecoration( + color: const Color(0xFF9C27B0).withOpacity(0.1), + shape: BoxShape.circle, + ), + child: const Center( + child: Icon( + Icons.check_circle, + size: 64, + color: Color(0xFF9C27B0), + ), + ), + ), + const SizedBox(height: 24), + const Text( + '复习完成！', + style: TextStyle( + fontSize: 28, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Text( + '共复习 ${_reviewWords.length} 个单词', + style: const TextStyle( + fontSize: 18, + color: Colors.grey, + ), + ), + const SizedBox(height: 32), + // 统计信息 + Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + _buildStatRow( + '完全记得', + remembered, + Colors.green, + ), + const SizedBox(height: 12), + _buildStatRow( + '模糊记得', + fuzzy, + Colors.orange, + ), + const SizedBox(height: 12), + _buildStatRow( + '不记得', + forgotten, + Colors.red, + ), + ], + ), + ), + const SizedBox(height: 48), + ElevatedButton( + onPressed: () => Navigator.of(context).pop(), + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF9C27B0), + padding: const EdgeInsets.symmetric( + horizontal: 48, + vertical: 16, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: const Text( + '完成', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ), + const SizedBox(height: 16), + TextButton( + onPressed: () { + setState(() { + _currentIndex = 0; + _reviewResults.clear(); + _showAnswer = false; + }); + _loadWords(); + }, + child: const Text('重新复习'), + ), + ], + ), + ), + ), + ); + } + + Widget _buildStatRow(String label, int count, Color color) { + return Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Row( + children: [ + Container( + width: 12, + height: 12, + decoration: BoxDecoration( + color: color, + shape: BoxShape.circle, + ), + ), + const SizedBox(width: 12), + Text( + label, + style: const TextStyle( + fontSize: 16, + ), + ), + ], + ), + Text( + '$count', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: color, + ), + ), + ], + ); + } + + void _playAudio(String word) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('正在播放 "$word" 的发音'), + duration: const Duration(seconds: 1), + ), + ); + } + + void _showExitConfirmDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('退出复习'), + content: const Text('确定要退出吗？当前进度将不会保存。'), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(), + child: const Text('取消'), + ), + TextButton( + onPressed: () { + Navigator.of(context).pop(); + Navigator.of(context).pop(); + }, + child: const Text('确定'), + ), + ], + ), + ); + } +} diff --git a/client/lib/features/vocabulary/screens/study_plan_screen.dart b/client/lib/features/vocabulary/screens/study_plan_screen.dart new file mode 100644 index 0000000..2ad6071 --- /dev/null +++ b/client/lib/features/vocabulary/screens/study_plan_screen.dart @@ -0,0 +1,1854 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/utils/responsive_utils.dart'; +import '../../../shared/widgets/custom_app_bar.dart'; +import '../../../shared/widgets/loading_widget.dart'; + +class StudyPlanScreen extends ConsumerStatefulWidget { + const StudyPlanScreen({super.key}); + + @override + ConsumerState createState() => _StudyPlanScreenState(); +} + +class _StudyPlanScreenState extends ConsumerState + with TickerProviderStateMixin { + late TabController _tabController; + bool _isLoading = false; + + List _studyPlans = []; + StudyPlan? _currentPlan; + + @override + void initState() { + super.initState(); + _tabController = TabController(length: 3, vsync: this); + _loadStudyPlans(); + } + + @override + void dispose() { + _tabController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + final isMobile = ResponsiveUtils.isMobile(context); + + return Scaffold( + appBar: CustomAppBar( + title: '学习计划', + actions: [ + IconButton( + icon: const Icon(Icons.add), + onPressed: _showCreatePlanDialog, + ), + PopupMenuButton( + icon: const Icon(Icons.more_vert), + onSelected: _handleMenuAction, + itemBuilder: (context) => [ + const PopupMenuItem( + value: 'templates', + child: Row( + children: [ + Icon(Icons.library_books), + SizedBox(width: 8), + Text('计划模板'), + ], + ), + ), + const PopupMenuItem( + value: 'statistics', + child: Row( + children: [ + Icon(Icons.analytics), + SizedBox(width: 8), + Text('学习统计'), + ], + ), + ), + const PopupMenuItem( + value: 'settings', + child: Row( + children: [ + Icon(Icons.settings), + SizedBox(width: 8), + Text('设置'), + ], + ), + ), + ], + ), + ], + ), + body: Column( + children: [ + _buildTabBar(context, isMobile), + Expanded( + child: TabBarView( + controller: _tabController, + children: [ + _buildCurrentPlanTab(context, isMobile), + _buildAllPlansTab(context, isMobile), + _buildProgressTab(context, isMobile), + ], + ), + ), + ], + ), + floatingActionButton: FloatingActionButton( + onPressed: _showCreatePlanDialog, + backgroundColor: Colors.blue, + child: const Icon(Icons.add, color: Colors.white), + ), + ); + } + + Widget _buildTabBar(BuildContext context, bool isMobile) { + return Container( + decoration: BoxDecoration( + color: Colors.white, + border: Border( + bottom: BorderSide(color: Colors.grey.shade200), + ), + ), + child: TabBar( + controller: _tabController, + labelColor: Colors.blue, + unselectedLabelColor: Colors.grey, + indicatorColor: Colors.blue, + tabs: const [ + Tab( + icon: Icon(Icons.today), + text: '当前计划', + ), + Tab( + icon: Icon(Icons.list), + text: '所有计划', + ), + Tab( + icon: Icon(Icons.trending_up), + text: '学习进度', + ), + ], + ), + ); + } + + Widget _buildCurrentPlanTab(BuildContext context, bool isMobile) { + if (_isLoading) { + return const LoadingWidget(); + } + + if (_currentPlan == null) { + return _buildNoPlanState(context, isMobile); + } + + return SingleChildScrollView( + padding: EdgeInsets.all(isMobile ? 16.0 : 24.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildCurrentPlanHeader(context, _currentPlan!, isMobile), + const SizedBox(height: 24), + _buildTodayTasks(context, _currentPlan!, isMobile), + const SizedBox(height: 24), + _buildWeeklyProgress(context, _currentPlan!, isMobile), + const SizedBox(height: 24), + _buildQuickActions(context, isMobile), + ], + ), + ); + } + + Widget _buildAllPlansTab(BuildContext context, bool isMobile) { + if (_isLoading) { + return const LoadingWidget(); + } + + if (_studyPlans.isEmpty) { + return _buildEmptyPlansState(context, isMobile); + } + + return ListView.builder( + padding: EdgeInsets.all(isMobile ? 16.0 : 24.0), + itemCount: _studyPlans.length, + itemBuilder: (context, index) { + final plan = _studyPlans[index]; + return _buildPlanCard(context, plan, isMobile); + }, + ); + } + + Widget _buildProgressTab(BuildContext context, bool isMobile) { + if (_isLoading) { + return const LoadingWidget(); + } + + return SingleChildScrollView( + padding: EdgeInsets.all(isMobile ? 16.0 : 24.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildOverallProgress(context, isMobile), + const SizedBox(height: 24), + _buildWeeklyChart(context, isMobile), + const SizedBox(height: 24), + _buildMonthlyStats(context, isMobile), + const SizedBox(height: 24), + _buildAchievements(context, isMobile), + ], + ), + ); + } + + Widget _buildCurrentPlanHeader(BuildContext context, StudyPlan plan, bool isMobile) { + final progress = plan.completedTasks / plan.totalTasks; + + return Card( + elevation: 4, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Container( + padding: EdgeInsets.all(isMobile ? 20.0 : 24.0), + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [Colors.blue.shade400, Colors.blue.shade600], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + borderRadius: BorderRadius.circular(16), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + plan.title, + style: TextStyle( + color: Colors.white, + fontSize: isMobile ? 20 : 24, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + plan.description, + style: TextStyle( + color: Colors.white.withOpacity(0.9), + fontSize: isMobile ? 14 : 16, + ), + ), + ], + ), + ), + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.white.withOpacity(0.2), + borderRadius: BorderRadius.circular(12), + ), + child: Icon( + _getPlanTypeIcon(plan.type), + color: Colors.white, + size: isMobile ? 28 : 32, + ), + ), + ], + ), + const SizedBox(height: 20), + Row( + children: [ + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '总体进度', + style: TextStyle( + color: Colors.white.withOpacity(0.9), + fontSize: isMobile ? 14 : 16, + ), + ), + const SizedBox(height: 8), + LinearProgressIndicator( + value: progress, + backgroundColor: Colors.white.withOpacity(0.3), + valueColor: const AlwaysStoppedAnimation(Colors.white), + minHeight: 6, + ), + const SizedBox(height: 4), + Text( + '${(progress * 100).toInt()}% (${plan.completedTasks}/${plan.totalTasks})', + style: TextStyle( + color: Colors.white, + fontSize: isMobile ? 12 : 14, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ), + const SizedBox(width: 20), + Column( + children: [ + Text( + '剩余天数', + style: TextStyle( + color: Colors.white.withOpacity(0.9), + fontSize: isMobile ? 12 : 14, + ), + ), + Text( + '${plan.endDate.difference(DateTime.now()).inDays}', + style: TextStyle( + color: Colors.white, + fontSize: isMobile ? 24 : 28, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + ], + ), + ], + ), + ), + ); + } + + Widget _buildTodayTasks(BuildContext context, StudyPlan plan, bool isMobile) { + final todayTasks = plan.tasks.where((task) { + final today = DateTime.now(); + return task.dueDate.year == today.year && + task.dueDate.month == today.month && + task.dueDate.day == today.day; + }).toList(); + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.today, + color: Colors.blue[700], + size: isMobile ? 24 : 28, + ), + const SizedBox(width: 8), + Text( + '今日任务', + style: TextStyle( + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + const Spacer(), + Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 6), + decoration: BoxDecoration( + color: Colors.blue.withOpacity(0.1), + borderRadius: BorderRadius.circular(20), + ), + child: Text( + '${todayTasks.where((t) => t.isCompleted).length}/${todayTasks.length}', + style: TextStyle( + fontSize: 12, + color: Colors.blue[700], + fontWeight: FontWeight.w500, + ), + ), + ), + ], + ), + const SizedBox(height: 16), + if (todayTasks.isEmpty) + Container( + padding: EdgeInsets.all(isMobile ? 20.0 : 24.0), + decoration: BoxDecoration( + color: Colors.green.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all(color: Colors.green.withOpacity(0.3)), + ), + child: Row( + children: [ + Icon( + Icons.check_circle, + color: Colors.green[600], + size: isMobile ? 24 : 28, + ), + const SizedBox(width: 12), + Expanded( + child: Text( + '今日无任务，您可以休息或提前学习明天的内容', + style: TextStyle( + fontSize: isMobile ? 14 : 16, + color: Colors.green[700], + ), + ), + ), + ], + ), + ) + else + ...todayTasks.map((task) => _buildTaskCard(context, task, isMobile)), + ], + ); + } + + Widget _buildTaskCard(BuildContext context, StudyTask task, bool isMobile) { + return Container( + margin: const EdgeInsets.only(bottom: 12), + child: Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: InkWell( + onTap: () => _toggleTaskCompletion(task), + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: EdgeInsets.all(isMobile ? 16.0 : 20.0), + child: Row( + children: [ + Container( + width: 24, + height: 24, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: task.isCompleted ? Colors.green : Colors.transparent, + border: Border.all( + color: task.isCompleted ? Colors.green : Colors.grey[400]!, + width: 2, + ), + ), + child: task.isCompleted + ? const Icon( + Icons.check, + color: Colors.white, + size: 16, + ) + : null, + ), + const SizedBox(width: 16), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + task.title, + style: TextStyle( + fontSize: isMobile ? 16 : 18, + fontWeight: FontWeight.w600, + color: task.isCompleted ? Colors.grey[500] : Colors.grey[800], + decoration: task.isCompleted ? TextDecoration.lineThrough : null, + ), + ), + if (task.description.isNotEmpty) ...[ + const SizedBox(height: 4), + Text( + task.description, + style: TextStyle( + fontSize: isMobile ? 14 : 16, + color: task.isCompleted ? Colors.grey[400] : Colors.grey[600], + ), + ), + ], + const SizedBox(height: 8), + Row( + children: [ + _buildTaskTypeChip(task.type, isMobile), + const SizedBox(width: 8), + if (task.estimatedMinutes > 0) + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: Colors.orange.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + Icons.access_time, + size: 12, + color: Colors.orange[700], + ), + const SizedBox(width: 4), + Text( + '${task.estimatedMinutes}分钟', + style: TextStyle( + fontSize: 12, + color: Colors.orange[700], + ), + ), + ], + ), + ), + ], + ), + ], + ), + ), + if (!task.isCompleted) + IconButton( + icon: const Icon(Icons.play_arrow), + onPressed: () => _startTask(task), + color: Colors.blue, + ), + ], + ), + ), + ), + ), + ); + } + + Widget _buildTaskTypeChip(TaskType type, bool isMobile) { + Color color; + String text; + IconData icon; + + switch (type) { + case TaskType.vocabulary: + color = Colors.blue; + text = '词汇'; + icon = Icons.book; + break; + case TaskType.reading: + color = Colors.green; + text = '阅读'; + icon = Icons.article; + break; + case TaskType.listening: + color = Colors.purple; + text = '听力'; + icon = Icons.headphones; + break; + case TaskType.speaking: + color = Colors.orange; + text = '口语'; + icon = Icons.mic; + break; + case TaskType.writing: + color = Colors.red; + text = '写作'; + icon = Icons.edit; + break; + case TaskType.review: + color = Colors.teal; + text = '复习'; + icon = Icons.refresh; + break; + } + + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon(icon, size: 12, color: color), + const SizedBox(width: 4), + Text( + text, + style: TextStyle( + fontSize: 12, + color: color, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ); + } + + Widget _buildWeeklyProgress(BuildContext context, StudyPlan plan, bool isMobile) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.calendar_view_week, + color: Colors.blue[700], + size: isMobile ? 24 : 28, + ), + const SizedBox(width: 8), + Text( + '本周进度', + style: TextStyle( + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + ], + ), + const SizedBox(height: 16), + Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: Padding( + padding: EdgeInsets.all(isMobile ? 16.0 : 20.0), + child: Column( + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceAround, + children: List.generate(7, (index) { + final date = DateTime.now().subtract(Duration(days: 6 - index)); + final dayName = ['一', '二', '三', '四', '五', '六', '日'][date.weekday - 1]; + final isToday = date.day == DateTime.now().day; + final hasTask = plan.tasks.any((task) => + task.dueDate.year == date.year && + task.dueDate.month == date.month && + task.dueDate.day == date.day); + final isCompleted = hasTask && plan.tasks + .where((task) => + task.dueDate.year == date.year && + task.dueDate.month == date.month && + task.dueDate.day == date.day) + .every((task) => task.isCompleted); + + return Column( + children: [ + Text( + dayName, + style: TextStyle( + fontSize: 12, + color: isToday ? Colors.blue : Colors.grey[600], + fontWeight: isToday ? FontWeight.bold : FontWeight.normal, + ), + ), + const SizedBox(height: 8), + Container( + width: 32, + height: 32, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: isCompleted + ? Colors.green + : hasTask + ? Colors.orange.withOpacity(0.3) + : Colors.grey.withOpacity(0.2), + border: isToday + ? Border.all(color: Colors.blue, width: 2) + : null, + ), + child: Center( + child: isCompleted + ? const Icon( + Icons.check, + color: Colors.white, + size: 16, + ) + : hasTask + ? Icon( + Icons.circle, + color: Colors.orange, + size: 8, + ) + : null, + ), + ), + const SizedBox(height: 4), + Text( + '${date.day}', + style: TextStyle( + fontSize: 10, + color: Colors.grey[500], + ), + ), + ], + ); + }), + ), + ], + ), + ), + ), + ], + ); + } + + Widget _buildQuickActions(BuildContext context, bool isMobile) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '快速操作', + style: TextStyle( + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + const SizedBox(height: 16), + GridView.count( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + crossAxisCount: isMobile ? 2 : 4, + mainAxisSpacing: 12, + crossAxisSpacing: 12, + childAspectRatio: isMobile ? 1.2 : 1.0, + children: [ + _buildQuickActionCard( + context, + '开始学习', + Icons.play_arrow, + Colors.green, + () => _startStudySession(), + isMobile, + ), + _buildQuickActionCard( + context, + '复习单词', + Icons.refresh, + Colors.blue, + () => _startReview(), + isMobile, + ), + _buildQuickActionCard( + context, + '查看统计', + Icons.analytics, + Colors.purple, + () => _showStatistics(), + isMobile, + ), + _buildQuickActionCard( + context, + '调整计划', + Icons.edit, + Colors.orange, + () => _editCurrentPlan(), + isMobile, + ), + ], + ), + ], + ); + } + + Widget _buildQuickActionCard( + BuildContext context, + String title, + IconData icon, + Color color, + VoidCallback onTap, + bool isMobile, + ) { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: EdgeInsets.all(isMobile ? 12.0 : 16.0), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Icon( + icon, + color: color, + size: isMobile ? 24 : 28, + ), + ), + const SizedBox(height: 8), + Text( + title, + style: TextStyle( + fontSize: isMobile ? 12 : 14, + fontWeight: FontWeight.w600, + color: Colors.grey[800], + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ), + ); + } + + Widget _buildPlanCard(BuildContext context, StudyPlan plan, bool isMobile) { + final progress = plan.completedTasks / plan.totalTasks; + final isActive = plan == _currentPlan; + + return Container( + margin: const EdgeInsets.only(bottom: 16), + child: Card( + elevation: isActive ? 4 : 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + side: isActive + ? BorderSide(color: Colors.blue, width: 2) + : BorderSide.none, + ), + child: InkWell( + onTap: () => _selectPlan(plan), + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: EdgeInsets.all(isMobile ? 16.0 : 20.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + padding: const EdgeInsets.all(8), + decoration: BoxDecoration( + color: _getPlanTypeColor(plan.type).withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Icon( + _getPlanTypeIcon(plan.type), + color: _getPlanTypeColor(plan.type), + size: isMobile ? 20 : 24, + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + plan.title, + style: TextStyle( + fontSize: isMobile ? 16 : 18, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + ), + if (isActive) + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: Colors.blue, + borderRadius: BorderRadius.circular(12), + ), + child: const Text( + '当前', + style: TextStyle( + color: Colors.white, + fontSize: 10, + fontWeight: FontWeight.w500, + ), + ), + ), + ], + ), + const SizedBox(height: 4), + Text( + plan.description, + style: TextStyle( + fontSize: isMobile ? 14 : 16, + color: Colors.grey[600], + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ], + ), + ), + PopupMenuButton( + icon: Icon( + Icons.more_vert, + color: Colors.grey[600], + ), + onSelected: (value) => _handlePlanAction(value, plan), + itemBuilder: (context) => [ + if (!isActive) + const PopupMenuItem( + value: 'activate', + child: Row( + children: [ + Icon(Icons.play_arrow, size: 18), + SizedBox(width: 8), + Text('设为当前'), + ], + ), + ), + const PopupMenuItem( + value: 'edit', + child: Row( + children: [ + Icon(Icons.edit, size: 18), + SizedBox(width: 8), + Text('编辑'), + ], + ), + ), + const PopupMenuItem( + value: 'duplicate', + child: Row( + children: [ + Icon(Icons.copy, size: 18), + SizedBox(width: 8), + Text('复制'), + ], + ), + ), + const PopupMenuItem( + value: 'delete', + child: Row( + children: [ + Icon(Icons.delete, size: 18, color: Colors.red), + SizedBox(width: 8), + Text('删除', style: TextStyle(color: Colors.red)), + ], + ), + ), + ], + ), + ], + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '进度', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 4), + LinearProgressIndicator( + value: progress, + backgroundColor: Colors.grey[300], + valueColor: AlwaysStoppedAnimation( + _getPlanTypeColor(plan.type), + ), + minHeight: 4, + ), + const SizedBox(height: 4), + Text( + '${(progress * 100).toInt()}% (${plan.completedTasks}/${plan.totalTasks})', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ), + const SizedBox(width: 16), + Column( + crossAxisAlignment: CrossAxisAlignment.end, + children: [ + Text( + '剩余', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + Text( + '${plan.endDate.difference(DateTime.now()).inDays}天', + style: TextStyle( + fontSize: isMobile ? 16 : 18, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + ], + ), + ], + ), + ], + ), + ), + ), + ), + ); + } + + Widget _buildOverallProgress(BuildContext context, bool isMobile) { + return Card( + elevation: 4, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + child: Container( + padding: EdgeInsets.all(isMobile ? 20.0 : 24.0), + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [Colors.purple.shade400, Colors.purple.shade600], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + borderRadius: BorderRadius.circular(16), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.trending_up, + color: Colors.white, + size: isMobile ? 28 : 32, + ), + const SizedBox(width: 12), + Expanded( + child: Text( + '学习统计', + style: TextStyle( + color: Colors.white, + fontSize: isMobile ? 20 : 24, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + const SizedBox(height: 20), + Row( + children: [ + Expanded( + child: _buildStatItem('连续学习', '7天', Icons.local_fire_department, isMobile), + ), + Expanded( + child: _buildStatItem('总学习时长', '45小时', Icons.access_time, isMobile), + ), + ], + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildStatItem('掌握单词', '328个', Icons.book, isMobile), + ), + Expanded( + child: _buildStatItem('完成任务', '156个', Icons.check_circle, isMobile), + ), + ], + ), + ], + ), + ), + ); + } + + Widget _buildStatItem(String label, String value, IconData icon, bool isMobile) { + return Column( + children: [ + Icon( + icon, + color: Colors.white.withOpacity(0.8), + size: isMobile ? 24 : 28, + ), + const SizedBox(height: 8), + Text( + value, + style: TextStyle( + color: Colors.white, + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + ), + ), + Text( + label, + style: TextStyle( + color: Colors.white.withOpacity(0.8), + fontSize: isMobile ? 12 : 14, + ), + ), + ], + ); + } + + Widget _buildWeeklyChart(BuildContext context, bool isMobile) { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: Padding( + padding: EdgeInsets.all(isMobile ? 16.0 : 20.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '本周学习时长', + style: TextStyle( + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + const SizedBox(height: 20), + SizedBox( + height: 200, + child: Center( + child: Text( + '图表组件开发中...', + style: TextStyle( + fontSize: isMobile ? 16 : 18, + color: Colors.grey[500], + ), + ), + ), + ), + ], + ), + ), + ); + } + + Widget _buildMonthlyStats(BuildContext context, bool isMobile) { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: Padding( + padding: EdgeInsets.all(isMobile ? 16.0 : 20.0), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '月度统计', + style: TextStyle( + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildMonthlyStatCard( + '学习天数', + '23/30', + Icons.calendar_today, + Colors.blue, + isMobile, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildMonthlyStatCard( + '平均时长', + '1.8小时', + Icons.access_time, + Colors.green, + isMobile, + ), + ), + ], + ), + const SizedBox(height: 12), + Row( + children: [ + Expanded( + child: _buildMonthlyStatCard( + '新学单词', + '156个', + Icons.add_circle, + Colors.orange, + isMobile, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildMonthlyStatCard( + '复习次数', + '89次', + Icons.refresh, + Colors.purple, + isMobile, + ), + ), + ], + ), + ], + ), + ), + ); + } + + Widget _buildMonthlyStatCard( + String label, + String value, + IconData icon, + Color color, + bool isMobile, + ) { + return Container( + padding: EdgeInsets.all(isMobile ? 12.0 : 16.0), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Column( + children: [ + Icon( + icon, + color: color, + size: isMobile ? 24 : 28, + ), + const SizedBox(height: 8), + Text( + value, + style: TextStyle( + fontSize: isMobile ? 16 : 18, + fontWeight: FontWeight.bold, + color: color, + ), + ), + Text( + label, + style: TextStyle( + fontSize: isMobile ? 12 : 14, + color: Colors.grey[600], + ), + ), + ], + ), + ); + } + + Widget _buildAchievements(BuildContext context, bool isMobile) { + final achievements = [ + Achievement( + title: '连续学习7天', + description: '坚持每天学习，养成良好习惯', + icon: Icons.local_fire_department, + color: Colors.red, + isUnlocked: true, + ), + Achievement( + title: '掌握100个单词', + description: '词汇量达到新的里程碑', + icon: Icons.book, + color: Colors.blue, + isUnlocked: true, + ), + Achievement( + title: '学习时长达到50小时', + description: '累计学习时间的重要节点', + icon: Icons.access_time, + color: Colors.green, + isUnlocked: false, + ), + Achievement( + title: '完成第一个学习计划', + description: '成功完成制定的学习目标', + icon: Icons.emoji_events, + color: Colors.orange, + isUnlocked: false, + ), + ]; + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '成就徽章', + style: TextStyle( + fontSize: isMobile ? 18 : 20, + fontWeight: FontWeight.bold, + color: Colors.grey[800], + ), + ), + const SizedBox(height: 16), + GridView.builder( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + gridDelegate: SliverGridDelegateWithFixedCrossAxisCount( + crossAxisCount: isMobile ? 2 : 4, + mainAxisSpacing: 12, + crossAxisSpacing: 12, + childAspectRatio: 1.0, + ), + itemCount: achievements.length, + itemBuilder: (context, index) { + final achievement = achievements[index]; + return _buildAchievementCard(context, achievement, isMobile); + }, + ), + ], + ); + } + + Widget _buildAchievementCard(BuildContext context, Achievement achievement, bool isMobile) { + return Card( + elevation: achievement.isUnlocked ? 4 : 1, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: Container( + padding: EdgeInsets.all(isMobile ? 12.0 : 16.0), + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(12), + color: achievement.isUnlocked + ? achievement.color.withOpacity(0.1) + : Colors.grey.withOpacity(0.05), + ), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + shape: BoxShape.circle, + color: achievement.isUnlocked + ? achievement.color + : Colors.grey.withOpacity(0.3), + ), + child: Icon( + achievement.icon, + color: achievement.isUnlocked ? Colors.white : Colors.grey, + size: isMobile ? 24 : 28, + ), + ), + const SizedBox(height: 8), + Text( + achievement.title, + style: TextStyle( + fontSize: isMobile ? 12 : 14, + fontWeight: FontWeight.bold, + color: achievement.isUnlocked + ? Colors.grey[800] + : Colors.grey[500], + ), + textAlign: TextAlign.center, + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 4), + Text( + achievement.description, + style: TextStyle( + fontSize: 10, + color: achievement.isUnlocked + ? Colors.grey[600] + : Colors.grey[400], + ), + textAlign: TextAlign.center, + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ], + ), + ), + ); + } + + Widget _buildNoPlanState(BuildContext context, bool isMobile) { + return Center( + child: Padding( + padding: EdgeInsets.all(isMobile ? 32.0 : 48.0), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.assignment, + size: isMobile ? 80 : 100, + color: Colors.grey[400], + ), + const SizedBox(height: 24), + Text( + '暂无学习计划', + style: TextStyle( + fontSize: isMobile ? 20 : 24, + fontWeight: FontWeight.bold, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 12), + Text( + '创建您的第一个学习计划，开始高效学习之旅', + style: TextStyle( + fontSize: isMobile ? 16 : 18, + color: Colors.grey[500], + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 32), + ElevatedButton.icon( + onPressed: _showCreatePlanDialog, + icon: const Icon(Icons.add), + label: const Text('创建计划'), + style: ElevatedButton.styleFrom( + backgroundColor: Colors.blue, + foregroundColor: Colors.white, + padding: EdgeInsets.symmetric( + horizontal: isMobile ? 24 : 32, + vertical: isMobile ? 12 : 16, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(25), + ), + ), + ), + ], + ), + ), + ); + } + + Widget _buildEmptyPlansState(BuildContext context, bool isMobile) { + return Center( + child: Padding( + padding: EdgeInsets.all(isMobile ? 32.0 : 48.0), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.list_alt, + size: isMobile ? 80 : 100, + color: Colors.grey[400], + ), + const SizedBox(height: 24), + Text( + '暂无学习计划', + style: TextStyle( + fontSize: isMobile ? 20 : 24, + fontWeight: FontWeight.bold, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 12), + Text( + '创建学习计划，制定个性化的学习目标', + style: TextStyle( + fontSize: isMobile ? 16 : 18, + color: Colors.grey[500], + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 32), + Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + ElevatedButton.icon( + onPressed: _showCreatePlanDialog, + icon: const Icon(Icons.add), + label: const Text('创建计划'), + style: ElevatedButton.styleFrom( + backgroundColor: Colors.blue, + foregroundColor: Colors.white, + padding: EdgeInsets.symmetric( + horizontal: isMobile ? 20 : 24, + vertical: isMobile ? 12 : 16, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(25), + ), + ), + ), + const SizedBox(width: 16), + OutlinedButton.icon( + onPressed: _showPlanTemplates, + icon: const Icon(Icons.library_books), + label: const Text('使用模板'), + style: OutlinedButton.styleFrom( + padding: EdgeInsets.symmetric( + horizontal: isMobile ? 20 : 24, + vertical: isMobile ? 12 : 16, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(25), + ), + ), + ), + ], + ), + ], + ), + ), + ); + } + + Future _loadStudyPlans() async { + setState(() { + _isLoading = true; + }); + + // 模拟加载数据 + await Future.delayed(const Duration(milliseconds: 800)); + + setState(() { + _studyPlans = _generateMockPlans(); + _currentPlan = _studyPlans.isNotEmpty ? _studyPlans.first : null; + _isLoading = false; + }); + } + + List _generateMockPlans() { + final now = DateTime.now(); + return [ + StudyPlan( + id: '1', + title: '30天词汇突破计划', + description: '每天学习20个新单词，复习已学单词', + type: PlanType.vocabulary, + startDate: now.subtract(const Duration(days: 7)), + endDate: now.add(const Duration(days: 23)), + tasks: _generateMockTasks(), + totalTasks: 30, + completedTasks: 7, + isActive: true, + ), + StudyPlan( + id: '2', + title: '雅思备考计划', + description: '全面提升听说读写能力，目标7分', + type: PlanType.exam, + startDate: now.add(const Duration(days: 1)), + endDate: now.add(const Duration(days: 90)), + tasks: [], + totalTasks: 90, + completedTasks: 0, + isActive: false, + ), + ]; + } + + List _generateMockTasks() { + final now = DateTime.now(); + return [ + StudyTask( + id: '1', + title: '学习商务词汇', + description: '学习20个商务相关单词', + type: TaskType.vocabulary, + dueDate: now, + estimatedMinutes: 30, + isCompleted: false, + ), + StudyTask( + id: '2', + title: '复习昨日单词', + description: '复习昨天学习的单词', + type: TaskType.review, + dueDate: now, + estimatedMinutes: 15, + isCompleted: true, + ), + ]; + } + + void _showCreatePlanDialog() { + showDialog( + context: context, + builder: (context) { + return AlertDialog( + title: const Text('创建学习计划'), + content: const Text('计划创建功能开发中...'), + actions: [ + TextButton( + onPressed: () { + Navigator.of(context).pop(); + }, + child: const Text('关闭'), + ), + ], + ); + }, + ); + } + + void _showPlanTemplates() { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('计划模板功能开发中')), + ); + } + + void _handleMenuAction(String action) { + switch (action) { + case 'templates': + _showPlanTemplates(); + break; + case 'statistics': + _showStatistics(); + break; + case 'settings': + _showSettings(); + break; + } + } + + void _handlePlanAction(String action, StudyPlan plan) { + switch (action) { + case 'activate': + _selectPlan(plan); + break; + case 'edit': + _editPlan(plan); + break; + case 'duplicate': + _duplicatePlan(plan); + break; + case 'delete': + _deletePlan(plan); + break; + } + } + + void _selectPlan(StudyPlan plan) { + setState(() { + _currentPlan = plan; + }); + ScaffoldMessenger.of(context).showSnackBar( + SnackBar(content: Text('已切换到计划：${plan.title}')), + ); + } + + void _editPlan(StudyPlan plan) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('编辑计划功能开发中')), + ); + } + + void _duplicatePlan(StudyPlan plan) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('复制计划功能开发中')), + ); + } + + void _deletePlan(StudyPlan plan) { + showDialog( + context: context, + builder: (context) { + return AlertDialog( + title: const Text('确认删除'), + content: Text('确定要删除计划 "${plan.title}" 吗？'), + actions: [ + TextButton( + onPressed: () { + Navigator.of(context).pop(); + }, + child: const Text('取消'), + ), + TextButton( + onPressed: () { + Navigator.of(context).pop(); + setState(() { + _studyPlans.removeWhere((p) => p.id == plan.id); + if (_currentPlan?.id == plan.id) { + _currentPlan = _studyPlans.isNotEmpty ? _studyPlans.first : null; + } + }); + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('计划已删除')), + ); + }, + child: const Text('删除', style: TextStyle(color: Colors.red)), + ), + ], + ); + }, + ); + } + + void _toggleTaskCompletion(StudyTask task) { + setState(() { + task.isCompleted = !task.isCompleted; + if (_currentPlan != null) { + if (task.isCompleted) { + _currentPlan!.completedTasks++; + } else { + _currentPlan!.completedTasks--; + } + } + }); + } + + void _startTask(StudyTask task) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar(content: Text('开始任务：${task.title}')), + ); + } + + void _startStudySession() { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('开始学习会话')), + ); + } + + void _startReview() { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('开始复习')), + ); + } + + void _showStatistics() { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('统计功能开发中')), + ); + } + + void _showSettings() { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('设置功能开发中')), + ); + } + + void _editCurrentPlan() { + if (_currentPlan != null) { + _editPlan(_currentPlan!); + } + } + + IconData _getPlanTypeIcon(PlanType type) { + switch (type) { + case PlanType.vocabulary: + return Icons.book; + case PlanType.grammar: + return Icons.school; + case PlanType.speaking: + return Icons.mic; + case PlanType.listening: + return Icons.headphones; + case PlanType.reading: + return Icons.article; + case PlanType.writing: + return Icons.edit; + case PlanType.exam: + return Icons.quiz; + case PlanType.custom: + return Icons.settings; + } + } + + Color _getPlanTypeColor(PlanType type) { + switch (type) { + case PlanType.vocabulary: + return Colors.blue; + case PlanType.grammar: + return Colors.green; + case PlanType.speaking: + return Colors.orange; + case PlanType.listening: + return Colors.purple; + case PlanType.reading: + return Colors.teal; + case PlanType.writing: + return Colors.red; + case PlanType.exam: + return Colors.indigo; + case PlanType.custom: + return Colors.grey; + } + } +} + +enum PlanType { + vocabulary, + grammar, + speaking, + listening, + reading, + writing, + exam, + custom, +} + +enum TaskType { + vocabulary, + reading, + listening, + speaking, + writing, + review, +} + +class StudyPlan { + final String id; + final String title; + final String description; + final PlanType type; + final DateTime startDate; + final DateTime endDate; + final List tasks; + final int totalTasks; + int completedTasks; + final bool isActive; + + StudyPlan({ + required this.id, + required this.title, + required this.description, + required this.type, + required this.startDate, + required this.endDate, + required this.tasks, + required this.totalTasks, + required this.completedTasks, + required this.isActive, + }); +} + +class StudyTask { + final String id; + final String title; + final String description; + final TaskType type; + final DateTime dueDate; + final int estimatedMinutes; + bool isCompleted; + + StudyTask({ + required this.id, + required this.title, + required this.description, + required this.type, + required this.dueDate, + required this.estimatedMinutes, + required this.isCompleted, + }); +} + +class Achievement { + final String title; + final String description; + final IconData icon; + final Color color; + final bool isUnlocked; + + const Achievement({ + required this.title, + required this.description, + required this.icon, + required this.color, + required this.isUnlocked, + }); +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/screens/study_screen.dart b/client/lib/features/vocabulary/screens/study_screen.dart new file mode 100644 index 0000000..dbff63c --- /dev/null +++ b/client/lib/features/vocabulary/screens/study_screen.dart @@ -0,0 +1,299 @@ +import 'package:flutter/material.dart'; +import 'package:ai_english_learning/core/network/api_client.dart'; +import 'package:ai_english_learning/core/services/storage_service.dart'; +import 'package:ai_english_learning/features/vocabulary/models/vocabulary_book_model.dart'; +import 'package:ai_english_learning/features/vocabulary/models/word_model.dart'; +import 'package:ai_english_learning/features/vocabulary/models/learning_session_model.dart'; +import 'package:ai_english_learning/features/vocabulary/services/learning_service.dart'; +import 'package:ai_english_learning/features/vocabulary/services/vocabulary_service.dart'; +import 'package:ai_english_learning/features/vocabulary/widgets/study_card_widget.dart'; + +class StudyScreen extends StatefulWidget { + final VocabularyBook vocabularyBook; + final int dailyGoal; + + const StudyScreen({ + Key? key, + required this.vocabularyBook, + this.dailyGoal = 20, + }) : super(key: key); + + @override + State createState() => _StudyScreenState(); +} + +class _StudyScreenState extends State { + late LearningService _learningService; + late VocabularyService _vocabularyService; + + bool _isLoading = true; + String? _error; + + LearningSession? _session; + DailyLearningTasks? _tasks; + List _wordsList = []; + int _currentIndex = 0; + + int _studiedCount = 0; + DateTime? _studyStartTime; + + @override + void initState() { + super.initState(); + _init(); + } + + Future _init() async { + final storageService = await StorageService.getInstance(); + _learningService = LearningService(apiClient: ApiClient.instance); + _vocabularyService = VocabularyService( + apiClient: ApiClient.instance, + storageService: storageService, + ); + + await _startLearning(); + } + + Future _startLearning() async { + setState(() { + _isLoading = true; + _error = null; + }); + + try { + // 1. 开始学习会话 + final result = await _learningService.startLearning( + widget.vocabularyBook.id, + widget.dailyGoal, + ); + + _session = result['session'] as LearningSession; + _tasks = result['tasks'] as DailyLearningTasks; + + print('✅ 学习会话创建成功'); + print('📝 新单词数量: ${_tasks!.newWords.length}'); + print('🔄 复习单词数量: ${_tasks!.reviewWords.length}'); + + // 2. 加载单词详情 - 从词汇书API获取 + if (_tasks!.newWords.isEmpty && _tasks!.reviewWords.isEmpty) { + setState(() { + _isLoading = false; + _wordsList = []; + }); + return; + } + + // 合并新单词和复习单词的ID（学习逻辑：新词 + 所有到期复习词） + final allWordIds = { + ..._tasks!.newWords, + ..._tasks!.reviewWords.map((r) => r['vocabulary_id'] as int), + }; + + final totalWords = allWordIds.length; + print('📚 今日学习任务: ${_tasks!.newWords.length}个新词 + ${_tasks!.reviewWords.length}个复习词 = $totalWords个单词'); + + // 使用词汇书的单词加载API - 动态设置limit以包含所有需要的单词 + final limit = (totalWords / 50).ceil() * 50; // 向上取整到50的倍数 + final bookWords = await _vocabularyService.getVocabularyBookWords( + widget.vocabularyBook.id, + page: 1, + limit: limit < 100 ? 100 : limit, + ); + + // 筛选出需要学习的单词（新词 + 复习词） + final words = []; + + for (final bookWord in bookWords) { + if (bookWord.word == null) continue; + + final wordId = int.tryParse(bookWord.word!.id); + if (wordId != null && allWordIds.contains(wordId)) { + words.add(bookWord.word!); + } + if (words.length >= totalWords) break; + } + + print('✅ 加载了 ${words.length} 个单词，需要 $totalWords 个'); + + setState(() { + _wordsList = words; + _isLoading = false; + _studyStartTime = DateTime.now(); + }); + + } catch (e, stackTrace) { + print('❌ 开始学习失败: $e'); + print('Stack trace: $stackTrace'); + setState(() { + _error = '加载学习内容失败，请稍后重试\n错误：$e'; + _isLoading = false; + }); + } + } + + Future _handleAnswer(StudyDifficulty difficulty) async { + if (_currentIndex >= _wordsList.length) return; + + final word = _wordsList[_currentIndex]; + final studyTime = _studyStartTime != null + ? DateTime.now().difference(_studyStartTime!).inMilliseconds + : 0; + + try { + // 提交学习结果 + await _learningService.submitWordStudy( + word.id, + difficulty, + sessionId: int.tryParse(_session?.id ?? '0'), + ); + + setState(() { + _studiedCount++; + _currentIndex++; + _studyStartTime = DateTime.now(); + }); + + // 检查是否完成 + if (_currentIndex >= _wordsList.length) { + _showCompletionDialog(); + } + + } catch (e) { + print('提交学习结果失败: $e'); + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('提交失败，请重试')), + ); + } + } + + void _showCompletionDialog() { + showDialog( + context: context, + barrierDismissible: false, + builder: (context) => AlertDialog( + title: const Text('🎉 今日学习完成！'), + content: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text('学习单词数：$_studiedCount'), + Text('新学单词：${_tasks?.newWords.length ?? 0}'), + Text('复习单词：${_tasks?.reviewWords.length ?? 0}'), + ], + ), + actions: [ + TextButton( + onPressed: () { + Navigator.of(context).pop(); + Navigator.of(context).pop(true); // 返回到上一页 + }, + child: const Text('完成'), + ), + ], + ), + ); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: Text(widget.vocabularyBook.name), + actions: [ + // 进度显示 + Center( + child: Padding( + padding: const EdgeInsets.only(right: 16), + child: Text( + '$_studiedCount / ${_wordsList.length}', + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ), + ), + ], + ), + body: _buildBody(), + ); + } + + Widget _buildBody() { + if (_isLoading) { + return const Center(child: CircularProgressIndicator()); + } + + if (_error != null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon(Icons.error_outline, size: 64, color: Colors.grey[400]), + const SizedBox(height: 16), + Text( + _error!, + style: TextStyle(fontSize: 16, color: Colors.grey[600]), + ), + const SizedBox(height: 16), + ElevatedButton( + onPressed: _startLearning, + child: const Text('重试'), + ), + ], + ), + ); + } + + if (_wordsList.isEmpty) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon(Icons.check_circle, size: 64, color: Colors.green[400]), + const SizedBox(height: 16), + const Text( + '今日任务已完成！', + style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold), + ), + const SizedBox(height: 8), + Text( + '明天继续加油！', + style: TextStyle(fontSize: 16, color: Colors.grey[600]), + ), + const SizedBox(height: 24), + ElevatedButton( + onPressed: () => Navigator.of(context).pop(), + child: const Text('返回'), + ), + ], + ), + ); + } + + if (_currentIndex >= _wordsList.length) { + return const Center(child: CircularProgressIndicator()); + } + + return Column( + children: [ + // 进度条 + LinearProgressIndicator( + value: _currentIndex / _wordsList.length, + backgroundColor: Colors.grey[200], + ), + + // 学习卡片 + Expanded( + child: Padding( + padding: const EdgeInsets.all(16), + child: StudyCardWidget( + word: _wordsList[_currentIndex], + onAnswer: _handleAnswer, + ), + ), + ), + ], + ); + } +} diff --git a/client/lib/features/vocabulary/screens/vocabulary_book_screen.dart b/client/lib/features/vocabulary/screens/vocabulary_book_screen.dart new file mode 100644 index 0000000..0cbd48f --- /dev/null +++ b/client/lib/features/vocabulary/screens/vocabulary_book_screen.dart @@ -0,0 +1,1328 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/vocabulary_book_model.dart'; +import '../models/word_model.dart'; +import '../providers/vocabulary_provider.dart'; +import '../services/vocabulary_service.dart'; +import '../../../core/network/api_client.dart'; +import '../../../core/services/storage_service.dart'; +import '../../../shared/widgets/custom_app_bar.dart'; +import '../../../shared/widgets/custom_card.dart'; +import '../../../shared/widgets/loading_widget.dart'; +import '../../../shared/widgets/error_widget.dart' as custom_error; +import 'word_learning_screen.dart'; +import 'study_screen.dart'; + +/// 词汇书详情页面 +class VocabularyBookScreen extends ConsumerStatefulWidget { + final VocabularyBook vocabularyBook; + + const VocabularyBookScreen({ + super.key, + required this.vocabularyBook, + }); + + @override + ConsumerState createState() => _VocabularyBookScreenState(); +} + +class _VocabularyBookScreenState extends ConsumerState + with SingleTickerProviderStateMixin { + late TabController _tabController; + ScrollController? _scrollController; + + List _words = []; + List _filteredWords = []; // 过滤后的单词列表 + bool _isLoading = false; + bool _isLoadingMore = false; // 是否正在加载更多 + String? _error; + UserVocabularyBookProgress? _progress; + bool _isLoadingProgress = false; + + // 搜索相关 + bool _isSearching = false; + final TextEditingController _searchController = TextEditingController(); + String _searchQuery = ''; + + // 分页相关 + int _currentPage = 1; + final int _pageSize = 50; // 每频50个单词 + bool _hasMore = true; // 是否还有更多数据 + + @override + void initState() { + super.initState(); + _tabController = TabController(length: 2, vsync: this); + _scrollController = ScrollController(); + _scrollController?.addListener(_onScroll); + _loadVocabularyBookWords(); // 加载第一页 + _loadProgress(); + + // 监听搜索输入变化 + _searchController.addListener(_onSearchChanged); + } + + /// 监听滚动，实现懒加载 + void _onScroll() { + if (_scrollController == null) return; + // 如果滚动到底部80%的位置，且不在加载中，且还有更多数据 + if (_scrollController!.position.pixels >= _scrollController!.position.maxScrollExtent * 0.8 && + !_isLoadingMore && + _hasMore && + _tabController.index == 0) { // 只在单词列表标签触发 + _loadMoreWords(); + } + } + + /// 加载更多单词 + Future _loadMoreWords() async { + if (_isLoadingMore || !_hasMore) return; + + setState(() { + _isLoadingMore = true; + }); + + try { + _currentPage++; + final vocabularyService = VocabularyService( + apiClient: ApiClient.instance, + storageService: await StorageService.getInstance(), + ); + + final bookWords = await vocabularyService.getVocabularyBookWords( + widget.vocabularyBook.id, + page: _currentPage, + limit: _pageSize, + ); + + final newWords = bookWords + .where((bw) => bw.word != null) + .map((bw) => bw.word!) + .toList(); + + setState(() { + _words.addAll(newWords); + _filteredWords = _searchQuery.isEmpty ? _words : _filterWords(_searchQuery); + _isLoadingMore = false; + // 如果返回的数据少于pageSize，说明没有更多数据了 + _hasMore = newWords.length >= _pageSize; + }); + } catch (e) { + print('加载更多单词失败: $e'); + setState(() { + _isLoadingMore = false; + _currentPage--; // 回退页码 + }); + } + } + + /// 搜索输入变化监听 + void _onSearchChanged() { + setState(() { + _searchQuery = _searchController.text; + _filteredWords = _searchQuery.isEmpty ? _words : _filterWords(_searchQuery); + }); + } + + /// 过滤单词 + List _filterWords(String query) { + final lowerQuery = query.toLowerCase(); + return _words.where((word) { + // 搜索单词、音标、释义 + final wordMatch = word.word.toLowerCase().contains(lowerQuery); + final phoneticMatch = word.phonetic?.toLowerCase().contains(lowerQuery) ?? false; + final definitionMatch = word.definitions.any( + (def) => def.translation.toLowerCase().contains(lowerQuery), + ); + return wordMatch || phoneticMatch || definitionMatch; + }).toList(); + } + + /// 切换搜索状态 + void _toggleSearch() { + setState(() { + _isSearching = !_isSearching; + if (!_isSearching) { + _searchController.clear(); + _searchQuery = ''; + _filteredWords = _words; + } + }); + } + + @override + void dispose() { + _scrollController?.removeListener(_onScroll); + _scrollController?.dispose(); + _tabController.dispose(); + _searchController.dispose(); + super.dispose(); + } + + /// 从后端API加载词汇书单词（第一页） + Future _loadVocabularyBookWords() async { + setState(() { + _isLoading = true; + _error = null; + _currentPage = 1; + _hasMore = true; + }); + + try { + final vocabularyService = VocabularyService( + apiClient: ApiClient.instance, + storageService: await StorageService.getInstance(), + ); + + final bookWords = await vocabularyService.getVocabularyBookWords( + widget.vocabularyBook.id, + page: 1, + limit: _pageSize, + ); + + // 提取单词对象 + final words = bookWords + .where((bw) => bw.word != null) + .map((bw) => bw.word!) + .toList(); + + setState(() { + _words = words; + _filteredWords = words; // 初始化过滤列表 + _isLoading = false; + }); + } catch (e) { + print('加载词汇书单词失败: $e'); + setState(() { + _error = '加载失败，请稍后重试'; + _isLoading = false; + // API失败时显示空状态，不使用模拟数据 + _words = []; + }); + } + } + + /// 加载学习进度 + Future _loadProgress({bool forceRefresh = false}) async { + setState(() { + _isLoadingProgress = true; + }); + + try { + final vocabularyService = VocabularyService( + apiClient: ApiClient.instance, + storageService: await StorageService.getInstance(), + ); + + final progress = await vocabularyService.getVocabularyBookProgress( + widget.vocabularyBook.id, + forceRefresh: forceRefresh, // 传递强制刷新参数 + ); + + setState(() { + _progress = progress; + _isLoadingProgress = false; + }); + } catch (e) { + print('加载学习进度失败: $e'); + setState(() { + _isLoadingProgress = false; + // 使用默认进度 + _progress = UserVocabularyBookProgress( + id: '0', + userId: '0', + vocabularyBookId: widget.vocabularyBook.id, + learnedWords: 0, + masteredWords: 0, + progressPercentage: 0.0, + streakDays: 0, + totalStudyDays: 0, + averageDailyWords: 0.0, + startedAt: DateTime.now(), + lastStudiedAt: null, + ); + }); + } + } + + void _handleMenuAction(String action) { + switch (action) { + case 'start_learning': + _startLearning(context); + break; + case 'vocabulary_test': + _startVocabularyTest(); + break; + case 'smart_review': + _startSmartReview(); + break; + case 'export': + _exportWords(); + break; + } + } + + void _startLearning(BuildContext context) async { + // 显示学习目标选择对话框 + double selectedGoal = 20.0; + + final dailyGoal = await showDialog( + context: context, + builder: (context) => StatefulBuilder( + builder: (context, setState) { + return AlertDialog( + title: const Text('设置学习目标'), + content: Column( + mainAxisSize: MainAxisSize.min, + children: [ + const Text('请选择每日学习单词数：'), + const SizedBox(height: 8), + Text( + '${selectedGoal.toInt()}个单词', + style: const TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + color: Colors.blue, + ), + ), + const SizedBox(height: 16), + Slider( + value: selectedGoal, + min: 5, + max: 50, + divisions: 9, + label: '${selectedGoal.toInt()}个单词', + onChanged: (value) { + setState(() { + selectedGoal = value; + }); + }, + ), + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text('5', style: TextStyle(color: Colors.grey[600])), + Text('50', style: TextStyle(color: Colors.grey[600])), + ], + ), + ], + ), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(), + child: const Text('取消'), + ), + ElevatedButton( + onPressed: () => Navigator.of(context).pop(selectedGoal.toInt()), + child: const Text('开始学习'), + ), + ], + ); + }, + ), + ); + + if (dailyGoal == null) return; + + // 导航到学习页面 + final result = await Navigator.of(context).push( + MaterialPageRoute( + builder: (context) => StudyScreen( + vocabularyBook: widget.vocabularyBook, + dailyGoal: dailyGoal, + ), + ), + ); + + // 学习完成后强制刷新进度（跳过缓存） + if (result == true) { + _loadProgress(forceRefresh: true); + } + } + + void _startVocabularyTest() { + Navigator.of(context).pushNamed( + '/vocabulary_test', + arguments: { + 'vocabularyBook': widget.vocabularyBook, + 'testType': 'bookTest', + 'questionCount': 20, + }, + ); + } + + void _startSmartReview() { + final reviewWords = _words.where((word) { + // 这里可以根据学习进度和遗忘曲线来筛选需要复习的单词 + // 暂时返回所有单词 + return true; + }).toList(); + + if (reviewWords.isEmpty) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('暂无需要复习的单词')), + ); + return; + } + + Navigator.of(context).pushNamed( + '/smart_review', + arguments: { + 'vocabularyBook': widget.vocabularyBook, + 'words': reviewWords, + 'reviewMode': 'adaptive', + }, + ); + } + + void _exportWords() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('导出单词'), + content: Column( + mainAxisSize: MainAxisSize.min, + children: [ + ListTile( + leading: const Icon(Icons.text_snippet), + title: const Text('导出为文本文件'), + onTap: () { + Navigator.of(context).pop(); + _exportAsText(); + }, + ), + ListTile( + leading: const Icon(Icons.table_chart), + title: const Text('导出为Excel文件'), + onTap: () { + Navigator.of(context).pop(); + _exportAsExcel(); + }, + ), + ListTile( + leading: const Icon(Icons.picture_as_pdf), + title: const Text('导出为PDF文件'), + onTap: () { + Navigator.of(context).pop(); + _exportAsPDF(); + }, + ), + ], + ), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(), + child: const Text('取消'), + ), + ], + ), + ); + } + + void _exportAsText() { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('正在导出为文本文件...')), + ); + // TODO: 实现文本导出功能 + } + + void _exportAsExcel() { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('正在导出为Excel文件...')), + ); + // TODO: 实现Excel导出功能 + } + + void _exportAsPDF() { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('正在导出为PDF文件...')), + ); + // TODO: 实现PDF导出功能 + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: TabAppBar( + title: widget.vocabularyBook.name, + controller: _tabController, + tabs: const [ + Tab(text: '单词列表'), + Tab(text: '学习进度'), + ], + actions: [ + IconButton( + icon: Icon(_isSearching ? Icons.close : Icons.search), + onPressed: _toggleSearch, + ), + PopupMenuButton( + onSelected: _handleMenuAction, + itemBuilder: (context) => [ + const PopupMenuItem( + value: 'start_learning', + child: Row( + children: [ + Icon(Icons.school), + SizedBox(width: 8), + Text('开始学习'), + ], + ), + ), + const PopupMenuItem( + value: 'vocabulary_test', + child: Row( + children: [ + Icon(Icons.quiz), + SizedBox(width: 8), + Text('词汇测试'), + ], + ), + ), + const PopupMenuItem( + value: 'smart_review', + child: Row( + children: [ + Icon(Icons.psychology), + SizedBox(width: 8), + Text('智能复习'), + ], + ), + ), + const PopupMenuItem( + value: 'export', + child: Row( + children: [ + Icon(Icons.download), + SizedBox(width: 8), + Text('导出单词'), + ], + ), + ), + ], + ), + ], + ), + body: Column( + children: [ + // 搜索框 + if (_isSearching) + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: TextField( + controller: _searchController, + autofocus: true, + decoration: InputDecoration( + hintText: '搜索单词、音标或释义...', + prefixIcon: const Icon(Icons.search), + suffixIcon: _searchQuery.isNotEmpty + ? IconButton( + icon: const Icon(Icons.clear), + onPressed: () { + _searchController.clear(); + }, + ) + : null, + border: OutlineInputBorder( + borderRadius: BorderRadius.circular(12), + borderSide: BorderSide(color: Colors.grey[300]!), + ), + focusedBorder: OutlineInputBorder( + borderRadius: BorderRadius.circular(12), + borderSide: BorderSide( + color: Theme.of(context).primaryColor, + width: 2, + ), + ), + filled: true, + fillColor: Colors.grey[50], + ), + ), + ), + // TabBarView + Expanded( + child: TabBarView( + controller: _tabController, + children: [ + _buildWordListTab(), + _buildProgressTab(), + ], + ), + ), + ], + ), + floatingActionButton: _buildFloatingActionButton(), + ); + } + + Widget _buildFloatingActionButton() { + return Column( + mainAxisSize: MainAxisSize.min, + children: [ + FloatingActionButton.extended( + onPressed: () => _startLearning(context), + icon: const Icon(Icons.school), + label: const Text('开始学习'), + heroTag: 'start_learning', + ), + const SizedBox(height: 8), + FloatingActionButton( + onPressed: () => _startVocabularyTest(), + child: const Icon(Icons.quiz), + heroTag: 'vocabulary_test', + ), + ], + ); + } + + Widget _buildWordListTab() { + if (_isLoading) { + return const Center(child: LoadingWidget()); + } + + if (_error != null) { + return Center( + child: custom_error.PageErrorWidget( + message: _error!, + onRetry: _loadVocabularyBookWords, + ), + ); + } + + if (_words.isEmpty) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.book_outlined, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '暂无单词', + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + Text( + '该词汇书还没有单词', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + ), + ], + ), + ); + } + + return RefreshIndicator( + onRefresh: _loadVocabularyBookWords, + child: ListView.builder( + controller: _scrollController, // 可以为null，ListView会自动处理 + padding: const EdgeInsets.all(16), + itemCount: _filteredWords.length + (_hasMore && _searchQuery.isEmpty ? 1 : 0), // 搜索时不显示加载更多 + itemBuilder: (context, index) { + // 搜索结果提示 + if (_searchQuery.isNotEmpty && index == 0 && _filteredWords.isEmpty) { + return _buildNoResultsWidget(); + } + + // 如果是最后一项且还有更多数据，显示加载指示器 + if (index == _filteredWords.length && _searchQuery.isEmpty) { + return _buildLoadingIndicator(); + } + + final word = _filteredWords[index]; + return _buildWordCard(word, index); + }, + ), + ); + } + + /// 构建无搜索结果提示 + Widget _buildNoResultsWidget() { + return Center( + child: Padding( + padding: const EdgeInsets.all(48), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.search_off, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '未找到相关单词', + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + Text( + '请尝试使用其他关键词搜索', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + ), + ], + ), + ), + ); + } + + /// 构建加载更多指示器 + Widget _buildLoadingIndicator() { + return Padding( + padding: const EdgeInsets.all(16), + child: Center( + child: Column( + children: [ + const CircularProgressIndicator(), + const SizedBox(height: 8), + Text( + '正在加载更多...', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ), + ); + } + + Widget _buildWordCard(Word word, int index) { + return CustomCard( + margin: const EdgeInsets.only(bottom: 12), + child: InkWell( + onTap: () => _showWordDetail(word), + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + width: 32, + height: 32, + decoration: BoxDecoration( + color: Theme.of(context).primaryColor.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Center( + child: Text( + '${index + 1}', + style: TextStyle( + color: Theme.of(context).primaryColor, + fontWeight: FontWeight.bold, + ), + ), + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Text( + word.word, + style: const TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + if (word.phonetic != null) ...[ + const SizedBox(width: 8), + Text( + word.phonetic!, + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ], + ), + if (word.definitions.isNotEmpty) ...[ + const SizedBox(height: 4), + Text( + word.definitions.first.translation, + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ], + ], + ), + ), + IconButton( + icon: const Icon(Icons.volume_up), + onPressed: () => _playWordPronunciation(word), + ), + ], + ), + if (word.examples.isNotEmpty) ...[ + const SizedBox(height: 12), + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(8), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + word.examples.first.sentence, + style: const TextStyle( + fontSize: 13, + fontStyle: FontStyle.italic, + ), + ), + const SizedBox(height: 4), + Text( + word.examples.first.translation, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ), + ], + ], + ), + ), + ), + ); + } + + void _showWordDetail(Word word) { + showModalBottomSheet( + context: context, + isScrollControlled: true, + backgroundColor: Colors.transparent, + builder: (context) => DraggableScrollableSheet( + initialChildSize: 0.7, + minChildSize: 0.5, + maxChildSize: 0.95, + builder: (context, scrollController) => Container( + decoration: const BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.vertical(top: Radius.circular(20)), + ), + child: Column( + children: [ + Container( + margin: const EdgeInsets.symmetric(vertical: 12), + width: 40, + height: 4, + decoration: BoxDecoration( + color: Colors.grey[300], + borderRadius: BorderRadius.circular(2), + ), + ), + Expanded( + child: ListView( + controller: scrollController, + padding: const EdgeInsets.all(24), + children: [ + Row( + children: [ + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + word.word, + style: const TextStyle( + fontSize: 28, + fontWeight: FontWeight.bold, + ), + ), + if (word.phonetic != null) ...[ + const SizedBox(height: 4), + Text( + word.phonetic!, + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + ), + ), + ], + ], + ), + ), + IconButton( + icon: const Icon(Icons.volume_up, size: 32), + onPressed: () => _playWordPronunciation(word), + ), + ], + ), + const SizedBox(height: 24), + const Text( + '释义', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + ...word.definitions.map((def) => Padding( + padding: const EdgeInsets.only(bottom: 12), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: Theme.of(context).primaryColor.withOpacity(0.1), + borderRadius: BorderRadius.circular(4), + ), + child: Text( + _getWordTypeText(def.type), + style: TextStyle( + fontSize: 12, + color: Theme.of(context).primaryColor, + fontWeight: FontWeight.bold, + ), + ), + ), + const SizedBox(width: 12), + Expanded( + child: Text( + def.translation, + style: const TextStyle(fontSize: 16), + ), + ), + ], + ), + )), + if (word.examples.isNotEmpty) ...[ + const SizedBox(height: 24), + const Text( + '例句', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + ...word.examples.map((example) => Container( + margin: const EdgeInsets.only(bottom: 16), + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(12), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + example.sentence, + style: const TextStyle( + fontSize: 15, + fontStyle: FontStyle.italic, + ), + ), + const SizedBox(height: 8), + Text( + example.translation, + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + ), + ], + ), + )), + ], + if (word.synonyms.isNotEmpty) ...[ + const SizedBox(height: 24), + const Text( + '同义词', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + Wrap( + spacing: 8, + runSpacing: 8, + children: word.synonyms.map((synonym) => Chip( + label: Text(synonym), + backgroundColor: Colors.blue[50], + )).toList(), + ), + ], + if (word.antonyms.isNotEmpty) ...[ + const SizedBox(height: 24), + const Text( + '反义词', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + Wrap( + spacing: 8, + runSpacing: 8, + children: word.antonyms.map((antonym) => Chip( + label: Text(antonym), + backgroundColor: Colors.orange[50], + )).toList(), + ), + ], + ], + ), + ), + ], + ), + ), + ), + ); + } + + String _getWordTypeText(WordType type) { + switch (type) { + case WordType.noun: + return 'n.'; + case WordType.verb: + return 'v.'; + case WordType.adjective: + return 'adj.'; + case WordType.adverb: + return 'adv.'; + case WordType.pronoun: + return 'pron.'; + case WordType.preposition: + return 'prep.'; + case WordType.conjunction: + return 'conj.'; + case WordType.interjection: + return 'interj.'; + case WordType.article: + return 'art.'; + case WordType.phrase: + return 'phrase'; + } + } + + void _playWordPronunciation(Word word) { + // TODO: 实现音频播放功能 + ScaffoldMessenger.of(context).showSnackBar( + SnackBar(content: Text('播放 ${word.word} 的发音')), + ); + } + + Widget _buildProgressTab() { + if (_isLoadingProgress) { + return const Center(child: LoadingWidget()); + } + + if (_progress == null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon(Icons.trending_up, size: 64, color: Colors.grey[400]), + const SizedBox(height: 16), + Text( + '暂无学习进度', + style: TextStyle(fontSize: 16, color: Colors.grey[600]), + ), + ], + ), + ); + } + + return RefreshIndicator( + onRefresh: () => _loadProgress(forceRefresh: true), // 下拉刷新强制跳过缓存 + child: ListView( + padding: const EdgeInsets.all(16), + children: [ + // 整体进度卡片 + CustomCard( + child: Padding( + padding: const EdgeInsets.all(20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '整体进度', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + Container( + padding: const EdgeInsets.symmetric( + horizontal: 12, + vertical: 6, + ), + decoration: BoxDecoration( + color: Theme.of(context).primaryColor.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + '${_progress!.progressPercentage.toStringAsFixed(1)}%', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Theme.of(context).primaryColor, + ), + ), + ), + ], + ), + const SizedBox(height: 20), + // 进度条 + ClipRRect( + borderRadius: BorderRadius.circular(10), + child: LinearProgressIndicator( + value: _progress!.progressPercentage / 100, + minHeight: 20, + backgroundColor: Colors.grey[200], + valueColor: AlwaysStoppedAnimation( + Theme.of(context).primaryColor, + ), + ), + ), + const SizedBox(height: 16), + // 进度详情 + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '${_progress!.learnedWords} / ${widget.vocabularyBook.totalWords} 个单词', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + Text( + '剩余 ${widget.vocabularyBook.totalWords - _progress!.learnedWords} 个', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ), + ], + ), + ), + ), + const SizedBox(height: 16), + // 单词状态统计 + Row( + children: [ + Expanded( + child: _buildStatCard( + '已学习', + _progress!.learnedWords.toString(), + Icons.school, + Colors.blue, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildStatCard( + '已掌握', + _progress!.masteredWords.toString(), + Icons.check_circle, + Colors.green, + ), + ), + ], + ), + const SizedBox(height: 12), + Row( + children: [ + Expanded( + child: _buildStatCard( + '待复习', + '0', + Icons.refresh, + Colors.orange, + ), + ), + const SizedBox(width: 12), + Expanded( + child: _buildStatCard( + '未学习', + '${widget.vocabularyBook.totalWords - _progress!.learnedWords}', + Icons.fiber_new, + Colors.grey, + ), + ), + ], + ), + const SizedBox(height: 16), + // 学习信息 + CustomCard( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '学习信息', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + _buildInfoRow( + Icons.calendar_today, + '累计学习', + '${_progress!.totalStudyDays} 天', + ), + const Divider(height: 24), + _buildInfoRow( + Icons.trending_up, + '掌握率', + '${(_progress!.masteredWords / widget.vocabularyBook.totalWords * 100).toStringAsFixed(1)}%', + ), + const Divider(height: 24), + _buildInfoRow( + Icons.access_time, + '上次学习', + _progress!.lastStudiedAt != null + ? _formatDateTime(_progress!.lastStudiedAt!) + : '从未学习', + ), + const Divider(height: 24), + _buildInfoRow( + Icons.play_circle_outline, + '开始时间', + _formatDateTime(_progress!.startedAt), + ), + ], + ), + ), + ), + ], + ), + ); + } + + Widget _buildStatCard(String label, String value, IconData icon, Color color) { + return CustomCard( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + children: [ + Container( + padding: const EdgeInsets.all(10), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(10), + ), + child: Icon(icon, size: 24, color: color), + ), + const SizedBox(height: 12), + Text( + value, + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + color: color, + ), + ), + const SizedBox(height: 4), + Text( + label, + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ), + ), + ); + } + + Widget _buildInfoRow(IconData icon, String label, String value) { + return Row( + children: [ + Icon(icon, size: 20, color: Colors.grey[600]), + const SizedBox(width: 12), + Expanded( + child: Text( + label, + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + ), + ), + ), + Text( + value, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + ), + ), + ], + ); + } + + String _formatDateTime(DateTime dateTime) { + final now = DateTime.now(); + final difference = now.difference(dateTime); + + if (difference.inDays == 0) { + if (difference.inHours == 0) { + if (difference.inMinutes == 0) { + return '刚刚'; + } + return '${difference.inMinutes} 分钟前'; + } + return '${difference.inHours} 小时前'; + } else if (difference.inDays == 1) { + return '昨天'; + } else if (difference.inDays < 7) { + return '${difference.inDays} 天前'; + } else { + return '${dateTime.year}-${dateTime.month.toString().padLeft(2, '0')}-${dateTime.day.toString().padLeft(2, '0')}'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/screens/vocabulary_category_screen.dart b/client/lib/features/vocabulary/screens/vocabulary_category_screen.dart new file mode 100644 index 0000000..9cc453e --- /dev/null +++ b/client/lib/features/vocabulary/screens/vocabulary_category_screen.dart @@ -0,0 +1,506 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/vocabulary_book_model.dart'; +import '../models/vocabulary_book_category.dart'; +import '../services/vocabulary_service.dart'; +import '../providers/vocabulary_provider.dart'; +import '../../../core/routes/app_routes.dart'; +import '../../../core/network/api_client.dart'; +import '../../../core/services/storage_service.dart'; + +class VocabularyCategoryScreen extends ConsumerStatefulWidget { + final String category; + + const VocabularyCategoryScreen({ + super.key, + required this.category, + }); + + @override + ConsumerState createState() => _VocabularyCategoryScreenState(); +} + +class _VocabularyCategoryScreenState extends ConsumerState { + List _categoryBooks = []; + bool _isLoading = true; + String? _error; + + @override + void initState() { + super.initState(); + _loadCategoryBooks(); + } + + Future _loadCategoryBooks() async { + setState(() { + _isLoading = true; + _error = null; + }); + + try { + final apiClient = ApiClient.instance; + final storageService = await StorageService.getInstance(); + final vocabularyService = VocabularyService( + apiClient: apiClient, + storageService: storageService, + ); + + // 从 API 获取该分类下的词书 + final books = await vocabularyService.getSystemVocabularyBooks( + category: widget.category, + limit: 100, + ); + + setState(() { + _categoryBooks = books; + _isLoading = false; + }); + } catch (e) { + setState(() { + _error = e.toString(); + _isLoading = false; + }); + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: Text(widget.category), + centerTitle: true, + ), + body: _buildBody(), + ); + } + + Widget _buildBody() { + if (_isLoading) { + return const Center( + child: CircularProgressIndicator(), + ); + } + + if (_error != null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '加载失败', + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + Text( + _error!, + style: TextStyle( + fontSize: 12, + color: Colors.grey[400], + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 16), + ElevatedButton( + onPressed: _loadCategoryBooks, + child: const Text('重试'), + ), + ], + ), + ); + } + + if (_categoryBooks.isEmpty) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.book_outlined, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '该分类下暂无词书', + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + Text( + '分类: ${widget.category}', + style: TextStyle( + fontSize: 12, + color: Colors.grey[400], + ), + ), + ], + ), + ); + } + + return LayoutBuilder( + builder: (context, constraints) { + final isMobile = constraints.maxWidth < 600; + return _buildBooksList(context, _categoryBooks, isMobile); + }, + ); + } + + Widget _buildBooksList(BuildContext context, List books, bool isMobile) { + return GridView.builder( + padding: EdgeInsets.all(isMobile ? 16.0 : 24.0), + gridDelegate: SliverGridDelegateWithFixedCrossAxisCount( + crossAxisCount: isMobile ? 2 : 3, + crossAxisSpacing: 12, + mainAxisSpacing: 12, + childAspectRatio: isMobile ? 0.75 : 0.8, + ), + itemCount: books.length, + itemBuilder: (context, index) { + final book = books[index]; + return _buildBookCard(context, book, isMobile); + }, + ); + } + + Widget _buildBookCard(BuildContext context, VocabularyBook book, bool isMobile) { + final difficultyColor = _getDifficultyColor(book.difficulty); + + return GestureDetector( + onTap: () => _navigateToBook(context, book), + child: Container( + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.08), + blurRadius: 12, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.stretch, + children: [ + // 顶部渐变封面区域 + Container( + height: isMobile ? 120 : 140, + decoration: BoxDecoration( + gradient: LinearGradient( + begin: Alignment.topLeft, + end: Alignment.bottomRight, + colors: [ + difficultyColor.withOpacity(0.15), + difficultyColor.withOpacity(0.05), + ], + ), + borderRadius: const BorderRadius.vertical(top: Radius.circular(16)), + ), + child: Stack( + children: [ + // 装饰性图案 + Positioned( + right: -20, + top: -20, + child: Icon( + Icons.auto_stories_outlined, + size: 100, + color: difficultyColor.withOpacity(0.1), + ), + ), + // 书本图标 + Center( + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + shape: BoxShape.circle, + boxShadow: [ + BoxShadow( + color: difficultyColor.withOpacity(0.2), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Icon( + Icons.menu_book_rounded, + size: isMobile ? 32 : 40, + color: difficultyColor, + ), + ), + ), + // 难度标签 + Positioned( + top: 12, + right: 12, + child: Container( + padding: const EdgeInsets.symmetric(horizontal: 10, vertical: 5), + decoration: BoxDecoration( + color: difficultyColor, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: difficultyColor.withOpacity(0.3), + blurRadius: 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Text( + _getDifficultyText(book.difficulty), + style: const TextStyle( + fontSize: 11, + color: Colors.white, + fontWeight: FontWeight.w600, + ), + ), + ), + ), + ], + ), + ), + // 词书信息区域 + Expanded( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 词书名称 + Text( + book.name, + style: TextStyle( + fontSize: isMobile ? 15 : 17, + fontWeight: FontWeight.bold, + color: const Color(0xFF2C3E50), + height: 1.3, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 8), + // 词汇量信息 + Row( + children: [ + Icon( + Icons.library_books_outlined, + size: 16, + color: Colors.grey[600], + ), + const SizedBox(width: 4), + Text( + '${book.totalWords} 词', + style: TextStyle( + fontSize: isMobile ? 13 : 14, + color: Colors.grey[700], + fontWeight: FontWeight.w500, + ), + ), + ], + ), + const SizedBox(height: 12), + // 学习进度 + Consumer( + builder: (context, ref, child) { + final progressAsync = ref.watch(vocabularyBookProgressProvider(book.id)); + return progressAsync.when( + data: (progress) { + final percentage = (progress.progressPercentage / 100.0).clamp(0.0, 1.0); + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '学习进度', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + Text( + '${progress.progressPercentage.toStringAsFixed(0)}%', + style: TextStyle( + fontSize: 12, + color: difficultyColor, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: 6), + ClipRRect( + borderRadius: BorderRadius.circular(10), + child: LinearProgressIndicator( + value: percentage, + backgroundColor: difficultyColor.withOpacity(0.1), + valueColor: AlwaysStoppedAnimation(difficultyColor), + minHeight: 6, + ), + ), + ], + ); + }, + loading: () => Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '学习进度', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + Text( + '0%', + style: TextStyle( + fontSize: 12, + color: difficultyColor, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: 6), + ClipRRect( + borderRadius: BorderRadius.circular(10), + child: LinearProgressIndicator( + value: 0, + backgroundColor: difficultyColor.withOpacity(0.1), + valueColor: AlwaysStoppedAnimation(difficultyColor), + minHeight: 6, + ), + ), + ], + ), + error: (_, __) => Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '学习进度', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + Text( + '0%', + style: TextStyle( + fontSize: 12, + color: difficultyColor, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + const SizedBox(height: 6), + ClipRRect( + borderRadius: BorderRadius.circular(10), + child: LinearProgressIndicator( + value: 0, + backgroundColor: difficultyColor.withOpacity(0.1), + valueColor: AlwaysStoppedAnimation(difficultyColor), + minHeight: 6, + ), + ), + ], + ), + ); + }, + ), + const Spacer(), + // 底部操作区域 + Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8), + decoration: BoxDecoration( + color: difficultyColor.withOpacity(0.08), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.play_circle_outline, + size: 18, + color: difficultyColor, + ), + const SizedBox(width: 6), + Text( + '开始学习', + style: TextStyle( + fontSize: 13, + color: difficultyColor, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + ), + ], + ), + ), + ), + ], + ), + ), + ); + } + + Color _getDifficultyColor(VocabularyBookDifficulty difficulty) { + switch (difficulty) { + case VocabularyBookDifficulty.beginner: + return Colors.green; + case VocabularyBookDifficulty.elementary: + return Colors.lightGreen; + case VocabularyBookDifficulty.intermediate: + return Colors.orange; + case VocabularyBookDifficulty.advanced: + return Colors.red; + case VocabularyBookDifficulty.expert: + return Colors.purple; + } + } + + String _getDifficultyText(VocabularyBookDifficulty difficulty) { + switch (difficulty) { + case VocabularyBookDifficulty.beginner: + return '初级'; + case VocabularyBookDifficulty.elementary: + return '基础'; + case VocabularyBookDifficulty.intermediate: + return '中级'; + case VocabularyBookDifficulty.advanced: + return '高级'; + case VocabularyBookDifficulty.expert: + return '专家'; + } + } + + void _navigateToBook(BuildContext context, VocabularyBook book) { + Navigator.pushNamed( + context, + Routes.vocabularyList, + arguments: {'vocabularyBook': book}, + ); + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/screens/vocabulary_home_screen.dart b/client/lib/features/vocabulary/screens/vocabulary_home_screen.dart new file mode 100644 index 0000000..a724958 --- /dev/null +++ b/client/lib/features/vocabulary/screens/vocabulary_home_screen.dart @@ -0,0 +1,1761 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../core/utils/responsive_utils.dart'; +import '../../../core/routes/app_routes.dart'; +import '../models/vocabulary_book_model.dart'; +import '../models/vocabulary_book_category.dart'; +import '../models/word_model.dart'; +import '../data/vocabulary_book_factory.dart'; +import '../providers/vocabulary_provider.dart'; +import '../../../core/routes/app_routes.dart'; +import '../../auth/providers/auth_provider.dart'; + +/// 词汇学习主页面 +class VocabularyHomeScreen extends ConsumerStatefulWidget { + const VocabularyHomeScreen({super.key}); + + @override + ConsumerState createState() => _VocabularyHomeScreenState(); +} + +class _VocabularyHomeScreenState extends ConsumerState { + @override + void initState() { + super.initState(); + // 初始化时加载统计数据 + WidgetsBinding.instance.addPostFrameCallback((_) { + _loadStats(); + }); + } + + // 移除 _loadVocabularyBooks 方法，因为 provider 已经自动加载} + + Future _loadStats() async { + try { + final vocabularyNotifier = ref.read(vocabularyProvider.notifier); + + // 获取当前用户ID以加载每日统计 + final user = ref.read(currentUserProvider); + final userId = user?.id; + + await vocabularyNotifier.loadUserVocabularyOverallStats(); + await vocabularyNotifier.loadWeeklyStudyStats(); + if (userId != null && userId.isNotEmpty) { + await vocabularyNotifier.loadTodayStudyWords(userId: userId); + } else { + // 无用户时仍加载今日单词与默认统计 + await vocabularyNotifier.loadTodayStudyWords(); + } + } catch (_) { + // 忽略错误，在UI中以默认值显示 + } + } + + // 获取推荐词汇书数据 + static List get _recommendedBooks => VocabularyBookFactory.getRecommendedBooks(limit: 8); + + @override + Widget build(BuildContext context) { + final vocabularyAsync = ref.watch(vocabularyProvider); + + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + backgroundColor: Colors.transparent, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back, color: Colors.black87), + onPressed: () => Navigator.of(context).pop(), + ), + title: const Text( + '词汇学习', + style: TextStyle( + color: Colors.black87, + fontSize: 18, + fontWeight: FontWeight.w600, + ), + ), + centerTitle: true, + ), + body: SafeArea( + child: SingleChildScrollView( + physics: const BouncingScrollPhysics(parent: AlwaysScrollableScrollPhysics()), + child: Column( + children: [ + const SizedBox(height: 12), + _buildTitle(), + const SizedBox(height: 12), + _buildCategoryNavigation(), + const SizedBox(height: 12), + _buildTodayWords(), + const SizedBox(height: 12), + // _buildAIRecommendation(), + // const SizedBox(height: 12), + _buildLearningStats(), + const SizedBox(height: 80), // 底部导航栏空间 + ], + ), + ), + ), + ); + } + + + + Widget _buildTitle() { + return const Padding( + padding: EdgeInsets.symmetric(horizontal: 16), + child: Align( + alignment: Alignment.centerLeft, + child: Text( + '选择词书开始学习', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ), + ); + } + + Widget _buildCategoryNavigation() { + // 从 API 加载分类数据 + final state = ref.watch(vocabularyProvider); + final categories = state.categories; + + print('📂 分类数据: ${categories.length} 个分类'); + if (categories.isNotEmpty) { + print('📂 第一个分类: ${categories.first}'); + } + + // 如果API没有返回分类数据，使用本地分类 + final displayCategories = categories.isEmpty + ? _getLocalCategories() + : categories; + + return ResponsiveBuilder( + builder: (context, isMobile, isTablet, isDesktop) { + return Container( + margin: ResponsiveUtils.getResponsivePadding(context), + child: GridView.builder( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + gridDelegate: SliverGridDelegateWithFixedCrossAxisCount( + crossAxisCount: 2, + crossAxisSpacing: 12, + mainAxisSpacing: 12, + mainAxisExtent: isMobile ? 110 : 130, + ), + itemCount: displayCategories.length, + itemBuilder: (context, index) { + final category = displayCategories[index]; + final categoryName = category['name'] as String; + final count = category['count'] as int; + + // 从中文名称映射到枚举（用于显示图标和颜色） + final mainCategory = VocabularyBookCategoryHelper.getMainCategoryFromName(categoryName); + if (mainCategory == null) return const SizedBox.shrink(); + + // 根据分类获取图标和颜色 + final iconData = _getCategoryIcon(mainCategory); + final color = _getCategoryColor(mainCategory); + + return _buildCategoryCard( + mainCategory, + iconData, + color, + count: count, + ); + }, + ), + ); + }, + ); + } + + // 获取本地分类数据作为后备方案 + List> _getLocalCategories() { + return [ + {'name': '学段基础词汇', 'count': 4}, + {'name': '国内应试类词汇', 'count': 4}, + {'name': '出国考试类词汇', 'count': 3}, + {'name': '职业与专业类词汇', 'count': 3}, + {'name': '功能型词库', 'count': 3}, + ]; + } + + IconData _getCategoryIcon(VocabularyBookMainCategory category) { + switch (category) { + case VocabularyBookMainCategory.academicStage: + return Icons.school; + case VocabularyBookMainCategory.domesticTest: + return Icons.quiz; + case VocabularyBookMainCategory.internationalTest: + return Icons.public; + case VocabularyBookMainCategory.professional: + return Icons.work; + case VocabularyBookMainCategory.functional: + return Icons.functions; + } + } + + Color _getCategoryColor(VocabularyBookMainCategory category) { + switch (category) { + case VocabularyBookMainCategory.academicStage: + return Colors.blue; + case VocabularyBookMainCategory.domesticTest: + return Colors.green; + case VocabularyBookMainCategory.internationalTest: + return Colors.orange; + case VocabularyBookMainCategory.professional: + return Colors.purple; + case VocabularyBookMainCategory.functional: + return Colors.teal; + } + } + + Widget _buildCategoryCard(VocabularyBookMainCategory category, IconData icon, Color color, {int? count}) { + final categoryName = VocabularyBookCategoryHelper.getMainCategoryName(category); + + return GestureDetector( + onTap: () => _navigateToCategory(category), + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 8, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Container( + width: 40, + height: 40, + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(20), + ), + child: Icon( + icon, + color: color, + size: 22, + ), + ), + const SizedBox(height: 8), + Text( + categoryName, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + ), + textAlign: TextAlign.center, + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + if (count != null) ...[ + const SizedBox(height: 4), + Text( + '$count 本', + style: TextStyle( + fontSize: 12, + color: Colors.grey[600], + ), + ), + ], + ], + ), + ), + ); + } + + Widget _buildVocabularyBooks() { + final systemBooks = ref.watch(systemVocabularyBooksProvider); + final userBooks = ref.watch(userVocabularyBooksProvider); + + // 合并系统词汇书和用户词汇书 + final allBooks = [...systemBooks, ...userBooks]; + + // 如果没有数据，显示推荐词书 + final booksToShow = allBooks.isNotEmpty ? allBooks : _recommendedBooks; + + return ResponsiveBuilder( + builder: (context, isMobile, isTablet, isDesktop) { + final crossAxisCount = ResponsiveUtils.getGridColumns( + context, + mobileColumns: 3, + tabletColumns: 4, + desktopColumns: 5, + ); + + final childAspectRatio = ResponsiveUtils.getValueForScreenSize( + context, + mobile: 1.3, + tablet: 1.4, + desktop: 1.5, + ); + + return Container( + margin: ResponsiveUtils.getResponsivePadding(context), + child: GridView.builder( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + gridDelegate: SliverGridDelegateWithFixedCrossAxisCount( + crossAxisCount: crossAxisCount, + crossAxisSpacing: 8, + mainAxisSpacing: 8, + childAspectRatio: childAspectRatio, + ), + itemCount: booksToShow.length, + itemBuilder: (context, index) { + final book = booksToShow[index]; + // 使用后端 Provider 获取词书学习进度 + final progressAsync = ref.watch(vocabularyBookProgressProvider(book.id)); + final progress = progressAsync.when( + data: (p) => (p.progressPercentage / 100.0).clamp(0.0, 1.0), + loading: () => null, + error: (e, st) => 0.0, + ); + return _buildBookCard( + book, + progress, + ); + }, + ), + ); + }, + ); + } + + Widget _buildBookCard(VocabularyBook book, double? progress) { + return ResponsiveBuilder( + builder: (context, isMobile, isTablet, isDesktop) { + final iconSize = ResponsiveUtils.getValueForScreenSize( + context, + mobile: 64.0, + tablet: 72.0, + desktop: 80.0, + ); + + final titleFontSize = ResponsiveUtils.getResponsiveFontSize( + context, + mobileSize: 14, + tabletSize: 16, + desktopSize: 18, + ); + + final subtitleFontSize = ResponsiveUtils.getResponsiveFontSize( + context, + mobileSize: 12, + tabletSize: 14, + desktopSize: 16, + ); + + final progressFontSize = ResponsiveUtils.getResponsiveFontSize( + context, + mobileSize: 10, + tabletSize: 12, + desktopSize: 14, + ); + + final cardPadding = ResponsiveUtils.getValueForScreenSize( + context, + mobile: 8.0, + tablet: 10.0, + desktop: 12.0, + ); + + return GestureDetector( + onTap: () => _navigateToVocabularyBook(book), + child: Container( + padding: EdgeInsets.all(cardPadding), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + Container( + width: iconSize, + height: iconSize, + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(8), + image: book.coverImageUrl != null + ? DecorationImage( + image: NetworkImage(book.coverImageUrl!), + fit: BoxFit.cover, + ) + : null, + color: book.coverImageUrl == null ? Colors.grey[300] : null, + ), + child: book.coverImageUrl == null + ? Icon( + Icons.book, + color: Colors.grey, + size: iconSize * 0.4, + ) + : null, + ), + const SizedBox(height: 4), + Text( + book.name, + style: TextStyle( + fontSize: titleFontSize, + fontWeight: FontWeight.bold, + ), + textAlign: TextAlign.center, + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 1), + Text( + '${book.totalWords}词', + style: TextStyle( + fontSize: subtitleFontSize, + color: Colors.grey, + ), + ), + const SizedBox(height: 3), + LinearProgressIndicator( + value: progress, + backgroundColor: Colors.grey[200], + valueColor: const AlwaysStoppedAnimation(Color(0xFF2196F3)), + minHeight: 4, + ), + const SizedBox(height: 1), + Text( + progress == null + ? '加载中...' + : '${(progress * 100).toInt()}%', + style: TextStyle( + fontSize: ResponsiveUtils.getValueForScreenSize( + context, + mobile: 9.0, + tablet: 10.0, + desktop: 12.0, + ), + color: Colors.grey[600], + ), + textAlign: TextAlign.center, + ), + ], + ), + ), + ); + }, + ); + } + + void _navigateToVocabularyBook(VocabularyBook book) { + Navigator.of(context).pushNamed( + Routes.vocabularyList, + arguments: {'vocabularyBook': book}, + ); + } + + void _startTodayWordLearning() { + // 导航到今日单词详情页面 + Navigator.of(context).pushNamed(Routes.dailyWords); + } + + void _showWordDetailFromModel(Word word) { + final meaning = word.definitions.isNotEmpty + ? word.definitions.map((d) => d.translation).join('; ') + : '暂无释义'; + final phonetic = word.phonetic ?? ''; + + _showWordDetail(word.word, meaning, phonetic, word); + } + + void _showWordDetail(String wordText, String meaning, String phonetic, [Word? wordModel]) { + showModalBottomSheet( + context: context, + isScrollControlled: true, + backgroundColor: Colors.transparent, + builder: (context) => Container( + height: MediaQuery.of(context).size.height * 0.7, + decoration: const BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.vertical(top: Radius.circular(20)), + ), + child: Column( + children: [ + Container( + width: 40, + height: 4, + margin: const EdgeInsets.only(top: 12), + decoration: BoxDecoration( + color: Colors.grey[300], + borderRadius: BorderRadius.circular(2), + ), + ), + Expanded( + child: Padding( + padding: const EdgeInsets.all(24), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + wordText, + style: const TextStyle( + fontSize: 28, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + phonetic, + style: const TextStyle( + fontSize: 16, + color: Color(0xFF2196F3), + fontStyle: FontStyle.italic, + ), + ), + ], + ), + ), + IconButton( + onPressed: () => _playWordPronunciation(wordText), + icon: const Icon( + Icons.volume_up, + color: Color(0xFF2196F3), + size: 32, + ), + ), + ], + ), + const SizedBox(height: 24), + const Text( + '释义', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + Text( + meaning, + style: const TextStyle( + fontSize: 16, + color: Colors.black87, + ), + ), + const SizedBox(height: 24), + Row( + children: [ + Expanded( + child: ElevatedButton( + onPressed: () { + Navigator.pop(context); + if (wordModel != null) { + _startWordLearningWithModel(wordModel); + } else { + _startWordLearning(wordText); + } + }, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(vertical: 12), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + child: const Text('开始学习'), + ), + ), + const SizedBox(width: 12), + Expanded( + child: OutlinedButton( + onPressed: () { + if (wordModel != null) { + _addWordToFavorites(wordModel); + } else { + _addToFavorites(wordText); + } + }, + style: OutlinedButton.styleFrom( + foregroundColor: const Color(0xFF2196F3), + side: const BorderSide(color: Color(0xFF2196F3)), + padding: const EdgeInsets.symmetric(vertical: 12), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + child: const Text('收藏'), + ), + ), + ], + ), + ], + ), + ), + ), + ], + ), + ), + ); + } + + void _startWordLearningWithModel(Word word) { + Navigator.of(context).pushNamed( + Routes.wordLearning, + arguments: { + 'words': [word], + 'mode': LearningMode.normal, + 'dailyTarget': 1, + }, + ); + } + + void _startWordLearning(String word) { + // 为单个单词创建学习会话 + final wordToLearn = Word( + id: '1', + word: word, + phonetic: '/example/', + difficulty: WordDifficulty.intermediate, + frequency: 1000, + definitions: [ + WordDefinition( + type: WordType.noun, + definition: word, + translation: '示例释义', + ), + ], + examples: [ + WordExample( + sentence: 'This is an example sentence.', + translation: '这是一个示例句子。', + ), + ], + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ); + + Navigator.of(context).pushNamed( + Routes.wordLearning, + arguments: { + 'words': [wordToLearn], + 'mode': LearningMode.normal, + 'dailyTarget': 1, + }, + ); + } + + void _playWordAudio(Word word) async { + if (word.audioUrl != null && word.audioUrl!.isNotEmpty) { + // TODO: 集成音频服务播放 + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('正在播放 "${word.word}" 的发音'), + duration: const Duration(seconds: 1), + ), + ); + } else { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('"${word.word}" 暂无音频'), + duration: const Duration(seconds: 1), + ), + ); + } + } + + void _playWordPronunciation(String word) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('播放 "$word" 的发音'), + duration: const Duration(seconds: 1), + ), + ); + } + + void _addWordToFavorites(Word word) async { + // TODO: 集成生词本服务 + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('已将 "${word.word}" 添加到生词本'), + duration: const Duration(seconds: 2), + backgroundColor: Colors.green, + ), + ); + } + + void _addToFavorites(String word) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar( + content: Text('已将 "$word" 添加到收藏夹'), + duration: const Duration(seconds: 2), + ), + ); + } + + Widget _buildTodayWords() { + final vocabularyAsync = ref.watch(vocabularyProvider); + + return Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '今日单词', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + TextButton( + onPressed: _startTodayWordLearning, + child: const Text( + '开始学习', + style: TextStyle( + color: Color(0xFF2196F3), + fontSize: 14, + ), + ), + ), + ], + ), + const SizedBox(height: 16), + Builder( + builder: (context) { + final state = ref.watch(vocabularyProvider); + final todayWords = state.todayWords; + if (todayWords.isEmpty) { + return const Center( + child: Padding( + padding: EdgeInsets.all(16.0), + child: Text( + '今日暂无学习单词', + style: TextStyle( + color: Colors.grey, + fontSize: 14, + ), + ), + ), + ); + } + + // 显示前3个单词 + final displayWords = todayWords.take(3).toList(); + return Column( + children: displayWords.asMap().entries.map((entry) { + final index = entry.key; + final word = entry.value; + return Column( + children: [ + if (index > 0) const SizedBox(height: 12), + _buildWordItemFromModel(word), + ], + ); + }).toList(), + ); + }, + ), + ], + ), + ); + } + + Widget _buildWordItemFromModel(Word word) { + final meaning = word.definitions.isNotEmpty + ? word.definitions.first.translation + : '暂无释义'; + final phonetic = word.phonetic ?? ''; + + return GestureDetector( + onTap: () => _showWordDetailFromModel(word), + child: Container( + padding: const EdgeInsets.symmetric(vertical: 8), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + word.word, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + if (phonetic.isNotEmpty) ...[ + const SizedBox(height: 2), + Text( + phonetic, + style: const TextStyle( + fontSize: 12, + color: Color(0xFF2196F3), + fontStyle: FontStyle.italic, + ), + ), + ], + const SizedBox(height: 2), + Text( + meaning, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + ], + ), + ), + Row( + mainAxisSize: MainAxisSize.min, + children: [ + if (word.audioUrl != null && word.audioUrl!.isNotEmpty) + IconButton( + onPressed: () => _playWordAudio(word), + icon: const Icon( + Icons.volume_up, + color: Color(0xFF2196F3), + size: 20, + ), + ), + // IconButton( + // onPressed: () => _addWordToFavorites(word), + // icon: const Icon( + // Icons.favorite_border, + // color: Colors.grey, + // size: 20, + // ), + // ), + ], + ), + ], + ), + ), + ); + } + + Widget _buildAIRecommendation() { + final state = ref.watch(vocabularyProvider); + final reviewWords = state.reviewWords; + final todayWords = state.todayWords; + + return Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Padding( + padding: EdgeInsets.only(left: 4, bottom: 12), + child: Text( + '推荐功能', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ), + Row( + children: [ + // 智能复习卡片 + Expanded( + child: _buildFeatureCard( + title: '智能复习', + subtitle: reviewWords.isEmpty + ? '暂无复习内容' + : '${reviewWords.length} 个单词待复习', + icon: Icons.psychology_outlined, + color: const Color(0xFF9C27B0), + onTap: () => _startSmartReview(), + ), + ), + const SizedBox(width: 12), + // 词汇测试卡片 + Expanded( + child: _buildFeatureCard( + title: '词汇测试', + subtitle: '测试你的词汇量', + icon: Icons.quiz_outlined, + color: const Color(0xFFFF9800), + onTap: () => _startVocabularyTest(), + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildFeatureCard({ + required String title, + required String subtitle, + required IconData icon, + required Color color, + required VoidCallback onTap, + }) { + return GestureDetector( + onTap: onTap, + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Container( + width: 48, + height: 48, + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Icon( + icon, + color: color, + size: 28, + ), + ), + const SizedBox(height: 12), + Text( + title, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Color(0xFF2C3E50), + ), + ), + const SizedBox(height: 4), + Text( + subtitle, + style: TextStyle( + fontSize: 13, + color: Colors.grey[600], + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ], + ), + ), + ); + } + + // 启动智能复习 + void _startSmartReview() async { + final state = ref.read(vocabularyProvider); + final reviewWords = state.reviewWords; + + if (reviewWords.isEmpty) { + // 如果没有复习词汇，尝试加载 + await ref.read(vocabularyProvider.notifier).loadReviewWords(); + final updatedWords = ref.read(vocabularyProvider).reviewWords; + + if (updatedWords.isEmpty) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('暂无需要复习的单词，赶紧去学习新单词吧！'), + duration: Duration(seconds: 2), + ), + ); + return; + } + } + + // 导航到智能复习页面 + Navigator.of(context).pushNamed( + Routes.smartReview, + arguments: { + 'reviewMode': 'adaptive', + 'dailyTarget': 20, + }, + ); + } + + // 启动词汇测试 + void _startVocabularyTest() { + // 显示测试选项对话框 + showModalBottomSheet( + context: context, + backgroundColor: Colors.transparent, + builder: (context) => Container( + decoration: const BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.vertical(top: Radius.circular(20)), + ), + padding: const EdgeInsets.all(24), + child: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '选择测试类型', + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 20), + _buildTestOption( + title: '快速测试', + subtitle: '10道题，约 3 分钟', + icon: Icons.speed, + color: const Color(0xFF4CAF50), + onTap: () { + Navigator.pop(context); + _navigateToTest(10); + }, + ), + const SizedBox(height: 12), + _buildTestOption( + title: '标准测试', + subtitle: '20道题，约 6 分钟', + icon: Icons.assessment, + color: const Color(0xFF2196F3), + onTap: () { + Navigator.pop(context); + _navigateToTest(20); + }, + ), + const SizedBox(height: 12), + _buildTestOption( + title: '完整测试', + subtitle: '50道题，约 15 分钟', + icon: Icons.assignment, + color: const Color(0xFFFF9800), + onTap: () { + Navigator.pop(context); + _navigateToTest(50); + }, + ), + const SizedBox(height: 16), + TextButton( + onPressed: () => Navigator.pop(context), + child: const Center( + child: Text('取消'), + ), + ), + ], + ), + ), + ); + } + + Widget _buildTestOption({ + required String title, + required String subtitle, + required IconData icon, + required Color color, + required VoidCallback onTap, + }) { + return InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(12), + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + border: Border.all(color: Colors.grey[200]!), + borderRadius: BorderRadius.circular(12), + ), + child: Row( + children: [ + Container( + width: 48, + height: 48, + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Icon( + icon, + color: color, + size: 24, + ), + ), + const SizedBox(width: 16), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + title, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + subtitle, + style: TextStyle( + fontSize: 13, + color: Colors.grey[600], + ), + ), + ], + ), + ), + Icon( + Icons.arrow_forward_ios, + size: 16, + color: Colors.grey[400], + ), + ], + ), + ), + ); + } + + void _navigateToTest(int questionCount) { + Navigator.of(context).pushNamed( + Routes.vocabularyTest, + arguments: { + 'testType': 'vocabularyLevel', + 'questionCount': questionCount, + }, + ); + } + + Widget _buildLearningStats() { + final dailyStats = ref.watch(dailyVocabularyStatsProvider); + final todayStats = ref.watch(todayStatisticsProvider); + final overallStats = ref.watch(overallVocabularyStatsProvider); + final weeklyTotal = ref.watch(weeklyWordsStudiedProvider); + final currentUser = ref.watch(currentUserProvider); + + final todayLearned = dailyStats?.wordsLearned ?? todayStats?.wordsStudied ?? 0; + final totalStudied = (overallStats != null && overallStats['total_studied'] != null) + ? (overallStats['total_studied'] as num).toInt() + : 0; + final dailyWordGoal = currentUser?.settings?.dailyWordGoal ?? 20; + final weeklyTarget = (dailyWordGoal * 7).clamp(1, 100000); + final weeklyProgress = weeklyTarget > 0 ? (weeklyTotal / weeklyTarget) : 0.0; + final weeklyPercent = ((weeklyProgress * 100).clamp(0, 100)).round(); + + return Container( + margin: const EdgeInsets.symmetric(horizontal: 16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '学习统计', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + TextButton( + onPressed: _showDetailedStats, + child: const Text( + '查看详情', + style: TextStyle( + color: Color(0xFF2196F3), + fontSize: 14, + ), + ), + ), + ], + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: GestureDetector( + onTap: _showTodayProgress, + child: _buildStatItem('今日学习', '$todayLearned', '个单词', Icons.today), + ), + ), + Expanded( + child: GestureDetector( + onTap: _showWeeklyProgress, + child: _buildStatItem('本周学习', '$weeklyTotal', '个单词', Icons.calendar_view_week), + ), + ), + Expanded( + child: GestureDetector( + onTap: _showVocabularyTest, + child: _buildStatItem('总词汇量', '$totalStudied', '个单词', Icons.library_books), + ), + ), + ], + ), + const SizedBox(height: 16), + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + const Icon( + Icons.trending_up, + color: Color(0xFF2196F3), + size: 20, + ), + const SizedBox(width: 8), + const Text( + '本周学习进度：', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(width: 8), + Expanded( + child: LinearProgressIndicator( + value: weeklyProgress.clamp(0.0, 1.0), + backgroundColor: Colors.grey[300], + valueColor: const AlwaysStoppedAnimation(Color(0xFF2196F3)), + ), + ), + const SizedBox(width: 8), + Text( + '$weeklyPercent%', + style: const TextStyle( + fontSize: 12, + color: Color(0xFF2196F3), + fontWeight: FontWeight.bold, + ), + ), + ], + ), + ), + ], + ), + ); + } + + Widget _buildStatItem(String label, String value, String unit, IconData icon) { + return Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + ), + child: Column( + children: [ + Icon( + icon, + color: const Color(0xFF2196F3), + size: 24, + ), + const SizedBox(height: 8), + Text( + value, + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + const SizedBox(height: 2), + Text( + unit, + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + ), + const SizedBox(height: 4), + Text( + label, + style: const TextStyle( + fontSize: 12, + color: Colors.black87, + fontWeight: FontWeight.w500, + ), + textAlign: TextAlign.center, + ), + ], + ), + ); + } + + void _showDetailedStats() { + Navigator.of(context).pushNamed(Routes.learningStatsDetail); + } + + void _showTodayProgress() { + // 显示今日学习进度详情 + final dailyStats = ref.read(dailyVocabularyStatsProvider); + final todayStats = ref.read(todayStatisticsProvider); + final todayLearned = dailyStats?.wordsLearned ?? todayStats?.wordsStudied ?? 0; + final currentUser = ref.read(currentUserProvider); + final dailyWordGoal = currentUser?.settings?.dailyWordGoal ?? 20; + final progress = dailyWordGoal > 0 ? (todayLearned / dailyWordGoal) : 0.0; + + showModalBottomSheet( + context: context, + isScrollControlled: true, + backgroundColor: Colors.transparent, + builder: (context) => Container( + height: MediaQuery.of(context).size.height * 0.6, + decoration: const BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.vertical(top: Radius.circular(20)), + ), + child: Column( + children: [ + // 拖拽条 + Container( + width: 40, + height: 4, + margin: const EdgeInsets.only(top: 12, bottom: 20), + decoration: BoxDecoration( + color: Colors.grey[300], + borderRadius: BorderRadius.circular(2), + ), + ), + // 内容 + Expanded( + child: SingleChildScrollView( + padding: const EdgeInsets.all(24), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + width: 48, + height: 48, + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: const Icon( + Icons.today, + color: Color(0xFF2196F3), + size: 28, + ), + ), + const SizedBox(width: 16), + const Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '今日学习进度', + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + SizedBox(height: 4), + Text( + '保持每日学习，让进步成为习惯', + style: TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + ], + ), + ), + ], + ), + const SizedBox(height: 32), + // 进度环 + Center( + child: SizedBox( + width: 160, + height: 160, + child: Stack( + alignment: Alignment.center, + children: [ + SizedBox( + width: 160, + height: 160, + child: CircularProgressIndicator( + value: progress.clamp(0.0, 1.0), + strokeWidth: 12, + backgroundColor: Colors.grey[200], + valueColor: const AlwaysStoppedAnimation( + Color(0xFF2196F3), + ), + ), + ), + Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Text( + '$todayLearned', + style: const TextStyle( + fontSize: 48, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + Text( + '/ $dailyWordGoal 个单词', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ), + ], + ), + ), + ), + const SizedBox(height: 32), + // 统计信息 + _buildProgressStatRow('学习进度', '${(progress * 100).clamp(0, 100).toInt()}%', Icons.trending_up), + const SizedBox(height: 16), + _buildProgressStatRow('已学单词', '$todayLearned 个', Icons.check_circle), + const SizedBox(height: 16), + _buildProgressStatRow('剩余目标', '${(dailyWordGoal - todayLearned).clamp(0, dailyWordGoal)} 个', Icons.flag), + const SizedBox(height: 32), + // 鼓励文字 + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Row( + children: [ + const Icon( + Icons.lightbulb_outline, + color: Color(0xFF2196F3), + ), + const SizedBox(width: 12), + Expanded( + child: Text( + progress >= 1.0 + ? '太棒了！今天的目标已经完成！' + : progress >= 0.5 + ? '再加把劲，马上就能完成今天的目标！' + : '加油！坚持学习，每天进步一点点！', + style: const TextStyle( + fontSize: 14, + color: Color(0xFF2196F3), + ), + ), + ), + ], + ), + ), + ], + ), + ), + ), + ], + ), + ), + ); + } + + Widget _buildProgressStatRow(String label, String value, IconData icon) { + return Row( + children: [ + Icon( + icon, + size: 20, + color: Colors.grey[600], + ), + const SizedBox(width: 12), + Text( + label, + style: TextStyle( + fontSize: 16, + color: Colors.grey[700], + ), + ), + const Spacer(), + Text( + value, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + ], + ); + } + + void _showWeeklyProgress() { + // 显示本周学习进度详情 + final weeklyTotal = ref.read(weeklyWordsStudiedProvider); + final currentUser = ref.read(currentUserProvider); + final dailyWordGoal = currentUser?.settings?.dailyWordGoal ?? 20; + final weeklyTarget = (dailyWordGoal * 7).clamp(1, 100000); + final weeklyProgress = weeklyTarget > 0 ? (weeklyTotal / weeklyTarget) : 0.0; + + showModalBottomSheet( + context: context, + isScrollControlled: true, + backgroundColor: Colors.transparent, + builder: (context) => Container( + height: MediaQuery.of(context).size.height * 0.6, + decoration: const BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.vertical(top: Radius.circular(20)), + ), + child: Column( + children: [ + // 拖拽条 + Container( + width: 40, + height: 4, + margin: const EdgeInsets.only(top: 12, bottom: 20), + decoration: BoxDecoration( + color: Colors.grey[300], + borderRadius: BorderRadius.circular(2), + ), + ), + // 内容 + Expanded( + child: SingleChildScrollView( + padding: const EdgeInsets.all(24), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Container( + width: 48, + height: 48, + decoration: BoxDecoration( + color: const Color(0xFF4CAF50).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: const Icon( + Icons.calendar_view_week, + color: Color(0xFF4CAF50), + size: 28, + ), + ), + const SizedBox(width: 16), + const Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '本周学习进度', + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + SizedBox(height: 4), + Text( + '坑持七天学习，养成好习惯', + style: TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + ], + ), + ), + ], + ), + const SizedBox(height: 32), + // 进度环 + Center( + child: SizedBox( + width: 160, + height: 160, + child: Stack( + alignment: Alignment.center, + children: [ + SizedBox( + width: 160, + height: 160, + child: CircularProgressIndicator( + value: weeklyProgress.clamp(0.0, 1.0), + strokeWidth: 12, + backgroundColor: Colors.grey[200], + valueColor: const AlwaysStoppedAnimation( + Color(0xFF4CAF50), + ), + ), + ), + Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Text( + '$weeklyTotal', + style: const TextStyle( + fontSize: 48, + fontWeight: FontWeight.bold, + color: Color(0xFF4CAF50), + ), + ), + Text( + '/ $weeklyTarget 个单词', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ), + ], + ), + ), + ), + const SizedBox(height: 32), + // 统计信息 + _buildProgressStatRow('周学习进度', '${(weeklyProgress * 100).clamp(0, 100).toInt()}%', Icons.trending_up), + const SizedBox(height: 16), + _buildProgressStatRow('已学单词', '$weeklyTotal 个', Icons.check_circle), + const SizedBox(height: 16), + _buildProgressStatRow('周目标', '$weeklyTarget 个', Icons.flag), + const SizedBox(height: 16), + _buildProgressStatRow('剩余目标', '${(weeklyTarget - weeklyTotal).clamp(0, weeklyTarget)} 个', Icons.timer), + const SizedBox(height: 32), + // 鼓励文字 + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: const Color(0xFF4CAF50).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Row( + children: [ + const Icon( + Icons.emoji_events, + color: Color(0xFF4CAF50), + ), + const SizedBox(width: 12), + Expanded( + child: Text( + weeklyProgress >= 1.0 + ? '完美！本周目标已经达成！' + : weeklyProgress >= 0.7 + ? '太棒了！本周已经完成大部分目标！' + : '加油！距离本周目标还差一点点！', + style: const TextStyle( + fontSize: 14, + color: Color(0xFF4CAF50), + ), + ), + ), + ], + ), + ), + const SizedBox(height: 16), + // 查看详情按钮 + SizedBox( + width: double.infinity, + child: ElevatedButton( + onPressed: () { + Navigator.pop(context); + _showDetailedStats(); + }, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF4CAF50), + padding: const EdgeInsets.symmetric(vertical: 16), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: const Text( + '查看详细统计', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ), + ), + ], + ), + ), + ), + ], + ), + ), + ); + } + + void _showVocabularyTest() { + // TODO: 导航到词汇量测试页面 + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar( + content: Text('开始词汇量测试'), + duration: Duration(seconds: 1), + ), + ); + } + + + + + + + + void _navigateToCategory(VocabularyBookMainCategory category) { + // 将枚举转换为中文名称传递 + final categoryName = VocabularyBookCategoryHelper.getMainCategoryName(category); + Navigator.pushNamed( + context, + Routes.vocabularyCategory, + arguments: { + 'category': categoryName, + }, + ); + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/screens/vocabulary_test_screen.dart b/client/lib/features/vocabulary/screens/vocabulary_test_screen.dart new file mode 100644 index 0000000..4b58461 --- /dev/null +++ b/client/lib/features/vocabulary/screens/vocabulary_test_screen.dart @@ -0,0 +1,507 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/vocabulary_book_model.dart'; +import '../models/word_model.dart'; +import '../providers/vocabulary_provider.dart'; +import 'dart:math'; + +enum TestType { + vocabularyLevel, + listening, + reading, +} + +class VocabularyTestScreen extends ConsumerStatefulWidget { + final VocabularyBook? vocabularyBook; + final TestType testType; + final int questionCount; + + const VocabularyTestScreen({ + super.key, + this.vocabularyBook, + this.testType = TestType.vocabularyLevel, + this.questionCount = 20, + }); + + @override + ConsumerState createState() => _VocabularyTestScreenState(); +} + +class _VocabularyTestScreenState extends ConsumerState { + List _testWords = []; + int _currentIndex = 0; + Map _userAnswers = {}; + bool _isLoading = true; + bool _isTestComplete = false; + + @override + void initState() { + super.initState(); + _initTest(); + } + + Future _initTest() async { + setState(() => _isLoading = true); + + try { + final notifier = ref.read(vocabularyProvider.notifier); + await notifier.loadTodayStudyWords(); + + final state = ref.read(vocabularyProvider); + final allWords = state.todayWords; + + if (allWords.isEmpty) { + // 如果没有今日单词，生成示例数据 + _testWords = _generateSampleWords(); + } else { + // 随机选取指定数量的单词 + final random = Random(); + final selectedWords = []; + final wordsCopy = List.from(allWords); + + final count = widget.questionCount.clamp(1, wordsCopy.length); + for (var i = 0; i < count; i++) { + if (wordsCopy.isEmpty) break; + final index = random.nextInt(wordsCopy.length); + selectedWords.add(wordsCopy.removeAt(index)); + } + + _testWords = selectedWords; + } + } catch (e) { + _testWords = _generateSampleWords(); + } + + setState(() => _isLoading = false); + } + + List _generateSampleWords() { + // 生成示例测试数据 + final sampleWords = [ + 'abandon', 'ability', 'abroad', 'absence', 'absolute', + 'absorb', 'abstract', 'abundant', 'academic', 'accept', + ]; + + return List.generate( + widget.questionCount.clamp(1, sampleWords.length), + (index) => Word( + id: '${index + 1}', + word: sampleWords[index % sampleWords.length], + phonetic: '/ˈsæmpl/', + difficulty: WordDifficulty.intermediate, + frequency: 1000, + definitions: [ + WordDefinition( + type: WordType.noun, + definition: 'Example definition', + translation: '示例释义 ${index + 1}', + ), + ], + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ), + ); + } + + @override + Widget build(BuildContext context) { + if (_isLoading) { + return Scaffold( + appBar: AppBar( + title: const Text('词汇测试'), + ), + body: const Center( + child: CircularProgressIndicator(), + ), + ); + } + + if (_isTestComplete) { + return _buildResultScreen(); + } + + return Scaffold( + appBar: AppBar( + title: Text('词汇测试 (${_currentIndex + 1}/${_testWords.length})'), + actions: [ + TextButton( + onPressed: _showExitConfirmDialog, + child: const Text( + '退出', + style: TextStyle(color: Colors.white), + ), + ), + ], + ), + body: _buildTestQuestion(), + ); + } + + Widget _buildTestQuestion() { + if (_currentIndex >= _testWords.length) { + return const Center(child: Text('测试已完成')); + } + + final word = _testWords[_currentIndex]; + final correctAnswer = word.definitions.isNotEmpty + ? word.definitions.first.translation + : '示例释义'; + + // 生成选项（一个正确答案 + 三个干扰项） + final options = _generateOptions(correctAnswer, _currentIndex); + + return Column( + children: [ + // 进度条 + LinearProgressIndicator( + value: (_currentIndex + 1) / _testWords.length, + backgroundColor: Colors.grey[200], + valueColor: const AlwaysStoppedAnimation(Color(0xFF2196F3)), + ), + Expanded( + child: SingleChildScrollView( + padding: const EdgeInsets.all(24), + child: Column( + crossAxisAlignment: CrossAxisAlignment.stretch, + children: [ + // 问题区域 + Container( + padding: const EdgeInsets.all(24), + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(16), + ), + child: Column( + children: [ + const Text( + '请选择下列单词的正确释义', + style: TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + const SizedBox(height: 16), + Text( + word.word, + style: const TextStyle( + fontSize: 36, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + if (word.phonetic != null) ...[ + const SizedBox(height: 8), + Text( + word.phonetic!, + style: const TextStyle( + fontSize: 18, + color: Colors.grey, + fontStyle: FontStyle.italic, + ), + ), + ], + ], + ), + ), + const SizedBox(height: 32), + // 选项 + ...options.asMap().entries.map((entry) { + final index = entry.key; + final option = entry.value; + final optionLabel = String.fromCharCode(65 + index); // A, B, C, D + + return Padding( + padding: const EdgeInsets.only(bottom: 12), + child: _buildOptionCard( + label: optionLabel, + text: option, + isSelected: _userAnswers[_currentIndex] == option, + onTap: () => _selectAnswer(option), + ), + ); + }), + ], + ), + ), + ), + // 底部按钮 + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, -2), + ), + ], + ), + child: SafeArea( + child: ElevatedButton( + onPressed: _userAnswers.containsKey(_currentIndex) ? _nextQuestion : null, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + padding: const EdgeInsets.symmetric(vertical: 16), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: Text( + _currentIndex < _testWords.length - 1 ? '下一题' : '完成测试', + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ), + ), + ), + ], + ); + } + + Widget _buildOptionCard({ + required String label, + required String text, + required bool isSelected, + required VoidCallback onTap, + }) { + return InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(12), + child: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: isSelected + ? const Color(0xFF2196F3).withOpacity(0.1) + : Colors.white, + border: Border.all( + color: isSelected + ? const Color(0xFF2196F3) + : Colors.grey[300]!, + width: isSelected ? 2 : 1, + ), + borderRadius: BorderRadius.circular(12), + ), + child: Row( + children: [ + Container( + width: 32, + height: 32, + decoration: BoxDecoration( + color: isSelected + ? const Color(0xFF2196F3) + : Colors.grey[200], + shape: BoxShape.circle, + ), + child: Center( + child: Text( + label, + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: isSelected ? Colors.white : Colors.grey[600], + ), + ), + ), + ), + const SizedBox(width: 16), + Expanded( + child: Text( + text, + style: TextStyle( + fontSize: 16, + color: isSelected ? const Color(0xFF2196F3) : Colors.black87, + fontWeight: isSelected ? FontWeight.w600 : FontWeight.normal, + ), + ), + ), + ], + ), + ), + ); + } + + List _generateOptions(String correctAnswer, int questionIndex) { + final distractors = [ + '放弃；遗弃', + '能力；才能', + '在国外；到国外', + '缺席；缺乏', + '绝对的；完全的', + '吸收；吸引', + '抽象的；抽象概念', + '丰富的；充裕的', + '学术的；学院的', + '接受；承认', + ]; + + final options = [correctAnswer]; + final random = Random(questionIndex); // 使用问题索引作为种子以保证一致性 + + while (options.length < 4 && distractors.isNotEmpty) { + final index = random.nextInt(distractors.length); + final distractor = distractors[index]; + if (distractor != correctAnswer && !options.contains(distractor)) { + options.add(distractor); + } + distractors.removeAt(index); + } + + // 打乱选项顺序 + options.shuffle(random); + return options; + } + + void _selectAnswer(String answer) { + setState(() { + _userAnswers[_currentIndex] = answer; + }); + } + + void _nextQuestion() { + if (_currentIndex < _testWords.length - 1) { + setState(() { + _currentIndex++; + }); + } else { + setState(() { + _isTestComplete = true; + }); + } + } + + Widget _buildResultScreen() { + int correctCount = 0; + + for (var i = 0; i < _testWords.length; i++) { + final word = _testWords[i]; + final correctAnswer = word.definitions.isNotEmpty + ? word.definitions.first.translation + : '示例释义'; + if (_userAnswers[i] == correctAnswer) { + correctCount++; + } + } + + final score = (correctCount / _testWords.length * 100).round(); + + return Scaffold( + appBar: AppBar( + title: const Text('测试结果'), + automaticallyImplyLeading: false, + ), + body: Center( + child: Padding( + padding: const EdgeInsets.all(24), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Container( + width: 120, + height: 120, + decoration: BoxDecoration( + color: score >= 60 + ? Colors.green.withOpacity(0.1) + : Colors.orange.withOpacity(0.1), + shape: BoxShape.circle, + ), + child: Center( + child: Text( + '$score', + style: TextStyle( + fontSize: 48, + fontWeight: FontWeight.bold, + color: score >= 60 ? Colors.green : Colors.orange, + ), + ), + ), + ), + const SizedBox(height: 24), + Text( + score >= 80 ? '太棒了！' : score >= 60 ? '不错哦！' : '加油！', + style: const TextStyle( + fontSize: 28, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Text( + '你的分数：$score 分', + style: const TextStyle( + fontSize: 18, + color: Colors.grey, + ), + ), + const SizedBox(height: 8), + Text( + '正确率：$correctCount/${_testWords.length}', + style: const TextStyle( + fontSize: 16, + color: Colors.grey, + ), + ), + const SizedBox(height: 48), + ElevatedButton( + onPressed: () => Navigator.of(context).pop(), + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + padding: const EdgeInsets.symmetric( + horizontal: 48, + vertical: 16, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + ), + child: const Text( + '完成', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ), + const SizedBox(height: 16), + TextButton( + onPressed: () { + setState(() { + _currentIndex = 0; + _userAnswers.clear(); + _isTestComplete = false; + }); + _initTest(); + }, + child: const Text('重新测试'), + ), + ], + ), + ), + ), + ); + } + + void _showExitConfirmDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('退出测试'), + content: const Text('确定要退出吗？当前进度将不会保存。'), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(), + child: const Text('取消'), + ), + TextButton( + onPressed: () { + Navigator.of(context).pop(); + Navigator.of(context).pop(); + }, + child: const Text('确定'), + ), + ], + ), + ); + } +} diff --git a/client/lib/features/vocabulary/screens/word_book_screen.dart b/client/lib/features/vocabulary/screens/word_book_screen.dart new file mode 100644 index 0000000..0a91df1 --- /dev/null +++ b/client/lib/features/vocabulary/screens/word_book_screen.dart @@ -0,0 +1,432 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../shared/services/word_book_service.dart'; +import '../../../core/services/tts_service.dart'; + +/// 生词本页面 +class WordBookScreen extends ConsumerStatefulWidget { + const WordBookScreen({super.key}); + + @override + ConsumerState createState() => _WordBookScreenState(); +} + +class _WordBookScreenState extends ConsumerState { + final TTSService _ttsService = TTSService(); + bool _isLoading = true; + List _words = []; + Map? _stats; + int _currentPage = 1; + final int _pageSize = 20; + String _sortBy = 'created_at'; + String _order = 'desc'; + + @override + void initState() { + super.initState(); + _ttsService.initialize(); + _loadData(); + } + + @override + void dispose() { + _ttsService.dispose(); + super.dispose(); + } + + Future _loadData() async { + setState(() => _isLoading = true); + + try { + final wordBookService = ref.read(wordBookServiceProvider); + + // 加载生词列表 + final wordsData = await wordBookService.getFavoriteWords( + page: _currentPage, + pageSize: _pageSize, + sortBy: _sortBy, + order: _order, + ); + + // 加载统计信息 + final stats = await wordBookService.getFavoriteStats(); + + setState(() { + _words = wordsData['words']; + _stats = stats; + _isLoading = false; + }); + } catch (e) { + setState(() => _isLoading = false); + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar(content: Text('加载失败: $e')), + ); + } + } + } + + Future _removeWord(int wordId) async { + try { + final wordBookService = ref.read(wordBookServiceProvider); + await wordBookService.removeFromFavorite(wordId); + + _loadData(); // 刷新列表 + + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('已从生词本移除')), + ); + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar(content: Text('移除失败: $e')), + ); + } + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + title: const Text('生词本'), + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + actions: [ + PopupMenuButton( + onSelected: (value) { + setState(() { + if (value == 'proficiency_asc') { + _sortBy = 'proficiency'; + _order = 'asc'; + } else if (value == 'proficiency_desc') { + _sortBy = 'proficiency'; + _order = 'desc'; + } else if (value == 'word_asc') { + _sortBy = 'word'; + _order = 'asc'; + } else if (value == 'created_at_desc') { + _sortBy = 'created_at'; + _order = 'desc'; + } + _currentPage = 1; + _loadData(); + }); + }, + itemBuilder: (context) => [ + const PopupMenuItem( + value: 'created_at_desc', + child: Text('按添加时间排序'), + ), + const PopupMenuItem( + value: 'proficiency_asc', + child: Text('按熟练度（低到高）'), + ), + const PopupMenuItem( + value: 'proficiency_desc', + child: Text('按熟练度（高到低）'), + ), + const PopupMenuItem( + value: 'word_asc', + child: Text('按单词字母排序'), + ), + ], + ), + ], + ), + body: _isLoading + ? const Center(child: CircularProgressIndicator()) + : RefreshIndicator( + onRefresh: _loadData, + child: Column( + children: [ + if (_stats != null) _buildStatsCard(), + Expanded( + child: _words.isEmpty + ? _buildEmptyState() + : _buildWordList(), + ), + ], + ), + ), + ); + } + + Widget _buildStatsCard() { + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '学习统计', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildStatItem( + '总词数', + _stats!['total_words'].toString(), + Icons.book, + const Color(0xFF2196F3), + ), + ), + Expanded( + child: _buildStatItem( + '已掌握', + _stats!['mastered_words'].toString(), + Icons.check_circle, + const Color(0xFF4CAF50), + ), + ), + Expanded( + child: _buildStatItem( + '复习中', + _stats!['reviewing_words'].toString(), + Icons.loop, + const Color(0xFFFF9800), + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildStatItem(String label, String value, IconData icon, Color color) { + return Column( + children: [ + Icon(icon, color: color, size: 24), + const SizedBox(height: 8), + Text( + value, + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: color, + ), + ), + const SizedBox(height: 4), + Text( + label, + style: const TextStyle(fontSize: 12, color: Colors.grey), + ), + ], + ); + } + + Widget _buildEmptyState() { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.bookmark_border, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '生词本为空', + style: TextStyle( + fontSize: 18, + color: Colors.grey[600], + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 8), + Text( + '在学习时点击收藏按钮添加生词', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + ), + ], + ), + ); + } + + Widget _buildWordList() { + return ListView.builder( + padding: const EdgeInsets.symmetric(horizontal: 16), + itemCount: _words.length, + itemBuilder: (context, index) { + final word = _words[index]; + return _buildWordCard(word); + }, + ); + } + + Widget _buildWordCard(Map word) { + return Container( + margin: const EdgeInsets.only(bottom: 12), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(12), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: ListTile( + contentPadding: const EdgeInsets.all(16), + title: Row( + children: [ + Expanded( + child: Text( + word['word'] ?? '', + style: const TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ), + if (word['phonetic'] != null) + Text( + word['phonetic'], + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + ], + ), + subtitle: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const SizedBox(height: 8), + if (word['definitions'] != null) + Text( + word['definitions'], + style: const TextStyle(fontSize: 14), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 8), + Row( + children: [ + _buildLevelBadge(word['level']), + const SizedBox(width: 8), + Text( + '熟练度: ${word['proficiency'] ?? 0}%', + style: TextStyle( + fontSize: 12, + color: _getProficiencyColor(word['proficiency'] ?? 0), + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ], + ), + trailing: Row( + mainAxisSize: MainAxisSize.min, + children: [ + IconButton( + icon: const Icon(Icons.volume_up, color: Color(0xFF2196F3)), + onPressed: () async { + await _ttsService.speak(word['word'] ?? ''); + }, + ), + IconButton( + icon: const Icon(Icons.delete, color: Colors.red), + onPressed: () { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('确认移除'), + content: Text('确定要将"${word['word']}"从生词本移除吗？'), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('取消'), + ), + TextButton( + onPressed: () { + Navigator.pop(context); + _removeWord(word['id']); + }, + child: const Text('确定'), + ), + ], + ), + ); + }, + ), + ], + ), + ), + ); + } + + Widget _buildLevelBadge(String? level) { + Color color; + String text; + + switch (level) { + case 'beginner': + color = const Color(0xFF4CAF50); + text = '初级'; + break; + case 'intermediate': + color = const Color(0xFF2196F3); + text = '中级'; + break; + case 'advanced': + color = const Color(0xFFFF9800); + text = '高级'; + break; + default: + color = Colors.grey; + text = '未知'; + } + + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(4), + ), + child: Text( + text, + style: TextStyle( + fontSize: 11, + color: color, + fontWeight: FontWeight.w500, + ), + ), + ); + } + + Color _getProficiencyColor(int proficiency) { + if (proficiency >= 80) return const Color(0xFF4CAF50); + if (proficiency >= 60) return const Color(0xFF2196F3); + if (proficiency >= 40) return const Color(0xFFFF9800); + return const Color(0xFFF44336); + } +} diff --git a/client/lib/features/vocabulary/screens/word_learning_screen.dart b/client/lib/features/vocabulary/screens/word_learning_screen.dart new file mode 100644 index 0000000..6a9fb54 --- /dev/null +++ b/client/lib/features/vocabulary/screens/word_learning_screen.dart @@ -0,0 +1,621 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/word_model.dart'; +import '../models/vocabulary_book_model.dart'; +import '../providers/vocabulary_provider.dart'; +import '../../../core/services/audio_service.dart'; +import '../../../core/theme/app_colors.dart'; + +enum LearningMode { normal, review, test } + +class WordLearningScreen extends ConsumerStatefulWidget { + final VocabularyBook vocabularyBook; + final List? specificWords; + final LearningMode mode; + + const WordLearningScreen({ + super.key, + required this.vocabularyBook, + this.specificWords, + this.mode = LearningMode.normal, + }); + + @override + ConsumerState createState() => _WordLearningScreenState(); +} + +class _WordLearningScreenState extends ConsumerState { + int _currentIndex = 0; + bool _showMeaning = false; + final AudioService _audioService = AudioService(); + Map _studyResults = {}; // 记录每个单词的学习结果 + List _words = []; + + @override + void initState() { + super.initState(); + _audioService.initialize(); + _words = widget.specificWords ?? []; + + // 如果没有指定单词，这里可以从 Provider 加载 + if (_words.isEmpty) { + print('⚠️ 没有指定学习单词'); + } + } + + @override + void dispose() { + _audioService.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + if (_words.isEmpty) { + return Scaffold( + appBar: AppBar( + title: Text(widget.vocabularyBook.name), + ), + body: const Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon(Icons.book_outlined, size: 64, color: Colors.grey), + SizedBox(height: 16), + Text('暂无可学习的单词'), + ], + ), + ), + ); + } + + return Scaffold( + appBar: AppBar( + title: Text(widget.vocabularyBook.name), + actions: [ + // 显示当前进度 + Center( + child: Padding( + padding: const EdgeInsets.symmetric(horizontal: 16), + child: Text( + '${_currentIndex + 1}/${_words.length}', + style: const TextStyle(fontSize: 16, fontWeight: FontWeight.bold), + ), + ), + ), + ], + ), + body: Column( + children: [ + // 进度条 + LinearProgressIndicator( + value: (_currentIndex + 1) / _words.length, + backgroundColor: Colors.grey[200], + valueColor: AlwaysStoppedAnimation(AppColors.primary), + ), + Expanded( + child: _buildLearningCard(), + ), + ], + ), + ); + } + + Widget _buildLearningCard() { + final word = _words[_currentIndex]; + // 根据学习模式判断：review模式为复习，其他为新词 + final isNewWord = widget.mode != LearningMode.review; + + return Container( + color: Colors.grey[50], + child: Column( + children: [ + // 上半部分：单词卡片 + Expanded( + flex: 3, + child: Container( + width: double.infinity, + margin: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(20), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.08), + blurRadius: 20, + offset: const Offset(0, 4), + ), + ], + ), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + // 新词/复习标签 + Container( + padding: const EdgeInsets.symmetric( + horizontal: 16, + vertical: 8, + ), + decoration: BoxDecoration( + color: isNewWord + ? Colors.orange.withOpacity(0.15) + : Colors.blue.withOpacity(0.15), + borderRadius: BorderRadius.circular(20), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + isNewWord ? Icons.fiber_new_rounded : Icons.refresh_rounded, + size: 18, + color: isNewWord ? Colors.orange[700] : Colors.blue[700], + ), + const SizedBox(width: 6), + Text( + isNewWord ? '新词' : '复习', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + color: isNewWord ? Colors.orange[700] : Colors.blue[700], + ), + ), + ], + ), + ), + + const SizedBox(height: 40), + + // 单词 + Text( + word.word, + style: const TextStyle( + fontSize: 48, + fontWeight: FontWeight.bold, + color: Color(0xFF2C3E50), + letterSpacing: 1.5, + ), + ), + + const SizedBox(height: 16), + + // 音标 + 发音按钮 + if (word.phonetic != null) + Container( + padding: const EdgeInsets.symmetric( + horizontal: 20, + vertical: 10, + ), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(25), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Text( + word.phonetic!, + style: TextStyle( + fontSize: 18, + color: Colors.grey[700], + fontStyle: FontStyle.italic, + ), + ), + const SizedBox(width: 12), + InkWell( + onTap: () => _playAudio(word), + borderRadius: BorderRadius.circular(20), + child: Container( + padding: const EdgeInsets.all(8), + decoration: BoxDecoration( + color: AppColors.primary, + shape: BoxShape.circle, + ), + child: const Icon( + Icons.volume_up_rounded, + color: Colors.white, + size: 20, + ), + ), + ), + ], + ), + ), + + const SizedBox(height: 40), + + // 显示释义按钮 + if (!_showMeaning) + InkWell( + onTap: () { + setState(() { + _showMeaning = true; + }); + }, + child: Container( + padding: const EdgeInsets.symmetric( + horizontal: 32, + vertical: 14, + ), + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [AppColors.primary, AppColors.primary.withOpacity(0.8)], + ), + borderRadius: BorderRadius.circular(25), + boxShadow: [ + BoxShadow( + color: AppColors.primary.withOpacity(0.3), + blurRadius: 12, + offset: const Offset(0, 4), + ), + ], + ), + child: const Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + Icons.visibility_rounded, + color: Colors.white, + size: 20, + ), + SizedBox(width: 8), + Text( + '点击查看释义', + style: TextStyle( + color: Colors.white, + fontSize: 16, + fontWeight: FontWeight.w600, + ), + ), + ], + ), + ), + ), + ], + ), + ), + ), + + // 下半部分：释义内容（点击后显示） + if (_showMeaning) + Expanded( + flex: 2, + child: SingleChildScrollView( + padding: const EdgeInsets.symmetric(horizontal: 16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: _buildMeaningContent(word), + ), + ), + ), + + // 底部按钮区 + if (_showMeaning) + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, -2), + ), + ], + ), + child: _buildActionButtons(), + ), + ], + ), + ); + } + + List _buildMeaningContent(Word word) { + return [ + // 释义区域 + if (word.definitions.isNotEmpty) ...[ + Container( + width: double.infinity, + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + border: Border.all(color: Colors.grey[200]!), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon(Icons.book_rounded, size: 20, color: AppColors.primary), + const SizedBox(width: 8), + const Text( + '释义', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Color(0xFF2C3E50), + ), + ), + ], + ), + const SizedBox(height: 12), + ...word.definitions.take(3).map((def) => Padding( + padding: const EdgeInsets.only(bottom: 10), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Container( + margin: const EdgeInsets.only(top: 6), + width: 6, + height: 6, + decoration: BoxDecoration( + color: AppColors.primary, + shape: BoxShape.circle, + ), + ), + const SizedBox(width: 12), + Expanded( + child: RichText( + text: TextSpan( + style: const TextStyle( + fontSize: 15, + color: Color(0xFF2C3E50), + height: 1.5, + ), + children: [ + TextSpan( + text: '${_getWordTypeText(def.type)} ', + style: TextStyle( + color: Colors.grey[600], + fontSize: 13, + ), + ), + TextSpan(text: def.translation), + ], + ), + ), + ), + ], + ), + )), + ], + ), + ), + const SizedBox(height: 12), + ], + + // 例句区域 + if (word.examples.isNotEmpty) ...[ + Container( + width: double.infinity, + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [ + Colors.blue[50]!, + Colors.blue[50]!.withOpacity(0.5), + ], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + borderRadius: BorderRadius.circular(16), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon(Icons.lightbulb_outline_rounded, size: 20, color: Colors.blue[700]), + const SizedBox(width: 8), + Text( + '例句', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.blue[700], + ), + ), + ], + ), + const SizedBox(height: 12), + Text( + word.examples.first.sentence, + style: const TextStyle( + fontSize: 15, + fontStyle: FontStyle.italic, + color: Color(0xFF2C3E50), + height: 1.6, + ), + ), + const SizedBox(height: 8), + Text( + word.examples.first.translation, + style: TextStyle( + fontSize: 14, + color: Colors.grey[700], + height: 1.5, + ), + ), + ], + ), + ), + const SizedBox(height: 16), + ], + ]; + } + + Widget _buildActionButtons() { + return Row( + children: [ + Expanded( + child: InkWell( + onTap: () => _handleStudyResult(false), + borderRadius: BorderRadius.circular(16), + child: Container( + padding: const EdgeInsets.symmetric(vertical: 16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + border: Border.all(color: Colors.red[400]!, width: 2), + ), + child: Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon(Icons.close_rounded, color: Colors.red[600], size: 24), + const SizedBox(width: 8), + Text( + '不认识', + style: TextStyle( + fontSize: 17, + fontWeight: FontWeight.w600, + color: Colors.red[600], + ), + ), + ], + ), + ), + ), + ), + const SizedBox(width: 12), + Expanded( + child: InkWell( + onTap: () => _handleStudyResult(true), + borderRadius: BorderRadius.circular(16), + child: Container( + padding: const EdgeInsets.symmetric(vertical: 16), + decoration: BoxDecoration( + gradient: LinearGradient( + colors: [Colors.green[400]!, Colors.green[600]!], + ), + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.green.withOpacity(0.3), + blurRadius: 8, + offset: const Offset(0, 4), + ), + ], + ), + child: const Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon(Icons.check_rounded, color: Colors.white, size: 24), + SizedBox(width: 8), + Text( + '认识', + style: TextStyle( + fontSize: 17, + fontWeight: FontWeight.w600, + color: Colors.white, + ), + ), + ], + ), + ), + ), + ), + ], + ); + } + + void _handleStudyResult(bool isKnown) { + // 记录学习结果 + _studyResults[_words[_currentIndex].id] = isKnown; + + // 如果是最后一个单词，显示结果 + if (_currentIndex >= _words.length - 1) { + _showResults(); + } else { + // 下一个单词 + setState(() { + _currentIndex++; + _showMeaning = false; + }); + } + } + + void _showResults() { + final knownCount = _studyResults.values.where((v) => v).length; + final totalCount = _studyResults.length; + final accuracy = totalCount > 0 ? (knownCount / totalCount * 100).round() : 0; + + showDialog( + context: context, + barrierDismissible: false, + builder: (context) => AlertDialog( + title: const Text('学习完成！'), + content: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + Icons.celebration, + size: 64, + color: accuracy >= 80 ? Colors.green : Colors.orange, + ), + const SizedBox(height: 16), + Text( + '正确率：$accuracy%', + style: const TextStyle(fontSize: 24, fontWeight: FontWeight.bold), + ), + const SizedBox(height: 8), + Text('认识 $knownCount/$totalCount 个单词'), + ], + ), + actions: [ + TextButton( + onPressed: () { + Navigator.of(context).pop(); // 关闭对话框 + Navigator.of(context).pop(_studyResults); // 返回结果 + }, + child: const Text('完成'), + ), + ], + ), + ); + } + + Future _playAudio(Word word) async { + try { + if (word.audioUrl != null && word.audioUrl!.isNotEmpty) { + await _audioService.playAudio(word.audioUrl!); + } else { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('该单词暂无音频')), + ); + } + } catch (e) { + print('播放音频失败: $e'); + } + } + + String _getWordTypeText(WordType type) { + switch (type) { + case WordType.noun: + return '名词'; + case WordType.verb: + return '动词'; + case WordType.adjective: + return '形容词'; + case WordType.adverb: + return '副词'; + case WordType.preposition: + return '介词'; + case WordType.conjunction: + return '连词'; + case WordType.interjection: + return '感叹词'; + case WordType.pronoun: + return '代词'; + case WordType.article: + return '冠词'; + case WordType.phrase: + return '短语'; + } + } + + Future _saveProgress() async { + final notifier = ref.read(vocabularyProvider.notifier); + await notifier.loadUserVocabularyOverallStats(); + await notifier.loadWeeklyStudyStats(); + } +} diff --git a/client/lib/features/vocabulary/services/learning_service.dart b/client/lib/features/vocabulary/services/learning_service.dart new file mode 100644 index 0000000..acade1a --- /dev/null +++ b/client/lib/features/vocabulary/services/learning_service.dart @@ -0,0 +1,87 @@ +import 'package:ai_english_learning/core/network/api_client.dart'; +import 'package:ai_english_learning/features/vocabulary/models/learning_session_model.dart'; +import 'package:ai_english_learning/features/vocabulary/models/word_model.dart'; + +class LearningService { + final ApiClient _apiClient; + + LearningService({required ApiClient apiClient}) : _apiClient = apiClient; + + /// 开始学习会话 + Future> startLearning(String bookId, int dailyGoal) async { + try { + final response = await _apiClient.post( + '/vocabulary/books/$bookId/learn', + data: { + 'dailyGoal': dailyGoal, + }, + ); + + final data = response.data['data']; + return { + 'session': LearningSession.fromJson(data['session']), + 'tasks': DailyLearningTasks.fromJson(data['tasks']), + }; + } catch (e) { + print('开始学习失败: $e'); + rethrow; + } + } + + /// 获取今日学习任务 + Future getTodayTasks(String bookId, { + int newWords = 20, + int review = 50, + }) async { + try { + final response = await _apiClient.get( + '/vocabulary/books/$bookId/tasks', + queryParameters: { + 'newWords': newWords, + 'review': review, + }, + ); + + return DailyLearningTasks.fromJson(response.data['data']); + } catch (e) { + print('获取学习任务失败: $e'); + rethrow; + } + } + + /// 提交单词学习结果 + Future submitWordStudy( + String wordId, + StudyDifficulty difficulty, { + int? sessionId, + }) async { + try { + final response = await _apiClient.post( + '/vocabulary/words/$wordId/study', + data: { + 'difficulty': difficulty.name, + if (sessionId != null) 'sessionId': sessionId, + }, + ); + + return UserWordProgress.fromJson(response.data['data']); + } catch (e) { + print('提交学习结果失败: $e'); + rethrow; + } + } + + /// 获取学习统计 + Future getLearningStatistics(String bookId) async { + try { + final response = await _apiClient.get( + '/vocabulary/books/$bookId/statistics', + ); + + return LearningStatistics.fromJson(response.data['data']); + } catch (e) { + print('获取学习统计失败: $e'); + rethrow; + } + } +} diff --git a/client/lib/features/vocabulary/services/learning_stats_service.dart b/client/lib/features/vocabulary/services/learning_stats_service.dart new file mode 100644 index 0000000..0b5667e --- /dev/null +++ b/client/lib/features/vocabulary/services/learning_stats_service.dart @@ -0,0 +1,730 @@ +import 'dart:convert'; +import 'dart:math'; +import '../../../core/network/api_client.dart'; +import '../../../core/services/storage_service.dart'; +import '../models/learning_stats_model.dart'; + +/// 学习统计服务 +class LearningStatsService { + final ApiClient _apiClient; + final StorageService _storageService; + + static const String _statsKey = 'learning_stats'; + static const String _achievementsKey = 'achievements'; + static const String _dailyRecordsKey = 'daily_records'; + + LearningStatsService({ + required ApiClient apiClient, + required StorageService storageService, + }) : _apiClient = apiClient, + _storageService = storageService; + + /// 获取用户学习统计 + Future getUserStats() async { + try { + // 1. 从后端API获取每日、每周、每月统计数据 + final today = DateTime.now(); + final sevenDaysAgo = today.subtract(const Duration(days: 7)); + final thirtyDaysAgo = today.subtract(const Duration(days: 30)); + + final startDateStr = thirtyDaysAgo.toIso8601String().split('T')[0]; + final endDateStr = today.toIso8601String().split('T')[0]; + + print('🔍 开始获取学习统计: startDate=$startDateStr, endDate=$endDateStr'); + print('🔍 请求路径: /vocabulary/study/statistics/history'); + + // 获取历史统计数据 + final response = await _apiClient.get( + '/vocabulary/study/statistics/history', + queryParameters: { + 'startDate': startDateStr, + 'endDate': endDateStr, + }, + ); + + print('✅ API响应成功: statusCode=${response.statusCode}'); + + final List historyData = response.data['data'] ?? []; + final dailyRecords = historyData.map((item) => DailyStudyRecord.fromJson(item)).toList(); + + print('📊 获取到 ${dailyRecords.length} 天的学习记录'); + + // 2. 计算总体统计 + final totalWordsLearned = dailyRecords.fold(0, (sum, record) => sum + record.wordsLearned); + final totalWordsReviewed = dailyRecords.fold(0, (sum, record) => sum + record.wordsReviewed); + final totalStudyTimeMinutes = dailyRecords.fold(0, (sum, record) => sum + record.studyTimeMinutes); + final totalExp = dailyRecords.fold(0, (sum, record) => sum + record.expGained); + + // 3. 计算连续学习天数 + final currentStreak = _calculateCurrentStreak(dailyRecords); + final maxStreak = _calculateMaxStreak(dailyRecords); + + // 4. 计算周统计（使用最近7天的记录） + final weeklyRecords = dailyRecords.where((record) { + return record.date.isAfter(sevenDaysAgo.subtract(const Duration(days: 1))); + }).toList(); + final weeklyStats = _calculateWeeklyStats(weeklyRecords); + + print('📅 本周学习记录: ${weeklyRecords.length} 天, 学习 ${weeklyStats.wordsLearned} 个单词'); + + // 5. 计算月统计（使用最近30天的记录） + final monthlyRecords = dailyRecords; + + // 计算本月的周统计记录（用于柱状图） + final weeklyStatsList = []; + final firstDayOfMonth = DateTime(today.year, today.month, 1); + DateTime currentWeekStart = firstDayOfMonth; + + while (currentWeekStart.isBefore(today)) { + final weekEnd = currentWeekStart.add(const Duration(days: 6)); + final weekRecords = dailyRecords.where((record) { + return record.date.isAfter(currentWeekStart.subtract(const Duration(days: 1))) && + record.date.isBefore(weekEnd.add(const Duration(days: 1))); + }).toList(); + + if (weekRecords.isNotEmpty || currentWeekStart.isBefore(today)) { + weeklyStatsList.add(_calculateWeeklyStats(weekRecords)); + } + + currentWeekStart = currentWeekStart.add(const Duration(days: 7)); + } + + final monthlyStats = _calculateMonthlyStats(monthlyRecords, weeklyStatsList); + + print('📆 本月学习记录: ${monthlyRecords.length} 天, 学习 ${monthlyStats.wordsLearned} 个单词, ${weeklyStatsList.length} 周数据'); + + // 6. 计算等级和经验值 + final level = calculateLevel(totalExp); + final nextLevelExp = calculateNextLevelExp(level); + final currentExp = calculateCurrentLevelExp(totalExp, level); + + // 7. 计算平均值 + final studyDays = dailyRecords.length; + final averageDailyWords = studyDays > 0 ? totalWordsLearned / studyDays : 0.0; + final averageDailyMinutes = studyDays > 0 ? totalStudyTimeMinutes / studyDays : 0.0; + + // 8. 计算准确率 + final totalTests = dailyRecords.fold(0, (sum, record) => sum + record.testsCompleted); + final averageAccuracy = totalTests > 0 + ? dailyRecords.fold(0.0, (sum, record) => sum + record.accuracyRate) / totalTests + : 0.0; + + final stats = LearningStats( + userId: 'current_user', + totalStudyDays: studyDays, + currentStreak: currentStreak, + maxStreak: maxStreak, + totalWordsLearned: totalWordsLearned, + totalWordsReviewed: totalWordsReviewed, + totalStudyTimeMinutes: totalStudyTimeMinutes, + averageDailyWords: averageDailyWords, + averageDailyMinutes: averageDailyMinutes, + accuracyRate: averageAccuracy, + completedBooks: 0, + currentBooks: 0, + masteredWords: 0, + learningWords: 0, + reviewWords: 0, + weeklyStats: weeklyStats, + monthlyStats: monthlyStats, + level: level, + currentExp: currentExp, + nextLevelExp: nextLevelExp, + lastStudyTime: dailyRecords.isNotEmpty ? dailyRecords.last.date : null, + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + dailyRecords: dailyRecords, + achievements: [], + leaderboard: null, + ); + + // 保存到本地缓存 + await _saveStatsToLocal(stats); + + return stats; + } catch (e, stackTrace) { + print('❌ 从API获取学习统计失败: $e'); + print('❌ 错误堆栈: $stackTrace'); + + // 如果API失败，尝试从本地缓存加载 + final localData = await _storageService.getString(_statsKey); + if (localData != null) { + print('💾 从本地缓存加载数据'); + return LearningStats.fromJson(json.decode(localData)); + } + // 如果本地也没有，返回默认数据 + print('⚠️ 返回默认数据'); + return _createDefaultStats(); + } + } + + /// 更新学习统计 + Future updateStats({ + required int wordsLearned, + required int wordsReviewed, + required int studyTimeMinutes, + required double accuracyRate, + List vocabularyBookIds = const [], + }) async { + try { + final currentStats = await getUserStats(); + final today = DateTime.now(); + + // 更新每日记录 + await _updateDailyRecord( + date: today, + wordsLearned: wordsLearned, + wordsReviewed: wordsReviewed, + studyTimeMinutes: studyTimeMinutes, + accuracyRate: accuracyRate, + vocabularyBookIds: vocabularyBookIds, + ); + + // 计算新的统计数据 + final updatedStats = await _calculateUpdatedStats(currentStats); + + // 保存到本地 + await _saveStatsToLocal(updatedStats); + + return updatedStats; + } catch (e) { + throw Exception('更新学习统计失败: $e'); + } + } + + /// 获取每日学习记录 + Future> getDailyRecords({ + DateTime? startDate, + DateTime? endDate, + }) async { + try { + final localData = await _storageService.getString(_dailyRecordsKey); + if (localData == null) { + return []; + } + + final Map recordsMap = json.decode(localData); + final records = recordsMap.values + .map((json) => DailyStudyRecord.fromJson(json)) + .toList(); + + // 按日期过滤 + if (startDate != null || endDate != null) { + return records.where((record) { + if (startDate != null && record.date.isBefore(startDate)) { + return false; + } + if (endDate != null && record.date.isAfter(endDate)) { + return false; + } + return true; + }).toList(); + } + + return records; + } catch (e) { + throw Exception('获取每日记录失败: $e'); + } + } + + /// 获取周统计 + Future getWeeklyStats([DateTime? weekStart]) async { + try { + final startDate = weekStart ?? _getWeekStart(DateTime.now()); + final endDate = startDate.add(const Duration(days: 6)); + + final dailyRecords = await getDailyRecords( + startDate: startDate, + endDate: endDate, + ); + + return _calculateWeeklyStats(dailyRecords); + } catch (e) { + throw Exception('获取周统计失败: $e'); + } + } + + /// 获取月统计 + Future getMonthlyStats([DateTime? month]) async { + try { + final targetMonth = month ?? DateTime.now(); + final startDate = DateTime(targetMonth.year, targetMonth.month, 1); + final endDate = DateTime(targetMonth.year, targetMonth.month + 1, 0); + + final dailyRecords = await getDailyRecords( + startDate: startDate, + endDate: endDate, + ); + + // 计算周统计 + final weeklyRecords = []; + DateTime currentWeekStart = startDate; + + while (currentWeekStart.isBefore(endDate)) { + final weekEnd = currentWeekStart.add(const Duration(days: 6)); + final weekRecords = dailyRecords.where((record) { + return record.date.isAfter(currentWeekStart.subtract(const Duration(days: 1))) && + record.date.isBefore(weekEnd.add(const Duration(days: 1))); + }).toList(); + + weeklyRecords.add(_calculateWeeklyStats(weekRecords)); + currentWeekStart = currentWeekStart.add(const Duration(days: 7)); + } + + return _calculateMonthlyStats(dailyRecords, weeklyRecords); + } catch (e) { + throw Exception('获取月统计失败: $e'); + } + } + + /// 获取用户成就 + Future> getUserAchievements() async { + try { + final localData = await _storageService.getString(_achievementsKey); + if (localData != null) { + final List jsonList = json.decode(localData); + return jsonList.map((json) => Achievement.fromJson(json)).toList(); + } + + // 返回默认成就列表 + return _createDefaultAchievements(); + } catch (e) { + throw Exception('获取成就失败: $e'); + } + } + + /// 检查并解锁成就 + Future> checkAndUnlockAchievements() async { + try { + final stats = await getUserStats(); + final achievements = await getUserAchievements(); + final unlockedAchievements = []; + + for (final achievement in achievements) { + if (!achievement.isUnlocked) { + final shouldUnlock = _checkAchievementCondition(achievement, stats); + if (shouldUnlock) { + final unlockedAchievement = achievement.copyWith( + isUnlocked: true, + unlockedAt: DateTime.now(), + ); + unlockedAchievements.add(unlockedAchievement); + } + } + } + + if (unlockedAchievements.isNotEmpty) { + // 更新成就列表 + final updatedAchievements = achievements.map((achievement) { + final unlocked = unlockedAchievements + .where((a) => a.id == achievement.id) + .firstOrNull; + return unlocked ?? achievement; + }).toList(); + + await _saveAchievementsToLocal(updatedAchievements); + } + + return unlockedAchievements; + } catch (e) { + throw Exception('检查成就失败: $e'); + } + } + + /// 获取排行榜 + Future getLeaderboard({ + required LeaderboardType type, + required LeaderboardPeriod period, + }) async { + try { + // 模拟排行榜数据 + final entries = _generateMockLeaderboardEntries(type); + + return Leaderboard( + type: type, + period: period, + entries: entries, + userRank: Random().nextInt(100) + 1, + updatedAt: DateTime.now(), + ); + } catch (e) { + throw Exception('获取排行榜失败: $e'); + } + } + + /// 计算用户等级 + int calculateLevel(int totalExp) { + // 等级计算公式：level = floor(sqrt(totalExp / 100)) + return (sqrt(totalExp / 100)).floor() + 1; + } + + /// 计算升级所需经验值 + int calculateNextLevelExp(int level) { + // 下一级所需总经验值：(level^2) * 100 + return level * level * 100; + } + + /// 计算当前等级经验值 + int calculateCurrentLevelExp(int totalExp, int level) { + final currentLevelTotalExp = (level - 1) * (level - 1) * 100; + return totalExp - currentLevelTotalExp; + } + + /// 更新每日记录 + Future _updateDailyRecord({ + required DateTime date, + required int wordsLearned, + required int wordsReviewed, + required int studyTimeMinutes, + required double accuracyRate, + required List vocabularyBookIds, + }) async { + final dateKey = _formatDateKey(date); + final recordsData = await _storageService.getString(_dailyRecordsKey); + + Map records = {}; + if (recordsData != null) { + records = json.decode(recordsData); + } + + // 获取现有记录或创建新记录 + DailyStudyRecord existingRecord; + if (records.containsKey(dateKey)) { + existingRecord = DailyStudyRecord.fromJson(records[dateKey]); + } else { + existingRecord = DailyStudyRecord( + date: DateTime(date.year, date.month, date.day), + wordsLearned: 0, + wordsReviewed: 0, + studyTimeMinutes: 0, + accuracyRate: 0.0, + testsCompleted: 0, + expGained: 0, + vocabularyBookIds: [], + ); + } + + // 更新记录 + final updatedRecord = DailyStudyRecord( + date: existingRecord.date, + wordsLearned: existingRecord.wordsLearned + wordsLearned, + wordsReviewed: existingRecord.wordsReviewed + wordsReviewed, + studyTimeMinutes: existingRecord.studyTimeMinutes + studyTimeMinutes, + accuracyRate: (existingRecord.accuracyRate + accuracyRate) / 2, + testsCompleted: existingRecord.testsCompleted + 1, + expGained: existingRecord.expGained + _calculateExpGained(wordsLearned, wordsReviewed, accuracyRate), + vocabularyBookIds: [...existingRecord.vocabularyBookIds, ...vocabularyBookIds].toSet().toList(), + ); + + records[dateKey] = updatedRecord.toJson(); + await _storageService.setString(_dailyRecordsKey, json.encode(records)); + } + + /// 计算更新后的统计数据 + Future _calculateUpdatedStats(LearningStats currentStats) async { + final allRecords = await getDailyRecords(); + + // 计算总数据 + final totalWordsLearned = allRecords.fold(0, (sum, record) => sum + record.wordsLearned); + final totalWordsReviewed = allRecords.fold(0, (sum, record) => sum + record.wordsReviewed); + final totalStudyTimeMinutes = allRecords.fold(0, (sum, record) => sum + record.studyTimeMinutes); + final totalExp = allRecords.fold(0, (sum, record) => sum + record.expGained); + + // 计算连续学习天数 + final currentStreak = _calculateCurrentStreak(allRecords); + final maxStreak = _calculateMaxStreak(allRecords); + + // 计算平均值 + final studyDays = allRecords.length; + final averageDailyWords = studyDays > 0 ? totalWordsLearned / studyDays : 0.0; + final averageDailyMinutes = studyDays > 0 ? totalStudyTimeMinutes / studyDays : 0.0; + + // 计算准确率 + final totalTests = allRecords.fold(0, (sum, record) => sum + record.testsCompleted); + final averageAccuracy = totalTests > 0 + ? allRecords.fold(0.0, (sum, record) => sum + record.accuracyRate) / totalTests + : 0.0; + + // 计算等级 + final level = calculateLevel(totalExp); + final nextLevelExp = calculateNextLevelExp(level); + final currentExp = calculateCurrentLevelExp(totalExp, level); + + // 获取周月统计 + final weeklyStats = await getWeeklyStats(); + final monthlyStats = await getMonthlyStats(); + + return currentStats.copyWith( + totalStudyDays: studyDays, + currentStreak: currentStreak, + maxStreak: maxStreak > currentStats.maxStreak ? maxStreak : currentStats.maxStreak, + totalWordsLearned: totalWordsLearned, + totalWordsReviewed: totalWordsReviewed, + totalStudyTimeMinutes: totalStudyTimeMinutes, + averageDailyWords: averageDailyWords, + averageDailyMinutes: averageDailyMinutes, + accuracyRate: averageAccuracy, + weeklyStats: weeklyStats, + monthlyStats: monthlyStats, + level: level, + currentExp: currentExp, + nextLevelExp: nextLevelExp, + lastStudyTime: DateTime.now(), + updatedAt: DateTime.now(), + ); + } + + /// 创建默认统计数据 + LearningStats _createDefaultStats() { + final now = DateTime.now(); + return LearningStats( + userId: 'current_user', + totalStudyDays: 0, + currentStreak: 0, + maxStreak: 0, + totalWordsLearned: 0, + totalWordsReviewed: 0, + totalStudyTimeMinutes: 0, + averageDailyWords: 0.0, + averageDailyMinutes: 0.0, + accuracyRate: 0.0, + completedBooks: 0, + currentBooks: 0, + masteredWords: 0, + learningWords: 0, + reviewWords: 0, + weeklyStats: WeeklyStats( + studyDays: 0, + wordsLearned: 0, + wordsReviewed: 0, + studyTimeMinutes: 0, + accuracyRate: 0.0, + dailyRecords: [], + ), + monthlyStats: MonthlyStats( + studyDays: 0, + wordsLearned: 0, + wordsReviewed: 0, + studyTimeMinutes: 0, + accuracyRate: 0.0, + completedBooks: 0, + weeklyRecords: [], + ), + level: 1, + currentExp: 0, + nextLevelExp: 100, + lastStudyTime: null, + createdAt: now, + updatedAt: now, + dailyRecords: [], + achievements: [], + leaderboard: null, + ); + } + + /// 创建默认成就列表 + List _createDefaultAchievements() { + return [ + Achievement( + id: 'first_word', + name: '初学者', + description: '学习第一个单词', + icon: '🌱', + type: AchievementType.wordsLearned, + isUnlocked: false, + progress: 0, + target: 1, + rewardExp: 10, + ), + Achievement( + id: 'hundred_words', + name: '百词斩', + description: '累计学习100个单词', + icon: '💯', + type: AchievementType.wordsLearned, + isUnlocked: false, + progress: 0, + target: 100, + rewardExp: 100, + ), + Achievement( + id: 'first_streak', + name: '坚持不懈', + description: '连续学习7天', + icon: '🔥', + type: AchievementType.streak, + isUnlocked: false, + progress: 0, + target: 7, + rewardExp: 50, + ), + Achievement( + id: 'month_streak', + name: '月度达人', + description: '连续学习30天', + icon: '🏆', + type: AchievementType.streak, + isUnlocked: false, + progress: 0, + target: 30, + rewardExp: 300, + ), + ]; + } + + /// 计算周统计 + WeeklyStats _calculateWeeklyStats(List dailyRecords) { + final studyDays = dailyRecords.length; + final wordsLearned = dailyRecords.fold(0, (sum, record) => sum + record.wordsLearned); + final wordsReviewed = dailyRecords.fold(0, (sum, record) => sum + record.wordsReviewed); + final studyTimeMinutes = dailyRecords.fold(0, (sum, record) => sum + record.studyTimeMinutes); + final totalTests = dailyRecords.fold(0, (sum, record) => sum + record.testsCompleted); + final accuracyRate = totalTests > 0 + ? dailyRecords.fold(0.0, (sum, record) => sum + record.accuracyRate) / totalTests + : 0.0; + + return WeeklyStats( + studyDays: studyDays, + wordsLearned: wordsLearned, + wordsReviewed: wordsReviewed, + studyTimeMinutes: studyTimeMinutes, + accuracyRate: accuracyRate, + dailyRecords: dailyRecords, + ); + } + + /// 计算月统计 + MonthlyStats _calculateMonthlyStats( + List dailyRecords, + List weeklyRecords, + ) { + final studyDays = dailyRecords.length; + final wordsLearned = dailyRecords.fold(0, (sum, record) => sum + record.wordsLearned); + final wordsReviewed = dailyRecords.fold(0, (sum, record) => sum + record.wordsReviewed); + final studyTimeMinutes = dailyRecords.fold(0, (sum, record) => sum + record.studyTimeMinutes); + final totalTests = dailyRecords.fold(0, (sum, record) => sum + record.testsCompleted); + final accuracyRate = totalTests > 0 + ? dailyRecords.fold(0.0, (sum, record) => sum + record.accuracyRate) / totalTests + : 0.0; + + return MonthlyStats( + studyDays: studyDays, + wordsLearned: wordsLearned, + wordsReviewed: wordsReviewed, + studyTimeMinutes: studyTimeMinutes, + accuracyRate: accuracyRate, + completedBooks: 0, // TODO: 从实际数据计算 + weeklyRecords: weeklyRecords, + ); + } + + /// 计算当前连续学习天数 + int _calculateCurrentStreak(List records) { + if (records.isEmpty) return 0; + + records.sort((a, b) => b.date.compareTo(a.date)); + + int streak = 0; + DateTime currentDate = DateTime.now(); + + for (final record in records) { + final daysDiff = currentDate.difference(record.date).inDays; + + if (daysDiff == streak) { + streak++; + } else { + break; + } + } + + return streak; + } + + /// 计算最大连续学习天数 + int _calculateMaxStreak(List records) { + if (records.isEmpty) return 0; + + records.sort((a, b) => a.date.compareTo(b.date)); + + int maxStreak = 1; + int currentStreak = 1; + + for (int i = 1; i < records.length; i++) { + final daysDiff = records[i].date.difference(records[i - 1].date).inDays; + + if (daysDiff == 1) { + currentStreak++; + maxStreak = maxStreak > currentStreak ? maxStreak : currentStreak; + } else { + currentStreak = 1; + } + } + + return maxStreak; + } + + /// 计算获得的经验值 + int _calculateExpGained(int wordsLearned, int wordsReviewed, double accuracyRate) { + final baseExp = wordsLearned * 2 + wordsReviewed * 1; + final accuracyBonus = (accuracyRate * baseExp * 0.5).round(); + return baseExp + accuracyBonus; + } + + /// 检查成就条件 + bool _checkAchievementCondition(Achievement achievement, LearningStats stats) { + switch (achievement.type) { + case AchievementType.wordsLearned: + return stats.totalWordsLearned >= achievement.target; + case AchievementType.streak: + return stats.currentStreak >= achievement.target; + case AchievementType.studyDays: + return stats.totalStudyDays >= achievement.target; + case AchievementType.booksCompleted: + return stats.completedBooks >= achievement.target; + case AchievementType.studyTime: + return stats.totalStudyTimeMinutes >= achievement.target; + default: + return false; + } + } + + /// 生成模拟排行榜数据 + List _generateMockLeaderboardEntries(LeaderboardType type) { + final random = Random(); + final entries = []; + + for (int i = 1; i <= 50; i++) { + entries.add(LeaderboardEntry( + rank: i, + userId: 'user_$i', + username: '用户$i', + score: random.nextInt(1000) + 100, + level: random.nextInt(20) + 1, + )); + } + + return entries; + } + + /// 获取周开始日期 + DateTime _getWeekStart(DateTime date) { + final weekday = date.weekday; + return date.subtract(Duration(days: weekday - 1)); + } + + /// 格式化日期键 + String _formatDateKey(DateTime date) { + return '${date.year}-${date.month.toString().padLeft(2, '0')}-${date.day.toString().padLeft(2, '0')}'; + } + + /// 保存统计数据到本地 + Future _saveStatsToLocal(LearningStats stats) async { + await _storageService.setString(_statsKey, json.encode(stats.toJson())); + } + + /// 保存成就到本地 + Future _saveAchievementsToLocal(List achievements) async { + final jsonList = achievements.map((achievement) => achievement.toJson()).toList(); + await _storageService.setString(_achievementsKey, json.encode(jsonList)); + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/services/study_plan_service.dart b/client/lib/features/vocabulary/services/study_plan_service.dart new file mode 100644 index 0000000..d4e81d4 --- /dev/null +++ b/client/lib/features/vocabulary/services/study_plan_service.dart @@ -0,0 +1,442 @@ +import 'dart:convert'; +import '../../../core/network/api_client.dart'; +import '../../../core/services/storage_service.dart'; +import '../models/study_plan_model.dart'; +import '../models/vocabulary_book_model.dart'; + +/// 学习计划服务 +class StudyPlanService { + final ApiClient _apiClient; + final StorageService _storageService; + + static const String _studyPlansKey = 'study_plans'; + static const String _dailyRecordsKey = 'daily_study_records'; + static const String _templatesKey = 'study_plan_templates'; + + StudyPlanService({ + required ApiClient apiClient, + required StorageService storageService, + }) : _apiClient = apiClient, + _storageService = storageService; + + /// 获取用户的所有学习计划 + Future> getUserStudyPlans() async { + try { + final localData = await _storageService.getString(_studyPlansKey); + if (localData != null) { + final List jsonList = json.decode(localData); + return jsonList.map((json) => StudyPlan.fromJson(json)).toList(); + } + return []; + } catch (e) { + throw Exception('获取学习计划失败: $e'); + } + } + + /// 创建新的学习计划 + Future createStudyPlan({ + required String name, + String? description, + required StudyPlanType type, + required DateTime startDate, + required DateTime endDate, + required int dailyTarget, + List vocabularyBookIds = const [], + }) async { + try { + final studyPlan = StudyPlan( + id: DateTime.now().millisecondsSinceEpoch.toString(), + name: name, + description: description, + userId: 'current_user', + type: type, + status: StudyPlanStatus.active, + startDate: startDate, + endDate: endDate, + dailyTarget: dailyTarget, + vocabularyBookIds: vocabularyBookIds, + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ); + + final existingPlans = await getUserStudyPlans(); + existingPlans.add(studyPlan); + await _saveStudyPlansToLocal(existingPlans); + + return studyPlan; + } catch (e) { + throw Exception('创建学习计划失败: $e'); + } + } + + /// 更新学习计划 + Future updateStudyPlan(StudyPlan studyPlan) async { + try { + final existingPlans = await getUserStudyPlans(); + final index = existingPlans.indexWhere((plan) => plan.id == studyPlan.id); + + if (index == -1) { + throw Exception('学习计划不存在'); + } + + final updatedPlan = studyPlan.copyWith(updatedAt: DateTime.now()); + existingPlans[index] = updatedPlan; + await _saveStudyPlansToLocal(existingPlans); + + return updatedPlan; + } catch (e) { + throw Exception('更新学习计划失败: $e'); + } + } + + /// 删除学习计划 + Future deleteStudyPlan(String planId) async { + try { + final existingPlans = await getUserStudyPlans(); + existingPlans.removeWhere((plan) => plan.id == planId); + await _saveStudyPlansToLocal(existingPlans); + } catch (e) { + throw Exception('删除学习计划失败: $e'); + } + } + + /// 记录每日学习进度 + Future recordDailyProgress({ + required String planId, + required DateTime date, + required int wordsLearned, + required int wordsReviewed, + required int studyTimeMinutes, + List vocabularyBookIds = const [], + }) async { + try { + final record = DailyStudyRecord( + date: DateTime(date.year, date.month, date.day), + wordsLearned: wordsLearned, + wordsReviewed: wordsReviewed, + studyTimeMinutes: studyTimeMinutes, + vocabularyBookIds: vocabularyBookIds, + ); + + // 获取现有记录 + final allRecords = await _getAllDailyRecords(); + final recordKey = '${planId}_${_formatDateKey(date)}'; + + // 更新或添加记录 + allRecords[recordKey] = record; + await _saveDailyRecordsToLocal(allRecords); + + // 更新学习计划的进度 + await _updateStudyPlanProgress(planId); + } catch (e) { + throw Exception('记录学习进度失败: $e'); + } + } + + /// 获取学习计划统计信息 + Future getStudyPlanStats(String planId) async { + try { + final studyPlans = await getUserStudyPlans(); + final studyPlan = studyPlans.where((plan) => plan.id == planId).firstOrNull; + + if (studyPlan == null) { + throw Exception('学习计划不存在'); + } + + final allRecords = await _getAllDailyRecords(); + final planRecords = []; + + // 获取该计划的所有记录 + for (final entry in allRecords.entries) { + if (entry.key.startsWith('${planId}_')) { + planRecords.add(entry.value); + } + } + + // 计算统计信息 + final totalDays = studyPlan.endDate.difference(studyPlan.startDate).inDays + 1; + final studiedDays = planRecords.length; + final totalWordsLearned = planRecords.fold(0, (sum, record) => sum + record.wordsLearned); + final totalWordsReviewed = planRecords.fold(0, (sum, record) => sum + record.wordsReviewed); + + // 计算连续学习天数 + final currentStreak = _calculateCurrentStreak(planRecords); + final maxStreak = _calculateMaxStreak(planRecords); + + final completionRate = studyPlan.totalWords > 0 + ? studyPlan.completedWords / studyPlan.totalWords + : 0.0; + + final averageDailyWords = studiedDays > 0 + ? totalWordsLearned / studiedDays + : 0.0; + + final remainingDays = studyPlan.endDate.difference(DateTime.now()).inDays; + final remainingWords = studyPlan.totalWords - studyPlan.completedWords; + + final lastStudyDate = planRecords.isNotEmpty + ? planRecords.map((r) => r.date).reduce((a, b) => a.isAfter(b) ? a : b) + : null; + + return StudyPlanStats( + planId: planId, + totalDays: totalDays, + studiedDays: studiedDays, + totalWords: studyPlan.totalWords, + learnedWords: totalWordsLearned, + reviewedWords: totalWordsReviewed, + currentStreak: currentStreak, + maxStreak: maxStreak, + completionRate: completionRate, + averageDailyWords: averageDailyWords, + remainingDays: remainingDays > 0 ? remainingDays : 0, + remainingWords: remainingWords > 0 ? remainingWords : 0, + lastStudyDate: lastStudyDate, + dailyRecords: planRecords, + ); + } catch (e) { + throw Exception('获取学习计划统计失败: $e'); + } + } + + /// 获取今日学习任务 + Future> getTodayStudyTasks() async { + try { + final allPlans = await getUserStudyPlans(); + final today = DateTime.now(); + + return allPlans.where((plan) { + return plan.status == StudyPlanStatus.active && + plan.startDate.isBefore(today.add(const Duration(days: 1))) && + plan.endDate.isAfter(today.subtract(const Duration(days: 1))); + }).toList(); + } catch (e) { + throw Exception('获取今日学习任务失败: $e'); + } + } + + /// 检查今日是否完成目标 + Future isTodayTargetAchieved(String planId) async { + try { + final today = DateTime.now(); + final allRecords = await _getAllDailyRecords(); + final recordKey = '${planId}_${_formatDateKey(today)}'; + + final todayRecord = allRecords[recordKey]; + if (todayRecord == null) return false; + + final studyPlans = await getUserStudyPlans(); + final studyPlan = studyPlans.where((plan) => plan.id == planId).firstOrNull; + + if (studyPlan == null) return false; + + return todayRecord.wordsLearned >= studyPlan.dailyTarget; + } catch (e) { + return false; + } + } + + /// 获取学习计划模板 + Future> getStudyPlanTemplates() async { + try { + // 返回预设的学习计划模板 + return [ + StudyPlanTemplate( + id: 'daily_basic', + name: '每日基础学习', + description: '每天学习20个新单词，适合初学者', + type: StudyPlanType.daily, + durationDays: 30, + dailyTarget: 20, + difficulty: 1, + tags: ['基础', '初学者'], + isPopular: true, + ), + StudyPlanTemplate( + id: 'weekly_intensive', + name: '周集中学习', + description: '每周集中学习，每天50个单词', + type: StudyPlanType.weekly, + durationDays: 7, + dailyTarget: 50, + difficulty: 3, + tags: ['集中', '高强度'], + ), + StudyPlanTemplate( + id: 'exam_prep_cet4', + name: 'CET-4考试准备', + description: '为大学英语四级考试准备的学习计划', + type: StudyPlanType.examPrep, + durationDays: 60, + dailyTarget: 30, + difficulty: 2, + tags: ['考试', 'CET-4'], + isPopular: true, + ), + StudyPlanTemplate( + id: 'exam_prep_cet6', + name: 'CET-6考试准备', + description: '为大学英语六级考试准备的学习计划', + type: StudyPlanType.examPrep, + durationDays: 90, + dailyTarget: 40, + difficulty: 3, + tags: ['考试', 'CET-6'], + ), + StudyPlanTemplate( + id: 'toefl_prep', + name: 'TOEFL考试准备', + description: '为托福考试准备的高强度学习计划', + type: StudyPlanType.examPrep, + durationDays: 120, + dailyTarget: 60, + difficulty: 4, + tags: ['考试', 'TOEFL', '出国'], + isPopular: true, + ), + ]; + } catch (e) { + throw Exception('获取学习计划模板失败: $e'); + } + } + + /// 从模板创建学习计划 + Future createStudyPlanFromTemplate({ + required StudyPlanTemplate template, + required DateTime startDate, + List vocabularyBookIds = const [], + }) async { + try { + final endDate = startDate.add(Duration(days: template.durationDays - 1)); + + return await createStudyPlan( + name: template.name, + description: template.description, + type: template.type, + startDate: startDate, + endDate: endDate, + dailyTarget: template.dailyTarget, + vocabularyBookIds: vocabularyBookIds, + ); + } catch (e) { + throw Exception('从模板创建学习计划失败: $e'); + } + } + + /// 保存学习计划到本地存储 + Future _saveStudyPlansToLocal(List studyPlans) async { + final jsonList = studyPlans.map((plan) => plan.toJson()).toList(); + await _storageService.setString(_studyPlansKey, json.encode(jsonList)); + } + + /// 保存每日记录到本地存储 + Future _saveDailyRecordsToLocal(Map records) async { + final jsonMap = records.map((key, record) => MapEntry(key, record.toJson())); + await _storageService.setString(_dailyRecordsKey, json.encode(jsonMap)); + } + + /// 获取所有每日记录 + Future> _getAllDailyRecords() async { + final localData = await _storageService.getString(_dailyRecordsKey); + if (localData == null) { + return {}; + } + + final Map jsonMap = json.decode(localData); + return jsonMap.map((key, value) => MapEntry(key, DailyStudyRecord.fromJson(value))); + } + + /// 更新学习计划进度 + Future _updateStudyPlanProgress(String planId) async { + try { + final studyPlans = await getUserStudyPlans(); + final index = studyPlans.indexWhere((plan) => plan.id == planId); + + if (index == -1) return; + + final studyPlan = studyPlans[index]; + final allRecords = await _getAllDailyRecords(); + + // 计算总完成单词数 + int totalCompleted = 0; + for (final entry in allRecords.entries) { + if (entry.key.startsWith('${planId}_')) { + totalCompleted += entry.value.wordsLearned; + } + } + + // 计算连续学习天数 + final planRecords = []; + for (final entry in allRecords.entries) { + if (entry.key.startsWith('${planId}_')) { + planRecords.add(entry.value); + } + } + + final currentStreak = _calculateCurrentStreak(planRecords); + final maxStreak = _calculateMaxStreak(planRecords); + + final updatedPlan = studyPlan.copyWith( + completedWords: totalCompleted, + currentStreak: currentStreak, + maxStreak: maxStreak > studyPlan.maxStreak ? maxStreak : studyPlan.maxStreak, + updatedAt: DateTime.now(), + ); + + studyPlans[index] = updatedPlan; + await _saveStudyPlansToLocal(studyPlans); + } catch (e) { + // 忽略更新错误 + } + } + + /// 计算当前连续学习天数 + int _calculateCurrentStreak(List records) { + if (records.isEmpty) return 0; + + records.sort((a, b) => b.date.compareTo(a.date)); + + int streak = 0; + DateTime currentDate = DateTime.now(); + + for (final record in records) { + final daysDiff = currentDate.difference(record.date).inDays; + + if (daysDiff == streak) { + streak++; + } else { + break; + } + } + + return streak; + } + + /// 计算最大连续学习天数 + int _calculateMaxStreak(List records) { + if (records.isEmpty) return 0; + + records.sort((a, b) => a.date.compareTo(b.date)); + + int maxStreak = 1; + int currentStreak = 1; + + for (int i = 1; i < records.length; i++) { + final daysDiff = records[i].date.difference(records[i - 1].date).inDays; + + if (daysDiff == 1) { + currentStreak++; + maxStreak = maxStreak > currentStreak ? maxStreak : currentStreak; + } else { + currentStreak = 1; + } + } + + return maxStreak; + } + + /// 格式化日期键 + String _formatDateKey(DateTime date) { + return '${date.year}-${date.month.toString().padLeft(2, '0')}-${date.day.toString().padLeft(2, '0')}'; + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/services/test_data_generator.dart b/client/lib/features/vocabulary/services/test_data_generator.dart new file mode 100644 index 0000000..7bebdb9 --- /dev/null +++ b/client/lib/features/vocabulary/services/test_data_generator.dart @@ -0,0 +1,616 @@ +import '../models/word_model.dart'; +import 'dart:math'; + +/// 测试数据生成器 +class TestDataGenerator { + static final Random _random = Random(); + + /// 生成测试单词数据 + static List generateTestWords({int count = 20}) { + final words = []; + final testWordData = _getTestWordData(); + + for (int i = 0; i < min(count, testWordData.length); i++) { + final data = testWordData[i]; + words.add(_createWord(data)); + } + + return words; + } + + /// 创建单词对象 + static Word _createWord(Map data) { + return Word( + id: data['id'], + word: data['word'], + phonetic: data['phonetic'], + audioUrl: data['audioUrl'], + difficulty: data['difficulty'], + frequency: data['frequency'], + definitions: (data['definitions'] as List).map((d) => WordDefinition( + type: d['type'], + definition: d['definition'], + translation: d['translation'], + )).toList(), + examples: (data['examples'] as List).map((e) => WordExample( + sentence: e['sentence'], + translation: e['translation'], + )).toList(), + synonyms: List.from(data['synonyms'] ?? []), + antonyms: List.from(data['antonyms'] ?? []), + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ); + } + + /// 获取测试单词数据 + static List> _getTestWordData() { + return [ + { + 'id': 'test_word_1', + 'word': 'innovation', + 'phonetic': '/ˌɪnəˈveɪʃn/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=innovation&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 8500, + 'definitions': [ + { + 'type': WordType.noun, + 'definition': 'A new method, idea, product, etc.', + 'translation': '创新；革新；新方法', + } + ], + 'examples': [ + { + 'sentence': 'The company is known for its technological innovations.', + 'translation': '这家公司以其技术创新而闻名。', + }, + { + 'sentence': 'Innovation is the key to success in business.', + 'translation': '创新是商业成功的关键。', + } + ], + 'synonyms': ['novelty', 'invention', 'breakthrough'], + 'antonyms': ['tradition', 'convention'], + 'tags': ['business', 'technology', 'CET6'], + }, + { + 'id': 'test_word_2', + 'word': 'persistent', + 'phonetic': '/pərˈsɪstənt/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=persistent&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 7200, + 'definitions': [ + { + 'type': WordType.adjective, + 'definition': 'Continuing firmly or obstinately in a course of action despite difficulty or opposition.', + 'translation': '坚持不懈的；执着的', + } + ], + 'examples': [ + { + 'sentence': 'She is very persistent in pursuing her goals.', + 'translation': '她在追求目标时非常执着。', + }, + { + 'sentence': 'His persistent efforts finally paid off.', + 'translation': '他坚持不懈的努力终于得到了回报。', + } + ], + 'synonyms': ['determined', 'tenacious', 'steadfast'], + 'antonyms': ['inconsistent', 'wavering'], + 'tags': ['character', 'CET4'], + }, + { + 'id': 'test_word_3', + 'word': 'enthusiasm', + 'phonetic': '/ɪnˈθuziæzəm/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=enthusiasm&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 6800, + 'definitions': [ + { + 'type': WordType.noun, + 'definition': 'Intense and eager enjoyment, interest, or approval.', + 'translation': '热情；热忱；热心', + } + ], + 'examples': [ + { + 'sentence': 'She showed great enthusiasm for the project.', + 'translation': '她对这个项目表现出极大的热情。', + }, + { + 'sentence': 'His enthusiasm is contagious.', + 'translation': '他的热情很有感染力。', + } + ], + 'synonyms': ['passion', 'eagerness', 'zeal'], + 'antonyms': ['apathy', 'indifference'], + 'tags': ['emotion', 'CET4'], + }, + { + 'id': 'test_word_4', + 'word': 'collaborate', + 'phonetic': '/kəˈlæbəreɪt/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=collaborate&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 5900, + 'definitions': [ + { + 'type': WordType.verb, + 'definition': 'Work jointly on an activity or project.', + 'translation': '合作；协作', + } + ], + 'examples': [ + { + 'sentence': 'The two companies collaborated on the research project.', + 'translation': '这两家公司在研究项目上进行了合作。', + }, + { + 'sentence': 'We need to collaborate more effectively.', + 'translation': '我们需要更有效地合作。', + } + ], + 'synonyms': ['cooperate', 'work together', 'team up'], + 'antonyms': ['compete', 'oppose'], + 'tags': ['work', 'teamwork', 'CET6'], + }, + { + 'id': 'test_word_5', + 'word': 'efficient', + 'phonetic': '/ɪˈfɪʃnt/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=efficient&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 7500, + 'definitions': [ + { + 'type': WordType.adjective, + 'definition': 'Achieving maximum productivity with minimum wasted effort or expense.', + 'translation': '高效的；效率高的', + } + ], + 'examples': [ + { + 'sentence': 'We need to find a more efficient way to do this.', + 'translation': '我们需要找到一个更高效的方法来做这件事。', + }, + { + 'sentence': 'She is very efficient at her job.', + 'translation': '她工作非常高效。', + } + ], + 'synonyms': ['effective', 'productive', 'competent'], + 'antonyms': ['inefficient', 'wasteful'], + 'tags': ['work', 'productivity', 'CET4'], + }, + { + 'id': 'test_word_6', + 'word': 'analyze', + 'phonetic': '/ˈænəlaɪz/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=analyze&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 8200, + 'definitions': [ + { + 'type': WordType.verb, + 'definition': 'Examine in detail the structure of something.', + 'translation': '分析；分解', + } + ], + 'examples': [ + { + 'sentence': 'We need to analyze the data carefully.', + 'translation': '我们需要仔细分析这些数据。', + }, + { + 'sentence': 'The report analyzes the current market trends.', + 'translation': '这份报告分析了当前的市场趋势。', + } + ], + 'synonyms': ['examine', 'study', 'investigate'], + 'antonyms': ['synthesize', 'combine'], + 'tags': ['research', 'thinking', 'CET4'], + }, + { + 'id': 'test_word_7', + 'word': 'comprehensive', + 'phonetic': '/ˌkɑːmprɪˈhensɪv/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=comprehensive&type=1', + 'difficulty': WordDifficulty.advanced, + 'frequency': 6500, + 'definitions': [ + { + 'type': WordType.adjective, + 'definition': 'Including or dealing with all or nearly all elements or aspects of something.', + 'translation': '综合的；全面的；详尽的', + } + ], + 'examples': [ + { + 'sentence': 'The book provides a comprehensive overview of the subject.', + 'translation': '这本书提供了该主题的全面概述。', + }, + { + 'sentence': 'We need a comprehensive solution to this problem.', + 'translation': '我们需要一个全面的解决方案来解决这个问题。', + } + ], + 'synonyms': ['complete', 'thorough', 'extensive'], + 'antonyms': ['partial', 'incomplete'], + 'tags': ['description', 'CET6'], + }, + { + 'id': 'test_word_8', + 'word': 'demonstrate', + 'phonetic': '/ˈdemənstreɪt/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=demonstrate&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 7800, + 'definitions': [ + { + 'type': WordType.verb, + 'definition': 'Clearly show the existence or truth of something by giving proof or evidence.', + 'translation': '证明；展示；演示', + } + ], + 'examples': [ + { + 'sentence': 'The study demonstrates the effectiveness of the new method.', + 'translation': '这项研究证明了新方法的有效性。', + }, + { + 'sentence': 'Let me demonstrate how to use this tool.', + 'translation': '让我演示一下如何使用这个工具。', + } + ], + 'synonyms': ['show', 'prove', 'illustrate'], + 'antonyms': ['conceal', 'hide'], + 'tags': ['action', 'proof', 'CET4'], + }, + { + 'id': 'test_word_9', + 'word': 'significant', + 'phonetic': '/sɪɡˈnɪfɪkənt/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=significant&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 9200, + 'definitions': [ + { + 'type': WordType.adjective, + 'definition': 'Sufficiently great or important to be worthy of attention.', + 'translation': '重要的；显著的；有意义的', + } + ], + 'examples': [ + { + 'sentence': 'There has been a significant improvement in sales.', + 'translation': '销售额有了显著的提高。', + }, + { + 'sentence': 'This is a significant achievement.', + 'translation': '这是一个重大的成就。', + } + ], + 'synonyms': ['important', 'notable', 'considerable'], + 'antonyms': ['insignificant', 'trivial'], + 'tags': ['importance', 'CET4'], + }, + { + 'id': 'test_word_10', + 'word': 'implement', + 'phonetic': '/ˈɪmplɪment/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=implement&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 6700, + 'definitions': [ + { + 'type': WordType.verb, + 'definition': 'Put a decision or plan into effect.', + 'translation': '实施；执行；实现', + } + ], + 'examples': [ + { + 'sentence': 'The company will implement the new policy next month.', + 'translation': '公司将在下个月实施新政策。', + }, + { + 'sentence': 'We need to implement these changes immediately.', + 'translation': '我们需要立即实施这些变更。', + } + ], + 'synonyms': ['execute', 'carry out', 'apply'], + 'antonyms': ['abandon', 'neglect'], + 'tags': ['action', 'business', 'CET6'], + }, + { + 'id': 'test_word_11', + 'word': 'strategy', + 'phonetic': '/ˈstrætədʒi/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=strategy&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 8900, + 'definitions': [ + { + 'type': WordType.noun, + 'definition': 'A plan of action designed to achieve a long-term or overall aim.', + 'translation': '策略；战略；计划', + } + ], + 'examples': [ + { + 'sentence': 'We need to develop a new marketing strategy.', + 'translation': '我们需要制定一个新的营销策略。', + }, + { + 'sentence': 'The company\'s strategy is to expand into new markets.', + 'translation': '公司的战略是扩展到新市场。', + } + ], + 'synonyms': ['plan', 'approach', 'tactic'], + 'antonyms': [], + 'tags': ['business', 'planning', 'CET6'], + }, + { + 'id': 'test_word_12', + 'word': 'perspective', + 'phonetic': '/pərˈspektɪv/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=perspective&type=1', + 'difficulty': WordDifficulty.advanced, + 'frequency': 7100, + 'definitions': [ + { + 'type': WordType.noun, + 'definition': 'A particular attitude toward or way of regarding something; a point of view.', + 'translation': '观点；视角；看法', + } + ], + 'examples': [ + { + 'sentence': 'We need to look at this from a different perspective.', + 'translation': '我们需要从不同的角度来看待这个问题。', + }, + { + 'sentence': 'The book offers a fresh perspective on the issue.', + 'translation': '这本书对这个问题提供了新的视角。', + } + ], + 'synonyms': ['viewpoint', 'outlook', 'angle'], + 'antonyms': [], + 'tags': ['thinking', 'opinion', 'CET6'], + }, + { + 'id': 'test_word_13', + 'word': 'enhance', + 'phonetic': '/ɪnˈhæns/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=enhance&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 6400, + 'definitions': [ + { + 'type': WordType.verb, + 'definition': 'Intensify, increase, or further improve the quality, value, or extent of.', + 'translation': '提高；增强；改善', + } + ], + 'examples': [ + { + 'sentence': 'This will enhance the quality of our products.', + 'translation': '这将提高我们产品的质量。', + }, + { + 'sentence': 'The new features enhance user experience.', + 'translation': '新功能增强了用户体验。', + } + ], + 'synonyms': ['improve', 'boost', 'strengthen'], + 'antonyms': ['diminish', 'reduce'], + 'tags': ['improvement', 'CET6'], + }, + { + 'id': 'test_word_14', + 'word': 'sustainable', + 'phonetic': '/səˈsteɪnəbl/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=sustainable&type=1', + 'difficulty': WordDifficulty.advanced, + 'frequency': 5800, + 'definitions': [ + { + 'type': WordType.adjective, + 'definition': 'Able to be maintained at a certain rate or level.', + 'translation': '可持续的；能维持的', + } + ], + 'examples': [ + { + 'sentence': 'We need to develop sustainable energy sources.', + 'translation': '我们需要开发可持续的能源。', + }, + { + 'sentence': 'The company is committed to sustainable development.', + 'translation': '公司致力于可持续发展。', + } + ], + 'synonyms': ['viable', 'maintainable', 'renewable'], + 'antonyms': ['unsustainable', 'temporary'], + 'tags': ['environment', 'business', 'IELTS'], + }, + { + 'id': 'test_word_15', + 'word': 'integrate', + 'phonetic': '/ˈɪntɪɡreɪt/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=integrate&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 6900, + 'definitions': [ + { + 'type': WordType.verb, + 'definition': 'Combine one thing with another to form a whole.', + 'translation': '整合；使结合；使一体化', + } + ], + 'examples': [ + { + 'sentence': 'We need to integrate the new system with the existing one.', + 'translation': '我们需要将新系统与现有系统整合。', + }, + { + 'sentence': 'The program integrates various learning methods.', + 'translation': '该程序整合了各种学习方法。', + } + ], + 'synonyms': ['combine', 'merge', 'unify'], + 'antonyms': ['separate', 'divide'], + 'tags': ['combination', 'technology', 'CET6'], + }, + { + 'id': 'test_word_16', + 'word': 'facilitate', + 'phonetic': '/fəˈsɪlɪteɪt/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=facilitate&type=1', + 'difficulty': WordDifficulty.advanced, + 'frequency': 5500, + 'definitions': [ + { + 'type': WordType.verb, + 'definition': 'Make an action or process easy or easier.', + 'translation': '促进；使便利；使容易', + } + ], + 'examples': [ + { + 'sentence': 'Technology can facilitate communication.', + 'translation': '技术可以促进沟通。', + }, + { + 'sentence': 'The new software facilitates data analysis.', + 'translation': '新软件使数据分析变得更容易。', + } + ], + 'synonyms': ['enable', 'assist', 'help'], + 'antonyms': ['hinder', 'obstruct'], + 'tags': ['action', 'help', 'CET6'], + }, + { + 'id': 'test_word_17', + 'word': 'objective', + 'phonetic': '/əbˈdʒektɪv/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=objective&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 7600, + 'definitions': [ + { + 'type': WordType.noun, + 'definition': 'A thing aimed at or sought; a goal.', + 'translation': '目标；目的', + }, + { + 'type': WordType.adjective, + 'definition': 'Not influenced by personal feelings or opinions.', + 'translation': '客观的；不带偏见的', + } + ], + 'examples': [ + { + 'sentence': 'Our main objective is to improve customer satisfaction.', + 'translation': '我们的主要目标是提高客户满意度。', + }, + { + 'sentence': 'Try to be objective when making decisions.', + 'translation': '做决定时要尽量客观。', + } + ], + 'synonyms': ['goal', 'aim', 'target', 'impartial'], + 'antonyms': ['subjective', 'biased'], + 'tags': ['goal', 'thinking', 'CET4'], + }, + { + 'id': 'test_word_18', + 'word': 'diverse', + 'phonetic': '/daɪˈvɜːrs/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=diverse&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 6300, + 'definitions': [ + { + 'type': WordType.adjective, + 'definition': 'Showing a great deal of variety; very different.', + 'translation': '多样的；不同的；各种各样的', + } + ], + 'examples': [ + { + 'sentence': 'The city has a diverse population.', + 'translation': '这个城市有多样化的人口。', + }, + { + 'sentence': 'We offer a diverse range of products.', + 'translation': '我们提供各种各样的产品。', + } + ], + 'synonyms': ['varied', 'different', 'assorted'], + 'antonyms': ['uniform', 'similar'], + 'tags': ['variety', 'difference', 'CET6'], + }, + { + 'id': 'test_word_19', + 'word': 'fundamental', + 'phonetic': '/ˌfʌndəˈmentl/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=fundamental&type=1', + 'difficulty': WordDifficulty.advanced, + 'frequency': 7400, + 'definitions': [ + { + 'type': WordType.adjective, + 'definition': 'Forming a necessary base or core; of central importance.', + 'translation': '基本的；根本的；重要的', + } + ], + 'examples': [ + { + 'sentence': 'Education is fundamental to success.', + 'translation': '教育是成功的基础。', + }, + { + 'sentence': 'There are fundamental differences between the two approaches.', + 'translation': '这两种方法之间存在根本性的差异。', + } + ], + 'synonyms': ['basic', 'essential', 'primary'], + 'antonyms': ['secondary', 'superficial'], + 'tags': ['importance', 'basic', 'CET6'], + }, + { + 'id': 'test_word_20', + 'word': 'accomplish', + 'phonetic': '/əˈkɑːmplɪʃ/', + 'audioUrl': 'https://dict.youdao.com/dictvoice?audio=accomplish&type=1', + 'difficulty': WordDifficulty.intermediate, + 'frequency': 6100, + 'definitions': [ + { + 'type': WordType.verb, + 'definition': 'Achieve or complete successfully.', + 'translation': '完成；实现；达到', + } + ], + 'examples': [ + { + 'sentence': 'We accomplished our goal ahead of schedule.', + 'translation': '我们提前完成了目标。', + }, + { + 'sentence': 'She has accomplished a great deal in her career.', + 'translation': '她在职业生涯中取得了很大成就。', + } + ], + 'synonyms': ['achieve', 'complete', 'fulfill'], + 'antonyms': ['fail', 'abandon'], + 'tags': ['achievement', 'success', 'CET4'], + }, + ]; + } +} diff --git a/client/lib/features/vocabulary/services/vocabulary_data_service.dart b/client/lib/features/vocabulary/services/vocabulary_data_service.dart new file mode 100644 index 0000000..21cc841 --- /dev/null +++ b/client/lib/features/vocabulary/services/vocabulary_data_service.dart @@ -0,0 +1,368 @@ +import '../models/vocabulary_book_model.dart'; +import '../models/vocabulary_book_category.dart'; + +/// 词汇书数据服务 +class VocabularyDataService { + /// 获取模拟的词汇书数据（根据分类） + static List getVocabularyBooksByCategory(VocabularyBookMainCategory category) { + final baseTime = DateTime.now(); + + switch (category) { + case VocabularyBookMainCategory.academicStage: + return [ + _createVocabularyBook( + id: 'primary_core_1000', + name: '小学英语核心词汇', + description: '小学阶段必备的1000个核心词汇，涵盖日常生活场景', + totalWords: 1000, + tags: ['小学', '基础', '日常用语'], + difficulty: VocabularyBookDifficulty.beginner, + category: category, + ), + _createVocabularyBook( + id: 'junior_high_1500', + name: '初中英语词汇', + description: '初中阶段1500-2500词汇，结合教材要求', + totalWords: 1500, + tags: ['初中', '教材', '基础'], + difficulty: VocabularyBookDifficulty.beginner, + category: category, + ), + _createVocabularyBook( + id: 'senior_high_3500', + name: '高中英语词汇', + description: '高中阶段2500-3500词汇，涵盖课标与高考高频词', + totalWords: 3500, + tags: ['高中', '高考', '课标'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + _createVocabularyBook( + id: 'college_textbook', + name: '大学英语教材词汇', + description: '大学英语精读/泛读配套词汇', + totalWords: 2000, + tags: ['大学', '教材', '精读'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + ]; + + case VocabularyBookMainCategory.domesticTest: + return [ + _createVocabularyBook( + id: 'cet4_vocabulary', + name: '大学四级词汇(CET-4)', + description: '大学英语四级考试核心词汇', + totalWords: 4500, + tags: ['四级', 'CET-4', '考试'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + _createVocabularyBook( + id: 'cet6_vocabulary', + name: '大学六级词汇(CET-6)', + description: '大学英语六级考试核心词汇', + totalWords: 5500, + tags: ['六级', 'CET-6', '考试'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + _createVocabularyBook( + id: 'postgraduate_vocabulary', + name: '考研英语核心词汇', + description: '考研英语必备核心词汇', + totalWords: 5500, + tags: ['考研', '研究生', '核心词汇'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'tem4_vocabulary', + name: '专四词汇(TEM-4)', + description: '英语专业四级考试词汇', + totalWords: 8000, + tags: ['专四', 'TEM-4', '英语专业'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'tem8_vocabulary', + name: '专八词汇(TEM-8)', + description: '英语专业八级考试词汇', + totalWords: 12000, + tags: ['专八', 'TEM-8', '英语专业'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + ]; + + case VocabularyBookMainCategory.internationalTest: + return [ + _createVocabularyBook( + id: 'ielts_academic', + name: '雅思学术词汇(IELTS Academic)', + description: '雅思学术类考试核心词汇', + totalWords: 8000, + tags: ['雅思', 'IELTS', '学术类'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'ielts_general', + name: '雅思通用词汇(IELTS General)', + description: '雅思通用类考试核心词汇', + totalWords: 6000, + tags: ['雅思', 'IELTS', '通用类'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + _createVocabularyBook( + id: 'toefl_ibt', + name: '托福词汇(TOEFL iBT)', + description: '托福网考核心词汇', + totalWords: 10000, + tags: ['托福', 'TOEFL', 'iBT'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'toeic_vocabulary', + name: '托业词汇(TOEIC)', + description: '托业考试职场应用词汇', + totalWords: 6000, + tags: ['托业', 'TOEIC', '职场'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + _createVocabularyBook( + id: 'gre_vocabulary', + name: 'GRE词汇', + description: 'GRE学术/研究生申请词汇', + totalWords: 15000, + tags: ['GRE', '研究生', '学术'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'gmat_vocabulary', + name: 'GMAT词汇', + description: 'GMAT商科/管理类研究生词汇', + totalWords: 8000, + tags: ['GMAT', '商科', '管理'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'sat_vocabulary', + name: 'SAT词汇', + description: 'SAT美本申请词汇', + totalWords: 5000, + tags: ['SAT', '美本', '申请'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + ]; + + case VocabularyBookMainCategory.professional: + return [ + _createVocabularyBook( + id: 'bec_preliminary', + name: '商务英语初级(BEC Preliminary)', + description: 'BEC初级商务英语词汇', + totalWords: 3000, + tags: ['BEC', '商务', '初级'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + _createVocabularyBook( + id: 'bec_vantage', + name: '商务英语中级(BEC Vantage)', + description: 'BEC中级商务英语词汇', + totalWords: 4000, + tags: ['BEC', '商务', '中级'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + _createVocabularyBook( + id: 'bec_higher', + name: '商务英语高级(BEC Higher)', + description: 'BEC高级商务英语词汇', + totalWords: 5000, + tags: ['BEC', '商务', '高级'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'mba_finance', + name: 'MBA/金融词汇', + description: 'MBA、金融、会计、经济学专业词汇', + totalWords: 6000, + tags: ['MBA', '金融', '会计'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'medical_english', + name: '医学英语词汇', + description: '医学专业英语词汇', + totalWords: 8000, + tags: ['医学', '专业', '医疗'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'legal_english', + name: '法律英语词汇', + description: '法律专业英语词汇', + totalWords: 5000, + tags: ['法律', '专业', '司法'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'it_engineering', + name: '工程与IT英语', + description: '计算机科学、人工智能、软件工程词汇', + totalWords: 4000, + tags: ['IT', '工程', '计算机'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + _createVocabularyBook( + id: 'academic_english', + name: '学术英语(EAP)', + description: '学术英语写作/阅读/科研常用词汇', + totalWords: 6000, + tags: ['学术', 'EAP', '科研'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + ]; + + case VocabularyBookMainCategory.functional: + return [ + _createVocabularyBook( + id: 'word_roots_affixes', + name: '词根词缀词汇', + description: '帮助记忆与扩展的词根词缀词汇', + totalWords: 3000, + tags: ['词根', '词缀', '记忆'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + _createVocabularyBook( + id: 'synonyms_antonyms', + name: '同义词/反义词库', + description: '同义词、反义词、近义搭配库', + totalWords: 2500, + tags: ['同义词', '反义词', '搭配'], + difficulty: VocabularyBookDifficulty.intermediate, + category: category, + ), + _createVocabularyBook( + id: 'daily_spoken_collocations', + name: '日常口语搭配库', + description: '日常口语常用搭配库', + totalWords: 1500, + tags: ['口语', '搭配', '日常'], + difficulty: VocabularyBookDifficulty.beginner, + category: category, + ), + _createVocabularyBook( + id: 'academic_spoken_collocations', + name: '学术口语搭配库', + description: '学术口语常用搭配库', + totalWords: 2000, + tags: ['学术', '口语', '搭配'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'academic_writing_collocations', + name: '学术写作搭配库', + description: '学术写作常用搭配库(Collocations)', + totalWords: 2500, + tags: ['学术', '写作', '搭配'], + difficulty: VocabularyBookDifficulty.advanced, + category: category, + ), + _createVocabularyBook( + id: 'daily_life_english', + name: '日常生活英语', + description: '旅游、点餐、购物、出行、租房等日常生活英语', + totalWords: 2000, + tags: ['日常', '生活', '实用'], + difficulty: VocabularyBookDifficulty.beginner, + category: category, + ), + ]; + } + } + + /// 创建词汇书的辅助方法 + static VocabularyBook _createVocabularyBook({ + required String id, + required String name, + required String description, + required int totalWords, + required List tags, + required VocabularyBookDifficulty difficulty, + required VocabularyBookMainCategory category, + }) { + final coverImages = [ + 'https://images.unsplash.com/photo-1503676260728-1c00da094a0b?w=300', + 'https://images.unsplash.com/photo-1481627834876-b7833e8f5570?w=300', + 'https://images.unsplash.com/photo-1434030216411-0b793f4b4173?w=300', + 'https://images.unsplash.com/photo-1507003211169-0a1dd7228f2d?w=300', + 'https://images.unsplash.com/photo-1456513080510-7bf3a84b82f8?w=300', + ]; + + return VocabularyBook( + id: id, + name: name, + description: description, + type: VocabularyBookType.system, + difficulty: difficulty, + coverImageUrl: coverImages[id.hashCode % coverImages.length], + totalWords: totalWords, + isPublic: true, + tags: tags, + mainCategory: category, + targetLevels: _getTargetLevels(category), + estimatedDays: (totalWords / 20).ceil(), + dailyWordCount: 20, + downloadCount: (totalWords * 0.3).round(), + rating: 4.2 + (id.hashCode % 8) * 0.1, + reviewCount: 50 + (id.hashCode % 200), + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ); + } + + /// 根据分类获取目标等级 + static List _getTargetLevels(VocabularyBookMainCategory category) { + switch (category) { + case VocabularyBookMainCategory.academicStage: + return ['小学', '初中', '高中', '大学']; + case VocabularyBookMainCategory.domesticTest: + return ['大学', '研究生']; + case VocabularyBookMainCategory.internationalTest: + return ['大学', '研究生', '出国']; + case VocabularyBookMainCategory.professional: + return ['职场', '专业']; + case VocabularyBookMainCategory.functional: + return ['通用']; + } + } + + /// 获取推荐词汇书（首页显示） + static List getRecommendedVocabularyBooks() { + final recommended = []; + for (final category in VocabularyBookMainCategory.values) { + final categoryBooks = getVocabularyBooksByCategory(category).take(2); + recommended.addAll(categoryBooks); + } + return recommended; + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/services/vocabulary_service.dart b/client/lib/features/vocabulary/services/vocabulary_service.dart new file mode 100644 index 0000000..2974038 --- /dev/null +++ b/client/lib/features/vocabulary/services/vocabulary_service.dart @@ -0,0 +1,746 @@ +import 'dart:math'; +import '../models/word_model.dart'; +import '../models/vocabulary_book_model.dart'; +import '../models/study_session_model.dart'; +import '../models/daily_stats_model.dart'; +import '../../../core/network/api_client.dart'; +import '../../../core/services/storage_service.dart'; +import '../../../core/services/enhanced_api_service.dart'; +import '../../../core/models/api_response.dart'; + +/// 单词学习服务 +class VocabularyService { + final ApiClient _apiClient; + final StorageService _storageService; + final EnhancedApiService _enhancedApiService = EnhancedApiService(); + final Random _random = Random(); + + VocabularyService({ + required ApiClient apiClient, + required StorageService storageService, + }) : _apiClient = apiClient, + _storageService = storageService; + + // 缓存时长配置 + static const Duration _shortCacheDuration = Duration(minutes: 5); + static const Duration _longCacheDuration = Duration(hours: 1); + + // ==================== 词汇书相关 ==================== + + /// 获取系统词汇书列表 + Future> getSystemVocabularyBooks({ + VocabularyBookDifficulty? difficulty, + String? category, + int page = 1, + int limit = 20, + }) async { + try { + final response = await _enhancedApiService.get>( + '/vocabulary/books/system', + queryParameters: { + if (difficulty != null) 'difficulty': difficulty.name, + if (category != null) 'category': category, + 'page': page, + 'limit': limit, + }, + cacheDuration: Duration.zero, // 暂时禁用缓存，避免旧数据解析错误 + fromJson: (data) { + // 处理分页响应结构: data.items + final responseData = data['data']; + final List list = responseData is Map + ? (responseData['items'] ?? []) + : (data['data'] ?? []); + return list.map((json) => VocabularyBook.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取系统词汇书失败: $e'); + } + } + + /// 获取词汇书分类列表 + Future>> getVocabularyBookCategories() async { + try { + final response = await _enhancedApiService.get>>( + '/vocabulary/books/categories', + cacheDuration: _longCacheDuration, + fromJson: (data) { + final List list = data['data'] ?? []; + return list.map((item) => item as Map).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取词汇书分类失败: $e'); + } + } + + /// 获取用户词汇书列表 + Future> getUserVocabularyBooks() async { + try { + final response = await _enhancedApiService.get>( + '/vocabulary/books/user', + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final List list = data['data'] ?? []; + return list.map((json) => VocabularyBook.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取用户词汇书失败: $e'); + } + } + + /// 获取词汇书详情 + Future getVocabularyBookDetail(String bookId) async { + try { + final response = await _enhancedApiService.get( + '/vocabulary/books/$bookId', + cacheDuration: _longCacheDuration, + fromJson: (data) => VocabularyBook.fromJson(data['data']), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取词汇书详情失败: $e'); + } + } + + /// 获取词汇书单词列表 + Future> getVocabularyBookWords( + String bookId, { + int page = 1, + int limit = 50, + }) async { + try { + final response = await _enhancedApiService.get>( + '/vocabulary/books/$bookId/words', + queryParameters: { + 'page': page, + 'limit': limit, + }, + cacheDuration: Duration.zero, // 暂时禁用缓存 + fromJson: (data) { + // 处理分页响应结构: data.items + final responseData = data['data']; + final List list = responseData is Map + ? (responseData['items'] ?? []) + : (data['data'] ?? []); + return list.map((json) => VocabularyBookWord.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取词汇书单词失败: $e'); + } + } + + /// 获取用户在某词汇书中的学习进度（后端API优先，失败时兜底为0） + Future getVocabularyBookProgress( + String bookId, { + bool forceRefresh = false, // 是否强制刷新（跳过缓存） + }) async { + try { + final response = await _enhancedApiService.get( + '/vocabulary/books/$bookId/progress', + cacheDuration: forceRefresh ? Duration.zero : _shortCacheDuration, + fromJson: (data) => UserVocabularyBookProgress.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + // 当后端暂未提供词书进度接口时，返回一个默认的进度对象，避免前端崩溃 + final now = DateTime.now(); + return UserVocabularyBookProgress( + id: 'progress_$bookId', + userId: 'current_user', + vocabularyBookId: bookId, + learnedWords: 0, + masteredWords: 0, + progressPercentage: 0.0, + streakDays: 0, + totalStudyDays: 0, + averageDailyWords: 0.0, + estimatedCompletionDate: null, + isCompleted: false, + completedAt: null, + startedAt: now, + lastStudiedAt: now, + ); + } + } + + /// 添加词汇书到用户库 + Future addVocabularyBookToUser(String bookId) async { + try { + await _apiClient.post('/vocabulary/books/$bookId/add'); + } catch (e) { + throw Exception('添加词汇书失败: $e'); + } + } + + /// 创建自定义词汇书 + Future createCustomVocabularyBook({ + required String name, + String? description, + List wordIds = const [], + }) async { + try { + final response = await _apiClient.post( + '/vocabulary/books/custom', + data: { + 'name': name, + 'description': description, + 'wordIds': wordIds, + }, + ); + + return VocabularyBook.fromJson(response.data['data']); + } catch (e) { + throw Exception('创建词汇书失败: $e'); + } + } + + // ==================== 单词相关 ==================== + + /// 搜索单词 + Future> searchWords( + String query, { + int page = 1, + int limit = 20, + }) async { + try { + final response = await _apiClient.get( + '/vocabulary/words/search', + queryParameters: { + 'q': query, + 'page': page, + 'limit': limit, + }, + ); + + final List data = response.data['data'] ?? []; + return data.map((json) => Word.fromJson(json)).toList(); + } catch (e) { + throw Exception('搜索单词失败: $e'); + } + } + + /// 获取单词详情 + Future getWordDetail(String wordId) async { + try { + final response = await _apiClient.get('/vocabulary/words/$wordId'); + return Word.fromJson(response.data['data']); + } catch (e) { + throw Exception('获取单词详情失败: $e'); + } + } + + /// 获取用户单词学习进度 + Future getUserWordProgress(String wordId) async { + try { + final response = await _apiClient.get('/vocabulary/words/$wordId/progress'); + final data = response.data['data']; + return data != null ? UserWordProgress.fromJson(data) : null; + } catch (e) { + throw Exception('获取单词学习进度失败: $e'); + } + } + + /// 更新用户单词学习进度 + Future updateUserWordProgress({ + required String wordId, + required LearningStatus status, + required bool isCorrect, + int responseTime = 0, + }) async { + try { + final response = await _apiClient.put( + '/vocabulary/words/$wordId/progress', + data: { + 'status': status.name, + 'isCorrect': isCorrect, + 'responseTime': responseTime, + }, + ); + + return UserWordProgress.fromJson(response.data['data']); + } catch (e) { + throw Exception('更新单词学习进度失败: $e'); + } + } + + // ==================== 学习会话相关 ==================== + + /// 开始学习会话 + Future startStudySession({ + String? vocabularyBookId, + required StudyMode mode, + required int targetWordCount, + }) async { + try { + final response = await _apiClient.post( + '/vocabulary/study/sessions', + data: { + 'vocabularyBookId': vocabularyBookId, + 'mode': mode.name, + 'targetWordCount': targetWordCount, + }, + ); + + return StudySession.fromJson(response.data['data']); + } catch (e) { + throw Exception('开始学习会话失败: $e'); + } + } + + /// 结束学习会话 + Future endStudySession( + String sessionId, { + required int durationSeconds, + required List exercises, + }) async { + try { + final response = await _apiClient.put( + '/vocabulary/study/sessions/$sessionId/end', + data: { + 'durationSeconds': durationSeconds, + 'exercises': exercises.map((e) => e.toJson()).toList(), + }, + ); + + return StudySession.fromJson(response.data['data']); + } catch (e) { + throw Exception('结束学习会话失败: $e'); + } + } + + /// 获取学习会话历史 + Future> getStudySessionHistory({ + int page = 1, + int limit = 20, + DateTime? startDate, + DateTime? endDate, + }) async { + try { + final response = await _apiClient.get( + '/vocabulary/study/sessions', + queryParameters: { + 'page': page, + 'limit': limit, + if (startDate != null) 'startDate': startDate.toIso8601String(), + if (endDate != null) 'endDate': endDate.toIso8601String(), + }, + ); + + final List data = response.data['data'] ?? []; + return data.map((json) => StudySession.fromJson(json)).toList(); + } catch (e) { + throw Exception('获取学习会话历史失败: $e'); + } + } + + // ==================== 学习统计相关 ==================== + + /// 获取学习统计 + Future getStudyStatistics(DateTime date) async { + try { + final response = await _apiClient.get( + '/vocabulary/study/statistics', + queryParameters: { + 'date': date.toIso8601String().split('T')[0], + }, + ); + + return StudyStatistics.fromJson(response.data['data']); + } catch (e) { + throw Exception('获取学习统计失败: $e'); + } + } + + /// 获取每日词汇统计（wordsLearned、studyTimeMinutes） + Future getDailyVocabularyStats({required String userId}) async { + try { + final response = await _enhancedApiService.get( + '/vocabulary/daily', + queryParameters: { + 'user_id': userId, + }, + useCache: false, + fromJson: (data) => DailyStats.fromJson(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取每日词汇统计失败: $e'); + } + } + + /// 获取用户词汇整体统计（total_studied、accuracy_rate、mastery_stats等） + Future> getUserVocabularyStats() async { + try { + final response = await _enhancedApiService.get>( + '/vocabulary/stats', + fromJson: (data) => Map.from(data['data'] ?? data), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取用户词汇整体统计失败: $e'); + } + } + + /// 获取学习统计历史 + Future> getStudyStatisticsHistory({ + required DateTime startDate, + required DateTime endDate, + }) async { + try { + final response = await _apiClient.get( + '/vocabulary/study/statistics/history', + queryParameters: { + 'startDate': startDate.toIso8601String().split('T')[0], + 'endDate': endDate.toIso8601String().split('T')[0], + }, + ); + + final List data = response.data['data'] ?? []; + return data.map((json) => StudyStatistics.fromJson(json)).toList(); + } catch (e) { + throw Exception('获取学习统计历史失败: $e'); + } + } + + // ==================== 智能学习算法 ==================== + + /// 获取今日需要学习的单词 + Future> getTodayStudyWords({ + String? vocabularyBookId, + int limit = 20, + }) async { + try { + final response = await _apiClient.get( + '/vocabulary/study/today', + queryParameters: { + if (vocabularyBookId != null) 'vocabularyBookId': vocabularyBookId, + 'limit': limit, + }, + ); + + print('=== getTodayStudyWords API响应 ==='); + print('原始响应: ${response.data}'); + print('data字段类型: ${response.data['data'].runtimeType}'); + + // 后端返回的结构是 {"data": {"words": []}} + final responseData = response.data['data']; + + List data; + if (responseData is Map) { + print('responseData是Map，尝试获取words字段'); + final words = responseData['words']; + print('words字段类型: ${words.runtimeType}'); + data = words is List ? words : []; + } else if (responseData is List) { + print('responseData是List，直接使用'); + data = responseData; + } else { + print('responseData类型未知: ${responseData.runtimeType}'); + data = []; + } + + print('最终数据条数: ${data.length}'); + if (data.isNotEmpty) { + print('第一条数据: ${data[0]}'); + } + + return data.map((json) => Word.fromJson(json as Map)).toList(); + } catch (e, stackTrace) { + // API调用失败，返回空列表，让UI显示空状态 + print('getTodayStudyWords API调用失败: $e'); + print('堆栈跟踪: $stackTrace'); + return []; + } + } + + /// 获取需要复习的单词 + Future> getReviewWords({ + String? vocabularyBookId, + int limit = 20, + }) async { + try { + final response = await _apiClient.get( + '/vocabulary/study/review', + queryParameters: { + if (vocabularyBookId != null) 'vocabularyBookId': vocabularyBookId, + 'limit': limit, + }, + ); + + // 后端返回的结构可能是 {"data": {"words": []}} 或 {"data": []} + final responseData = response.data['data']; + final List data = responseData is Map + ? (responseData['words'] ?? []) + : (responseData ?? []); + + print('=== getReviewWords API响应 ==='); + print('数据条数: ${data.length}'); + return data.map((json) => Word.fromJson(json)).toList(); + } catch (e) { + // API调用失败，返回空列表，让UI显示空状态 + print('getReviewWords API调用失败: $e'); + return []; + } + } + + /// 生成单词练习题 + Future> generateWordExercise( + String wordId, + ExerciseType exerciseType, + ) async { + try { + final response = await _apiClient.post( + '/vocabulary/study/exercise', + data: { + 'wordId': wordId, + 'exerciseType': exerciseType.name, + }, + ); + + return response.data['data']; + } catch (e) { + throw Exception('生成练习题失败: $e'); + } + } + + // ==================== 本地缓存相关 ==================== + + /// 缓存词汇书到本地 + Future cacheVocabularyBook(VocabularyBook book) async { + try { + await _storageService.setString( + 'vocabulary_book_${book.id}', + book.toJson().toString(), + ); + } catch (e) { + throw Exception('缓存词汇书失败: $e'); + } + } + + /// 从本地获取缓存的词汇书 + Future getCachedVocabularyBook(String bookId) async { + try { + final cached = await _storageService.getString('vocabulary_book_$bookId'); + if (cached != null) { + // 这里需要实际的JSON解析逻辑 + // return VocabularyBook.fromJson(jsonDecode(cached)); + } + return null; + } catch (e) { + return null; + } + } + + /// 清除本地缓存 + Future clearCache() async { + try { + // 清除所有词汇相关的缓存 + await _storageService.remove('vocabulary_books'); + await _storageService.remove('study_statistics'); + } catch (e) { + throw Exception('清除缓存失败: $e'); + } + } + + // ==================== 工具方法 ==================== + + /// 计算单词熟练度 + int calculateWordProficiency(UserWordProgress progress) { + if (progress.studyCount == 0) return 0; + + final accuracy = progress.accuracy; + final studyCount = progress.studyCount; + final reviewInterval = progress.reviewInterval; + + // 基于准确率、学习次数和复习间隔计算熟练度 + int proficiency = (accuracy * 50).round(); + proficiency += (studyCount * 5).clamp(0, 30); + proficiency += (reviewInterval * 2).clamp(0, 20); + + return proficiency.clamp(0, 100); + } + + /// 计算下次复习时间 + DateTime calculateNextReviewTime(UserWordProgress progress) { + final now = DateTime.now(); + final accuracy = progress.accuracy; + + // 基于准确率调整复习间隔 + int intervalDays = progress.reviewInterval; + + if (accuracy >= 0.9) { + intervalDays = (intervalDays * 2).clamp(1, 30); + } else if (accuracy >= 0.7) { + intervalDays = (intervalDays * 1.5).round().clamp(1, 14); + } else if (accuracy >= 0.5) { + intervalDays = intervalDays.clamp(1, 7); + } else { + intervalDays = 1; + } + + return now.add(Duration(days: intervalDays)); + } + + /// 随机选择练习类型 + ExerciseType getRandomExerciseType() { + final types = ExerciseType.values; + return types[_random.nextInt(types.length)]; + } + + /// 生成干扰选项 + List generateDistractors( + String correctAnswer, + List wordPool, + int count, + ) { + final distractors = []; + final shuffled = List.from(wordPool)..shuffle(_random); + + for (final word in shuffled) { + if (word != correctAnswer && !distractors.contains(word)) { + distractors.add(word); + if (distractors.length >= count) break; + } + } + + return distractors; + } + + // ==================== 本地兜底（无后端时） ==================== + + /// 当后端不可用或接口缺失时，生成基础示例单词（仅用于开发调试） + List _generateSampleWords(int limit) { + final now = DateTime.now(); + final samples = [ + {'w': 'apple', 'cn': '苹果', 'def': 'a round fruit of a tree', 'type': 'noun'}, + {'w': 'run', 'cn': '跑步', 'def': 'move fast by using one’s feet', 'type': 'verb'}, + {'w': 'happy', 'cn': '开心的', 'def': 'feeling or showing pleasure', 'type': 'adjective'}, + {'w': 'quickly', 'cn': '快速地', 'def': 'at a fast speed', 'type': 'adverb'}, + {'w': 'book', 'cn': '书', 'def': 'a written or printed work', 'type': 'noun'}, + {'w': 'study', 'cn': '学习', 'def': 'apply oneself to learning', 'type': 'verb'}, + {'w': 'blue', 'cn': '蓝色的', 'def': 'of the color blue', 'type': 'adjective'}, + {'w': 'slowly', 'cn': '缓慢地', 'def': 'at a slow speed', 'type': 'adverb'}, + {'w': 'friend', 'cn': '朋友', 'def': 'a person you know well', 'type': 'noun'}, + {'w': 'listen', 'cn': '听', 'def': 'give attention to sound', 'type': 'verb'}, + {'w': 'green', 'cn': '绿色的', 'def': 'of the color green', 'type': 'adjective'}, + {'w': 'often', 'cn': '经常', 'def': 'frequently; many times', 'type': 'adverb'}, + {'w': 'school', 'cn': '学校', 'def': 'a place for learning', 'type': 'noun'}, + {'w': 'write', 'cn': '写作', 'def': 'mark letters or words on a surface', 'type': 'verb'}, + {'w': 'smart', 'cn': '聪明的', 'def': 'intelligent or clever', 'type': 'adjective'}, + {'w': 'carefully', 'cn': '小心地', 'def': 'with care or attention', 'type': 'adverb'}, + {'w': 'music', 'cn': '音乐', 'def': 'art of arranging sounds', 'type': 'noun'}, + {'w': 'learn', 'cn': '学习', 'def': 'gain knowledge or skill', 'type': 'verb'}, + {'w': 'bright', 'cn': '明亮的/聪明的', 'def': 'giving much light; intelligent', 'type': 'adjective'}, + {'w': 'rarely', 'cn': '很少', 'def': 'not often; seldom', 'type': 'adverb'}, + ]; + + WordType _parseType(String t) { + switch (t) { + case 'noun': + return WordType.noun; + case 'verb': + return WordType.verb; + case 'adjective': + return WordType.adjective; + case 'adverb': + return WordType.adverb; + default: + return WordType.noun; + } + } + + final list = []; + for (var i = 0; i < samples.length && list.length < limit; i++) { + final s = samples[i]; + list.add( + Word( + id: 'sample_${s['w']}', + word: s['w']!, + definitions: [ + WordDefinition( + type: _parseType(s['type']!), + definition: s['def']!, + translation: s['cn']!, + frequency: 3, + ), + ], + examples: [ + WordExample( + sentence: 'I like ${s['w']}.', + translation: '我喜欢${s['cn']}.', + ), + ], + synonyms: const [], + antonyms: const [], + etymology: null, + difficulty: WordDifficulty.beginner, + frequency: 5, + imageUrl: null, + memoryTip: null, + createdAt: now, + updatedAt: now, + ), + ); + } + return list; + } + + /// 根据ID获取单词详情 + Future getWordById(String wordId) async { + try { + final response = await _apiClient.get('/vocabulary/$wordId'); + final data = response.data['data']; + return Word.fromJson(data); + } catch (e) { + print('获取单词详情失败: $e'); + rethrow; + } + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/services/word_book_service.dart b/client/lib/features/vocabulary/services/word_book_service.dart new file mode 100644 index 0000000..cdbf445 --- /dev/null +++ b/client/lib/features/vocabulary/services/word_book_service.dart @@ -0,0 +1,314 @@ +import 'dart:convert'; +import '../../../core/network/api_client.dart'; +import '../../../core/services/storage_service.dart'; +import '../models/word_book_model.dart'; +import '../models/word_model.dart'; + +/// 生词本服务 +class WordBookService { + final ApiClient _apiClient; + final StorageService _storageService; + + static const String _wordBooksKey = 'word_books'; + static const String _wordBookEntriesKey = 'word_book_entries'; + + WordBookService({ + required ApiClient apiClient, + required StorageService storageService, + }) : _apiClient = apiClient, + _storageService = storageService; + + /// 获取用户的所有生词本 + Future> getUserWordBooks() async { + try { + // 尝试从本地存储获取 + final localData = await _storageService.getString(_wordBooksKey); + if (localData != null) { + final List jsonList = json.decode(localData); + return jsonList.map((json) => WordBook.fromJson(json)).toList(); + } + + // 如果本地没有数据，创建默认生词本 + final defaultWordBook = WordBook( + id: 'default_word_book', + name: '我的生词本', + description: '收藏的生词', + userId: 'current_user', + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ); + + await _saveWordBooksToLocal([defaultWordBook]); + return [defaultWordBook]; + } catch (e) { + throw Exception('获取生词本失败: $e'); + } + } + + /// 创建新的生词本 + Future createWordBook({ + required String name, + String? description, + WordBookType type = WordBookType.personal, + }) async { + try { + final wordBook = WordBook( + id: DateTime.now().millisecondsSinceEpoch.toString(), + name: name, + description: description, + userId: 'current_user', + type: type, + createdAt: DateTime.now(), + updatedAt: DateTime.now(), + ); + + final existingBooks = await getUserWordBooks(); + existingBooks.add(wordBook); + await _saveWordBooksToLocal(existingBooks); + + return wordBook; + } catch (e) { + throw Exception('创建生词本失败: $e'); + } + } + + /// 删除生词本 + Future deleteWordBook(String wordBookId) async { + try { + final existingBooks = await getUserWordBooks(); + existingBooks.removeWhere((book) => book.id == wordBookId); + await _saveWordBooksToLocal(existingBooks); + + // 同时删除该生词本的所有条目 + final entries = await getWordBookEntries(wordBookId); + for (final entry in entries) { + await removeWordFromBook(wordBookId, entry.wordId); + } + } catch (e) { + throw Exception('删除生词本失败: $e'); + } + } + + /// 更新生词本信息 + Future updateWordBook(WordBook wordBook) async { + try { + final existingBooks = await getUserWordBooks(); + final index = existingBooks.indexWhere((book) => book.id == wordBook.id); + + if (index == -1) { + throw Exception('生词本不存在'); + } + + final updatedWordBook = wordBook.copyWith(updatedAt: DateTime.now()); + existingBooks[index] = updatedWordBook; + await _saveWordBooksToLocal(existingBooks); + + return updatedWordBook; + } catch (e) { + throw Exception('更新生词本失败: $e'); + } + } + + /// 添加单词到生词本 + Future addWordToBook({ + required String wordBookId, + required Word word, + String? note, + List tags = const [], + }) async { + try { + // 检查单词是否已存在 + final existingEntries = await getWordBookEntries(wordBookId); + final existingEntry = existingEntries.where((entry) => entry.wordId == word.id).firstOrNull; + + if (existingEntry != null) { + throw Exception('单词已存在于生词本中'); + } + + final entry = WordBookEntry( + id: '${wordBookId}_${word.id}', + wordBookId: wordBookId, + wordId: word.id, + word: word, + note: note, + tags: tags, + addedAt: DateTime.now(), + ); + + existingEntries.add(entry); + await _saveWordBookEntriesToLocal(existingEntries); + + // 更新生词本的单词数量 + await _updateWordBookCount(wordBookId); + + return entry; + } catch (e) { + throw Exception('添加单词到生词本失败: $e'); + } + } + + /// 从生词本移除单词 + Future removeWordFromBook(String wordBookId, String wordId) async { + try { + final existingEntries = await getWordBookEntries(wordBookId); + existingEntries.removeWhere((entry) => + entry.wordBookId == wordBookId && entry.wordId == wordId); + await _saveWordBookEntriesToLocal(existingEntries); + + // 更新生词本的单词数量 + await _updateWordBookCount(wordBookId); + } catch (e) { + throw Exception('从生词本移除单词失败: $e'); + } + } + + /// 获取生词本的所有条目 + Future> getWordBookEntries(String wordBookId) async { + try { + final localData = await _storageService.getString(_wordBookEntriesKey); + if (localData == null) { + return []; + } + + final List jsonList = json.decode(localData); + final allEntries = jsonList.map((json) => WordBookEntry.fromJson(json)).toList(); + + return allEntries.where((entry) => entry.wordBookId == wordBookId).toList(); + } catch (e) { + throw Exception('获取生词本条目失败: $e'); + } + } + + /// 更新生词本条目 + Future updateWordBookEntry(WordBookEntry entry) async { + try { + final allEntries = await _getAllWordBookEntries(); + final index = allEntries.indexWhere((e) => e.id == entry.id); + + if (index == -1) { + throw Exception('生词本条目不存在'); + } + + allEntries[index] = entry; + await _saveWordBookEntriesToLocal(allEntries); + + return entry; + } catch (e) { + throw Exception('更新生词本条目失败: $e'); + } + } + + /// 获取生词本统计信息 + Future getWordBookStats(String wordBookId) async { + try { + final entries = await getWordBookEntries(wordBookId); + + final totalWords = entries.length; + final masteredWords = entries.where((entry) => + entry.reviewCount >= 3 && + entry.correctCount / entry.reviewCount >= 0.8 + ).length; + final reviewingWords = entries.where((entry) => + entry.reviewCount > 0 && entry.reviewCount < 3 + ).length; + final newWords = entries.where((entry) => entry.reviewCount == 0).length; + + final masteryRate = totalWords > 0 ? masteredWords / totalWords : 0.0; + + final lastStudyAt = entries + .where((entry) => entry.lastReviewAt != null) + .map((entry) => entry.lastReviewAt!) + .fold(null, (latest, current) => + latest == null || current.isAfter(latest) ? current : latest); + + return WordBookStats( + wordBookId: wordBookId, + totalWords: totalWords, + masteredWords: masteredWords, + reviewingWords: reviewingWords, + newWords: newWords, + masteryRate: masteryRate, + lastStudyAt: lastStudyAt, + totalReviews: entries.fold(0, (sum, entry) => sum + entry.reviewCount), + ); + } catch (e) { + throw Exception('获取生词本统计失败: $e'); + } + } + + /// 检查单词是否在生词本中 + Future isWordInBook(String wordBookId, String wordId) async { + try { + final entries = await getWordBookEntries(wordBookId); + return entries.any((entry) => entry.wordId == wordId); + } catch (e) { + return false; + } + } + + /// 搜索生词本中的单词 + Future> searchWordsInBook({ + required String wordBookId, + required String query, + }) async { + try { + final entries = await getWordBookEntries(wordBookId); + final lowerQuery = query.toLowerCase(); + + return entries.where((entry) { + final word = entry.word.word.toLowerCase(); + final definitions = entry.word.definitions + .map((def) => def.definition.toLowerCase()) + .join(' '); + final translations = entry.word.definitions + .map((def) => def.translation?.toLowerCase() ?? '') + .join(' '); + + return word.contains(lowerQuery) || + definitions.contains(lowerQuery) || + translations.contains(lowerQuery); + }).toList(); + } catch (e) { + throw Exception('搜索生词本失败: $e'); + } + } + + /// 保存生词本到本地存储 + Future _saveWordBooksToLocal(List wordBooks) async { + final jsonList = wordBooks.map((book) => book.toJson()).toList(); + await _storageService.setString(_wordBooksKey, json.encode(jsonList)); + } + + /// 保存生词本条目到本地存储 + Future _saveWordBookEntriesToLocal(List entries) async { + final jsonList = entries.map((entry) => entry.toJson()).toList(); + await _storageService.setString(_wordBookEntriesKey, json.encode(jsonList)); + } + + /// 获取所有生词本条目 + Future> _getAllWordBookEntries() async { + final localData = await _storageService.getString(_wordBookEntriesKey); + if (localData == null) { + return []; + } + + final List jsonList = json.decode(localData); + return jsonList.map((json) => WordBookEntry.fromJson(json)).toList(); + } + + /// 更新生词本的单词数量 + Future _updateWordBookCount(String wordBookId) async { + final entries = await getWordBookEntries(wordBookId); + final wordBooks = await getUserWordBooks(); + + final index = wordBooks.indexWhere((book) => book.id == wordBookId); + if (index != -1) { + final updatedBook = wordBooks[index].copyWith( + wordCount: entries.length, + updatedAt: DateTime.now(), + ); + wordBooks[index] = updatedBook; + await _saveWordBooksToLocal(wordBooks); + } + } +} \ No newline at end of file diff --git a/client/lib/features/vocabulary/widgets/study_card_widget.dart b/client/lib/features/vocabulary/widgets/study_card_widget.dart new file mode 100644 index 0000000..f99e1c7 --- /dev/null +++ b/client/lib/features/vocabulary/widgets/study_card_widget.dart @@ -0,0 +1,360 @@ +import 'package:flutter/material.dart'; +import 'package:ai_english_learning/features/vocabulary/models/word_model.dart'; +import 'package:ai_english_learning/features/vocabulary/models/learning_session_model.dart'; + +class StudyCardWidget extends StatefulWidget { + final Word word; + final Function(StudyDifficulty) onAnswer; + final VoidCallback? onNext; + + const StudyCardWidget({ + Key? key, + required this.word, + required this.onAnswer, + this.onNext, + }) : super(key: key); + + @override + State createState() => _StudyCardWidgetState(); +} + +class _StudyCardWidgetState extends State + with SingleTickerProviderStateMixin { + bool _showAnswer = false; + late AnimationController _flipController; + late Animation _flipAnimation; + + @override + void initState() { + super.initState(); + _flipController = AnimationController( + duration: const Duration(milliseconds: 300), + vsync: this, + ); + _flipAnimation = Tween(begin: 0, end: 1).animate( + CurvedAnimation(parent: _flipController, curve: Curves.easeInOut), + ); + } + + @override + void dispose() { + _flipController.dispose(); + super.dispose(); + } + + void _toggleAnswer() { + setState(() { + _showAnswer = !_showAnswer; + if (_showAnswer) { + _flipController.forward(); + } else { + _flipController.reverse(); + } + }); + } + + @override + Widget build(BuildContext context) { + return Column( + children: [ + // 卡片主体 + Expanded( + child: GestureDetector( + onTap: _toggleAnswer, + child: AnimatedBuilder( + animation: _flipAnimation, + builder: (context, child) { + final angle = _flipAnimation.value * 3.14159; + final transform = Matrix4.identity() + ..setEntry(3, 2, 0.001) + ..rotateY(angle); + + return Transform( + transform: transform, + alignment: Alignment.center, + child: angle < 1.57 + ? _buildFrontCard() + : Transform( + transform: Matrix4.identity()..rotateY(3.14159), + alignment: Alignment.center, + child: _buildBackCard(), + ), + ); + }, + ), + ), + ), + + const SizedBox(height: 16), + + // 答案按钮 + if (_showAnswer) _buildAnswerButtons(), + + // 提示文本 + if (!_showAnswer) + Padding( + padding: const EdgeInsets.all(16), + child: Text( + '点击卡片查看答案', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ), + ], + ); + } + + Widget _buildFrontCard() { + return Card( + elevation: 8, + shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(16)), + child: Container( + width: double.infinity, + padding: const EdgeInsets.all(32), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + // 单词 + Text( + widget.word.word, + style: const TextStyle( + fontSize: 48, + fontWeight: FontWeight.bold, + ), + textAlign: TextAlign.center, + ), + + const SizedBox(height: 16), + + // 音标 + if (widget.word.phonetic != null) + Text( + widget.word.phonetic!, + style: TextStyle( + fontSize: 18, + color: Colors.grey[600], + ), + ), + + const SizedBox(height: 32), + + // 提示：点击查看释义 + Icon( + Icons.flip, + size: 32, + color: Colors.grey[400], + ), + ], + ), + ), + ); + } + + Widget _buildBackCard() { + return Card( + elevation: 8, + shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(16)), + child: Container( + width: double.infinity, + padding: const EdgeInsets.all(24), + child: SingleChildScrollView( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 单词和音标 + Center( + child: Column( + children: [ + Text( + widget.word.word, + style: const TextStyle( + fontSize: 32, + fontWeight: FontWeight.bold, + ), + ), + if (widget.word.phonetic != null) + Text( + widget.word.phonetic!, + style: TextStyle( + fontSize: 16, + color: Colors.grey[600], + ), + ), + ], + ), + ), + + const SizedBox(height: 24), + const Divider(), + const SizedBox(height: 16), + + // 释义 + if (widget.word.definitions.isNotEmpty) ...[ + const Text( + '释义', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + ...widget.word.definitions.map((def) => Padding( + padding: const EdgeInsets.only(bottom: 8), + child: Text( + '• ${def.translation}', + style: const TextStyle(fontSize: 14), + ), + )), + const SizedBox(height: 16), + ], + + // 例句 + if (widget.word.examples.isNotEmpty) ...[ + const Text( + '例句', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + ...widget.word.examples.take(2).map((example) => Padding( + padding: const EdgeInsets.only(bottom: 12), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + example.sentence, + style: const TextStyle( + fontSize: 14, + fontStyle: FontStyle.italic, + ), + ), + const SizedBox(height: 4), + Text( + example.translation, + style: TextStyle( + fontSize: 13, + color: Colors.grey[700], + ), + ), + ], + ), + )), + ], + ], + ), + ), + ), + ); + } + + Widget _buildAnswerButtons() { + return Padding( + padding: const EdgeInsets.symmetric(horizontal: 16), + child: Column( + children: [ + Row( + children: [ + // 完全忘记 + Expanded( + child: _DifficultyButton( + label: '完全忘记', + icon: Icons.close, + color: Colors.red, + onPressed: () => widget.onAnswer(StudyDifficulty.forgot), + ), + ), + const SizedBox(width: 8), + // 困难 + Expanded( + child: _DifficultyButton( + label: '困难', + icon: Icons.sentiment_dissatisfied, + color: Colors.orange, + onPressed: () => widget.onAnswer(StudyDifficulty.hard), + ), + ), + ], + ), + const SizedBox(height: 8), + Row( + children: [ + // 一般 + Expanded( + child: _DifficultyButton( + label: '一般', + icon: Icons.sentiment_neutral, + color: Colors.blue, + onPressed: () => widget.onAnswer(StudyDifficulty.good), + ), + ), + const SizedBox(width: 8), + // 容易 + Expanded( + child: _DifficultyButton( + label: '容易', + icon: Icons.sentiment_satisfied, + color: Colors.green, + onPressed: () => widget.onAnswer(StudyDifficulty.easy), + ), + ), + const SizedBox(width: 8), + // 完美 + Expanded( + child: _DifficultyButton( + label: '完美', + icon: Icons.sentiment_very_satisfied, + color: Colors.purple, + onPressed: () => widget.onAnswer(StudyDifficulty.perfect), + ), + ), + ], + ), + ], + ), + ); + } +} + +class _DifficultyButton extends StatelessWidget { + final String label; + final IconData icon; + final Color color; + final VoidCallback onPressed; + + const _DifficultyButton({ + required this.label, + required this.icon, + required this.color, + required this.onPressed, + }); + + @override + Widget build(BuildContext context) { + return ElevatedButton( + onPressed: onPressed, + style: ElevatedButton.styleFrom( + backgroundColor: color, + foregroundColor: Colors.white, + padding: const EdgeInsets.symmetric(vertical: 12), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + child: Column( + mainAxisSize: MainAxisSize.min, + children: [ + Icon(icon, size: 20), + const SizedBox(height: 4), + Text( + label, + style: const TextStyle(fontSize: 12), + ), + ], + ), + ); + } +} diff --git a/client/lib/features/writing/data/writing_static_data.dart b/client/lib/features/writing/data/writing_static_data.dart new file mode 100644 index 0000000..a65f155 --- /dev/null +++ b/client/lib/features/writing/data/writing_static_data.dart @@ -0,0 +1,388 @@ +import '../models/writing_task.dart'; + +class WritingStaticData { + static List getAllTasks() { + final regularTasks = [ + // 议论文类型 + WritingTask( + id: 'essay_1', + title: '环境保护的重要性', + description: '写一篇关于环境保护重要性的议论文，阐述个人观点并提供支持论据。', + type: WritingType.essay, + difficulty: WritingDifficulty.intermediate, + timeLimit: 45, + wordLimit: 300, + keywords: ['环境保护', '可持续发展', '气候变化', '绿色生活'], + requirements: [ + '明确表达个人观点', + '提供至少3个支持论据', + '使用恰当的连接词', + '结构清晰，逻辑性强' + ], + prompt: '随着工业化的发展，环境问题日益严重。请就"环境保护的重要性"这一话题写一篇议论文，表达你的观点并提供有力的论据支持。', + createdAt: DateTime.now().subtract(const Duration(days: 7)), + ), + + WritingTask( + id: 'essay_2', + title: '科技对教育的影响', + description: '分析科技发展对现代教育的积极和消极影响。', + type: WritingType.essay, + difficulty: WritingDifficulty.upperIntermediate, + timeLimit: 50, + wordLimit: 400, + keywords: ['科技', '教育', '在线学习', '数字化'], + requirements: [ + '分析积极和消极两方面影响', + '举出具体例子说明', + '使用高级词汇和句型', + '观点平衡，论证充分' + ], + prompt: '科技的快速发展正在改变教育的方式。请分析科技对现代教育的影响，包括积极和消极两个方面。', + createdAt: DateTime.now().subtract(const Duration(days: 5)), + ), + + // 书信类型 + WritingTask( + id: 'letter_1', + title: '给朋友的邀请信', + description: '写一封邀请朋友参加生日聚会的信件。', + type: WritingType.letter, + difficulty: WritingDifficulty.elementary, + timeLimit: 30, + wordLimit: 150, + keywords: ['邀请', '生日聚会', '朋友', '时间地点'], + requirements: [ + '使用正确的书信格式', + '语气友好亲切', + '包含时间、地点等具体信息', + '表达期待之情' + ], + prompt: '你即将举办生日聚会，想邀请你的好朋友Tom参加。请写一封邀请信，包含聚会的时间、地点和活动安排。', + createdAt: DateTime.now().subtract(const Duration(days: 3)), + ), + + WritingTask( + id: 'letter_2', + title: '求职申请信', + description: '写一封应聘市场营销职位的求职信。', + type: WritingType.letter, + difficulty: WritingDifficulty.advanced, + timeLimit: 40, + wordLimit: 250, + keywords: ['求职', '市场营销', '技能', '经验'], + requirements: [ + '使用正式的商务信件格式', + '突出个人优势和相关经验', + '表达对职位的兴趣', + '语言专业得体' + ], + prompt: '你看到一家公司招聘市场营销专员的广告，请写一封求职申请信，介绍你的背景和为什么适合这个职位。', + createdAt: DateTime.now().subtract(const Duration(days: 2)), + ), + + // 邮件类型 + WritingTask( + id: 'email_1', + title: '商务邮件：会议安排', + description: '写一封关于安排部门会议的商务邮件。', + type: WritingType.email, + difficulty: WritingDifficulty.intermediate, + timeLimit: 25, + wordLimit: 120, + keywords: ['会议', '安排', '议程', '时间'], + requirements: [ + '使用恰当的邮件格式', + '主题明确', + '内容简洁明了', + '包含必要的会议信息' + ], + prompt: '作为项目经理，你需要安排下周的部门会议。请写一封邮件通知团队成员，包含会议时间、地点和主要议程。', + createdAt: DateTime.now().subtract(const Duration(days: 1)), + ), + + // 报告类型 + WritingTask( + id: 'report_1', + title: '市场调研报告', + description: '撰写一份关于新产品市场前景的调研报告。', + type: WritingType.report, + difficulty: WritingDifficulty.advanced, + timeLimit: 60, + wordLimit: 500, + keywords: ['市场调研', '数据分析', '趋势', '建议'], + requirements: [ + '使用正式的报告格式', + '包含数据和图表说明', + '分析客观准确', + '提出可行性建议' + ], + prompt: '你的公司计划推出一款新的智能手表产品。请根据市场调研数据，撰写一份市场前景分析报告。', + createdAt: DateTime.now(), + ), + + // 故事类型 + WritingTask( + id: 'story_1', + title: '童年回忆', + description: '写一个关于童年难忘经历的故事。', + type: WritingType.story, + difficulty: WritingDifficulty.intermediate, + timeLimit: 35, + wordLimit: 200, + keywords: ['童年', '回忆', '成长', '经历'], + requirements: [ + '情节生动有趣', + '使用描述性语言', + '表达真实情感', + '结构完整' + ], + prompt: '回想你的童年时光，选择一个特别难忘的经历，写成一个小故事。可以是快乐的、有趣的，或者让你学到重要道理的经历。', + createdAt: DateTime.now().subtract(const Duration(hours: 12)), + ), + + // 评论类型 + WritingTask( + id: 'review_1', + title: '电影评论', + description: '写一篇关于最近观看电影的评论。', + type: WritingType.review, + difficulty: WritingDifficulty.upperIntermediate, + timeLimit: 40, + wordLimit: 300, + keywords: ['电影', '评论', '剧情', '演技'], + requirements: [ + '客观评价电影各个方面', + '支持观点的具体例子', + '使用评论性词汇', + '给出推荐建议' + ], + prompt: '选择一部你最近观看的电影，写一篇评论。包括对剧情、演技、视觉效果等方面的评价，并说明是否推荐他人观看。', + createdAt: DateTime.now().subtract(const Duration(hours: 6)), + ), + + // 描述文类型 + WritingTask( + id: 'description_1', + title: '我的理想房屋', + description: '描述你心目中理想房屋的样子。', + type: WritingType.description, + difficulty: WritingDifficulty.elementary, + timeLimit: 30, + wordLimit: 180, + keywords: ['房屋', '设计', '装修', '功能'], + requirements: [ + '使用丰富的形容词', + '空间描述清晰', + '细节生动具体', + '逻辑顺序合理' + ], + prompt: '想象你有机会设计自己的理想房屋。请详细描述这个房屋的外观、内部布局、装修风格和特殊功能。', + createdAt: DateTime.now().subtract(const Duration(hours: 3)), + ), + ]; + + final examTasks = getExamTasks(); + + return [...regularTasks, ...examTasks]; + } + + static List getTasksByType(WritingType type) { + return getAllTasks().where((task) => task.type == type).toList(); + } + + static List getTasksByDifficulty(WritingDifficulty difficulty) { + return getAllTasks().where((task) => task.difficulty == difficulty).toList(); + } + + static WritingTask? getTaskById(String id) { + try { + return getAllTasks().firstWhere((task) => task.id == id); + } catch (e) { + return null; + } + } + + static List getRecentTasks({int limit = 5}) { + final tasks = getAllTasks(); + tasks.sort((a, b) => b.createdAt.compareTo(a.createdAt)); + return tasks.take(limit).toList(); + } + + static List getPopularTasks({int limit = 5}) { + // 模拟热门任务（实际应用中可能基于完成次数、评分等） + final popularIds = ['essay_1', 'letter_1', 'email_1', 'story_1', 'description_1']; + return getAllTasks() + .where((task) => popularIds.contains(task.id)) + .take(limit) + .toList(); + } + + static List getExamTasks() { + return [ + // 四六级写作 + WritingTask( + id: 'cet_1', + title: '校园生活的变化', + description: '描述大学校园生活的变化及其影响', + type: WritingType.essay, + difficulty: WritingDifficulty.intermediate, + timeLimit: 30, + wordLimit: 120, + keywords: ['校园生活', '变化', '影响', '大学'], + requirements: [ + '字数不少于120词', + '结构清晰，逻辑合理', + '语言准确，表达流畅', + '内容充实，观点明确' + ], + prompt: 'For this part, you are allowed 30 minutes to write an essay on the changes in campus life. You should write at least 120 words but no more than 180 words.', + examType: ExamType.cet, + createdAt: DateTime.now().subtract(const Duration(days: 1)), + ), + WritingTask( + id: 'cet_2', + title: '网络学习的利弊', + description: '分析网络学习的优势和劣势', + type: WritingType.essay, + difficulty: WritingDifficulty.intermediate, + timeLimit: 30, + wordLimit: 120, + keywords: ['网络学习', '在线教育', '优势', '劣势'], + requirements: [ + '字数不少于120词', + '分析利弊两个方面', + '举例说明观点', + '语言规范，表达清楚' + ], + prompt: 'For this part, you are allowed 30 minutes to write an essay on the advantages and disadvantages of online learning. You should write at least 120 words but no more than 180 words.', + examType: ExamType.cet, + createdAt: DateTime.now().subtract(const Duration(days: 2)), + ), + + // 考研写作 + WritingTask( + id: 'kaoyan_1', + title: '文化交流的重要性', + description: '论述文化交流在全球化时代的重要性', + type: WritingType.essay, + difficulty: WritingDifficulty.upperIntermediate, + timeLimit: 30, + wordLimit: 160, + keywords: ['文化交流', '全球化', '理解', '合作'], + requirements: [ + '字数160-200词', + '论点明确，论证充分', + '使用高级词汇和句型', + '结构完整，逻辑清晰' + ], + prompt: 'Write an essay of 160-200 words based on the following drawing. In your essay, you should 1) describe the drawing briefly, 2) explain its intended meaning, and 3) give your comments.', + examType: ExamType.kaoyan, + createdAt: DateTime.now().subtract(const Duration(days: 3)), + ), + WritingTask( + id: 'kaoyan_2', + title: '环境保护与经济发展', + description: '讨论环境保护与经济发展的关系', + type: WritingType.essay, + difficulty: WritingDifficulty.upperIntermediate, + timeLimit: 30, + wordLimit: 160, + keywords: ['环境保护', '经济发展', '平衡', '可持续'], + requirements: [ + '字数160-200词', + '分析两者关系', + '提出解决方案', + '语言准确，表达地道' + ], + prompt: 'Write an essay of 160-200 words based on the following drawing. In your essay, you should 1) describe the drawing briefly, 2) explain its intended meaning, and 3) give your comments.', + examType: ExamType.kaoyan, + createdAt: DateTime.now().subtract(const Duration(days: 4)), + ), + + // 托福写作 + WritingTask( + id: 'toefl_1', + title: '独立写作：在线教育vs传统教育', + description: '比较在线教育和传统教育的优劣', + type: WritingType.essay, + difficulty: WritingDifficulty.advanced, + timeLimit: 30, + wordLimit: 300, + keywords: ['在线教育', '传统教育', '比较', '效果'], + requirements: [ + '字数不少于300词', + '明确表达个人观点', + '提供具体例子支持', + '使用多样化的句型和词汇' + ], + prompt: 'Do you agree or disagree with the following statement? Online education is more effective than traditional classroom education. Use specific reasons and examples to support your answer.', + examType: ExamType.toefl, + createdAt: DateTime.now().subtract(const Duration(days: 5)), + ), + WritingTask( + id: 'toefl_2', + title: '独立写作：科技对人际关系的影响', + description: '分析现代科技对人际关系的影响', + type: WritingType.essay, + difficulty: WritingDifficulty.advanced, + timeLimit: 30, + wordLimit: 300, + keywords: ['科技', '人际关系', '社交媒体', '沟通'], + requirements: [ + '字数不少于300词', + '分析正面和负面影响', + '使用具体例子', + '结论明确' + ], + prompt: 'Do you agree or disagree with the following statement? Technology has made people less social and more isolated. Use specific reasons and examples to support your answer.', + examType: ExamType.toefl, + createdAt: DateTime.now().subtract(const Duration(days: 6)), + ), + + // 雅思写作 + WritingTask( + id: 'ielts_1', + title: 'Task 2: 城市化的影响', + description: '讨论城市化对社会和环境的影响', + type: WritingType.essay, + difficulty: WritingDifficulty.advanced, + timeLimit: 40, + wordLimit: 250, + keywords: ['城市化', '社会影响', '环境影响', '发展'], + requirements: [ + '字数不少于250词', + '讨论问题的两个方面', + '给出自己的观点', + '使用正式的学术语言' + ], + prompt: 'In many countries, people are moving from rural areas to cities. What are the advantages and disadvantages of this trend? Give reasons for your answer and include any relevant examples from your own knowledge or experience.', + examType: ExamType.ielts, + createdAt: DateTime.now().subtract(const Duration(days: 7)), + ), + WritingTask( + id: 'ielts_2', + title: 'Task 2: 教育的目的', + description: '讨论教育的主要目的是什么', + type: WritingType.essay, + difficulty: WritingDifficulty.advanced, + timeLimit: 40, + wordLimit: 250, + keywords: ['教育', '目的', '技能', '知识'], + requirements: [ + '字数不少于250词', + '清楚表达观点', + '提供相关例子', + '逻辑清晰，结构完整' + ], + prompt: 'Some people think that the main purpose of education is to prepare students for the working world. Others believe that education should focus on developing knowledge and critical thinking skills. Discuss both views and give your own opinion.', + examType: ExamType.ielts, + createdAt: DateTime.now().subtract(const Duration(days: 8)), + ), + ]; + } + + static List getTasksByExamType(ExamType examType) { + return getExamTasks().where((task) => task.examType == examType).toList(); + } +} \ No newline at end of file diff --git a/client/lib/features/writing/models/writing_record.dart b/client/lib/features/writing/models/writing_record.dart new file mode 100644 index 0000000..765528b --- /dev/null +++ b/client/lib/features/writing/models/writing_record.dart @@ -0,0 +1,96 @@ +/// 写作完成记录模型 +class WritingRecord { + final String id; + final String taskId; + final String taskTitle; + final String taskDescription; + final String content; + final int wordCount; + final int timeUsed; // 使用的时间（秒） + final int score; + final DateTime completedAt; + final Map? feedback; + + const WritingRecord({ + required this.id, + required this.taskId, + required this.taskTitle, + required this.taskDescription, + required this.content, + required this.wordCount, + required this.timeUsed, + required this.score, + required this.completedAt, + this.feedback, + }); + + Map toJson() { + return { + 'id': id, + 'taskId': taskId, + 'taskTitle': taskTitle, + 'taskDescription': taskDescription, + 'content': content, + 'wordCount': wordCount, + 'timeUsed': timeUsed, + 'score': score, + 'completedAt': completedAt.toIso8601String(), + 'feedback': feedback, + }; + } + + factory WritingRecord.fromJson(Map json) { + return WritingRecord( + id: json['id'], + taskId: json['taskId'], + taskTitle: json['taskTitle'], + taskDescription: json['taskDescription'], + content: json['content'], + wordCount: json['wordCount'], + timeUsed: json['timeUsed'], + score: json['score'], + completedAt: DateTime.parse(json['completedAt']), + feedback: json['feedback'], + ); + } + + WritingRecord copyWith({ + String? id, + String? taskId, + String? taskTitle, + String? taskDescription, + String? content, + int? wordCount, + int? timeUsed, + int? score, + DateTime? completedAt, + Map? feedback, + }) { + return WritingRecord( + id: id ?? this.id, + taskId: taskId ?? this.taskId, + taskTitle: taskTitle ?? this.taskTitle, + taskDescription: taskDescription ?? this.taskDescription, + content: content ?? this.content, + wordCount: wordCount ?? this.wordCount, + timeUsed: timeUsed ?? this.timeUsed, + score: score ?? this.score, + completedAt: completedAt ?? this.completedAt, + feedback: feedback ?? this.feedback, + ); + } + + String get formattedDate { + return '${completedAt.year}-${completedAt.month.toString().padLeft(2, '0')}-${completedAt.day.toString().padLeft(2, '0')}'; + } + + String get formattedTime { + final minutes = timeUsed ~/ 60; + final seconds = timeUsed % 60; + return '${minutes}分${seconds}秒'; + } + + String get scoreText { + return '${score}分'; + } +} \ No newline at end of file diff --git a/client/lib/features/writing/models/writing_stats.dart b/client/lib/features/writing/models/writing_stats.dart new file mode 100644 index 0000000..ad7c09b --- /dev/null +++ b/client/lib/features/writing/models/writing_stats.dart @@ -0,0 +1,238 @@ +class WritingStats { + final String userId; + final int totalTasks; + final int completedTasks; + final int totalWords; + final int totalTimeSpent; // 秒 + final double averageScore; + final Map taskTypeStats; + final Map difficultyStats; + final List progressData; + final WritingSkillAnalysis skillAnalysis; + final DateTime lastUpdated; + + const WritingStats({ + required this.userId, + required this.totalTasks, + required this.completedTasks, + required this.totalWords, + required this.totalTimeSpent, + required this.averageScore, + required this.taskTypeStats, + required this.difficultyStats, + required this.progressData, + required this.skillAnalysis, + required this.lastUpdated, + }); + + double get completionRate => totalTasks > 0 ? (completedTasks / totalTasks) * 100 : 0; + + double get averageWordsPerTask => completedTasks > 0 ? totalWords / completedTasks : 0; + + double get averageTimePerTask => completedTasks > 0 ? totalTimeSpent / completedTasks : 0; + + factory WritingStats.fromJson(Map json) { + final userIdVal = json['userId']; + final totalTasksVal = json['totalTasks'] ?? json['total_submissions']; + final completedTasksVal = json['completedTasks'] ?? json['completed_submissions']; + final totalWordsVal = json['totalWords'] ?? json['total_word_count']; + final totalTimeSpentVal = json['totalTimeSpent'] ?? json['total_time_spent']; + final averageScoreVal = json['averageScore'] ?? json['average_score']; + final difficultyStatsVal = json['difficultyStats'] ?? json['difficulty_stats'] ?? {}; + final progressDataVal = json['progressData'] ?? []; + final skillAnalysisVal = json['skillAnalysis']; + final lastUpdatedVal = json['lastUpdated']; + + final stats = WritingStats( + userId: userIdVal?.toString() ?? '', + totalTasks: _asInt(totalTasksVal), + completedTasks: _asInt(completedTasksVal), + totalWords: _asInt(totalWordsVal), + totalTimeSpent: _asInt(totalTimeSpentVal), + averageScore: _asDouble(averageScoreVal), + taskTypeStats: Map.from(json['taskTypeStats'] ?? {}), + difficultyStats: Map.from(difficultyStatsVal), + progressData: (progressDataVal is List) + ? progressDataVal + .map((e) => WritingProgressData.fromJson(Map.from(e))) + .toList() + : [], + skillAnalysis: skillAnalysisVal is Map + ? WritingSkillAnalysis.fromJson(skillAnalysisVal) + : WritingSkillAnalysis( + criteriaScores: { + 'grammar': _normalize01(_asDouble(json['average_grammar_score'])), + 'coherence': _normalize01(_asDouble(json['average_coherence_score'])), + 'vocab': _normalize01(_asDouble(json['average_vocab_score'])), + }, + errorCounts: {}, + strengths: const [], + weaknesses: const [], + recommendations: const [], + improvementRate: 0.0, + lastAnalyzed: DateTime.now(), + ), + lastUpdated: lastUpdatedVal is String + ? DateTime.parse(lastUpdatedVal) + : DateTime.now(), + ); + + return stats; + } + + Map toJson() { + return { + 'userId': userId, + 'totalTasks': totalTasks, + 'completedTasks': completedTasks, + 'totalWords': totalWords, + 'totalTimeSpent': totalTimeSpent, + 'averageScore': averageScore, + 'taskTypeStats': taskTypeStats, + 'difficultyStats': difficultyStats, + 'progressData': progressData.map((e) => e.toJson()).toList(), + 'skillAnalysis': skillAnalysis.toJson(), + 'lastUpdated': lastUpdated.toIso8601String(), + }; + } + + WritingStats copyWith({ + String? userId, + int? totalTasks, + int? completedTasks, + int? totalWords, + int? totalTimeSpent, + double? averageScore, + Map? taskTypeStats, + Map? difficultyStats, + List? progressData, + WritingSkillAnalysis? skillAnalysis, + DateTime? lastUpdated, + }) { + return WritingStats( + userId: userId ?? this.userId, + totalTasks: totalTasks ?? this.totalTasks, + completedTasks: completedTasks ?? this.completedTasks, + totalWords: totalWords ?? this.totalWords, + totalTimeSpent: totalTimeSpent ?? this.totalTimeSpent, + averageScore: averageScore ?? this.averageScore, + taskTypeStats: taskTypeStats ?? this.taskTypeStats, + difficultyStats: difficultyStats ?? this.difficultyStats, + progressData: progressData ?? this.progressData, + skillAnalysis: skillAnalysis ?? this.skillAnalysis, + lastUpdated: lastUpdated ?? this.lastUpdated, + ); + } +} + +class WritingProgressData { + final DateTime date; + final double score; + final int wordCount; + final int timeSpent; + final String taskType; + final String difficulty; + + const WritingProgressData({ + required this.date, + required this.score, + required this.wordCount, + required this.timeSpent, + required this.taskType, + required this.difficulty, + }); + + factory WritingProgressData.fromJson(Map json) { + return WritingProgressData( + date: DateTime.parse(json['date'] as String), + score: (json['score'] as num).toDouble(), + wordCount: json['wordCount'] as int, + timeSpent: json['timeSpent'] as int, + taskType: json['taskType'] as String, + difficulty: json['difficulty'] as String, + ); + } + + Map toJson() { + return { + 'date': date.toIso8601String(), + 'score': score, + 'wordCount': wordCount, + 'timeSpent': timeSpent, + 'taskType': taskType, + 'difficulty': difficulty, + }; + } +} + +class WritingSkillAnalysis { + final Map criteriaScores; + final Map errorCounts; + final List strengths; + final List weaknesses; + final List recommendations; + final double improvementRate; + final DateTime lastAnalyzed; + + const WritingSkillAnalysis({ + required this.criteriaScores, + required this.errorCounts, + required this.strengths, + required this.weaknesses, + required this.recommendations, + required this.improvementRate, + required this.lastAnalyzed, + }); + + factory WritingSkillAnalysis.fromJson(Map json) { + return WritingSkillAnalysis( + criteriaScores: Map.from( + (json['criteriaScores'] as Map).map( + (k, v) => MapEntry(k, (v as num).toDouble()), + ), + ), + errorCounts: Map.from(json['errorCounts'] ?? {}), + strengths: List.from(json['strengths'] ?? []), + weaknesses: List.from(json['weaknesses'] ?? []), + recommendations: List.from(json['recommendations'] ?? []), + improvementRate: (json['improvementRate'] as num).toDouble(), + lastAnalyzed: DateTime.parse(json['lastAnalyzed'] as String), + ); + } + + Map toJson() { + return { + 'criteriaScores': criteriaScores, + 'errorCounts': errorCounts, + 'strengths': strengths, + 'weaknesses': weaknesses, + 'recommendations': recommendations, + 'improvementRate': improvementRate, + 'lastAnalyzed': lastAnalyzed.toIso8601String(), + }; + } +} + +int _asInt(dynamic v) { + if (v == null) return 0; + if (v is int) return v; + if (v is num) return v.toInt(); + if (v is String) { + final parsed = double.tryParse(v); + return parsed?.toInt() ?? int.tryParse(v) ?? 0; + } + return 0; +} + +double _asDouble(dynamic v) { + if (v == null) return 0.0; + if (v is double) return v; + if (v is num) return v.toDouble(); + if (v is String) return double.tryParse(v) ?? 0.0; + return 0.0; +} + +double _normalize01(double v) { + if (v <= 1.0) return v; + return v / 100.0; +} \ No newline at end of file diff --git a/client/lib/features/writing/models/writing_submission.dart b/client/lib/features/writing/models/writing_submission.dart new file mode 100644 index 0000000..860eca7 --- /dev/null +++ b/client/lib/features/writing/models/writing_submission.dart @@ -0,0 +1,408 @@ +import 'writing_task.dart'; + +class WritingSubmission { + final String id; + final String taskId; + final String userId; + final String content; + final int wordCount; + final int timeSpent; // 秒 + final WritingStatus status; + final DateTime submittedAt; + final WritingFeedback? feedback; + final WritingScore? score; + + const WritingSubmission({ + required this.id, + required this.taskId, + required this.userId, + required this.content, + required this.wordCount, + required this.timeSpent, + required this.status, + required this.submittedAt, + this.feedback, + this.score, + }); + + factory WritingSubmission.fromJson(Map json) { + return WritingSubmission( + id: json['id'] as String, + taskId: json['taskId'] as String, + userId: json['userId'] as String, + content: json['content'] as String, + wordCount: json['wordCount'] as int, + timeSpent: json['timeSpent'] as int, + status: WritingStatus.values.firstWhere( + (e) => e.name == json['status'], + orElse: () => WritingStatus.draft, + ), + submittedAt: DateTime.parse(json['submittedAt'] as String), + feedback: json['feedback'] != null + ? WritingFeedback.fromJson(json['feedback'] as Map) + : null, + score: json['score'] != null + ? WritingScore.fromJson(json['score'] as Map) + : null, + ); + } + + Map toJson() { + return { + 'id': id, + 'taskId': taskId, + 'userId': userId, + 'content': content, + 'wordCount': wordCount, + 'timeSpent': timeSpent, + 'status': status.name, + 'submittedAt': submittedAt.toIso8601String(), + 'feedback': feedback?.toJson(), + 'score': score?.toJson(), + }; + } + + WritingSubmission copyWith({ + String? id, + String? taskId, + String? userId, + String? content, + int? wordCount, + int? timeSpent, + WritingStatus? status, + DateTime? submittedAt, + WritingFeedback? feedback, + WritingScore? score, + }) { + return WritingSubmission( + id: id ?? this.id, + taskId: taskId ?? this.taskId, + userId: userId ?? this.userId, + content: content ?? this.content, + wordCount: wordCount ?? this.wordCount, + timeSpent: timeSpent ?? this.timeSpent, + status: status ?? this.status, + submittedAt: submittedAt ?? this.submittedAt, + feedback: feedback ?? this.feedback, + score: score ?? this.score, + ); + } +} + +class WritingFeedback { + final String id; + final String submissionId; + final String overallComment; + final List criteriaFeedbacks; + final List errors; + final List suggestions; + final DateTime createdAt; + + const WritingFeedback({ + required this.id, + required this.submissionId, + required this.overallComment, + required this.criteriaFeedbacks, + required this.errors, + required this.suggestions, + required this.createdAt, + }); + + factory WritingFeedback.fromJson(Map json) { + return WritingFeedback( + id: json['id'] as String, + submissionId: json['submissionId'] as String, + overallComment: json['overallComment'] as String, + criteriaFeedbacks: (json['criteriaFeedbacks'] as List) + .map((e) => WritingCriteriaFeedback.fromJson(e as Map)) + .toList(), + errors: (json['errors'] as List) + .map((e) => WritingError.fromJson(e as Map)) + .toList(), + suggestions: (json['suggestions'] as List) + .map((e) => WritingSuggestion.fromJson(e as Map)) + .toList(), + createdAt: DateTime.parse(json['createdAt'] as String), + ); + } + + Map toJson() { + return { + 'id': id, + 'submissionId': submissionId, + 'overallComment': overallComment, + 'criteriaFeedbacks': criteriaFeedbacks.map((e) => e.toJson()).toList(), + 'errors': errors.map((e) => e.toJson()).toList(), + 'suggestions': suggestions.map((e) => e.toJson()).toList(), + 'createdAt': createdAt.toIso8601String(), + }; + } +} + +class WritingScore { + final String id; + final String submissionId; + final double totalScore; + final double maxScore; + final Map criteriaScores; + final String grade; + final DateTime createdAt; + + const WritingScore({ + required this.id, + required this.submissionId, + required this.totalScore, + required this.maxScore, + required this.criteriaScores, + required this.grade, + required this.createdAt, + }); + + double get percentage => (totalScore / maxScore) * 100; + + factory WritingScore.fromJson(Map json) { + return WritingScore( + id: json['id'] as String, + submissionId: json['submissionId'] as String, + totalScore: (json['totalScore'] as num).toDouble(), + maxScore: (json['maxScore'] as num).toDouble(), + criteriaScores: Map.fromEntries( + (json['criteriaScores'] as Map).entries.map( + (e) => MapEntry( + WritingCriteria.values.firstWhere((c) => c.name == e.key), + (e.value as num).toDouble(), + ), + ), + ), + grade: json['grade'] as String, + createdAt: DateTime.parse(json['createdAt'] as String), + ); + } + + Map toJson() { + return { + 'id': id, + 'submissionId': submissionId, + 'totalScore': totalScore, + 'maxScore': maxScore, + 'criteriaScores': Map.fromEntries( + criteriaScores.entries.map( + (e) => MapEntry(e.key.name, e.value), + ), + ), + 'grade': grade, + 'createdAt': createdAt.toIso8601String(), + }; + } +} + +class WritingCriteriaFeedback { + final WritingCriteria criteria; + final double score; + final double maxScore; + final String comment; + final List strengths; + final List improvements; + + const WritingCriteriaFeedback({ + required this.criteria, + required this.score, + required this.maxScore, + required this.comment, + required this.strengths, + required this.improvements, + }); + + factory WritingCriteriaFeedback.fromJson(Map json) { + return WritingCriteriaFeedback( + criteria: WritingCriteria.values.firstWhere( + (e) => e.name == json['criteria'], + ), + score: (json['score'] as num).toDouble(), + maxScore: (json['maxScore'] as num).toDouble(), + comment: json['comment'] as String, + strengths: List.from(json['strengths'] ?? []), + improvements: List.from(json['improvements'] ?? []), + ); + } + + Map toJson() { + return { + 'criteria': criteria.name, + 'score': score, + 'maxScore': maxScore, + 'comment': comment, + 'strengths': strengths, + 'improvements': improvements, + }; + } +} + +class WritingError { + final WritingErrorType type; + final String description; + final String originalText; + final String? suggestedText; + final int startPosition; + final int endPosition; + final String explanation; + + const WritingError({ + required this.type, + required this.description, + required this.originalText, + this.suggestedText, + required this.startPosition, + required this.endPosition, + required this.explanation, + }); + + factory WritingError.fromJson(Map json) { + return WritingError( + type: WritingErrorType.values.firstWhere( + (e) => e.name == json['type'], + ), + description: json['description'] as String, + originalText: json['originalText'] as String, + suggestedText: json['suggestedText'] as String?, + startPosition: json['startPosition'] as int, + endPosition: json['endPosition'] as int, + explanation: json['explanation'] as String, + ); + } + + Map toJson() { + return { + 'type': type.name, + 'description': description, + 'originalText': originalText, + 'suggestedText': suggestedText, + 'startPosition': startPosition, + 'endPosition': endPosition, + 'explanation': explanation, + }; + } +} + +class WritingSuggestion { + final WritingSuggestionType type; + final String title; + final String description; + final String? example; + final int? position; + + const WritingSuggestion({ + required this.type, + required this.title, + required this.description, + this.example, + this.position, + }); + + factory WritingSuggestion.fromJson(Map json) { + return WritingSuggestion( + type: WritingSuggestionType.values.firstWhere( + (e) => e.name == json['type'], + ), + title: json['title'] as String, + description: json['description'] as String, + example: json['example'] as String?, + position: json['position'] as int?, + ); + } + + Map toJson() { + return { + 'type': type.name, + 'title': title, + 'description': description, + 'example': example, + 'position': position, + }; + } +} + +enum WritingStatus { + draft, + submitted, + grading, + graded, + revised, +} + +enum WritingCriteria { + content, + organization, + vocabulary, + grammar, + mechanics, +} + +enum WritingErrorType { + grammar, + spelling, + punctuation, + vocabulary, + structure, + style, +} + +enum WritingSuggestionType { + improvement, + enhancement, + alternative, + clarification, +} + +extension WritingStatusExtension on WritingStatus { + String get displayName { + switch (this) { + case WritingStatus.draft: + return '草稿'; + case WritingStatus.submitted: + return '已提交'; + case WritingStatus.grading: + return '评分中'; + case WritingStatus.graded: + return '已评分'; + case WritingStatus.revised: + return '已修改'; + } + } +} + +extension WritingCriteriaExtension on WritingCriteria { + String get displayName { + switch (this) { + case WritingCriteria.content: + return '内容'; + case WritingCriteria.organization: + return '结构'; + case WritingCriteria.vocabulary: + return '词汇'; + case WritingCriteria.grammar: + return '语法'; + case WritingCriteria.mechanics: + return '拼写标点'; + } + } +} + +extension WritingErrorTypeExtension on WritingErrorType { + String get displayName { + switch (this) { + case WritingErrorType.grammar: + return '语法错误'; + case WritingErrorType.spelling: + return '拼写错误'; + case WritingErrorType.punctuation: + return '标点错误'; + case WritingErrorType.vocabulary: + return '词汇错误'; + case WritingErrorType.structure: + return '结构错误'; + case WritingErrorType.style: + return '风格问题'; + } + } +} \ No newline at end of file diff --git a/client/lib/features/writing/models/writing_task.dart b/client/lib/features/writing/models/writing_task.dart new file mode 100644 index 0000000..f6698b0 --- /dev/null +++ b/client/lib/features/writing/models/writing_task.dart @@ -0,0 +1,267 @@ +class WritingTask { + final String id; + final String title; + final String description; + final WritingType type; + final WritingDifficulty difficulty; + final int timeLimit; // 分钟 + final int wordLimit; + final List keywords; + final List requirements; + final String? prompt; + final String? imageUrl; + final ExamType? examType; // 考试类型 + final DateTime createdAt; + final DateTime? updatedAt; + + const WritingTask({ + required this.id, + required this.title, + required this.description, + required this.type, + required this.difficulty, + required this.timeLimit, + required this.wordLimit, + required this.keywords, + required this.requirements, + this.prompt, + this.imageUrl, + this.examType, + required this.createdAt, + this.updatedAt, + }); + + factory WritingTask.fromJson(Map json) { + final idVal = json['id'] ?? json['prompt_id']; + final typeVal = json['type']; + final difficultyVal = json['difficulty']; + final timeLimitVal = json['timeLimit'] ?? json['time_limit']; + final wordLimitVal = json['wordLimit'] ?? json['word_limit']; + final examTypeVal = json['examType'] ?? json['exam_type']; + final createdAtVal = json['createdAt'] ?? json['created_at']; + final updatedAtVal = json['updatedAt'] ?? json['updated_at']; + + return WritingTask( + id: (idVal ?? '').toString(), + title: (json['title'] ?? '').toString(), + description: (json['description'] ?? '').toString(), + type: typeVal is String + ? WritingType.values.firstWhere( + (e) => e.name == typeVal, + orElse: () => WritingType.essay, + ) + : WritingType.essay, + difficulty: difficultyVal is String + ? WritingDifficulty.values.firstWhere( + (e) => e.name == difficultyVal, + orElse: () => WritingDifficulty.intermediate, + ) + : WritingDifficulty.intermediate, + timeLimit: _asInt(timeLimitVal), + wordLimit: _asInt(wordLimitVal), + keywords: List.from(json['keywords'] ?? []), + requirements: List.from(json['requirements'] ?? []), + prompt: json['prompt'] as String?, + imageUrl: json['imageUrl'] as String?, + examType: examTypeVal is String + ? ExamType.values.firstWhere( + (e) => e.name == examTypeVal, + orElse: () => ExamType.cet, + ) + : null, + createdAt: _parseDate(createdAtVal), + updatedAt: updatedAtVal != null ? _parseDate(updatedAtVal) : null, + ); + } + + Map toJson() { + return { + 'id': id, + 'title': title, + 'description': description, + 'type': type.name, + 'difficulty': difficulty.name, + 'timeLimit': timeLimit, + 'wordLimit': wordLimit, + 'keywords': keywords, + 'requirements': requirements, + 'prompt': prompt, + 'imageUrl': imageUrl, + 'examType': examType?.name, + 'createdAt': createdAt.toIso8601String(), + 'updatedAt': updatedAt?.toIso8601String(), + }; + } + + WritingTask copyWith({ + String? id, + String? title, + String? description, + WritingType? type, + WritingDifficulty? difficulty, + int? timeLimit, + int? wordLimit, + List? keywords, + List? requirements, + String? prompt, + String? imageUrl, + ExamType? examType, + DateTime? createdAt, + DateTime? updatedAt, + }) { + return WritingTask( + id: id ?? this.id, + title: title ?? this.title, + description: description ?? this.description, + type: type ?? this.type, + difficulty: difficulty ?? this.difficulty, + timeLimit: timeLimit ?? this.timeLimit, + wordLimit: wordLimit ?? this.wordLimit, + keywords: keywords ?? this.keywords, + requirements: requirements ?? this.requirements, + prompt: prompt ?? this.prompt, + imageUrl: imageUrl ?? this.imageUrl, + examType: examType ?? this.examType, + createdAt: createdAt ?? this.createdAt, + updatedAt: updatedAt ?? this.updatedAt, + ); + } +} + +enum WritingType { + essay, + letter, + email, + report, + story, + review, + article, + diary, + description, + argument, +} + +enum WritingDifficulty { + beginner, + elementary, + intermediate, + upperIntermediate, + advanced, +} + +extension WritingTypeExtension on WritingType { + String get displayName { + switch (this) { + case WritingType.essay: + return '议论文'; + case WritingType.letter: + return '书信'; + case WritingType.email: + return '邮件'; + case WritingType.report: + return '报告'; + case WritingType.story: + return '故事'; + case WritingType.review: + return '评论'; + case WritingType.article: + return '文章'; + case WritingType.diary: + return '日记'; + case WritingType.description: + return '描述文'; + case WritingType.argument: + return '辩论文'; + } + } +} + +extension WritingDifficultyExtension on WritingDifficulty { + String get displayName { + switch (this) { + case WritingDifficulty.beginner: + return '初级'; + case WritingDifficulty.elementary: + return '基础'; + case WritingDifficulty.intermediate: + return '中级'; + case WritingDifficulty.upperIntermediate: + return '中高级'; + case WritingDifficulty.advanced: + return '高级'; + } + } + + int get level { + switch (this) { + case WritingDifficulty.beginner: + return 1; + case WritingDifficulty.elementary: + return 2; + case WritingDifficulty.intermediate: + return 3; + case WritingDifficulty.upperIntermediate: + return 4; + case WritingDifficulty.advanced: + return 5; + } + } +} + +enum ExamType { + cet, // 四六级 + kaoyan, // 考研 + toefl, // 托福 + ielts, // 雅思 +} + +extension ExamTypeExtension on ExamType { + String get displayName { + switch (this) { + case ExamType.cet: + return '四六级'; + case ExamType.kaoyan: + return '考研'; + case ExamType.toefl: + return '托福'; + case ExamType.ielts: + return '雅思'; + } + } + + String get description { + switch (this) { + case ExamType.cet: + return '大学英语四六级考试写作'; + case ExamType.kaoyan: + return '研究生入学考试英语写作'; + case ExamType.toefl: + return 'TOEFL托福考试写作'; + case ExamType.ielts: + return 'IELTS雅思考试写作'; + } + } +} + +int _asInt(dynamic v) { + if (v == null) return 0; + if (v is int) return v; + if (v is num) return v.toInt(); + if (v is String) { + final parsed = double.tryParse(v); + return parsed?.toInt() ?? int.tryParse(v) ?? 0; + } + return 0; +} + +DateTime _parseDate(dynamic v) { + if (v is String) { + try { + return DateTime.parse(v); + } catch (_) {} + } + if (v is int) { + return DateTime.fromMillisecondsSinceEpoch(v); + } + return DateTime.now(); +} \ No newline at end of file diff --git a/client/lib/features/writing/providers/writing_provider.dart b/client/lib/features/writing/providers/writing_provider.dart new file mode 100644 index 0000000..bc85371 --- /dev/null +++ b/client/lib/features/writing/providers/writing_provider.dart @@ -0,0 +1,117 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/writing_task.dart'; +import '../models/writing_submission.dart'; +import '../services/writing_service.dart'; + +/// 写作任务状态 +class WritingTasksState { + final List tasks; + final bool isLoading; + final String? error; + + WritingTasksState({ + this.tasks = const [], + this.isLoading = false, + this.error, + }); + + WritingTasksState copyWith({ + List? tasks, + bool? isLoading, + String? error, + }) { + return WritingTasksState( + tasks: tasks ?? this.tasks, + isLoading: isLoading ?? this.isLoading, + error: error, + ); + } +} + +/// 写作任务 Notifier +class WritingTasksNotifier extends StateNotifier { + final WritingService _writingService; + + WritingTasksNotifier(this._writingService) : super(WritingTasksState()); + + /// 加载写作任务列表 + Future loadTasks({ + WritingType? type, + WritingDifficulty? difficulty, + int page = 1, + bool forceRefresh = false, + }) async { + state = state.copyWith(isLoading: true, error: null); + + try { + final tasks = await _writingService.getWritingTasks( + type: type, + difficulty: difficulty, + page: page, + forceRefresh: forceRefresh, + ); + + state = state.copyWith(tasks: tasks, isLoading: false); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } + + /// 获取推荐任务 + Future loadRecommendedTasks(String userId, {bool forceRefresh = false}) async { + state = state.copyWith(isLoading: true, error: null); + + try { + final tasks = await _writingService.getRecommendedWritingTasks( + userId: userId, + limit: 5, + forceRefresh: forceRefresh, + ); + + state = state.copyWith(tasks: tasks, isLoading: false); + } catch (e) { + state = state.copyWith( + isLoading: false, + error: e.toString(), + ); + } + } +} + +/// 写作服务 Provider +final writingServiceProvider = Provider((ref) { + return WritingService(); +}); + +/// 写作任务列表 Provider +final writingTasksProvider = StateNotifierProvider((ref) { + final service = ref.watch(writingServiceProvider); + return WritingTasksNotifier(service); +}); + +/// 按考试类型获取写作任务 +final examWritingTasksProvider = FutureProvider.family, ExamType>((ref, examType) async { + final service = ref.watch(writingServiceProvider); + + try { + // 从后端获取所有任务，然后在前端过滤 + final tasks = await service.getWritingTasks(limit: 100); + return tasks.where((task) => task.examType == examType).toList(); + } catch (e) { + return []; + } +}); + +/// 用户写作历史 Provider +final userWritingHistoryProvider = FutureProvider.family, String>((ref, userId) async { + final service = ref.watch(writingServiceProvider); + + try { + return await service.getUserWritingHistory(userId: userId, limit: 3); + } catch (e) { + return []; + } +}); diff --git a/client/lib/features/writing/screens/exam_writing_screen.dart b/client/lib/features/writing/screens/exam_writing_screen.dart new file mode 100644 index 0000000..3def6f5 --- /dev/null +++ b/client/lib/features/writing/screens/exam_writing_screen.dart @@ -0,0 +1,388 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/writing_task.dart'; +import '../providers/writing_provider.dart'; +import 'writing_detail_screen.dart'; + +/// 考试写作页面 +class ExamWritingScreen extends ConsumerStatefulWidget { + final ExamType? examType; + final String title; + + const ExamWritingScreen({ + super.key, + this.examType, + required this.title, + }); + + @override + ConsumerState createState() => _ExamWritingScreenState(); +} + +class _ExamWritingScreenState extends ConsumerState { + ExamType? selectedExamType; + + @override + void initState() { + super.initState(); + selectedExamType = widget.examType; + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + title: Text(widget.title), + backgroundColor: Colors.white, + foregroundColor: Colors.black, + elevation: 0, + ), + body: Column( + children: [ + if (widget.examType == null) _buildExamTypeFilter(), + Expanded( + child: Builder( + builder: (context) { + if (selectedExamType != null) { + final tasksAsync = ref.watch(examWritingTasksProvider(selectedExamType!)); + return tasksAsync.when( + data: (tasks) { + if (tasks.isEmpty) return _buildEmptyState(); + return ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: tasks.length, + itemBuilder: (context, index) { + final task = tasks[index]; + return _buildTaskCard(task); + }, + ); + }, + loading: () => const Center(child: CircularProgressIndicator()), + error: (e, st) => Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon(Icons.error_outline, size: 48, color: Colors.grey[400]), + const SizedBox(height: 12), + Text('加载失败', style: TextStyle(fontSize: 14, color: Colors.grey[600])), + const SizedBox(height: 8), + TextButton( + onPressed: () { + ref.invalidate(examWritingTasksProvider(selectedExamType!)); + }, + child: const Text('重试'), + ), + ], + ), + ), + ); + } else { + final service = ref.watch(writingServiceProvider); + return FutureBuilder>( + future: service.getWritingTasks(limit: 100), + builder: (context, snapshot) { + if (snapshot.connectionState == ConnectionState.waiting) { + return const Center(child: CircularProgressIndicator()); + } + if (snapshot.hasError) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon(Icons.error_outline, size: 48, color: Colors.grey[400]), + const SizedBox(height: 12), + Text('加载失败', style: TextStyle(fontSize: 14, color: Colors.grey[600])), + const SizedBox(height: 8), + TextButton( + onPressed: () { + setState(() {}); + }, + child: const Text('重试'), + ), + ], + ), + ); + } + final allTasks = snapshot.data ?? []; + final examTasks = allTasks.where((t) => t.examType != null).toList(); + if (examTasks.isEmpty) return _buildEmptyState(); + return ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: examTasks.length, + itemBuilder: (context, index) { + final task = examTasks[index]; + return _buildTaskCard(task); + }, + ); + }, + ); + } + }, + ), + ), + ], + ), + ); + } + + Widget _buildExamTypeFilter() { + return Container( + padding: const EdgeInsets.all(16), + color: Colors.white, + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '选择考试类型', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + _buildFilterChip('全部', null), + const SizedBox(width: 8), + ...ExamType.values.map((type) => Padding( + padding: const EdgeInsets.only(right: 8), + child: _buildFilterChip(type.displayName, type), + )), + ], + ), + ), + ], + ), + ); + } + + Widget _buildFilterChip(String label, ExamType? type) { + final isSelected = selectedExamType == type; + return FilterChip( + label: Text(label), + selected: isSelected, + onSelected: (selected) { + setState(() { + selectedExamType = type; + }); + }, + backgroundColor: Colors.grey[100], + selectedColor: const Color(0xFF2196F3).withOpacity(0.2), + checkmarkColor: const Color(0xFF2196F3), + labelStyle: TextStyle( + color: isSelected ? const Color(0xFF2196F3) : Colors.grey[700], + fontWeight: isSelected ? FontWeight.bold : FontWeight.normal, + ), + ); + } + + Widget _buildEmptyState() { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.school_outlined, + size: 80, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + '暂无考试写作题目', + style: TextStyle( + fontSize: 18, + color: Colors.grey[600], + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(height: 8), + Text( + '请选择其他考试类型或稍后再试', + style: TextStyle( + fontSize: 14, + color: Colors.grey[500], + ), + ), + ], + ), + ); + } + + Widget _buildTaskCard(WritingTask task) { + return Container( + margin: const EdgeInsets.only(bottom: 16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: InkWell( + onTap: () { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => WritingDetailScreen(task: task), + ), + ); + }, + borderRadius: BorderRadius.circular(16), + child: Padding( + padding: const EdgeInsets.all(20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + task.title, + style: const TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ), + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: _getExamTypeColor(task.examType!), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + task.examType!.displayName, + style: const TextStyle( + fontSize: 12, + color: Colors.white, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + const SizedBox(height: 8), + Text( + task.description, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + height: 1.4, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 12), + Row( + children: [ + _buildInfoChip( + Icons.access_time, + '${task.timeLimit}分钟', + const Color(0xFF4CAF50), + ), + const SizedBox(width: 12), + _buildInfoChip( + Icons.text_fields, + '${task.wordLimit}词', + const Color(0xFFFF9800), + ), + const SizedBox(width: 12), + _buildInfoChip( + Icons.star, + '${task.difficulty.level}级', + _getDifficultyColor(task.difficulty), + ), + ], + ), + if (task.keywords.isNotEmpty) ...[ + const SizedBox(height: 12), + Wrap( + spacing: 6, + runSpacing: 6, + children: task.keywords.take(3).map((keyword) => Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(8), + ), + child: Text( + keyword, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + )).toList(), + ), + ], + ], + ), + ), + ), + ); + } + + Widget _buildInfoChip(IconData icon, String text, Color color) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + icon, + size: 14, + color: color, + ), + const SizedBox(width: 4), + Text( + text, + style: TextStyle( + fontSize: 12, + color: color, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ); + } + + Color _getDifficultyColor(WritingDifficulty difficulty) { + switch (difficulty) { + case WritingDifficulty.beginner: + return const Color(0xFF4CAF50); + case WritingDifficulty.elementary: + return const Color(0xFF8BC34A); + case WritingDifficulty.intermediate: + return const Color(0xFFFF9800); + case WritingDifficulty.upperIntermediate: + return const Color(0xFFFF5722); + case WritingDifficulty.advanced: + return const Color(0xFFF44336); + } + } + + Color _getExamTypeColor(ExamType examType) { + switch (examType) { + case ExamType.cet: + return const Color(0xFF2196F3); + case ExamType.kaoyan: + return const Color(0xFFF44336); + case ExamType.toefl: + return const Color(0xFF4CAF50); + case ExamType.ielts: + return const Color(0xFF9C27B0); + } + } +} \ No newline at end of file diff --git a/client/lib/features/writing/screens/widgets/writing_filter_bar.dart b/client/lib/features/writing/screens/widgets/writing_filter_bar.dart new file mode 100644 index 0000000..7beadcd --- /dev/null +++ b/client/lib/features/writing/screens/widgets/writing_filter_bar.dart @@ -0,0 +1,188 @@ +import 'package:flutter/material.dart'; +import '../../models/writing_task.dart'; + +class WritingFilterBar extends StatelessWidget { + final WritingType? selectedType; + final WritingDifficulty? selectedDifficulty; + final String? sortBy; + final bool isAscending; + final Function(WritingType?) onTypeChanged; + final Function(WritingDifficulty?) onDifficultyChanged; + final Function(String) onSortChanged; + final VoidCallback onClearFilters; + + const WritingFilterBar({ + super.key, + this.selectedType, + this.selectedDifficulty, + this.sortBy, + this.isAscending = true, + required this.onTypeChanged, + required this.onDifficultyChanged, + required this.onSortChanged, + required this.onClearFilters, + }); + + @override + Widget build(BuildContext context) { + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.1), + spreadRadius: 1, + blurRadius: 3, + offset: const Offset(0, 1), + ), + ], + ), + child: Column( + children: [ + Row( + children: [ + const Text( + '筛选条件', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const Spacer(), + TextButton( + onPressed: onClearFilters, + child: const Text('清除'), + ), + ], + ), + const SizedBox(height: 12), + SingleChildScrollView( + scrollDirection: Axis.horizontal, + child: Row( + children: [ + _buildTypeFilter(), + const SizedBox(width: 12), + _buildDifficultyFilter(), + const SizedBox(width: 12), + _buildSortFilter(), + ], + ), + ), + ], + ), + ); + } + + Widget _buildTypeFilter() { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8), + decoration: BoxDecoration( + border: Border.all(color: Colors.grey[300]!), + borderRadius: BorderRadius.circular(20), + color: selectedType != null ? Colors.blue[50] : Colors.white, + ), + child: DropdownButtonHideUnderline( + child: DropdownButton( + value: selectedType, + hint: const Text( + '类型', + style: TextStyle(fontSize: 14), + ), + isDense: true, + items: [ + const DropdownMenuItem( + value: null, + child: Text('全部类型'), + ), + ...WritingType.values.map((type) { + return DropdownMenuItem( + value: type, + child: Text(type.displayName), + ); + }).toList(), + ], + onChanged: onTypeChanged, + ), + ), + ); + } + + Widget _buildDifficultyFilter() { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8), + decoration: BoxDecoration( + border: Border.all(color: Colors.grey[300]!), + borderRadius: BorderRadius.circular(20), + color: selectedDifficulty != null ? Colors.orange[50] : Colors.white, + ), + child: DropdownButtonHideUnderline( + child: DropdownButton( + value: selectedDifficulty, + hint: const Text( + '难度', + style: TextStyle(fontSize: 14), + ), + isDense: true, + items: [ + const DropdownMenuItem( + value: null, + child: Text('全部难度'), + ), + ...WritingDifficulty.values.map((difficulty) { + return DropdownMenuItem( + value: difficulty, + child: Text(difficulty.displayName), + ); + }).toList(), + ], + onChanged: onDifficultyChanged, + ), + ), + ); + } + + Widget _buildSortFilter() { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8), + decoration: BoxDecoration( + border: Border.all(color: Colors.grey[300]!), + borderRadius: BorderRadius.circular(20), + color: sortBy != null ? Colors.green[50] : Colors.white, + ), + child: DropdownButtonHideUnderline( + child: DropdownButton( + value: sortBy, + hint: const Text( + '排序', + style: TextStyle(fontSize: 14), + ), + isDense: true, + items: const [ + DropdownMenuItem( + value: 'createdAt', + child: Text('创建时间'), + ), + DropdownMenuItem( + value: 'difficulty', + child: Text('难度'), + ), + DropdownMenuItem( + value: 'timeLimit', + child: Text('时间限制'), + ), + DropdownMenuItem( + value: 'wordLimit', + child: Text('字数限制'), + ), + ], + onChanged: (value) { + if (value != null) { + onSortChanged(value); + } + }, + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/writing/screens/widgets/writing_stats_card.dart b/client/lib/features/writing/screens/widgets/writing_stats_card.dart new file mode 100644 index 0000000..56fcd26 --- /dev/null +++ b/client/lib/features/writing/screens/widgets/writing_stats_card.dart @@ -0,0 +1,228 @@ +import 'package:flutter/material.dart'; +import '../../models/writing_stats.dart'; + +class WritingStatsCard extends StatelessWidget { + final WritingStats stats; + final VoidCallback? onTap; + + const WritingStatsCard({ + super.key, + required this.stats, + this.onTap, + }); + + @override + Widget build(BuildContext context) { + return Card( + margin: const EdgeInsets.all(8), + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '写作统计', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildStatItem( + '完成任务', + '${stats.completedTasks}', + Icons.task_alt, + Colors.green, + ), + ), + Expanded( + child: _buildStatItem( + '总字数', + '${stats.totalWords}', + Icons.text_fields, + Colors.blue, + ), + ), + Expanded( + child: _buildStatItem( + '平均分', + '${stats.averageScore.toStringAsFixed(1)}', + Icons.star, + Colors.orange, + ), + ), + ], + ), + const SizedBox(height: 16), + if (stats.taskTypeStats.isNotEmpty) ...[ + const Text( + '任务类型分布', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 8), + Column( + children: stats.taskTypeStats.entries.map((entry) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 2), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + entry.key, + style: const TextStyle(fontSize: 12), + ), + Text( + entry.value.toString(), + style: const TextStyle( + fontSize: 12, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + ); + }).toList(), + ), + const SizedBox(height: 12), + ], + if (stats.difficultyStats.isNotEmpty) ...[ + const Text( + '难度分布', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 8), + Column( + children: stats.difficultyStats.entries.map((entry) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 2), + child: Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + entry.key, + style: const TextStyle(fontSize: 12), + ), + Text( + entry.value.toString(), + style: const TextStyle( + fontSize: 12, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + ); + }).toList(), + ), + const SizedBox(height: 12), + ], + if (stats.skillAnalysis.criteriaScores.isNotEmpty) ...[ + const Text( + '技能分析', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 8), + Column( + children: [ + ...stats.skillAnalysis.criteriaScores.entries.map((entry) => + _buildSkillItem(entry.key, entry.value) + ).toList(), + ], + ), + ], + ], + ), + ), + ), + ); + } + + Widget _buildStatItem( + String label, + String value, + IconData icon, + Color color, + ) { + return Column( + children: [ + Icon( + icon, + color: color, + size: 24, + ), + const SizedBox(height: 4), + Text( + value, + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: color, + ), + ), + Text( + label, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ); + } + + Widget _buildSkillItem(String skill, double score) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 2), + child: Row( + children: [ + Expanded( + flex: 2, + child: Text( + skill, + style: const TextStyle(fontSize: 12), + ), + ), + Expanded( + flex: 3, + child: LinearProgressIndicator( + value: score / 100, + backgroundColor: Colors.grey[300], + valueColor: AlwaysStoppedAnimation( + _getScoreColor(score), + ), + ), + ), + const SizedBox(width: 8), + Text( + '${score.toStringAsFixed(1)}', + style: const TextStyle( + fontSize: 12, + fontWeight: FontWeight.bold, + ), + ), + ], + ), + ); + } + + Color _getScoreColor(double score) { + if (score >= 80) return Colors.green; + if (score >= 60) return Colors.orange; + return Colors.red; + } +} \ No newline at end of file diff --git a/client/lib/features/writing/screens/writing_detail_screen.dart b/client/lib/features/writing/screens/writing_detail_screen.dart new file mode 100644 index 0000000..5807da0 --- /dev/null +++ b/client/lib/features/writing/screens/writing_detail_screen.dart @@ -0,0 +1,439 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/writing_task.dart'; +import 'writing_exercise_screen.dart'; +import '../providers/writing_provider.dart'; + +/// 写作练习详情页面 +class WritingDetailScreen extends ConsumerWidget { + final WritingTask task; + + const WritingDetailScreen({ + super.key, + required this.task, + }); + + @override + Widget build(BuildContext context, WidgetRef ref) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + title: const Text('写作详情'), + backgroundColor: Colors.white, + foregroundColor: Colors.black, + elevation: 0, + ), + body: SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildTaskHeader(), + const SizedBox(height: 20), + _buildTaskInfo(), + const SizedBox(height: 20), + _buildPrompt(), + const SizedBox(height: 20), + _buildRequirements(), + if (task.keywords.isNotEmpty) ...[ + const SizedBox(height: 20), + _buildKeywords(), + ], + const SizedBox(height: 30), + _buildStartButton(context, ref), + ], + ), + ), + ); + } + + Widget _buildTaskHeader() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + task.title, + style: const TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + ), + ), + ), + Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 6), + decoration: BoxDecoration( + color: _getDifficultyColor(task.difficulty), + borderRadius: BorderRadius.circular(16), + ), + child: Text( + task.difficulty.displayName, + style: const TextStyle( + fontSize: 14, + color: Colors.white, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + const SizedBox(height: 12), + Text( + task.description, + style: const TextStyle( + fontSize: 16, + color: Colors.grey, + height: 1.5, + ), + ), + ], + ), + ); + } + + Widget _buildTaskInfo() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '任务信息', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildInfoItem( + Icons.category, + '类型', + task.type.displayName, + const Color(0xFF2196F3), + ), + ), + Expanded( + child: _buildInfoItem( + Icons.timer, + '时间限制', + '${task.timeLimit}分钟', + const Color(0xFF4CAF50), + ), + ), + ], + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildInfoItem( + Icons.text_fields, + '字数要求', + '${task.wordLimit}词', + const Color(0xFFFF9800), + ), + ), + Expanded( + child: _buildInfoItem( + Icons.star, + '难度等级', + '${task.difficulty.level}级', + _getDifficultyColor(task.difficulty), + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildInfoItem(IconData icon, String label, String value, Color color) { + return Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Column( + children: [ + Icon( + icon, + color: color, + size: 24, + ), + const SizedBox(height: 8), + Text( + label, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + const SizedBox(height: 4), + Text( + value, + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: color, + ), + ), + ], + ), + ); + } + + Widget _buildPrompt() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '写作提示', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: const Color(0xFF2196F3).withOpacity(0.3), + ), + ), + child: Text( + task.prompt ?? '暂无写作提示', + style: const TextStyle( + fontSize: 16, + height: 1.6, + ), + ), + ), + ], + ), + ); + } + + Widget _buildRequirements() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '写作要求', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + ...task.requirements.map((requirement) => Padding( + padding: const EdgeInsets.only(bottom: 8), + child: Row( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Icon( + Icons.check_circle, + color: Color(0xFF4CAF50), + size: 20, + ), + const SizedBox(width: 8), + Expanded( + child: Text( + requirement, + style: const TextStyle( + fontSize: 14, + height: 1.5, + ), + ), + ), + ], + ), + )).toList(), + ], + ), + ); + } + + Widget _buildKeywords() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '关键词提示', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + Wrap( + spacing: 8, + runSpacing: 8, + children: task.keywords.map((keyword) => Container( + padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 6), + decoration: BoxDecoration( + color: const Color(0xFFFF9800).withOpacity(0.1), + borderRadius: BorderRadius.circular(16), + border: Border.all( + color: const Color(0xFFFF9800).withOpacity(0.3), + ), + ), + child: Text( + keyword, + style: const TextStyle( + fontSize: 14, + color: Color(0xFFFF9800), + fontWeight: FontWeight.w500, + ), + ), + )).toList(), + ), + ], + ), + ); + } + + Widget _buildStartButton(BuildContext context, WidgetRef ref) { + return SizedBox( + width: double.infinity, + height: 56, + child: ElevatedButton( + onPressed: () async { + showDialog( + context: context, + barrierDismissible: false, + builder: (context) => const Center(child: CircularProgressIndicator()), + ); + try { + final service = ref.read(writingServiceProvider); + final freshTask = await service.getWritingTask(task.id); + Navigator.pop(context); + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => WritingExerciseScreen(task: freshTask), + ), + ); + } catch (e) { + Navigator.pop(context); + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('加载失败'), + content: const Text('无法获取最新任务，稍后重试'), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('确定'), + ), + ], + ), + ); + } + }, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(16), + ), + elevation: 0, + ), + child: const Text( + '开始写作', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ), + ); + } + + Color _getDifficultyColor(WritingDifficulty difficulty) { + switch (difficulty) { + case WritingDifficulty.beginner: + return const Color(0xFF4CAF50); + case WritingDifficulty.elementary: + return const Color(0xFF8BC34A); + case WritingDifficulty.intermediate: + return const Color(0xFFFF9800); + case WritingDifficulty.upperIntermediate: + return const Color(0xFFFF5722); + case WritingDifficulty.advanced: + return const Color(0xFFF44336); + } + } +} \ No newline at end of file diff --git a/client/lib/features/writing/screens/writing_exercise_screen.dart b/client/lib/features/writing/screens/writing_exercise_screen.dart new file mode 100644 index 0000000..bb624b5 --- /dev/null +++ b/client/lib/features/writing/screens/writing_exercise_screen.dart @@ -0,0 +1,393 @@ +import 'dart:async'; +import 'package:flutter/material.dart'; +import '../models/writing_task.dart'; +import 'writing_result_screen.dart'; + +/// 写作练习页面 +class WritingExerciseScreen extends StatefulWidget { + final WritingTask task; + + const WritingExerciseScreen({ + super.key, + required this.task, + }); + + @override + State createState() => _WritingExerciseScreenState(); +} + +class _WritingExerciseScreenState extends State { + final TextEditingController _textController = TextEditingController(); + Timer? _timer; + int _remainingSeconds = 0; + int _wordCount = 0; + bool _isSubmitted = false; + + @override + void initState() { + super.initState(); + final minutes = widget.task.timeLimit > 0 ? widget.task.timeLimit : 30; + _remainingSeconds = minutes * 60; + _startTimer(); + _textController.addListener(_updateWordCount); + } + + @override + void dispose() { + _timer?.cancel(); + _textController.dispose(); + super.dispose(); + } + + void _startTimer() { + _timer = Timer.periodic(const Duration(seconds: 1), (timer) { + if (_remainingSeconds > 0) { + setState(() { + _remainingSeconds--; + }); + } else { + _submitWriting(); + } + }); + } + + void _updateWordCount() { + final text = _textController.text.trim(); + final words = text.isEmpty ? 0 : text.split(RegExp(r'\s+')).length; + setState(() { + _wordCount = words; + }); + } + + String _formatTime(int seconds) { + final minutes = seconds ~/ 60; + final remainingSeconds = seconds % 60; + return '${minutes.toString().padLeft(2, '0')}:${remainingSeconds.toString().padLeft(2, '0')}'; + } + + void _submitWriting() { + if (_isSubmitted) return; + + setState(() { + _isSubmitted = true; + }); + + _timer?.cancel(); + + Navigator.pushReplacement( + context, + MaterialPageRoute( + builder: (context) => WritingResultScreen( + task: widget.task, + content: _textController.text, + wordCount: _wordCount, + timeUsed: widget.task.timeLimit * 60 - _remainingSeconds, + ), + ), + ); + } + + void _showSubmitDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('提交写作'), + content: Text('确定要提交吗？当前已写${_wordCount}词，剩余时间${_formatTime(_remainingSeconds)}。'), + actions: [ + TextButton( + onPressed: () => Navigator.pop(context), + child: const Text('继续写作'), + ), + TextButton( + onPressed: () { + Navigator.pop(context); + _submitWriting(); + }, + child: const Text('确定提交'), + ), + ], + ), + ); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + title: Text(widget.task.title), + backgroundColor: Colors.white, + foregroundColor: Colors.black, + elevation: 0, + actions: [ + IconButton( + icon: const Icon(Icons.help_outline), + onPressed: _showTaskInfo, + ), + ], + ), + body: Column( + children: [ + _buildStatusBar(), + Expanded( + child: _buildWritingArea(), + ), + _buildBottomBar(), + ], + ), + ); + } + + Widget _buildStatusBar() { + final timeColor = _remainingSeconds < 300 ? Colors.red : const Color(0xFF2196F3); // 5分钟内显示红色 + final limit = widget.task.wordLimit > 0 ? widget.task.wordLimit : 200; + final wordColor = _wordCount > limit ? Colors.red : const Color(0xFF4CAF50); + + return Container( + padding: const EdgeInsets.all(16), + color: Colors.white, + child: Row( + children: [ + Expanded( + child: _buildStatusItem( + Icons.timer, + '剩余时间', + _formatTime(_remainingSeconds), + timeColor, + ), + ), + Container( + width: 1, + height: 40, + color: Colors.grey[300], + ), + Expanded( + child: _buildStatusItem( + Icons.text_fields, + '字数统计', + '$_wordCount/$limit', + wordColor, + ), + ), + ], + ), + ); + } + + Widget _buildStatusItem(IconData icon, String label, String value, Color color) { + return Column( + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + icon, + size: 16, + color: color, + ), + const SizedBox(width: 4), + Text( + label, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ), + const SizedBox(height: 4), + Text( + value, + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + color: color, + ), + ), + ], + ); + } + + Widget _buildWritingArea() { + return Container( + margin: const EdgeInsets.all(16), + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '写作提示：${widget.task.prompt}', + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + fontStyle: FontStyle.italic, + ), + ), + const SizedBox(height: 16), + Expanded( + child: TextField( + controller: _textController, + maxLines: null, + expands: true, + decoration: const InputDecoration( + hintText: '请在此处开始写作...', + border: InputBorder.none, + hintStyle: TextStyle( + color: Colors.grey, + fontSize: 16, + ), + ), + style: const TextStyle( + fontSize: 16, + height: 1.6, + ), + ), + ), + ], + ), + ); + } + + Widget _buildBottomBar() { + return Container( + padding: const EdgeInsets.all(16), + color: Colors.white, + child: Row( + children: [ + Expanded( + child: OutlinedButton( + onPressed: _showTaskInfo, + style: OutlinedButton.styleFrom( + foregroundColor: const Color(0xFF2196F3), + side: const BorderSide(color: Color(0xFF2196F3)), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + padding: const EdgeInsets.symmetric(vertical: 16), + ), + child: const Text('查看要求'), + ), + ), + const SizedBox(width: 16), + Expanded( + child: ElevatedButton( + onPressed: _wordCount > 0 ? _showSubmitDialog : null, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + padding: const EdgeInsets.symmetric(vertical: 16), + elevation: 0, + ), + child: const Text( + '提交写作', + style: TextStyle( + fontWeight: FontWeight.bold, + ), + ), + ), + ), + ], + ), + ); + } + + void _showTaskInfo() { + showModalBottomSheet( + context: context, + isScrollControlled: true, + backgroundColor: Colors.transparent, + builder: (context) => Container( + height: MediaQuery.of(context).size.height * 0.7, + decoration: const BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.vertical(top: Radius.circular(20)), + ), + child: Column( + children: [ + Container( + padding: const EdgeInsets.all(20), + child: Row( + children: [ + const Expanded( + child: Text( + '写作要求', + style: TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + ), + ), + ), + IconButton( + onPressed: () => Navigator.pop(context), + icon: const Icon(Icons.close), + ), + ], + ), + ), + Expanded( + child: SingleChildScrollView( + padding: const EdgeInsets.symmetric(horizontal: 20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildInfoSection('写作提示', widget.task.prompt ?? '暂无写作提示'), + const SizedBox(height: 20), + _buildInfoSection('写作要求', widget.task.requirements.join('\n• ')), + if (widget.task.keywords.isNotEmpty) ...[ + const SizedBox(height: 20), + _buildInfoSection('关键词', widget.task.keywords.join(', ')), + ], + ], + ), + ), + ), + ], + ), + ), + ); + } + + Widget _buildInfoSection(String title, String content) { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + title, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 8), + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(12), + ), + child: Text( + content, + style: const TextStyle( + fontSize: 14, + height: 1.5, + ), + ), + ), + ], + ); + } +} \ No newline at end of file diff --git a/client/lib/features/writing/screens/writing_history_screen.dart b/client/lib/features/writing/screens/writing_history_screen.dart new file mode 100644 index 0000000..5eb2dc5 --- /dev/null +++ b/client/lib/features/writing/screens/writing_history_screen.dart @@ -0,0 +1,86 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../models/writing_submission.dart'; +import '../providers/writing_provider.dart'; + +class WritingHistoryScreen extends StatefulWidget { + const WritingHistoryScreen({super.key}); + + @override + State createState() => _WritingHistoryScreenState(); +} + +class _WritingHistoryScreenState extends State { + @override + void initState() { + super.initState(); + WidgetsBinding.instance.addPostFrameCallback((_) { + Provider.of(context, listen: false).loadSubmissions(); + }); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('写作历史'), + ), + body: Consumer( + builder: (context, provider, child) { + if (provider.isLoading) { + return const Center(child: CircularProgressIndicator()); + } + + if (provider.error != null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Text(provider.error!), + ElevatedButton( + onPressed: () => provider.loadSubmissions(), + child: const Text('重试'), + ), + ], + ), + ); + } + + if (provider.submissions.isEmpty) { + return const Center( + child: Text('暂无写作记录'), + ); + } + + return ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: provider.submissions.length, + itemBuilder: (context, index) { + final submission = provider.submissions[index]; + return Card( + child: ListTile( + title: Text('写作任务 ${index + 1}'), + subtitle: Text( + '状态: ${submission.status.displayName}\n' + '字数: ${submission.wordCount}\n' + '时间: ${_formatDateTime(submission.submittedAt)}', + ), + trailing: submission.score != null + ? Text( + '${submission.score!.totalScore.toStringAsFixed(1)}分', + style: const TextStyle(fontWeight: FontWeight.bold), + ) + : null, + ), + ); + }, + ); + }, + ), + ); + } + + String _formatDateTime(DateTime dateTime) { + return '${dateTime.month}-${dateTime.day} ${dateTime.hour}:${dateTime.minute.toString().padLeft(2, '0')}'; + } +} \ No newline at end of file diff --git a/client/lib/features/writing/screens/writing_home_screen.dart b/client/lib/features/writing/screens/writing_home_screen.dart new file mode 100644 index 0000000..47ee8e2 --- /dev/null +++ b/client/lib/features/writing/screens/writing_home_screen.dart @@ -0,0 +1,690 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../auth/providers/auth_provider.dart'; +import '../widgets/writing_mode_card.dart'; +import '../models/writing_task.dart'; +import '../models/writing_record.dart'; +import '../providers/writing_provider.dart'; +import 'exam_writing_screen.dart'; + +/// 写作练习主页面 +class WritingHomeScreen extends ConsumerStatefulWidget { + const WritingHomeScreen({super.key}); + + @override + ConsumerState createState() => _WritingHomeScreenState(); +} + +class _WritingHomeScreenState extends ConsumerState { + bool _statsForceRefresh = false; + @override + Widget build(BuildContext context) { + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + backgroundColor: Colors.transparent, + elevation: 0, + leading: IconButton( + icon: const Icon(Icons.arrow_back, color: Colors.black87), + onPressed: () => Navigator.of(context).pop(), + ), + title: const Text( + '写作练习', + style: TextStyle( + color: Colors.black87, + fontSize: 18, + fontWeight: FontWeight.w600, + ), + ), + centerTitle: true, + ), + body: SingleChildScrollView( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildWritingModes(), + const SizedBox(height: 20), + _buildExamWriting(context), + const SizedBox(height: 20), + _buildRecentWritings(), + const SizedBox(height: 20), + _buildWritingProgress(), + const SizedBox(height: 100), // 底部导航栏空间 + ], + ), + ), + ), + ); + } + + Widget _buildWritingModes() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '写作模式', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: WritingModeCard( + title: '议论文写作', + subtitle: '观点论述练习', + icon: Icons.article, + color: const Color(0xFF2196F3), + type: WritingType.essay, + ), + ), + const SizedBox(width: 16), + Expanded( + child: WritingModeCard( + title: '应用文写作', + subtitle: '实用文体练习', + icon: Icons.email, + color: const Color(0xFF4CAF50), + type: WritingType.email, + ), + ), + ], + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: WritingModeCard( + title: '初级练习', + subtitle: '基础写作训练', + icon: Icons.school, + color: const Color(0xFFFF9800), + difficulty: WritingDifficulty.beginner, + ), + ), + const SizedBox(width: 16), + Expanded( + child: WritingModeCard( + title: '高级练习', + subtitle: '进阶写作挑战', + icon: Icons.star, + color: const Color(0xFFF44336), + difficulty: WritingDifficulty.advanced, + ), + ), + ], + ), + ], + ), + ); + } + + + + Widget _buildExamWriting(BuildContext context) { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '考试写作', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + GridView.count( + shrinkWrap: true, + physics: const NeverScrollableScrollPhysics(), + crossAxisCount: 2, + crossAxisSpacing: 12, + mainAxisSpacing: 12, + childAspectRatio: 2.5, + children: [ + _buildExamCard(context, '四六级', Icons.school, Colors.blue, ExamType.cet), + _buildExamCard(context, '考研', Icons.menu_book, Colors.red, ExamType.kaoyan), + _buildExamCard(context, '托福', Icons.flight_takeoff, Colors.green, ExamType.toefl), + _buildExamCard(context, '雅思', Icons.language, Colors.purple, ExamType.ielts), + ], + ), + ], + ), + ); + } + + Widget _buildExamCard(BuildContext context, String title, IconData icon, Color color, ExamType examType) { + return InkWell( + onTap: () { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => ExamWritingScreen( + examType: examType, + title: title, + ), + ), + ); + }, + borderRadius: BorderRadius.circular(8), + child: Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Icon( + icon, + color: color, + size: 24, + ), + const SizedBox(width: 8), + Expanded( + child: Text( + title, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w500, + color: color, + ), + ), + ), + ], + ), + ), + ); + } + + Widget _buildRecentWritings() { + final user = ref.watch(currentUserProvider); + final userId = user?.id?.toString() ?? ''; + final historyAsync = ref.watch(userWritingHistoryProvider(userId)); + + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + const Text( + '最近写作', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox.shrink(), + ], + ), + const SizedBox(height: 16), + historyAsync.when( + data: (records) { + if (records.isEmpty) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.edit_note, + size: 48, + color: Colors.grey[400], + ), + const SizedBox(height: 12), + Text( + '还没有完成的写作', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + Text( + '完成一篇写作练习后，记录会显示在这里', + style: TextStyle( + fontSize: 12, + color: Colors.grey[500], + ), + textAlign: TextAlign.center, + ), + ], + ), + ); + } + + return Column( + children: records.take(3).map((record) { + // 将WritingSubmission转换为WritingRecord显示 + final writingRecord = WritingRecord( + id: record.id, + taskId: record.taskId, + taskTitle: '写作任务', + taskDescription: '', + content: record.content, + wordCount: record.wordCount, + timeUsed: record.timeSpent, + score: record.score?.totalScore.toInt() ?? 0, + feedback: record.feedback?.toJson(), + completedAt: record.submittedAt, + ); + return Padding( + padding: const EdgeInsets.only(bottom: 12), + child: _buildWritingRecordItem(writingRecord), + ); + }).toList(), + ); + }, + loading: () => const Center( + child: Padding( + padding: EdgeInsets.all(20.0), + child: CircularProgressIndicator(), + ), + ), + error: (error, stack) => Container( + padding: const EdgeInsets.all(20), + child: Column( + children: [ + Icon( + Icons.error_outline, + size: 48, + color: Colors.grey[400], + ), + const SizedBox(height: 12), + Text( + '加载失败', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + TextButton( + onPressed: () { + ref.invalidate(userWritingHistoryProvider(userId)); + }, + child: const Text('重试'), + ), + ], + ), + ), + ), + ], + ), + ); + } + + Widget _buildWritingRecordItem(WritingRecord record) { + return Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Container( + width: 40, + height: 40, + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(20), + ), + child: const Icon( + Icons.description, + color: Color(0xFF2196F3), + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + record.taskTitle, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + ), + ), + Text( + record.taskDescription, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + maxLines: 1, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 4), + Row( + children: [ + Text( + record.formattedDate, + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + ), + const SizedBox(width: 8), + Text( + '${record.wordCount}词', + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + ), + const SizedBox(width: 8), + Text( + record.formattedTime, + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + ), + ], + ), + ], + ), + ), + Column( + children: [ + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: _getScoreColor(record.score), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + record.scoreText, + style: const TextStyle( + fontSize: 12, + color: Colors.white, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + ], + ), + ); + } + + Color _getScoreColor(int score) { + if (score >= 90) return const Color(0xFF4CAF50); + if (score >= 80) return const Color(0xFF2196F3); + if (score >= 70) return const Color(0xFFFF9800); + return const Color(0xFFFF5722); + } + + Widget _buildWritingItem( + String title, + String subtitle, + String score, + String date, + ) { + return Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(8), + ), + child: Row( + children: [ + Container( + width: 40, + height: 40, + decoration: BoxDecoration( + color: const Color(0xFF2196F3).withOpacity(0.1), + borderRadius: BorderRadius.circular(20), + ), + child: const Icon( + Icons.description, + color: Color(0xFF2196F3), + ), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + title, + style: const TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + ), + ), + Text( + subtitle, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + const SizedBox(height: 4), + Text( + date, + style: const TextStyle( + fontSize: 10, + color: Colors.grey, + ), + ), + ], + ), + ), + Column( + children: [ + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: const Color(0xFF2196F3), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + score, + style: const TextStyle( + fontSize: 12, + color: Colors.white, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildWritingProgress() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '写作统计', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Consumer( + builder: (context, ref, _) { + final service = ref.watch(writingServiceProvider); + final user = ref.watch(currentUserProvider); + final userId = user?.id?.toString() ?? ''; + return FutureBuilder( + future: service.getUserWritingStats(userId, forceRefresh: _statsForceRefresh), + builder: (context, snapshot) { + if (snapshot.connectionState == ConnectionState.waiting) { + return const Center(child: CircularProgressIndicator()); + } + if (snapshot.hasError) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 48, + color: Colors.grey[400], + ), + const SizedBox(height: 12), + Text( + '统计加载失败', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + TextButton( + onPressed: () { + setState(() { + _statsForceRefresh = !_statsForceRefresh; + }); + }, + child: const Text('重试'), + ), + ], + ), + ); + } + if (!snapshot.hasData) { + return const SizedBox.shrink(); + } + final stats = snapshot.data!; + if (stats.completedTasks == 0) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.insights, + size: 48, + color: Colors.grey[400], + ), + const SizedBox(height: 12), + Text( + '暂无写作统计', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + TextButton( + onPressed: () { + setState(() { + _statsForceRefresh = !_statsForceRefresh; + }); + }, + child: const Text('刷新'), + ), + ], + ), + ); + } + return Row( + mainAxisAlignment: MainAxisAlignment.spaceAround, + children: [ + _buildProgressItem('${stats.completedTasks}', '完成篇数', Icons.article), + _buildProgressItem('${stats.averageScore.toStringAsFixed(0)}', '平均分', Icons.grade), + _buildProgressItem('${((stats.skillAnalysis.criteriaScores['grammar'] ?? 0.0) * 100).toStringAsFixed(0)}%', '语法正确率', Icons.spellcheck), + ], + ); + }, + ); + }, + ), + ], + ), + ); + } + + Widget _buildProgressItem(String value, String label, IconData icon) { + return Column( + children: [ + Icon( + icon, + color: const Color(0xFF2196F3), + size: 24, + ), + const SizedBox(height: 8), + Text( + value, + style: const TextStyle( + fontSize: 20, + fontWeight: FontWeight.bold, + color: Color(0xFF2196F3), + ), + ), + const SizedBox(height: 4), + Text( + label, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ); + } +} \ No newline at end of file diff --git a/client/lib/features/writing/screens/writing_list_screen.dart b/client/lib/features/writing/screens/writing_list_screen.dart new file mode 100644 index 0000000..9195a6f --- /dev/null +++ b/client/lib/features/writing/screens/writing_list_screen.dart @@ -0,0 +1,392 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/writing_task.dart'; +import '../providers/writing_provider.dart'; +import 'writing_detail_screen.dart'; + +/// 写作练习列表页面 +class WritingListScreen extends ConsumerStatefulWidget { + final WritingType? type; + final WritingDifficulty? difficulty; + final String title; + + const WritingListScreen({ + super.key, + this.type, + this.difficulty, + required this.title, + }); + + @override + ConsumerState createState() => _WritingListScreenState(); +} + +class _WritingListScreenState extends ConsumerState { + WritingDifficulty? selectedDifficulty; + WritingType? selectedType; + + @override + void initState() { + super.initState(); + selectedDifficulty = widget.difficulty; + selectedType = widget.type; + WidgetsBinding.instance.addPostFrameCallback((_) { + _loadTasks(); + }); + } + + void _loadTasks() { + ref.read(writingTasksProvider.notifier).loadTasks( + type: selectedType, + difficulty: selectedDifficulty, + page: 1, + ); + } + + @override + Widget build(BuildContext context) { + final state = ref.watch(writingTasksProvider); + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + title: Text(widget.title), + backgroundColor: Colors.white, + foregroundColor: Colors.black, + elevation: 0, + actions: [ + IconButton( + icon: const Icon(Icons.filter_list), + onPressed: _showFilterDialog, + ), + ], + ), + body: Column( + children: [ + if (selectedDifficulty != null || selectedType != null) + Container( + padding: const EdgeInsets.all(16), + color: Colors.white, + child: Row( + children: [ + if (selectedDifficulty != null) + Chip( + label: Text(selectedDifficulty!.displayName), + onDeleted: () { + setState(() { + selectedDifficulty = null; + }); + _loadTasks(); + }, + ), + if (selectedType != null) + Padding( + padding: const EdgeInsets.only(left: 8), + child: Chip( + label: Text(selectedType!.displayName), + onDeleted: () { + setState(() { + selectedType = null; + }); + _loadTasks(); + }, + ), + ), + ], + ), + ), + Expanded( + child: Builder( + builder: (context) { + if (state.isLoading) { + return const Center(child: CircularProgressIndicator()); + } + if (state.error != null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.error_outline, + size: 48, + color: Colors.grey[400], + ), + const SizedBox(height: 12), + Text( + '加载失败', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + const SizedBox(height: 8), + TextButton( + onPressed: _loadTasks, + child: const Text('重试'), + ), + ], + ), + ); + } + if (state.tasks.isEmpty) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + Icons.edit_note, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 12), + Text( + '暂无写作任务', + style: TextStyle( + fontSize: 14, + color: Colors.grey[600], + ), + ), + ], + ), + ); + } + return ListView.builder( + padding: const EdgeInsets.all(16), + itemCount: state.tasks.length, + itemBuilder: (context, index) { + final task = state.tasks[index]; + return _buildTaskCard(task); + }, + ); + }, + ), + ), + ], + ), + ); + } + + Widget _buildTaskCard(WritingTask task) { + return Container( + margin: const EdgeInsets.only(bottom: 16), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: InkWell( + onTap: () { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => WritingDetailScreen(task: task), + ), + ); + }, + borderRadius: BorderRadius.circular(16), + child: Padding( + padding: const EdgeInsets.all(20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + task.title, + style: const TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ), + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: _getDifficultyColor(task.difficulty), + borderRadius: BorderRadius.circular(12), + ), + child: Text( + task.difficulty.displayName, + style: const TextStyle( + fontSize: 12, + color: Colors.white, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + const SizedBox(height: 8), + Text( + task.description, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 12), + Row( + children: [ + _buildInfoChip( + Icons.category, + task.type.displayName, + const Color(0xFF2196F3), + ), + const SizedBox(width: 8), + _buildInfoChip( + Icons.timer, + '${task.timeLimit}分钟', + const Color(0xFF4CAF50), + ), + const SizedBox(width: 8), + _buildInfoChip( + Icons.text_fields, + '${task.wordLimit}词', + const Color(0xFFFF9800), + ), + ], + ), + if (task.keywords.isNotEmpty) ...[ + const SizedBox(height: 12), + Wrap( + spacing: 6, + runSpacing: 6, + children: task.keywords.take(3).map((keyword) => Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: Colors.grey[100], + borderRadius: BorderRadius.circular(8), + ), + child: Text( + keyword, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + )).toList(), + ), + ], + ], + ), + ), + ), + ); + } + + Widget _buildInfoChip(IconData icon, String text, Color color) { + return Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + icon, + size: 14, + color: color, + ), + const SizedBox(width: 4), + Text( + text, + style: TextStyle( + fontSize: 12, + color: color, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ); + } + + Color _getDifficultyColor(WritingDifficulty difficulty) { + switch (difficulty) { + case WritingDifficulty.beginner: + return const Color(0xFF4CAF50); + case WritingDifficulty.elementary: + return const Color(0xFF8BC34A); + case WritingDifficulty.intermediate: + return const Color(0xFFFF9800); + case WritingDifficulty.upperIntermediate: + return const Color(0xFFFF5722); + case WritingDifficulty.advanced: + return const Color(0xFFF44336); + } + } + + void _showFilterDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('筛选条件'), + content: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text('难度等级'), + const SizedBox(height: 8), + Wrap( + spacing: 8, + children: WritingDifficulty.values.map((difficulty) => FilterChip( + label: Text(difficulty.displayName), + selected: selectedDifficulty == difficulty, + onSelected: (selected) { + setState(() { + selectedDifficulty = selected ? difficulty : null; + }); + }, + )).toList(), + ), + const SizedBox(height: 16), + const Text('写作类型'), + const SizedBox(height: 8), + Wrap( + spacing: 8, + children: WritingType.values.map((type) => FilterChip( + label: Text(type.displayName), + selected: selectedType == type, + onSelected: (selected) { + setState(() { + selectedType = selected ? type : null; + }); + }, + )).toList(), + ), + ], + ), + actions: [ + TextButton( + onPressed: () { + setState(() { + selectedDifficulty = null; + selectedType = null; + }); + Navigator.pop(context); + _loadTasks(); + }, + child: const Text('清除'), + ), + TextButton( + onPressed: () { + Navigator.pop(context); + _loadTasks(); + }, + child: const Text('确定'), + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/writing/screens/writing_result_screen.dart b/client/lib/features/writing/screens/writing_result_screen.dart new file mode 100644 index 0000000..a021386 --- /dev/null +++ b/client/lib/features/writing/screens/writing_result_screen.dart @@ -0,0 +1,551 @@ +import 'package:flutter/material.dart'; +import '../models/writing_task.dart'; +import '../models/writing_record.dart'; +import '../services/writing_record_service.dart'; + +/// 写作结果页面 +class WritingResultScreen extends StatefulWidget { + final WritingTask task; + final String content; + final int wordCount; + final int timeUsed; // 使用的时间（秒） + + const WritingResultScreen({ + super.key, + required this.task, + required this.content, + required this.wordCount, + required this.timeUsed, + }); + + @override + State createState() => _WritingResultScreenState(); +} + +class _WritingResultScreenState extends State { + late int score; + late Map feedback; + bool _recordSaved = false; + + @override + void initState() { + super.initState(); + score = _calculateScore(); + feedback = _generateFeedback(score); + _saveWritingRecord(); + } + + Future _saveWritingRecord() async { + if (_recordSaved) return; + + final record = WritingRecord( + id: 'record_${DateTime.now().millisecondsSinceEpoch}', + taskId: widget.task.id, + taskTitle: widget.task.title, + taskDescription: widget.task.description, + content: widget.content, + wordCount: widget.wordCount, + timeUsed: widget.timeUsed, + score: score, + completedAt: DateTime.now(), + feedback: feedback, + ); + + await WritingRecordService.saveRecord(record); + _recordSaved = true; + } + + @override + Widget build(BuildContext context) { + + return Scaffold( + backgroundColor: const Color(0xFFF5F5F5), + appBar: AppBar( + title: const Text('写作结果'), + backgroundColor: Colors.white, + foregroundColor: Colors.black, + elevation: 0, + automaticallyImplyLeading: false, + actions: [ + IconButton( + icon: const Icon(Icons.close), + onPressed: () { + Navigator.popUntil(context, (route) => route.isFirst); + }, + ), + ], + ), + body: SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildScoreCard(score), + const SizedBox(height: 20), + _buildStatistics(), + const SizedBox(height: 20), + _buildFeedback(feedback), + const SizedBox(height: 20), + _buildContentReview(), + const SizedBox(height: 30), + _buildActionButtons(context), + ], + ), + ), + ); + } + + Widget _buildScoreCard(int score) { + Color scoreColor; + String scoreLevel; + + if (score >= 90) { + scoreColor = const Color(0xFF4CAF50); + scoreLevel = '优秀'; + } else if (score >= 80) { + scoreColor = const Color(0xFF2196F3); + scoreLevel = '良好'; + } else if (score >= 70) { + scoreColor = const Color(0xFFFF9800); + scoreLevel = '一般'; + } else { + scoreColor = const Color(0xFFF44336); + scoreLevel = '需要改进'; + } + + return Container( + padding: const EdgeInsets.all(24), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + children: [ + const Text( + '写作得分', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Container( + width: 120, + height: 120, + decoration: BoxDecoration( + shape: BoxShape.circle, + color: scoreColor.withOpacity(0.1), + border: Border.all( + color: scoreColor, + width: 4, + ), + ), + child: Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Text( + '$score', + style: TextStyle( + fontSize: 36, + fontWeight: FontWeight.bold, + color: scoreColor, + ), + ), + Text( + scoreLevel, + style: TextStyle( + fontSize: 14, + color: scoreColor, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ), + ), + const SizedBox(height: 16), + Text( + widget.task.title, + style: const TextStyle( + fontSize: 16, + color: Colors.grey, + ), + textAlign: TextAlign.center, + ), + ], + ), + ); + } + + Widget _buildStatistics() { + final timeUsedMinutes = (widget.timeUsed / 60).ceil(); + final timeLimit = widget.task.timeLimit; + final wordLimit = widget.task.wordLimit; + + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '写作统计', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildStatItem( + Icons.text_fields, + '字数', + '${widget.wordCount} / $wordLimit', + widget.wordCount <= wordLimit ? const Color(0xFF4CAF50) : const Color(0xFFF44336), + ), + ), + Expanded( + child: _buildStatItem( + Icons.timer, + '用时', + '$timeUsedMinutes / $timeLimit 分钟', + const Color(0xFF2196F3), + ), + ), + ], + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildStatItem( + Icons.category, + '类型', + widget.task.type.displayName, + const Color(0xFFFF9800), + ), + ), + Expanded( + child: _buildStatItem( + Icons.star, + '难度', + widget.task.difficulty.displayName, + _getDifficultyColor(widget.task.difficulty), + ), + ), + ], + ), + ], + ), + ); + } + + Widget _buildStatItem(IconData icon, String label, String value, Color color) { + return Container( + padding: const EdgeInsets.all(12), + margin: const EdgeInsets.symmetric(horizontal: 4), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Column( + children: [ + Icon( + icon, + color: color, + size: 24, + ), + const SizedBox(height: 8), + Text( + label, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + const SizedBox(height: 4), + Text( + value, + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: color, + ), + textAlign: TextAlign.center, + ), + ], + ), + ); + } + + Widget _buildFeedback(Map feedback) { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '评价反馈', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + _buildFeedbackItem('内容质量', feedback['content'], feedback['contentScore']), + const SizedBox(height: 12), + _buildFeedbackItem('语法准确性', feedback['grammar'], feedback['grammarScore']), + const SizedBox(height: 12), + _buildFeedbackItem('词汇运用', feedback['vocabulary'], feedback['vocabularyScore']), + const SizedBox(height: 12), + _buildFeedbackItem('结构组织', feedback['structure'], feedback['structureScore']), + ], + ), + ); + } + + Widget _buildFeedbackItem(String title, String description, int score) { + Color scoreColor; + if (score >= 90) { + scoreColor = const Color(0xFF4CAF50); + } else if (score >= 80) { + scoreColor = const Color(0xFF2196F3); + } else if (score >= 70) { + scoreColor = const Color(0xFFFF9800); + } else { + scoreColor = const Color(0xFFF44336); + } + + return Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(12), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Expanded( + child: Text( + title, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + ), + Container( + padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4), + decoration: BoxDecoration( + color: scoreColor, + borderRadius: BorderRadius.circular(12), + ), + child: Text( + '$score分', + style: const TextStyle( + fontSize: 12, + color: Colors.white, + fontWeight: FontWeight.bold, + ), + ), + ), + ], + ), + const SizedBox(height: 8), + Text( + description, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + height: 1.5, + ), + ), + ], + ), + ); + } + + Widget _buildContentReview() { + return Container( + padding: const EdgeInsets.all(20), + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '写作内容', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 12), + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.grey[50], + borderRadius: BorderRadius.circular(12), + ), + child: Text( + widget.content.isEmpty ? '未提交任何内容' : widget.content, + style: const TextStyle( + fontSize: 14, + height: 1.6, + ), + ), + ), + ], + ), + ); + } + + Widget _buildActionButtons(BuildContext context) { + return Row( + children: [ + Expanded( + child: OutlinedButton( + onPressed: () { + Navigator.popUntil(context, (route) => route.isFirst); + }, + style: OutlinedButton.styleFrom( + foregroundColor: const Color(0xFF2196F3), + side: const BorderSide(color: Color(0xFF2196F3)), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + padding: const EdgeInsets.symmetric(vertical: 16), + ), + child: const Text('返回首页'), + ), + ), + const SizedBox(width: 16), + Expanded( + child: ElevatedButton( + onPressed: () { + // TODO: 实现重新练习功能 + Navigator.pop(context); + }, + style: ElevatedButton.styleFrom( + backgroundColor: const Color(0xFF2196F3), + foregroundColor: Colors.white, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + padding: const EdgeInsets.symmetric(vertical: 16), + elevation: 0, + ), + child: const Text( + '重新练习', + style: TextStyle( + fontWeight: FontWeight.bold, + ), + ), + ), + ), + ], + ); + } + + int _calculateScore() { + int score = 70; // 基础分数 + + // 字数评分 + if (widget.wordCount >= widget.task.wordLimit * 0.8 && widget.wordCount <= widget.task.wordLimit * 1.2) { + score += 10; + } else if (widget.wordCount >= widget.task.wordLimit * 0.6) { + score += 5; + } + + // 时间评分 + final timeUsedMinutes = widget.timeUsed / 60; + if (timeUsedMinutes <= widget.task.timeLimit) { + score += 10; + } + + // 内容长度评分 + if (widget.content.length > 100) { + score += 10; + } + + return score.clamp(0, 100); + } + + Map _generateFeedback(int score) { + return { + 'content': score >= 80 + ? '内容丰富，主题明确，论述清晰。' + : '内容需要更加充实，建议增加具体的例子和细节。', + 'contentScore': score >= 80 ? 85 : 75, + 'grammar': score >= 80 + ? '语法使用准确，句式多样。' + : '语法基本正确，建议注意时态和语态的使用。', + 'grammarScore': score >= 80 ? 88 : 78, + 'vocabulary': score >= 80 + ? '词汇运用恰当，表达准确。' + : '词汇使用基本准确，可以尝试使用更多高级词汇。', + 'vocabularyScore': score >= 80 ? 82 : 72, + 'structure': score >= 80 + ? '文章结构清晰，逻辑性强。' + : '文章结构基本合理，建议加强段落之间的连接。', + 'structureScore': score >= 80 ? 86 : 76, + }; + } + + Color _getDifficultyColor(WritingDifficulty difficulty) { + switch (difficulty) { + case WritingDifficulty.beginner: + return const Color(0xFF4CAF50); + case WritingDifficulty.elementary: + return const Color(0xFF8BC34A); + case WritingDifficulty.intermediate: + return const Color(0xFFFF9800); + case WritingDifficulty.upperIntermediate: + return const Color(0xFFFF5722); + case WritingDifficulty.advanced: + return const Color(0xFFF44336); + } + } +} \ No newline at end of file diff --git a/client/lib/features/writing/screens/writing_stats_screen.dart b/client/lib/features/writing/screens/writing_stats_screen.dart new file mode 100644 index 0000000..c82a2fc --- /dev/null +++ b/client/lib/features/writing/screens/writing_stats_screen.dart @@ -0,0 +1,273 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import '../models/writing_stats.dart'; +import '../providers/writing_provider.dart'; + +class WritingStatsScreen extends StatefulWidget { + const WritingStatsScreen({super.key}); + + @override + State createState() => _WritingStatsScreenState(); +} + +class _WritingStatsScreenState extends State { + @override + void initState() { + super.initState(); + WidgetsBinding.instance.addPostFrameCallback((_) { + Provider.of(context, listen: false).loadStats(); + }); + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('写作统计'), + ), + body: Consumer( + builder: (context, provider, child) { + if (provider.isLoading) { + return const Center(child: CircularProgressIndicator()); + } + + if (provider.error != null) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Text(provider.error!), + ElevatedButton( + onPressed: () => provider.loadStats(), + child: const Text('重试'), + ), + ], + ), + ); + } + + if (provider.stats == null) { + return const Center( + child: Text('暂无统计数据'), + ); + } + + final stats = provider.stats!; + return SingleChildScrollView( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + _buildOverviewCard(stats), + const SizedBox(height: 16), + _buildTaskTypeStats(stats), + const SizedBox(height: 16), + _buildDifficultyStats(stats), + const SizedBox(height: 16), + _buildSkillAnalysis(stats), + ], + ), + ); + }, + ), + ); + } + + Widget _buildOverviewCard(WritingStats stats) { + return Card( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '总体统计', + style: Theme.of(context).textTheme.titleLarge, + ), + const SizedBox(height: 16), + Row( + children: [ + Expanded( + child: _buildStatItem( + '完成任务', + '${stats.completedTasks}', + Icons.assignment_turned_in, + Colors.green, + ), + ), + Expanded( + child: _buildStatItem( + '总字数', + '${stats.totalWords}', + Icons.text_fields, + Colors.blue, + ), + ), + Expanded( + child: _buildStatItem( + '平均分', + '${stats.averageScore.toStringAsFixed(1)}', + Icons.star, + Colors.orange, + ), + ), + ], + ), + ], + ), + ), + ); + } + + Widget _buildStatItem(String label, String value, IconData icon, Color color) { + return Column( + children: [ + Icon(icon, color: color, size: 32), + const SizedBox(height: 8), + Text( + value, + style: TextStyle( + fontSize: 24, + fontWeight: FontWeight.bold, + color: color, + ), + ), + Text( + label, + style: const TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ); + } + + Widget _buildTaskTypeStats(WritingStats stats) { + return Card( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '任务类型分布', + style: Theme.of(context).textTheme.titleMedium, + ), + const SizedBox(height: 16), + ...stats.taskTypeStats.entries.map((entry) => Padding( + padding: const EdgeInsets.symmetric(vertical: 4), + child: Row( + children: [ + Expanded( + flex: 2, + child: Text(entry.key), + ), + Expanded( + flex: 3, + child: LinearProgressIndicator( + value: entry.value / stats.completedTasks, + backgroundColor: Colors.grey[300], + ), + ), + const SizedBox(width: 8), + Text('${entry.value}'), + ], + ), + )).toList(), + ], + ), + ), + ); + } + + Widget _buildDifficultyStats(WritingStats stats) { + return Card( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '难度分布', + style: Theme.of(context).textTheme.titleMedium, + ), + const SizedBox(height: 16), + ...stats.difficultyStats.entries.map((entry) => Padding( + padding: const EdgeInsets.symmetric(vertical: 4), + child: Row( + children: [ + Expanded( + flex: 2, + child: Text(entry.key), + ), + Expanded( + flex: 3, + child: LinearProgressIndicator( + value: entry.value / stats.completedTasks, + backgroundColor: Colors.grey[300], + ), + ), + const SizedBox(width: 8), + Text('${entry.value}'), + ], + ), + )).toList(), + ], + ), + ), + ); + } + + Widget _buildSkillAnalysis(WritingStats stats) { + return Card( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + '技能分析', + style: Theme.of(context).textTheme.titleMedium, + ), + const SizedBox(height: 16), + ...stats.skillAnalysis.criteriaScores.entries.map((entry) => Padding( + padding: const EdgeInsets.symmetric(vertical: 8), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text(entry.key), + Text( + '${(entry.value * 10).toStringAsFixed(1)}/10', + style: const TextStyle(fontWeight: FontWeight.bold), + ), + ], + ), + const SizedBox(height: 4), + LinearProgressIndicator( + value: entry.value, + backgroundColor: Colors.grey[300], + valueColor: AlwaysStoppedAnimation( + _getSkillColor(entry.value), + ), + ), + ], + ), + )).toList(), + ], + ), + ), + ); + } + + Color _getSkillColor(double value) { + if (value >= 0.9) return Colors.green; + if (value >= 0.8) return Colors.lightGreen; + if (value >= 0.7) return Colors.orange; + if (value >= 0.6) return Colors.deepOrange; + return Colors.red; + } +} \ No newline at end of file diff --git a/client/lib/features/writing/screens/writing_task_screen.dart b/client/lib/features/writing/screens/writing_task_screen.dart new file mode 100644 index 0000000..0fc19f6 --- /dev/null +++ b/client/lib/features/writing/screens/writing_task_screen.dart @@ -0,0 +1,437 @@ +import 'package:flutter/material.dart'; +import 'package:provider/provider.dart'; +import 'dart:async'; +import '../models/writing_task.dart'; +import '../models/writing_submission.dart'; +import '../providers/writing_provider.dart'; + +class WritingTaskScreen extends StatefulWidget { + final WritingTask task; + + const WritingTaskScreen({ + super.key, + required this.task, + }); + + @override + State createState() => _WritingTaskScreenState(); +} + +class _WritingTaskScreenState extends State { + final TextEditingController _contentController = TextEditingController(); + final ScrollController _scrollController = ScrollController(); + Timer? _timer; + int _elapsedSeconds = 0; + bool _isSubmitting = false; + bool _showInstructions = true; + int _wordCount = 0; + + @override + void initState() { + super.initState(); + _startTimer(); + _contentController.addListener(_updateWordCount); + } + + @override + void dispose() { + _timer?.cancel(); + _contentController.dispose(); + _scrollController.dispose(); + super.dispose(); + } + + void _startTimer() { + _timer = Timer.periodic(const Duration(seconds: 1), (timer) { + setState(() { + _elapsedSeconds++; + }); + + // 检查时间限制 + if (widget.task.timeLimit != null && + _elapsedSeconds >= widget.task.timeLimit! * 60) { + _showTimeUpDialog(); + } + }); + } + + void _updateWordCount() { + final text = _contentController.text; + final words = text.trim().split(RegExp(r'\s+')); + setState(() { + _wordCount = text.trim().isEmpty ? 0 : words.length; + }); + } + + void _showTimeUpDialog() { + showDialog( + context: context, + barrierDismissible: false, + builder: (context) => AlertDialog( + title: const Text('时间到！'), + content: const Text('写作时间已结束，请提交您的作品。'), + actions: [ + TextButton( + onPressed: () { + Navigator.of(context).pop(); + _submitWriting(); + }, + child: const Text('提交'), + ), + ], + ), + ); + } + + Future _submitWriting() async { + if (_isSubmitting) return; + + final content = _contentController.text.trim(); + if (content.isEmpty) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('请输入写作内容')), + ); + return; + } + + setState(() { + _isSubmitting = true; + }); + + try { + final provider = Provider.of(context, listen: false); + // 首先开始任务（如果还没有开始） + if (provider.currentSubmission == null) { + await provider.startTask(widget.task.id); + } + // 更新内容 + provider.updateContent(content); + provider.updateTimeSpent(_elapsedSeconds); + // 提交写作 + final success = await provider.submitWriting(); + + if (mounted && success) { + Navigator.of(context).pop(true); + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('写作已提交，正在批改中...')), + ); + } else if (mounted && !success) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('提交失败，请重试')), + ); + } + } catch (e) { + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + SnackBar(content: Text('提交失败: $e')), + ); + } + } finally { + if (mounted) { + setState(() { + _isSubmitting = false; + }); + } + } + } + + String _formatTime(int seconds) { + final minutes = seconds ~/ 60; + final remainingSeconds = seconds % 60; + return '${minutes.toString().padLeft(2, '0')}:${remainingSeconds.toString().padLeft(2, '0')}'; + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: Text(widget.task.title), + actions: [ + IconButton( + icon: Icon(_showInstructions ? Icons.visibility_off : Icons.visibility), + onPressed: () { + setState(() { + _showInstructions = !_showInstructions; + }); + }, + ), + IconButton( + icon: const Icon(Icons.help_outline), + onPressed: _showHelpDialog, + ), + ], + ), + body: Column( + children: [ + // 状态栏 + Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.grey[100], + border: Border( + bottom: BorderSide(color: Colors.grey[300]!), + ), + ), + child: Row( + children: [ + Icon( + Icons.timer, + size: 20, + color: _getTimeColor(), + ), + const SizedBox(width: 8), + Text( + _formatTime(_elapsedSeconds), + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: _getTimeColor(), + ), + ), + if (widget.task.timeLimit != null) + Text( + ' / ${widget.task.timeLimit}分钟', + style: const TextStyle(fontSize: 14, color: Colors.grey), + ), + const Spacer(), + Icon( + Icons.text_fields, + size: 20, + color: _getWordCountColor(_wordCount), + ), + const SizedBox(width: 8), + Text( + '$_wordCount', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: _getWordCountColor(_wordCount), + ), + ), + if (widget.task.wordLimit != null) + Text( + ' / ${widget.task.wordLimit}字', + style: const TextStyle(fontSize: 14, color: Colors.grey), + ), + ], + ), + ), + + // 任务说明 + if (_showInstructions) + Container( + width: double.infinity, + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.blue[50], + border: Border( + bottom: BorderSide(color: Colors.grey[300]!), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + Icon( + Icons.assignment, + color: Colors.blue[700], + size: 20, + ), + const SizedBox(width: 8), + Text( + '任务要求', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.blue[700], + ), + ), + ], + ), + const SizedBox(height: 8), + Text( + widget.task.description, + style: const TextStyle(fontSize: 14), + ), + if (widget.task.requirements.isNotEmpty) ...[ + const SizedBox(height: 12), + const Text( + '具体要求:', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 4), + ...widget.task.requirements.map((req) => Padding( + padding: const EdgeInsets.only(left: 16, bottom: 2), + child: Text( + '• $req', + style: const TextStyle(fontSize: 13), + ), + )).toList(), + ], + if (widget.task.keywords.isNotEmpty) ...[ + const SizedBox(height: 12), + const Text( + '关键词:', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 4), + Wrap( + spacing: 8, + children: widget.task.keywords.map((keyword) => Chip( + label: Text( + keyword, + style: const TextStyle(fontSize: 12), + ), + backgroundColor: Colors.blue[100], + materialTapTargetSize: MaterialTapTargetSize.shrinkWrap, + )).toList(), + ), + ], + if (widget.task.prompt != null && widget.task.prompt!.isNotEmpty) ...[ + const SizedBox(height: 12), + const Text( + '提示:', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.w600, + ), + ), + const SizedBox(height: 4), + Padding( + padding: const EdgeInsets.only(left: 16, bottom: 2), + child: Text( + '💡 ${widget.task.prompt}', + style: const TextStyle(fontSize: 13), + ), + ), + ], + ], + ), + ), + + // 写作区域 + Expanded( + child: Padding( + padding: const EdgeInsets.all(16), + child: TextField( + controller: _contentController, + maxLines: null, + expands: true, + decoration: const InputDecoration( + hintText: '请在此处开始写作...', + border: OutlineInputBorder(), + contentPadding: EdgeInsets.all(16), + ), + style: const TextStyle(fontSize: 16, height: 1.5), + ), + ), + ), + ], + ), + bottomNavigationBar: Container( + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Colors.white, + boxShadow: [ + BoxShadow( + color: Colors.grey.withOpacity(0.2), + spreadRadius: 1, + blurRadius: 3, + offset: const Offset(0, -1), + ), + ], + ), + child: Row( + children: [ + Expanded( + child: OutlinedButton( + onPressed: () => Navigator.of(context).pop(), + child: const Text('保存草稿'), + ), + ), + const SizedBox(width: 16), + Expanded( + child: ElevatedButton( + onPressed: _isSubmitting ? null : _submitWriting, + child: _isSubmitting + ? const SizedBox( + width: 20, + height: 20, + child: CircularProgressIndicator(strokeWidth: 2), + ) + : const Text('提交'), + ), + ), + ], + ), + ), + ); + } + + Color _getTimeColor() { + if (widget.task.timeLimit == null) return Colors.blue; + final remainingMinutes = (widget.task.timeLimit! * 60 - _elapsedSeconds) / 60; + if (remainingMinutes <= 5) return Colors.red; + if (remainingMinutes <= 10) return Colors.orange; + return Colors.blue; + } + + Color _getWordCountColor(int wordCount) { + if (widget.task.wordLimit == null) return Colors.green; + final ratio = wordCount / widget.task.wordLimit!; + if (ratio > 1.1) return Colors.red; + if (ratio > 0.9) return Colors.green; + if (ratio > 0.5) return Colors.orange; + return Colors.grey; + } + + void _showHelpDialog() { + showDialog( + context: context, + builder: (context) => AlertDialog( + title: const Text('写作帮助'), + content: const SingleChildScrollView( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + mainAxisSize: MainAxisSize.min, + children: [ + Text( + '写作技巧:', + style: TextStyle(fontWeight: FontWeight.bold), + ), + SizedBox(height: 8), + Text('• 仔细阅读任务要求，确保理解题意'), + Text('• 合理安排时间，留出检查和修改的时间'), + Text('• 注意文章结构，包括开头、主体和结尾'), + Text('• 使用多样化的词汇和句式'), + Text('• 检查语法、拼写和标点符号'), + SizedBox(height: 12), + Text( + '评分标准:', + style: TextStyle(fontWeight: FontWeight.bold), + ), + SizedBox(height: 8), + Text('• 内容相关性和完整性'), + Text('• 语言准确性和流畅性'), + Text('• 词汇丰富度和语法复杂性'), + Text('• 文章结构和逻辑性'), + ], + ), + ), + actions: [ + TextButton( + onPressed: () => Navigator.of(context).pop(), + child: const Text('知道了'), + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/writing/services/writing_record_service.dart b/client/lib/features/writing/services/writing_record_service.dart new file mode 100644 index 0000000..4b659fb --- /dev/null +++ b/client/lib/features/writing/services/writing_record_service.dart @@ -0,0 +1,168 @@ +import 'dart:convert'; +import 'package:shared_preferences/shared_preferences.dart'; +import '../models/writing_record.dart'; + +/// 写作记录管理服务 +class WritingRecordService { + static const String _recordsKey = 'writing_records'; + + /// 保存写作记录 + static Future saveRecord(WritingRecord record) async { + final prefs = await SharedPreferences.getInstance(); + final records = await getRecords(); + records.add(record); + + final recordsJson = records.map((r) => r.toJson()).toList(); + await prefs.setString(_recordsKey, jsonEncode(recordsJson)); + } + + /// 获取所有写作记录 + static Future> getRecords() async { + final prefs = await SharedPreferences.getInstance(); + final recordsString = prefs.getString(_recordsKey); + + if (recordsString == null) { + return []; + } + + try { + final recordsJson = jsonDecode(recordsString) as List; + return recordsJson.map((json) => WritingRecord.fromJson(json)).toList(); + } catch (e) { + return []; + } + } + + /// 获取最近的写作记录 + static Future> getRecentRecords({int limit = 5}) async { + final records = await getRecords(); + records.sort((a, b) => b.completedAt.compareTo(a.completedAt)); + return records.take(limit).toList(); + } + + /// 根据ID获取写作记录 + static Future getRecordById(String id) async { + final records = await getRecords(); + try { + return records.firstWhere((record) => record.id == id); + } catch (e) { + return null; + } + } + + /// 删除写作记录 + static Future deleteRecord(String id) async { + final prefs = await SharedPreferences.getInstance(); + final records = await getRecords(); + records.removeWhere((record) => record.id == id); + + final recordsJson = records.map((r) => r.toJson()).toList(); + await prefs.setString(_recordsKey, jsonEncode(recordsJson)); + } + + /// 获取写作统计数据 + static Future> getStatistics() async { + final records = await getRecords(); + + if (records.isEmpty) { + return { + 'totalCount': 0, + 'averageScore': 0, + 'totalTimeUsed': 0, + 'averageWordCount': 0, + }; + } + + final totalScore = records.fold(0, (sum, record) => sum + record.score); + final totalTimeUsed = records.fold(0, (sum, record) => sum + record.timeUsed); + final totalWordCount = records.fold(0, (sum, record) => sum + record.wordCount); + + return { + 'totalCount': records.length, + 'averageScore': (totalScore / records.length).round(), + 'totalTimeUsed': totalTimeUsed, + 'averageWordCount': (totalWordCount / records.length).round(), + }; + } + + /// 清空所有记录（用于测试） + static Future clearAllRecords() async { + final prefs = await SharedPreferences.getInstance(); + await prefs.remove(_recordsKey); + } + + /// 添加一些示例数据（用于演示） + static Future addSampleData() async { + final now = DateTime.now(); + + final sampleRecords = [ + WritingRecord( + id: 'record_1', + taskId: 'essay_1', + taskTitle: '市场调研报告', + taskDescription: '撰写一份关于新产品市场前景的调研报告。', + content: '随着科技的不断发展，智能手表市场呈现出强劲的增长势头。根据最新的市场调研数据显示，全球智能手表市场规模预计在未来五年内将保持年均15%的增长率。消费者对健康监测、运动追踪等功能的需求日益增长，为智能手表产品提供了广阔的市场空间。建议公司抓住这一机遇，加大研发投入，推出具有竞争力的产品。', + wordCount: 156, + timeUsed: 1800, // 30分钟 + score: 90, + completedAt: now.subtract(const Duration(days: 1)), + feedback: { + 'content': '内容丰富，主题明确，论述清晰。', + 'contentScore': 88, + 'grammar': '语法使用准确，句式多样。', + 'grammarScore': 92, + 'vocabulary': '词汇运用恰当，表达准确。', + 'vocabularyScore': 89, + 'structure': '文章结构清晰，逻辑性强。', + 'structureScore': 91, + }, + ), + WritingRecord( + id: 'record_2', + taskId: 'letter_1', + taskTitle: '我的理想房屋', + taskDescription: '描述你心目中理想房屋的样子。', + content: '我理想中的房屋坐落在一个安静的社区里，周围绿树成荫，环境优美。房屋采用现代简约风格设计，外观简洁大方。内部布局合理，包括宽敞的客厅、舒适的卧室、功能齐全的厨房和书房。特别是书房，我希望有一面大大的书墙，可以收藏我喜爱的书籍。房屋还应该有一个小花园，种植各种花草，让生活更加贴近自然。', + wordCount: 142, + timeUsed: 1200, // 20分钟 + score: 89, + completedAt: now.subtract(const Duration(days: 2)), + feedback: { + 'content': '内容充实，描述生动。', + 'contentScore': 87, + 'grammar': '语法基本正确，表达流畅。', + 'grammarScore': 90, + 'vocabulary': '词汇使用恰当，描述性强。', + 'vocabularyScore': 88, + 'structure': '结构清晰，层次分明。', + 'structureScore': 92, + }, + ), + WritingRecord( + id: 'record_3', + taskId: 'review_1', + taskTitle: '电影评论', + taskDescription: '写一篇关于最近观看电影的评论。', + content: '最近观看了《流浪地球2》这部科幻电影，给我留下了深刻的印象。影片在视觉效果方面表现出色，宏大的场面和精细的特效让人震撼。故事情节紧凑，人物刻画也比较丰满。特别是对人类面临危机时的团结精神的展现，很有感染力。不过，部分情节的发展略显仓促，希望能有更多的细节描述。总的来说，这是一部值得推荐的优秀科幻电影。', + wordCount: 138, + timeUsed: 1500, // 25分钟 + score: 92, + completedAt: now.subtract(const Duration(hours: 12)), + feedback: { + 'content': '评论客观全面，观点明确。', + 'contentScore': 90, + 'grammar': '语法准确，表达自然。', + 'grammarScore': 93, + 'vocabulary': '词汇丰富，用词精准。', + 'vocabularyScore': 91, + 'structure': '结构合理，逻辑清晰。', + 'structureScore': 94, + }, + ), + ]; + + for (final record in sampleRecords) { + await saveRecord(record); + } + } +} \ No newline at end of file diff --git a/client/lib/features/writing/services/writing_service.dart b/client/lib/features/writing/services/writing_service.dart new file mode 100644 index 0000000..a3aa4da --- /dev/null +++ b/client/lib/features/writing/services/writing_service.dart @@ -0,0 +1,242 @@ +import '../models/writing_task.dart'; +import '../models/writing_submission.dart'; +import '../models/writing_stats.dart'; +import '../../../core/network/api_client.dart'; +import '../../../core/network/api_endpoints.dart'; +import '../../../core/services/enhanced_api_service.dart'; +import '../../../core/models/api_response.dart'; +import '../models/writing_task.dart'; +import '../models/writing_submission.dart'; +import '../models/writing_stats.dart'; + +/// 写作训练服务 +class WritingService { + final EnhancedApiService _enhancedApiService = EnhancedApiService(); + + // 缓存时长配置 + static const Duration _shortCacheDuration = Duration(minutes: 5); + static const Duration _longCacheDuration = Duration(hours: 1); + + /// 获取写作任务列表 + Future> getWritingTasks({ + WritingType? type, + WritingDifficulty? difficulty, + int page = 1, + int limit = 20, + bool forceRefresh = false, + }) async { + try { + final response = await _enhancedApiService.get>( + ApiEndpoints.writingPrompts, + queryParameters: { + 'page': page, + 'limit': limit, + if (type != null) 'type': type.name, + if (difficulty != null) 'difficulty': difficulty.name, + }, + useCache: !forceRefresh, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final List list = data['data'] ?? []; + return list.map((json) => WritingTask.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取写作任务失败: $e'); + } + } + + /// 获取单个写作任务详情 + Future getWritingTask(String taskId) async { + try { + final response = await _enhancedApiService.get( + '${ApiEndpoints.writingPrompts}/$taskId', + cacheDuration: _longCacheDuration, + fromJson: (data) => WritingTask.fromJson(data['data']), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取写作任务详情失败: $e'); + } + } + + /// 提交写作作业 + Future submitWriting({ + required String taskId, + required String userId, + required String content, + required int timeSpent, + required int wordCount, + }) async { + try { + final response = await _enhancedApiService.post( + ApiEndpoints.writingSubmissions, + data: { + 'prompt_id': taskId, + 'user_id': userId, + 'content': content, + 'time_spent': timeSpent, + 'word_count': wordCount, + }, + fromJson: (data) => WritingSubmission.fromJson(data['data']), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('提交写作作业失败: $e'); + } + } + + /// 获取用户写作历史 + Future> getUserWritingHistory({ + required String userId, + int page = 1, + int limit = 20, + bool forceRefresh = false, + }) async { + try { + final response = await _enhancedApiService.get>( + ApiEndpoints.writingSubmissions, + queryParameters: { + 'page': page, + 'limit': limit, + }, + useCache: !forceRefresh, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final List list = data['data'] ?? []; + return list.map((json) => WritingSubmission.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取写作历史失败: $e'); + } + } + + /// 获取用户写作统计 + Future getUserWritingStats(String userId, {bool forceRefresh = false}) async { + try { + final response = await _enhancedApiService.get( + ApiEndpoints.writingStats, + useCache: !forceRefresh, + cacheDuration: _shortCacheDuration, + fromJson: (data) => WritingStats.fromJson(data['data']), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取写作统计失败: $e'); + } + } + + /// 获取写作反馈 + Future getWritingFeedback(String submissionId) async { + try { + final response = await _enhancedApiService.get( + '${ApiEndpoints.writingSubmissions}/$submissionId', + cacheDuration: _shortCacheDuration, + fromJson: (data) => WritingSubmission.fromJson(data['data']), + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取写作反馈失败: $e'); + } + } + + /// 搜索写作任务 + Future> searchWritingTasks({ + required String query, + WritingType? type, + WritingDifficulty? difficulty, + int page = 1, + int limit = 20, + bool forceRefresh = false, + }) async { + try { + final response = await _enhancedApiService.get>( + '${ApiEndpoints.writingPrompts}/search', + queryParameters: { + 'q': query, + 'page': page, + 'limit': limit, + if (type != null) 'type': type.name, + if (difficulty != null) 'difficulty': difficulty.name, + }, + useCache: !forceRefresh, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final List list = data['data'] ?? []; + return list.map((json) => WritingTask.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('搜索写作任务失败: $e'); + } + } + + /// 获取推荐的写作任务 + Future> getRecommendedWritingTasks({ + required String userId, + int limit = 10, + bool forceRefresh = false, + }) async { + try { + final response = await _enhancedApiService.get>( + '${ApiEndpoints.writingPrompts}/recommendations', + queryParameters: { + 'limit': limit, + }, + useCache: !forceRefresh, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final List list = data['data'] ?? []; + return list.map((json) => WritingTask.fromJson(json)).toList(); + }, + ); + + if (response.success && response.data != null) { + return response.data!; + } else { + throw Exception(response.message); + } + } catch (e) { + throw Exception('获取推荐写作任务失败: $e'); + } + } +} \ No newline at end of file diff --git a/client/lib/features/writing/widgets/writing_mode_card.dart b/client/lib/features/writing/widgets/writing_mode_card.dart new file mode 100644 index 0000000..7e55891 --- /dev/null +++ b/client/lib/features/writing/widgets/writing_mode_card.dart @@ -0,0 +1,111 @@ +import 'package:flutter/material.dart'; +import '../models/writing_task.dart'; +import '../screens/writing_list_screen.dart'; + +/// 写作模式卡片组件 +class WritingModeCard extends StatelessWidget { + final String title; + final String subtitle; + final IconData icon; + final Color color; + final WritingType? type; + final WritingDifficulty? difficulty; + + const WritingModeCard({ + super.key, + required this.title, + required this.subtitle, + required this.icon, + required this.color, + this.type, + this.difficulty, + }); + + @override + Widget build(BuildContext context) { + return Container( + decoration: BoxDecoration( + color: Colors.white, + borderRadius: BorderRadius.circular(16), + boxShadow: [ + BoxShadow( + color: Colors.black.withOpacity(0.05), + blurRadius: 10, + offset: const Offset(0, 2), + ), + ], + ), + child: InkWell( + onTap: () { + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => WritingListScreen( + title: title, + type: type, + difficulty: difficulty, + ), + ), + ); + }, + borderRadius: BorderRadius.circular(16), + child: Padding( + padding: const EdgeInsets.all(20), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Container( + width: 48, + height: 48, + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Icon( + icon, + color: color, + size: 24, + ), + ), + const SizedBox(height: 16), + Text( + title, + style: const TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + subtitle, + style: const TextStyle( + fontSize: 14, + color: Colors.grey, + ), + ), + const SizedBox(height: 16), + Row( + children: [ + Text( + '开始练习', + style: TextStyle( + fontSize: 14, + color: color, + fontWeight: FontWeight.w500, + ), + ), + const SizedBox(width: 4), + Icon( + Icons.arrow_forward, + size: 16, + color: color, + ), + ], + ), + ], + ), + ), + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/features/writing/widgets/writing_stats_card.dart b/client/lib/features/writing/widgets/writing_stats_card.dart new file mode 100644 index 0000000..9a5bf5c --- /dev/null +++ b/client/lib/features/writing/widgets/writing_stats_card.dart @@ -0,0 +1,360 @@ +import 'package:flutter/material.dart'; +import '../models/writing_stats.dart'; + +class WritingStatsCard extends StatelessWidget { + final WritingStats stats; + final bool showDetails; + + const WritingStatsCard({ + super.key, + required this.stats, + this.showDetails = false, + }); + + @override + Widget build(BuildContext context) { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: Container( + decoration: BoxDecoration( + borderRadius: BorderRadius.circular(12), + gradient: LinearGradient( + colors: [ + Colors.purple.shade50, + Colors.purple.shade100, + ], + begin: Alignment.topLeft, + end: Alignment.bottomRight, + ), + ), + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题 + Row( + children: [ + Icon( + Icons.analytics, + color: Colors.purple.shade700, + size: 20, + ), + const SizedBox(width: 8), + Text( + '写作统计', + style: TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + color: Colors.purple.shade700, + ), + ), + const Spacer(), + if (showDetails) + Icon( + Icons.keyboard_arrow_down, + color: Colors.purple.shade700, + ), + ], + ), + const SizedBox(height: 16), + + // 主要统计数据 + Row( + children: [ + Expanded( + child: _buildStatItem( + icon: Icons.assignment, + label: '完成任务', + value: '${stats.completedTasks}', + total: '${stats.totalTasks}', + color: Colors.blue, + ), + ), + const SizedBox(width: 16), + Expanded( + child: _buildStatItem( + icon: Icons.text_fields, + label: '总字数', + value: _formatNumber(stats.totalWords), + color: Colors.green, + ), + ), + const SizedBox(width: 16), + Expanded( + child: _buildStatItem( + icon: Icons.star, + label: '平均分', + value: stats.averageScore.toStringAsFixed(1), + color: Colors.orange, + ), + ), + ], + ), + + if (showDetails) ...[ + + const SizedBox(height: 16), + const Divider(), + const SizedBox(height: 16), + + // 详细统计 + _buildDetailedStats(), + ], + ], + ), + ), + ); + } + + Widget _buildStatItem({ + required IconData icon, + required String label, + required String value, + String? total, + required Color color, + }) { + return Column( + children: [ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: color.withValues(alpha: 0.1), + borderRadius: BorderRadius.circular(12), + ), + child: Icon( + icon, + color: color, + size: 24, + ), + ), + const SizedBox(height: 8), + Text( + total != null ? '$value/$total' : value, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 4), + Text( + label, + style: TextStyle( + fontSize: 12, + color: Colors.grey.shade600, + ), + textAlign: TextAlign.center, + ), + ], + ); + } + + Widget _buildDetailedStats() { + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 任务类型统计 + Text( + '任务类型分布', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: Colors.grey.shade700, + ), + ), + const SizedBox(height: 8), + _buildTypeStats(), + + const SizedBox(height: 16), + + // 难度分布 + Text( + '难度分布', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: Colors.grey.shade700, + ), + ), + const SizedBox(height: 8), + _buildDifficultyStats(), + + const SizedBox(height: 16), + + // 技能分析 + // 技能分析 + Text( + '技能分析', + style: TextStyle( + fontSize: 14, + fontWeight: FontWeight.bold, + color: Colors.grey.shade700, + ), + ), + const SizedBox(height: 8), + _buildSkillAnalysis(), + + ], + ); + } + + Widget _buildTypeStats() { + return Wrap( + spacing: 8, + runSpacing: 8, + children: stats.taskTypeStats.entries.map((entry) { + final percentage = stats.totalTasks > 0 + ? (entry.value / stats.totalTasks * 100).toInt() + : 0; + + return Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: Colors.blue.withValues(alpha: 0.1), + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: Colors.blue.withValues(alpha: 0.3), + ), + ), + child: Text( + '${entry.key}: ${entry.value} ($percentage%)', + style: TextStyle( + fontSize: 12, + color: Colors.blue.shade700, + ), + ), + ); + }).toList(), + ); + } + + Widget _buildDifficultyStats() { + return Wrap( + spacing: 8, + runSpacing: 8, + children: stats.difficultyStats.entries.map((entry) { + final percentage = stats.totalTasks > 0 + ? (entry.value / stats.totalTasks * 100).toInt() + : 0; + + Color color; + switch (entry.key) { + case 'beginner': + case 'elementary': + color = Colors.green; + break; + case 'intermediate': + case 'upperIntermediate': + color = Colors.orange; + break; + case 'advanced': + color = Colors.red; + break; + default: + color = Colors.grey; + } + + return Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: color.withValues(alpha: 0.1), + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: color.withValues(alpha: 0.3), + ), + ), + child: Text( + '${entry.key}: ${entry.value} ($percentage%)', + style: TextStyle( + fontSize: 12, + color: Colors.grey[700], + ), + ), + ); + }).toList(), + ); + } + + Widget _buildSkillAnalysis() { + final analysis = stats.skillAnalysis; + + return Column( + children: [ + ...analysis.criteriaScores.entries.map((entry) { + Color color; + switch (entry.key) { + case 'grammar': + color = Colors.blue; + break; + case 'vocabulary': + color = Colors.green; + break; + case 'structure': + color = Colors.orange; + break; + case 'content': + color = Colors.purple; + break; + default: + color = Colors.grey; + } + return Padding( + padding: const EdgeInsets.only(bottom: 8), + child: _buildSkillBar(entry.key, entry.value * 100, color), + ); + }), + ], + ); + } + + Widget _buildSkillBar(String skill, double score, Color color) { + return Row( + children: [ + SizedBox( + width: 60, + child: Text( + skill, + style: TextStyle( + fontSize: 12, + color: Colors.grey.shade600, + ), + ), + ), + Expanded( + child: LinearProgressIndicator( + value: score / 100, + backgroundColor: Colors.grey.shade200, + valueColor: AlwaysStoppedAnimation(color), + ), + ), + const SizedBox(width: 8), + Text( + '${score.toInt()}', + style: TextStyle( + fontSize: 12, + fontWeight: FontWeight.bold, + color: color, + ), + ), + ], + ); + } + + String _formatNumber(int number) { + if (number >= 1000000) { + return '${(number / 1000000).toStringAsFixed(1)}M'; + } else if (number >= 1000) { + return '${(number / 1000).toStringAsFixed(1)}K'; + } else { + return number.toString(); + } + } +} \ No newline at end of file diff --git a/client/lib/features/writing/widgets/writing_task_card.dart b/client/lib/features/writing/widgets/writing_task_card.dart new file mode 100644 index 0000000..aa4ad17 --- /dev/null +++ b/client/lib/features/writing/widgets/writing_task_card.dart @@ -0,0 +1,271 @@ +import 'package:flutter/material.dart'; +import '../models/writing_task.dart'; + +class WritingTaskCard extends StatelessWidget { + final WritingTask task; + final VoidCallback? onTap; + final bool showProgress; + + const WritingTaskCard({ + Key? key, + required this.task, + this.onTap, + this.showProgress = false, + }) : super(key: key); + + @override + Widget build(BuildContext context) { + return Card( + elevation: 2, + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(12), + ), + child: InkWell( + onTap: onTap, + borderRadius: BorderRadius.circular(12), + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + // 标题和类型 + Row( + children: [ + Expanded( + child: Text( + task.title, + style: const TextStyle( + fontSize: 16, + fontWeight: FontWeight.bold, + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ), + const SizedBox(width: 8), + _buildTypeChip(), + ], + ), + const SizedBox(height: 8), + + // 描述 + Text( + task.description, + style: TextStyle( + color: Colors.grey.shade600, + fontSize: 14, + ), + maxLines: 3, + overflow: TextOverflow.ellipsis, + ), + const SizedBox(height: 12), + + // 任务信息 + Row( + children: [ + _buildInfoChip( + icon: Icons.signal_cellular_alt, + label: task.difficulty.displayName, + color: _getDifficultyColor(), + ), + const SizedBox(width: 8), + if (task.timeLimit > 0) + _buildInfoChip( + icon: Icons.timer, + label: '${task.timeLimit}分钟', + color: Colors.blue, + ), + const SizedBox(width: 8), + if (task.wordLimit > 0) + _buildInfoChip( + icon: Icons.text_fields, + label: '${task.wordLimit}词', + color: Colors.green, + ), + ], + ), + + // 关键词 + if (task.keywords.isNotEmpty) ...[ + const SizedBox(height: 12), + Wrap( + spacing: 6, + runSpacing: 6, + children: task.keywords.take(3).map((keyword) { + return Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: Colors.purple.shade50, + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: Colors.purple.shade200, + width: 1, + ), + ), + child: Text( + keyword, + style: TextStyle( + color: Colors.purple.shade700, + fontSize: 12, + ), + ), + ); + }).toList(), + ), + ], + + // 进度条（如果需要显示） + if (showProgress) ...[ + const SizedBox(height: 12), + _buildProgressBar(), + ], + ], + ), + ), + ), + ); + } + + Widget _buildTypeChip() { + return Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: _getTypeColor().withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + border: Border.all( + color: _getTypeColor(), + width: 1, + ), + ), + child: Text( + task.type.displayName, + style: TextStyle( + color: _getTypeColor(), + fontSize: 12, + fontWeight: FontWeight.w500, + ), + ), + ); + } + + Widget _buildInfoChip({ + required IconData icon, + required String label, + required Color color, + }) { + return Container( + padding: const EdgeInsets.symmetric( + horizontal: 8, + vertical: 4, + ), + decoration: BoxDecoration( + color: color.withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Row( + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + icon, + size: 14, + color: color, + ), + const SizedBox(width: 4), + Text( + label, + style: TextStyle( + color: color, + fontSize: 12, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + ); + } + + Widget _buildProgressBar() { + // TODO: 实现进度条逻辑 + const progress = 0.6; // 示例进度 + + return Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '完成进度', + style: TextStyle( + color: Colors.grey.shade600, + fontSize: 12, + ), + ), + Text( + '${(progress * 100).toInt()}%', + style: TextStyle( + color: Colors.grey.shade600, + fontSize: 12, + fontWeight: FontWeight.w500, + ), + ), + ], + ), + const SizedBox(height: 4), + LinearProgressIndicator( + value: progress, + backgroundColor: Colors.grey.shade200, + valueColor: AlwaysStoppedAnimation( + Colors.purple.shade600, + ), + ), + ], + ); + } + + Color _getTypeColor() { + switch (task.type) { + case WritingType.essay: + return Colors.blue; + case WritingType.letter: + return Colors.green; + case WritingType.report: + return Colors.orange; + case WritingType.story: + return Colors.purple; + case WritingType.review: + return Colors.red; + case WritingType.argument: + return Colors.teal; + case WritingType.article: + return Colors.indigo; + case WritingType.email: + return Colors.cyan; + case WritingType.diary: + return Colors.pink; + case WritingType.description: + return Colors.amber; + } + } + + Color _getDifficultyColor() { + switch (task.difficulty) { + case WritingDifficulty.beginner: + return Colors.green; + case WritingDifficulty.elementary: + return Colors.lightGreen; + case WritingDifficulty.intermediate: + return Colors.orange; + case WritingDifficulty.upperIntermediate: + return Colors.deepOrange; + case WritingDifficulty.advanced: + return Colors.red; + } + } +} \ No newline at end of file diff --git a/client/lib/main.dart b/client/lib/main.dart new file mode 100644 index 0000000..bc317e8 --- /dev/null +++ b/client/lib/main.dart @@ -0,0 +1,127 @@ +import 'package:flutter/material.dart'; +import 'dart:async'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import 'core/theme/app_theme.dart'; +import 'core/routes/app_routes.dart'; +import 'core/storage/storage_service.dart' as legacy_storage; +import 'core/services/storage_service.dart'; +import 'core/services/navigation_service.dart'; +import 'core/network/api_client.dart'; +import 'core/providers/providers.dart'; +import 'core/providers/app_state_provider.dart'; +import 'core/config/environment.dart'; +import 'shared/widgets/error_handler.dart'; + +void main() async { + WidgetsFlutterBinding.ensureInitialized(); + + FlutterError.onError = (FlutterErrorDetails details) { + debugPrint('FlutterError: ${details.exception}'); + }; + WidgetsBinding.instance.platformDispatcher.onError = (error, stack) { + debugPrint('ZoneError: $error'); + return true; + }; + + // 使用runZonedGuarded包裹启动流程，捕获所有未处理异常 + runZonedGuarded(() async { + // 初始化环境配置 + _initializeEnvironment(); + + // 初始化存储服务（两个都初始化以保持兼容性） + await legacy_storage.StorageService.init(); + await StorageService.getInstance(); + + // 初始化API客户端 + await ApiClient.getInstance(); + + // 创建Provider容器 + final container = ProviderContainer( + observers: GlobalProviders.observers, + overrides: GlobalProviders.overrides, + ); + + // 预加载Provider + await GlobalProviders.preloadProviders(container); + + runApp( + UncontrolledProviderScope( + container: container, + child: const MyApp(), + ), + ); + }, (error, stack) { + debugPrint('ZoneError: $error'); + }); +} + +/// 初始化环境配置 +void _initializeEnvironment() { + // 从编译时参数获取环境配置 + const environment = String.fromEnvironment('ENVIRONMENT', defaultValue: 'development'); + EnvironmentConfig.setEnvironmentFromString(environment); + + // 检查是否有自定义API地址 + const customApiUrl = String.fromEnvironment('API_BASE_URL'); + + debugPrint('========================================'); + debugPrint('Environment: ${EnvironmentConfig.environmentName}'); + debugPrint('API Base URL: ${EnvironmentConfig.baseUrl}'); + if (customApiUrl.isNotEmpty) { + debugPrint('Custom API URL: $customApiUrl'); + } + debugPrint('Debug Mode: ${EnvironmentConfig.debugMode}'); + debugPrint('Enable Logging: ${EnvironmentConfig.enableLogging}'); + debugPrint('========================================'); +} + +class MyApp extends ConsumerStatefulWidget { + const MyApp({super.key}); + + @override + ConsumerState createState() => _MyAppState(); +} + +class _MyAppState extends ConsumerState { + @override + void initState() { + super.initState(); + // 确保应用启动后立即关闭全局加载状态 + WidgetsBinding.instance.addPostFrameCallback((_) { + ref.read(appStateProvider.notifier).updateLoading(false); + }); + } + + @override + Widget build(BuildContext context) { + final appState = ref.watch(appStateProvider); + + return GlobalErrorHandler( + child: MaterialApp( + title: 'AI English Learning', + theme: AppTheme.lightTheme, + darkTheme: AppTheme.darkTheme, + themeMode: appState.themeMode, + navigatorKey: NavigationService.instance.navigatorKey, + initialRoute: Routes.home, + onGenerateRoute: AppRoutes.onGenerateRoute, + builder: (context, child) { + return Stack( + children: [ + child ?? const SizedBox.shrink(), + if (appState.isGlobalLoading) + const Positioned.fill( + child: Material( + color: Colors.black54, + child: Center( + child: CircularProgressIndicator(), + ), + ), + ), + ], + ); + }, + ), + ); + } +} diff --git a/client/lib/main_web.dart b/client/lib/main_web.dart new file mode 100644 index 0000000..629f4b7 --- /dev/null +++ b/client/lib/main_web.dart @@ -0,0 +1,9 @@ +import 'package:flutter/material.dart'; +import 'main.dart' as app; + +void main() { + // 禁用Google Fonts的自动加载 + WidgetsFlutterBinding.ensureInitialized(); + + app.main(); +} diff --git a/client/lib/pages/settings/developer_settings_page.dart b/client/lib/pages/settings/developer_settings_page.dart new file mode 100644 index 0000000..d2b0c47 --- /dev/null +++ b/client/lib/pages/settings/developer_settings_page.dart @@ -0,0 +1,318 @@ +import 'package:flutter/material.dart'; +import '../../core/config/environment.dart'; +import '../../core/services/storage_service.dart'; + +/// 开发者设置页面 +class DeveloperSettingsPage extends StatefulWidget { + const DeveloperSettingsPage({Key? key}) : super(key: key); + + @override + State createState() => _DeveloperSettingsPageState(); +} + +class _DeveloperSettingsPageState extends State { + late Environment _selectedEnvironment; + final TextEditingController _customUrlController = TextEditingController(); + bool _useCustomUrl = false; + + @override + void initState() { + super.initState(); + _selectedEnvironment = EnvironmentConfig.current; + _loadCustomUrl(); + } + + Future _loadCustomUrl() async { + final customUrl = StorageService.getString('custom_api_url'); + if (customUrl != null && customUrl.isNotEmpty) { + setState(() { + _useCustomUrl = true; + _customUrlController.text = customUrl; + }); + } + } + + Future _saveSettings() async { + if (_useCustomUrl) { + // 保存自定义URL + await StorageService.setString('custom_api_url', _customUrlController.text); + // 可以在这里动态更新API配置 + } else { + // 清除自定义URL + await StorageService.remove('custom_api_url'); + // 使用预设环境 + EnvironmentConfig.setEnvironment(_selectedEnvironment); + } + + if (mounted) { + ScaffoldMessenger.of(context).showSnackBar( + const SnackBar(content: Text('设置已保存，重启应用后生效')), + ); + } + } + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: AppBar( + title: const Text('开发者设置'), + actions: [ + IconButton( + icon: const Icon(Icons.save), + onPressed: _saveSettings, + tooltip: '保存设置', + ), + ], + ), + body: ListView( + padding: const EdgeInsets.all(16), + children: [ + // 当前环境信息 + Card( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '当前环境信息', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + _buildInfoRow('环境', EnvironmentConfig.environmentName), + _buildInfoRow('API地址', EnvironmentConfig.baseUrl), + _buildInfoRow('连接超时', '${EnvironmentConfig.connectTimeout}ms'), + _buildInfoRow('接收超时', '${EnvironmentConfig.receiveTimeout}ms'), + _buildInfoRow('日志', EnvironmentConfig.enableLogging ? '启用' : '禁用'), + ], + ), + ), + ), + const SizedBox(height: 16), + + // 环境选择 + Card( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '环境选择', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + RadioListTile( + title: const Text('开发环境 (Development)'), + subtitle: Text(EnvironmentConfig.developmentConfig['baseUrl'] ?? ''), + value: Environment.development, + groupValue: _selectedEnvironment, + onChanged: _useCustomUrl + ? null + : (value) { + if (value != null) { + setState(() { + _selectedEnvironment = value; + }); + } + }, + ), + RadioListTile( + title: const Text('预发布环境 (Staging)'), + subtitle: Text(EnvironmentConfig.stagingConfig['baseUrl'] ?? ''), + value: Environment.staging, + groupValue: _selectedEnvironment, + onChanged: _useCustomUrl + ? null + : (value) { + if (value != null) { + setState(() { + _selectedEnvironment = value; + }); + } + }, + ), + RadioListTile( + title: const Text('生产环境 (Production)'), + subtitle: Text(EnvironmentConfig.productionConfig['baseUrl'] ?? ''), + value: Environment.production, + groupValue: _selectedEnvironment, + onChanged: _useCustomUrl + ? null + : (value) { + if (value != null) { + setState(() { + _selectedEnvironment = value; + }); + } + }, + ), + ], + ), + ), + ), + const SizedBox(height: 16), + + // 自定义API地址 + Card( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + const Expanded( + child: Text( + '自定义API地址', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + ), + Switch( + value: _useCustomUrl, + onChanged: (value) { + setState(() { + _useCustomUrl = value; + }); + }, + ), + ], + ), + const SizedBox(height: 16), + TextField( + controller: _customUrlController, + enabled: _useCustomUrl, + decoration: const InputDecoration( + labelText: 'API基础URL', + hintText: 'http://localhost:8080/api/v1', + border: OutlineInputBorder(), + helperText: '输入完整的API基础URL', + ), + ), + const SizedBox(height: 8), + const Text( + '提示：开发环境常用地址\n' + '• Web: http://localhost:8080/api/v1\n' + '• Android模拟器: http://10.0.2.2:8080/api/v1\n' + '• iOS模拟器: http://localhost:8080/api/v1\n' + '• 真机: http://你的电脑IP:8080/api/v1', + style: TextStyle( + fontSize: 12, + color: Colors.grey, + ), + ), + ], + ), + ), + ), + const SizedBox(height: 16), + + // 预设地址快捷按钮 + Card( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + const Text( + '快捷设置', + style: TextStyle( + fontSize: 18, + fontWeight: FontWeight.bold, + ), + ), + const SizedBox(height: 16), + Wrap( + spacing: 8, + runSpacing: 8, + children: [ + ElevatedButton.icon( + onPressed: () { + setState(() { + _useCustomUrl = true; + _customUrlController.text = 'http://localhost:8080/api/v1'; + }); + }, + icon: const Icon(Icons.computer), + label: const Text('Localhost'), + ), + ElevatedButton.icon( + onPressed: () { + setState(() { + _useCustomUrl = true; + _customUrlController.text = 'http://10.0.2.2:8080/api/v1'; + }); + }, + icon: const Icon(Icons.phone_android), + label: const Text('Android模拟器'), + ), + ], + ), + ], + ), + ), + ), + const SizedBox(height: 32), + + // 警告信息 + const Card( + color: Colors.orange, + child: Padding( + padding: EdgeInsets.all(16), + child: Row( + children: [ + Icon(Icons.warning, color: Colors.white), + SizedBox(width: 16), + Expanded( + child: Text( + '注意：修改环境设置需要重启应用才能生效。\n此页面仅在开发模式下可用。', + style: TextStyle(color: Colors.white), + ), + ), + ], + ), + ), + ), + ], + ), + ); + } + + Widget _buildInfoRow(String label, String value) { + return Padding( + padding: const EdgeInsets.symmetric(vertical: 4), + child: Row( + children: [ + SizedBox( + width: 100, + child: Text( + '$label:', + style: const TextStyle(fontWeight: FontWeight.w500), + ), + ), + Expanded( + child: Text( + value, + style: const TextStyle(color: Colors.grey), + ), + ), + ], + ), + ); + } + + @override + void dispose() { + _customUrlController.dispose(); + super.dispose(); + } +} diff --git a/client/lib/shared/models/api_response.dart b/client/lib/shared/models/api_response.dart new file mode 100644 index 0000000..ee69745 --- /dev/null +++ b/client/lib/shared/models/api_response.dart @@ -0,0 +1,260 @@ +/// API响应基础模型 +class ApiResponse { + final bool success; + final String message; + final T? data; + final String? error; + final int? code; + final Map? meta; + + const ApiResponse({ + required this.success, + required this.message, + this.data, + this.error, + this.code, + this.meta, + }); + + factory ApiResponse.fromJson( + Map json, + T Function(dynamic)? fromJsonT, + ) { + return ApiResponse( + success: json['success'] as bool? ?? false, + message: json['message'] as String? ?? '', + data: json['data'] != null && fromJsonT != null + ? fromJsonT(json['data']) + : json['data'] as T?, + error: json['error'] as String?, + code: json['code'] as int?, + meta: json['meta'] as Map?, + ); + } + + Map toJson() { + return { + 'success': success, + 'message': message, + 'data': data, + 'error': error, + 'code': code, + 'meta': meta, + }; + } + + /// 成功响应 + factory ApiResponse.success({ + required String message, + T? data, + Map? meta, + }) { + return ApiResponse( + success: true, + message: message, + data: data, + meta: meta, + ); + } + + /// 失败响应 + factory ApiResponse.failure({ + required String message, + String? error, + int? code, + Map? meta, + }) { + return ApiResponse( + success: false, + message: message, + error: error, + code: code, + meta: meta, + ); + } + + /// 是否成功 + bool get isSuccess => success; + + /// 是否失败 + bool get isFailure => !success; + + @override + String toString() { + return 'ApiResponse(success: $success, message: $message, data: $data, error: $error)'; + } +} + +/// 分页响应模型 +class PaginatedResponse { + final List data; + final PaginationMeta pagination; + + const PaginatedResponse({ + required this.data, + required this.pagination, + }); + + factory PaginatedResponse.fromJson( + Map json, + T Function(Map) fromJsonT, + ) { + return PaginatedResponse( + data: (json['data'] as List) + .map((e) => fromJsonT(e as Map)) + .toList(), + pagination: PaginationMeta.fromJson(json['pagination'] as Map), + ); + } + + Map toJson() { + return { + 'data': data, + 'pagination': pagination.toJson(), + }; + } +} + +/// 分页元数据模型 +class PaginationMeta { + final int currentPage; + final int totalPages; + final int totalItems; + final int itemsPerPage; + final bool hasNextPage; + final bool hasPreviousPage; + + const PaginationMeta({ + required this.currentPage, + required this.totalPages, + required this.totalItems, + required this.itemsPerPage, + required this.hasNextPage, + required this.hasPreviousPage, + }); + + factory PaginationMeta.fromJson(Map json) { + return PaginationMeta( + currentPage: json['current_page'] as int, + totalPages: json['total_pages'] as int, + totalItems: json['total_items'] as int, + itemsPerPage: json['items_per_page'] as int, + hasNextPage: json['has_next_page'] as bool, + hasPreviousPage: json['has_previous_page'] as bool, + ); + } + + Map toJson() { + return { + 'current_page': currentPage, + 'total_pages': totalPages, + 'total_items': totalItems, + 'items_per_page': itemsPerPage, + 'has_next_page': hasNextPage, + 'has_previous_page': hasPreviousPage, + }; + } +} + +/// 认证响应模型 +class AuthResponse { + final String accessToken; + final String refreshToken; + final String tokenType; + final int expiresIn; + final Map? user; + + const AuthResponse({ + required this.accessToken, + required this.refreshToken, + required this.tokenType, + required this.expiresIn, + this.user, + }); + + factory AuthResponse.fromJson(Map json) { + return AuthResponse( + accessToken: json['access_token'] as String, + refreshToken: json['refresh_token'] as String, + tokenType: json['token_type'] as String? ?? 'Bearer', + expiresIn: json['expires_in'] as int, + user: json['user'] as Map?, + ); + } + + Map toJson() { + return { + 'access_token': accessToken, + 'refresh_token': refreshToken, + 'token_type': tokenType, + 'expires_in': expiresIn, + 'user': user, + }; + } +} + +/// 错误响应模型 +class ErrorResponse { + final String message; + final String? code; + final List? validationErrors; + final Map? details; + + const ErrorResponse({ + required this.message, + this.code, + this.validationErrors, + this.details, + }); + + factory ErrorResponse.fromJson(Map json) { + return ErrorResponse( + message: json['message'] as String, + code: json['code'] as String?, + validationErrors: json['validation_errors'] != null + ? (json['validation_errors'] as List) + .map((e) => ValidationError.fromJson(e as Map)) + .toList() + : null, + details: json['details'] as Map?, + ); + } + + Map toJson() { + return { + 'message': message, + 'code': code, + 'validation_errors': validationErrors?.map((e) => e.toJson()).toList(), + 'details': details, + }; + } +} + +/// 验证错误模型 +class ValidationError { + final String field; + final String message; + final String? code; + + const ValidationError({ + required this.field, + required this.message, + this.code, + }); + + factory ValidationError.fromJson(Map json) { + return ValidationError( + field: json['field'] as String, + message: json['message'] as String, + code: json['code'] as String?, + ); + } + + Map toJson() { + return { + 'field': field, + 'message': message, + 'code': code, + }; + } +} \ No newline at end of file diff --git a/client/lib/shared/models/notification_model.dart b/client/lib/shared/models/notification_model.dart new file mode 100644 index 0000000..a4adfea --- /dev/null +++ b/client/lib/shared/models/notification_model.dart @@ -0,0 +1,90 @@ +import 'package:json_annotation/json_annotation.dart'; + +part 'notification_model.g.dart'; + +/// 通知模型 +@JsonSerializable() +class NotificationModel { + final int id; + + @JsonKey(name: 'user_id') + final int userId; + + final String type; + final String title; + final String content; + final String? link; + + @JsonKey(name: 'is_read') + final bool isRead; + + final int priority; + + @JsonKey(name: 'created_at') + final DateTime createdAt; + + @JsonKey(name: 'read_at') + final DateTime? readAt; + + const NotificationModel({ + required this.id, + required this.userId, + required this.type, + required this.title, + required this.content, + this.link, + required this.isRead, + required this.priority, + required this.createdAt, + this.readAt, + }); + + factory NotificationModel.fromJson(Map json) => + _$NotificationModelFromJson(json); + + Map toJson() => _$NotificationModelToJson(this); + + /// 通知类型 + String get typeLabel { + switch (type) { + case 'system': + return '系统通知'; + case 'learning': + return '学习提醒'; + case 'achievement': + return '成就通知'; + default: + return '通知'; + } + } + + /// 优先级 + String get priorityLabel { + switch (priority) { + case 0: + return '普通'; + case 1: + return '重要'; + case 2: + return '紧急'; + default: + return '普通'; + } + } + + /// 格式化时间 + String get timeAgo { + final now = DateTime.now(); + final difference = now.difference(createdAt); + + if (difference.inDays > 0) { + return '${difference.inDays}天前'; + } else if (difference.inHours > 0) { + return '${difference.inHours}小时前'; + } else if (difference.inMinutes > 0) { + return '${difference.inMinutes}分钟前'; + } else { + return '刚刚'; + } + } +} diff --git a/client/lib/shared/models/notification_model.g.dart b/client/lib/shared/models/notification_model.g.dart new file mode 100644 index 0000000..99f9b1b --- /dev/null +++ b/client/lib/shared/models/notification_model.g.dart @@ -0,0 +1,37 @@ +// GENERATED CODE - DO NOT MODIFY BY HAND + +part of 'notification_model.dart'; + +// ************************************************************************** +// JsonSerializableGenerator +// ************************************************************************** + +NotificationModel _$NotificationModelFromJson(Map json) => + NotificationModel( + id: (json['id'] as num).toInt(), + userId: (json['user_id'] as num).toInt(), + type: json['type'] as String, + title: json['title'] as String, + content: json['content'] as String, + link: json['link'] as String?, + isRead: json['is_read'] as bool, + priority: (json['priority'] as num).toInt(), + createdAt: DateTime.parse(json['created_at'] as String), + readAt: json['read_at'] == null + ? null + : DateTime.parse(json['read_at'] as String), + ); + +Map _$NotificationModelToJson(NotificationModel instance) => + { + 'id': instance.id, + 'user_id': instance.userId, + 'type': instance.type, + 'title': instance.title, + 'content': instance.content, + 'link': instance.link, + 'is_read': instance.isRead, + 'priority': instance.priority, + 'created_at': instance.createdAt.toIso8601String(), + 'read_at': instance.readAt?.toIso8601String(), + }; diff --git a/client/lib/shared/models/user_model.dart b/client/lib/shared/models/user_model.dart new file mode 100644 index 0000000..b05fbe0 --- /dev/null +++ b/client/lib/shared/models/user_model.dart @@ -0,0 +1,220 @@ +import 'package:json_annotation/json_annotation.dart'; + +part 'user_model.g.dart'; + +/// 用户模型 +@JsonSerializable() +class UserModel { + @JsonKey(name: 'user_id') + final int userId; + + final String username; + final String email; + final String? nickname; + final String? avatar; + final String? phone; + final DateTime? birthday; + final String? gender; + final String? bio; + + @JsonKey(name: 'learning_level') + final String learningLevel; + + @JsonKey(name: 'target_language') + final String targetLanguage; + + @JsonKey(name: 'native_language') + final String nativeLanguage; + + @JsonKey(name: 'daily_goal') + final int dailyGoal; + + @JsonKey(name: 'study_streak') + final int studyStreak; + + @JsonKey(name: 'total_study_days') + final int totalStudyDays; + + @JsonKey(name: 'vocabulary_count') + final int vocabularyCount; + + @JsonKey(name: 'experience_points') + final int experiencePoints; + + @JsonKey(name: 'current_level') + final int currentLevel; + + @JsonKey(name: 'created_at') + final DateTime createdAt; + + @JsonKey(name: 'updated_at') + final DateTime updatedAt; + + @JsonKey(name: 'last_login_at') + final DateTime? lastLoginAt; + + @JsonKey(name: 'is_premium') + final bool isPremium; + + @JsonKey(name: 'premium_expires_at') + final DateTime? premiumExpiresAt; + + const UserModel({ + required this.userId, + required this.username, + required this.email, + this.nickname, + this.avatar, + this.phone, + this.birthday, + this.gender, + this.bio, + required this.learningLevel, + required this.targetLanguage, + required this.nativeLanguage, + required this.dailyGoal, + required this.studyStreak, + required this.totalStudyDays, + required this.vocabularyCount, + required this.experiencePoints, + required this.currentLevel, + required this.createdAt, + required this.updatedAt, + this.lastLoginAt, + required this.isPremium, + this.premiumExpiresAt, + }); + + factory UserModel.fromJson(Map json) => _$UserModelFromJson(json); + + Map toJson() => _$UserModelToJson(this); + + UserModel copyWith({ + int? userId, + String? username, + String? email, + String? nickname, + String? avatar, + String? phone, + DateTime? birthday, + String? gender, + String? bio, + String? learningLevel, + String? targetLanguage, + String? nativeLanguage, + int? dailyGoal, + int? studyStreak, + int? totalStudyDays, + int? vocabularyCount, + int? experiencePoints, + int? currentLevel, + DateTime? createdAt, + DateTime? updatedAt, + DateTime? lastLoginAt, + bool? isPremium, + DateTime? premiumExpiresAt, + }) { + return UserModel( + userId: userId ?? this.userId, + username: username ?? this.username, + email: email ?? this.email, + nickname: nickname ?? this.nickname, + avatar: avatar ?? this.avatar, + phone: phone ?? this.phone, + birthday: birthday ?? this.birthday, + gender: gender ?? this.gender, + bio: bio ?? this.bio, + learningLevel: learningLevel ?? this.learningLevel, + targetLanguage: targetLanguage ?? this.targetLanguage, + nativeLanguage: nativeLanguage ?? this.nativeLanguage, + dailyGoal: dailyGoal ?? this.dailyGoal, + studyStreak: studyStreak ?? this.studyStreak, + totalStudyDays: totalStudyDays ?? this.totalStudyDays, + vocabularyCount: vocabularyCount ?? this.vocabularyCount, + experiencePoints: experiencePoints ?? this.experiencePoints, + currentLevel: currentLevel ?? this.currentLevel, + createdAt: createdAt ?? this.createdAt, + updatedAt: updatedAt ?? this.updatedAt, + lastLoginAt: lastLoginAt ?? this.lastLoginAt, + isPremium: isPremium ?? this.isPremium, + premiumExpiresAt: premiumExpiresAt ?? this.premiumExpiresAt, + ); + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) return true; + + return other is UserModel && + other.userId == userId && + other.username == username && + other.email == email; + } + + @override + int get hashCode { + return userId.hashCode ^ + username.hashCode ^ + email.hashCode; + } + + @override + String toString() { + return 'UserModel(userId: $userId, username: $username, email: $email)'; + } +} + +/// 用户统计信息模型 +@JsonSerializable() +class UserStatsModel { + @JsonKey(name: 'total_words_learned') + final int totalWordsLearned; + + @JsonKey(name: 'words_learned_today') + final int wordsLearnedToday; + + @JsonKey(name: 'study_time_today') + final int studyTimeToday; // 分钟 + + @JsonKey(name: 'total_study_time') + final int totalStudyTime; // 分钟 + + @JsonKey(name: 'listening_score') + final double listeningScore; + + @JsonKey(name: 'reading_score') + final double readingScore; + + @JsonKey(name: 'writing_score') + final double writingScore; + + @JsonKey(name: 'speaking_score') + final double speakingScore; + + @JsonKey(name: 'overall_score') + final double overallScore; + + @JsonKey(name: 'weekly_progress') + final List weeklyProgress; + + @JsonKey(name: 'monthly_progress') + final List monthlyProgress; + + const UserStatsModel({ + required this.totalWordsLearned, + required this.wordsLearnedToday, + required this.studyTimeToday, + required this.totalStudyTime, + required this.listeningScore, + required this.readingScore, + required this.writingScore, + required this.speakingScore, + required this.overallScore, + required this.weeklyProgress, + required this.monthlyProgress, + }); + + factory UserStatsModel.fromJson(Map json) => _$UserStatsModelFromJson(json); + + Map toJson() => _$UserStatsModelToJson(this); +} \ No newline at end of file diff --git a/client/lib/shared/models/user_model.g.dart b/client/lib/shared/models/user_model.g.dart new file mode 100644 index 0000000..6a074ee --- /dev/null +++ b/client/lib/shared/models/user_model.g.dart @@ -0,0 +1,99 @@ +// GENERATED CODE - DO NOT MODIFY BY HAND + +part of 'user_model.dart'; + +// ************************************************************************** +// JsonSerializableGenerator +// ************************************************************************** + +UserModel _$UserModelFromJson(Map json) => UserModel( + userId: (json['user_id'] as num).toInt(), + username: json['username'] as String, + email: json['email'] as String, + nickname: json['nickname'] as String?, + avatar: json['avatar'] as String?, + phone: json['phone'] as String?, + birthday: json['birthday'] == null + ? null + : DateTime.parse(json['birthday'] as String), + gender: json['gender'] as String?, + bio: json['bio'] as String?, + learningLevel: json['learning_level'] as String, + targetLanguage: json['target_language'] as String, + nativeLanguage: json['native_language'] as String, + dailyGoal: (json['daily_goal'] as num).toInt(), + studyStreak: (json['study_streak'] as num).toInt(), + totalStudyDays: (json['total_study_days'] as num).toInt(), + vocabularyCount: (json['vocabulary_count'] as num).toInt(), + experiencePoints: (json['experience_points'] as num).toInt(), + currentLevel: (json['current_level'] as num).toInt(), + createdAt: DateTime.parse(json['created_at'] as String), + updatedAt: DateTime.parse(json['updated_at'] as String), + lastLoginAt: json['last_login_at'] == null + ? null + : DateTime.parse(json['last_login_at'] as String), + isPremium: json['is_premium'] as bool, + premiumExpiresAt: json['premium_expires_at'] == null + ? null + : DateTime.parse(json['premium_expires_at'] as String), + ); + +Map _$UserModelToJson(UserModel instance) => { + 'user_id': instance.userId, + 'username': instance.username, + 'email': instance.email, + 'nickname': instance.nickname, + 'avatar': instance.avatar, + 'phone': instance.phone, + 'birthday': instance.birthday?.toIso8601String(), + 'gender': instance.gender, + 'bio': instance.bio, + 'learning_level': instance.learningLevel, + 'target_language': instance.targetLanguage, + 'native_language': instance.nativeLanguage, + 'daily_goal': instance.dailyGoal, + 'study_streak': instance.studyStreak, + 'total_study_days': instance.totalStudyDays, + 'vocabulary_count': instance.vocabularyCount, + 'experience_points': instance.experiencePoints, + 'current_level': instance.currentLevel, + 'created_at': instance.createdAt.toIso8601String(), + 'updated_at': instance.updatedAt.toIso8601String(), + 'last_login_at': instance.lastLoginAt?.toIso8601String(), + 'is_premium': instance.isPremium, + 'premium_expires_at': instance.premiumExpiresAt?.toIso8601String(), + }; + +UserStatsModel _$UserStatsModelFromJson(Map json) => + UserStatsModel( + totalWordsLearned: (json['total_words_learned'] as num).toInt(), + wordsLearnedToday: (json['words_learned_today'] as num).toInt(), + studyTimeToday: (json['study_time_today'] as num).toInt(), + totalStudyTime: (json['total_study_time'] as num).toInt(), + listeningScore: (json['listening_score'] as num).toDouble(), + readingScore: (json['reading_score'] as num).toDouble(), + writingScore: (json['writing_score'] as num).toDouble(), + speakingScore: (json['speaking_score'] as num).toDouble(), + overallScore: (json['overall_score'] as num).toDouble(), + weeklyProgress: (json['weekly_progress'] as List) + .map((e) => (e as num).toInt()) + .toList(), + monthlyProgress: (json['monthly_progress'] as List) + .map((e) => (e as num).toInt()) + .toList(), + ); + +Map _$UserStatsModelToJson(UserStatsModel instance) => + { + 'total_words_learned': instance.totalWordsLearned, + 'words_learned_today': instance.wordsLearnedToday, + 'study_time_today': instance.studyTimeToday, + 'total_study_time': instance.totalStudyTime, + 'listening_score': instance.listeningScore, + 'reading_score': instance.readingScore, + 'writing_score': instance.writingScore, + 'speaking_score': instance.speakingScore, + 'overall_score': instance.overallScore, + 'weekly_progress': instance.weeklyProgress, + 'monthly_progress': instance.monthlyProgress, + }; diff --git a/client/lib/shared/models/vocabulary_model.dart b/client/lib/shared/models/vocabulary_model.dart new file mode 100644 index 0000000..66f44e3 --- /dev/null +++ b/client/lib/shared/models/vocabulary_model.dart @@ -0,0 +1,292 @@ +/// 词汇模型 +class VocabularyModel { + final int wordId; + final String word; + final String pronunciation; + final String phonetic; + final List meanings; + final String? etymology; + final List examples; + final String? imageUrl; + final String? audioUrl; + final int difficulty; + final List tags; + final DateTime createdAt; + final DateTime updatedAt; + + const VocabularyModel({ + required this.wordId, + required this.word, + required this.pronunciation, + required this.phonetic, + required this.meanings, + this.etymology, + required this.examples, + this.imageUrl, + this.audioUrl, + required this.difficulty, + required this.tags, + required this.createdAt, + required this.updatedAt, + }); + + factory VocabularyModel.fromJson(Map json) { + return VocabularyModel( + wordId: json['word_id'] as int, + word: json['word'] as String, + pronunciation: json['pronunciation'] as String, + phonetic: json['phonetic'] as String, + meanings: (json['meanings'] as List) + .map((e) => WordMeaning.fromJson(e as Map)) + .toList(), + etymology: json['etymology'] as String?, + examples: (json['examples'] as List).cast(), + imageUrl: json['image_url'] as String?, + audioUrl: json['audio_url'] as String?, + difficulty: json['difficulty'] as int, + tags: (json['tags'] as List).cast(), + createdAt: DateTime.parse(json['created_at'] as String), + updatedAt: DateTime.parse(json['updated_at'] as String), + ); + } + + Map toJson() { + return { + 'word_id': wordId, + 'word': word, + 'pronunciation': pronunciation, + 'phonetic': phonetic, + 'meanings': meanings.map((e) => e.toJson()).toList(), + 'etymology': etymology, + 'examples': examples, + 'image_url': imageUrl, + 'audio_url': audioUrl, + 'difficulty': difficulty, + 'tags': tags, + 'created_at': createdAt.toIso8601String(), + 'updated_at': updatedAt.toIso8601String(), + }; + } + + VocabularyModel copyWith({ + int? wordId, + String? word, + String? pronunciation, + String? phonetic, + List? meanings, + String? etymology, + List? examples, + String? imageUrl, + String? audioUrl, + int? difficulty, + List? tags, + DateTime? createdAt, + DateTime? updatedAt, + }) { + return VocabularyModel( + wordId: wordId ?? this.wordId, + word: word ?? this.word, + pronunciation: pronunciation ?? this.pronunciation, + phonetic: phonetic ?? this.phonetic, + meanings: meanings ?? this.meanings, + etymology: etymology ?? this.etymology, + examples: examples ?? this.examples, + imageUrl: imageUrl ?? this.imageUrl, + audioUrl: audioUrl ?? this.audioUrl, + difficulty: difficulty ?? this.difficulty, + tags: tags ?? this.tags, + createdAt: createdAt ?? this.createdAt, + updatedAt: updatedAt ?? this.updatedAt, + ); + } +} + +/// 词汇含义模型 +class WordMeaning { + final String partOfSpeech; + final String definition; + final String? chineseDefinition; + final List synonyms; + final List antonyms; + final List examples; + + const WordMeaning({ + required this.partOfSpeech, + required this.definition, + this.chineseDefinition, + required this.synonyms, + required this.antonyms, + required this.examples, + }); + + factory WordMeaning.fromJson(Map json) { + return WordMeaning( + partOfSpeech: json['part_of_speech'] as String, + definition: json['definition'] as String, + chineseDefinition: json['chinese_definition'] as String?, + synonyms: (json['synonyms'] as List).cast(), + antonyms: (json['antonyms'] as List).cast(), + examples: (json['examples'] as List).cast(), + ); + } + + Map toJson() { + return { + 'part_of_speech': partOfSpeech, + 'definition': definition, + 'chinese_definition': chineseDefinition, + 'synonyms': synonyms, + 'antonyms': antonyms, + 'examples': examples, + }; + } +} + +/// 用户词汇学习记录模型 +class UserVocabularyModel { + final int userWordId; + final int userId; + final int wordId; + final VocabularyModel? vocabulary; + final LearningStatus status; + final int reviewCount; + final int correctCount; + final int incorrectCount; + final double masteryLevel; + final DateTime? lastReviewAt; + final DateTime? nextReviewAt; + final DateTime createdAt; + final DateTime updatedAt; + + const UserVocabularyModel({ + required this.userWordId, + required this.userId, + required this.wordId, + this.vocabulary, + required this.status, + required this.reviewCount, + required this.correctCount, + required this.incorrectCount, + required this.masteryLevel, + this.lastReviewAt, + this.nextReviewAt, + required this.createdAt, + required this.updatedAt, + }); + + factory UserVocabularyModel.fromJson(Map json) { + return UserVocabularyModel( + userWordId: json['user_word_id'] as int, + userId: json['user_id'] as int, + wordId: json['word_id'] as int, + vocabulary: json['vocabulary'] != null + ? VocabularyModel.fromJson(json['vocabulary'] as Map) + : null, + status: LearningStatus.values.firstWhere( + (e) => e.name == json['status'], + orElse: () => LearningStatus.new_word, + ), + reviewCount: json['review_count'] as int, + correctCount: json['correct_count'] as int, + incorrectCount: json['incorrect_count'] as int, + masteryLevel: (json['mastery_level'] as num).toDouble(), + lastReviewAt: json['last_review_at'] != null + ? DateTime.parse(json['last_review_at'] as String) + : null, + nextReviewAt: json['next_review_at'] != null + ? DateTime.parse(json['next_review_at'] as String) + : null, + createdAt: DateTime.parse(json['created_at'] as String), + updatedAt: DateTime.parse(json['updated_at'] as String), + ); + } + + Map toJson() { + return { + 'user_word_id': userWordId, + 'user_id': userId, + 'word_id': wordId, + 'vocabulary': vocabulary?.toJson(), + 'status': status.name, + 'review_count': reviewCount, + 'correct_count': correctCount, + 'incorrect_count': incorrectCount, + 'mastery_level': masteryLevel, + 'last_review_at': lastReviewAt?.toIso8601String(), + 'next_review_at': nextReviewAt?.toIso8601String(), + 'created_at': createdAt.toIso8601String(), + 'updated_at': updatedAt.toIso8601String(), + }; + } +} + +/// 学习状态枚举 +enum LearningStatus { + new_word('new_word', '新单词'), + learning('learning', '学习中'), + reviewing('reviewing', '复习中'), + mastered('mastered', '已掌握'), + forgotten('forgotten', '已遗忘'); + + const LearningStatus(this.value, this.label); + + final String value; + final String label; +} + +/// 词库模型 +class VocabularyBookModel { + final int bookId; + final String name; + final String description; + final String category; + final String level; + final int totalWords; + final String? coverImage; + final bool isPremium; + final DateTime createdAt; + final DateTime updatedAt; + + const VocabularyBookModel({ + required this.bookId, + required this.name, + required this.description, + required this.category, + required this.level, + required this.totalWords, + this.coverImage, + required this.isPremium, + required this.createdAt, + required this.updatedAt, + }); + + factory VocabularyBookModel.fromJson(Map json) { + return VocabularyBookModel( + bookId: json['book_id'] as int, + name: json['name'] as String, + description: json['description'] as String, + category: json['category'] as String, + level: json['level'] as String, + totalWords: json['total_words'] as int, + coverImage: json['cover_image'] as String?, + isPremium: json['is_premium'] as bool, + createdAt: DateTime.parse(json['created_at'] as String), + updatedAt: DateTime.parse(json['updated_at'] as String), + ); + } + + Map toJson() { + return { + 'book_id': bookId, + 'name': name, + 'description': description, + 'category': category, + 'level': level, + 'total_words': totalWords, + 'cover_image': coverImage, + 'is_premium': isPremium, + 'created_at': createdAt.toIso8601String(), + 'updated_at': updatedAt.toIso8601String(), + }; + } +} \ No newline at end of file diff --git a/client/lib/shared/providers/auth_provider.dart b/client/lib/shared/providers/auth_provider.dart new file mode 100644 index 0000000..0e49e32 --- /dev/null +++ b/client/lib/shared/providers/auth_provider.dart @@ -0,0 +1,289 @@ +import 'package:flutter/foundation.dart'; +import '../models/user_model.dart'; +import '../models/api_response.dart'; +import '../services/auth_service.dart'; +import '../../core/storage/storage_service.dart'; +import '../../core/constants/app_constants.dart'; + +/// 认证状态 +enum AuthState { + initial, + loading, + authenticated, + unauthenticated, + error, +} + +/// 认证Provider +class AuthProvider extends ChangeNotifier { + final AuthService _authService = AuthService(); + + AuthState _state = AuthState.initial; + UserModel? _user; + String? _errorMessage; + bool _isLoading = false; + + // Getters + AuthState get state => _state; + UserModel? get user => _user; + String? get errorMessage => _errorMessage; + bool get isLoading => _isLoading; + bool get isAuthenticated => _state == AuthState.authenticated && _user != null; + + /// 初始化认证状态 + Future initialize() async { + _setLoading(true); + + try { + if (_authService.isLoggedIn()) { + final cachedUser = _authService.getCachedUser(); + if (cachedUser != null) { + _user = cachedUser; + _setState(AuthState.authenticated); + + // 尝试刷新用户信息 + await _refreshUserInfo(); + } else { + _setState(AuthState.unauthenticated); + } + } else { + _setState(AuthState.unauthenticated); + } + } catch (e) { + _setError('初始化失败: $e'); + } finally { + _setLoading(false); + } + } + + /// 用户注册 + Future register({ + required String username, + required String email, + required String password, + required String nickname, + String? phone, + }) async { + _setLoading(true); + _clearError(); + + try { + final response = await _authService.register( + username: username, + email: email, + password: password, + nickname: nickname, + phone: phone, + ); + + if (response.success && response.data != null && response.data!.user != null) { + _user = UserModel.fromJson(response.data!.user!); + _setState(AuthState.authenticated); + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('注册失败: $e'); + return false; + } finally { + _setLoading(false); + } + } + + /// 用户登录 + Future login({ + required String account, // 用户名或邮箱 + required String password, + bool rememberMe = false, + }) async { + _setLoading(true); + _clearError(); + + try { + final response = await _authService.login( + account: account, + password: password, + rememberMe: rememberMe, + ); + + if (response.success && response.data != null && response.data!.user != null) { + _user = UserModel.fromJson(response.data!.user!); + _setState(AuthState.authenticated); + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('登录失败: $e'); + return false; + } finally { + _setLoading(false); + } + } + + /// 用户登出 + Future logout() async { + _setLoading(true); + + try { + await _authService.logout(); + } catch (e) { + // 即使登出请求失败，也要清除本地状态 + debugPrint('Logout error: $e'); + } finally { + _user = null; + _setState(AuthState.unauthenticated); + _setLoading(false); + } + } + + /// 刷新用户信息 + Future _refreshUserInfo() async { + try { + final response = await _authService.getCurrentUser(); + if (response.success && response.data != null) { + _user = response.data; + notifyListeners(); + } + } catch (e) { + debugPrint('Refresh user info error: $e'); + } + } + + /// 更新用户信息 + Future updateProfile({ + String? nickname, + String? avatar, + String? phone, + DateTime? birthday, + String? gender, + String? bio, + String? learningLevel, + String? targetLanguage, + String? nativeLanguage, + int? dailyGoal, + }) async { + _setLoading(true); + _clearError(); + + try { + final response = await _authService.updateProfile( + nickname: nickname, + avatar: avatar, + phone: phone, + birthday: birthday, + gender: gender, + bio: bio, + learningLevel: learningLevel, + targetLanguage: targetLanguage, + nativeLanguage: nativeLanguage, + dailyGoal: dailyGoal, + ); + + if (response.success && response.data != null) { + _user = response.data; + notifyListeners(); + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('更新个人信息失败: $e'); + return false; + } finally { + _setLoading(false); + } + } + + /// 修改密码 + Future changePassword({ + required String currentPassword, + required String newPassword, + required String confirmPassword, + }) async { + _setLoading(true); + _clearError(); + + try { + final response = await _authService.changePassword( + currentPassword: currentPassword, + newPassword: newPassword, + confirmPassword: confirmPassword, + ); + + if (response.success) { + return true; + } else { + _setError(response.message); + return false; + } + } catch (e) { + _setError('修改密码失败: $e'); + return false; + } finally { + _setLoading(false); + } + } + + /// 刷新Token + Future refreshToken() async { + try { + final response = await _authService.refreshToken(); + + if (response.success && response.data != null && response.data!.user != null) { + _user = UserModel.fromJson(response.data!.user!); + if (_state != AuthState.authenticated) { + _setState(AuthState.authenticated); + } + return true; + } else { + // Token刷新失败，需要重新登录 + _user = null; + _setState(AuthState.unauthenticated); + return false; + } + } catch (e) { + _user = null; + _setState(AuthState.unauthenticated); + return false; + } + } + + /// 设置加载状态 + void _setLoading(bool loading) { + _isLoading = loading; + notifyListeners(); + } + + /// 设置状态 + void _setState(AuthState state) { + _state = state; + notifyListeners(); + } + + /// 设置错误信息 + void _setError(String message) { + _errorMessage = message; + _setState(AuthState.error); + } + + /// 清除错误信息 + void _clearError() { + _errorMessage = null; + if (_state == AuthState.error) { + _setState(_user != null ? AuthState.authenticated : AuthState.unauthenticated); + } + } + + /// 清除所有状态 + void clear() { + _user = null; + _errorMessage = null; + _isLoading = false; + _setState(AuthState.initial); + } +} \ No newline at end of file diff --git a/client/lib/shared/providers/error_provider.dart b/client/lib/shared/providers/error_provider.dart new file mode 100644 index 0000000..a9b564e --- /dev/null +++ b/client/lib/shared/providers/error_provider.dart @@ -0,0 +1,382 @@ +import 'package:flutter/foundation.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; + +/// 错误类型枚举 +enum ErrorType { + network, + authentication, + validation, + server, + unknown, +} + +/// 错误严重程度枚举 +enum ErrorSeverity { + info, + warning, + error, + critical, +} + +/// 应用错误模型 +class AppError { + final String id; + final String message; + final String? details; + final ErrorType type; + final ErrorSeverity severity; + final DateTime timestamp; + final String? stackTrace; + final Map? context; + + const AppError({ + required this.id, + required this.message, + this.details, + required this.type, + required this.severity, + required this.timestamp, + this.stackTrace, + this.context, + }); + + AppError copyWith({ + String? id, + String? message, + String? details, + ErrorType? type, + ErrorSeverity? severity, + DateTime? timestamp, + String? stackTrace, + Map? context, + }) { + return AppError( + id: id ?? this.id, + message: message ?? this.message, + details: details ?? this.details, + type: type ?? this.type, + severity: severity ?? this.severity, + timestamp: timestamp ?? this.timestamp, + stackTrace: stackTrace ?? this.stackTrace, + context: context ?? this.context, + ); + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) return true; + return other is AppError && + other.id == id && + other.message == message && + other.type == type && + other.severity == severity; + } + + @override + int get hashCode { + return id.hashCode ^ + message.hashCode ^ + type.hashCode ^ + severity.hashCode; + } + + @override + String toString() { + return 'AppError(id: $id, message: $message, type: $type, severity: $severity, timestamp: $timestamp)'; + } + + /// 创建网络错误 + factory AppError.network(String message, {String? details, Map? context}) { + return AppError( + id: DateTime.now().millisecondsSinceEpoch.toString(), + message: message, + details: details, + type: ErrorType.network, + severity: ErrorSeverity.error, + timestamp: DateTime.now(), + context: context, + ); + } + + /// 创建认证错误 + factory AppError.authentication(String message, {String? details, Map? context}) { + return AppError( + id: DateTime.now().millisecondsSinceEpoch.toString(), + message: message, + details: details, + type: ErrorType.authentication, + severity: ErrorSeverity.error, + timestamp: DateTime.now(), + context: context, + ); + } + + /// 创建验证错误 + factory AppError.validation(String message, {String? details, Map? context}) { + return AppError( + id: DateTime.now().millisecondsSinceEpoch.toString(), + message: message, + details: details, + type: ErrorType.validation, + severity: ErrorSeverity.warning, + timestamp: DateTime.now(), + context: context, + ); + } + + /// 创建服务器错误 + factory AppError.server(String message, {String? details, Map? context}) { + return AppError( + id: DateTime.now().millisecondsSinceEpoch.toString(), + message: message, + details: details, + type: ErrorType.server, + severity: ErrorSeverity.error, + timestamp: DateTime.now(), + context: context, + ); + } + + /// 创建未知错误 + factory AppError.unknown(String message, {String? details, String? stackTrace, Map? context}) { + return AppError( + id: DateTime.now().millisecondsSinceEpoch.toString(), + message: message, + details: details, + type: ErrorType.unknown, + severity: ErrorSeverity.error, + timestamp: DateTime.now(), + stackTrace: stackTrace, + context: context, + ); + } +} + +/// 错误状态模型 +class ErrorState { + final List errors; + final AppError? currentError; + + const ErrorState({ + required this.errors, + this.currentError, + }); + + bool get hasErrors => errors.isNotEmpty; + + ErrorState copyWith({ + List? errors, + AppError? currentError, + }) { + return ErrorState( + errors: errors ?? this.errors, + currentError: currentError, + ); + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) return true; + return other is ErrorState && + other.errors.length == errors.length && + other.currentError == currentError; + } + + @override + int get hashCode { + return errors.hashCode ^ currentError.hashCode; + } +} + +/// 错误管理Provider +class ErrorNotifier extends StateNotifier { + static const int maxErrorCount = 50; // 最大错误数量 + static const Duration errorRetentionDuration = Duration(hours: 24); // 错误保留时间 + + ErrorNotifier() : super(const ErrorState(errors: [])); + + /// 添加错误 + void addError(AppError error) { + final updatedErrors = List.from(state.errors); + updatedErrors.insert(0, error); // 新错误插入到列表开头 + + // 限制错误数量 + if (updatedErrors.length > maxErrorCount) { + updatedErrors.removeRange(maxErrorCount, updatedErrors.length); + } + + // 清理过期错误 + _cleanExpiredErrors(updatedErrors); + + state = state.copyWith( + errors: updatedErrors, + currentError: error, + ); + + // 在调试模式下打印错误 + if (kDebugMode) { + print('Error added: ${error.toString()}'); + if (error.stackTrace != null) { + print('Stack trace: ${error.stackTrace}'); + } + } + } + + /// 清除当前错误 + void clearCurrentError() { + state = state.copyWith(currentError: null); + } + + /// 清除指定错误 + void removeError(String errorId) { + final updatedErrors = state.errors.where((error) => error.id != errorId).toList(); + + AppError? newCurrentError = state.currentError; + if (state.currentError?.id == errorId) { + newCurrentError = null; + } + + state = state.copyWith( + errors: updatedErrors, + currentError: newCurrentError, + ); + } + + /// 清除所有错误 + void clearAllErrors() { + state = const ErrorState(errors: []); + } + + /// 清除指定类型的错误 + void clearErrorsByType(ErrorType type) { + final updatedErrors = state.errors.where((error) => error.type != type).toList(); + + AppError? newCurrentError = state.currentError; + if (state.currentError?.type == type) { + newCurrentError = null; + } + + state = state.copyWith( + errors: updatedErrors, + currentError: newCurrentError, + ); + } + + /// 清除指定严重程度的错误 + void clearErrorsBySeverity(ErrorSeverity severity) { + final updatedErrors = state.errors.where((error) => error.severity != severity).toList(); + + AppError? newCurrentError = state.currentError; + if (state.currentError?.severity == severity) { + newCurrentError = null; + } + + state = state.copyWith( + errors: updatedErrors, + currentError: newCurrentError, + ); + } + + /// 获取指定类型的错误 + List getErrorsByType(ErrorType type) { + return state.errors.where((error) => error.type == type).toList(); + } + + /// 获取指定严重程度的错误 + List getErrorsBySeverity(ErrorSeverity severity) { + return state.errors.where((error) => error.severity == severity).toList(); + } + + /// 获取最近的错误 + List getRecentErrors({int count = 10}) { + return state.errors.take(count).toList(); + } + + /// 检查是否有指定类型的错误 + bool hasErrorOfType(ErrorType type) { + return state.errors.any((error) => error.type == type); + } + + /// 检查是否有指定严重程度的错误 + bool hasErrorOfSeverity(ErrorSeverity severity) { + return state.errors.any((error) => error.severity == severity); + } + + /// 清理过期错误 + void _cleanExpiredErrors(List errors) { + final now = DateTime.now(); + errors.removeWhere((error) => + now.difference(error.timestamp) > errorRetentionDuration); + } + + /// 处理异常并转换为AppError + void handleException(dynamic exception, { + String? message, + ErrorType? type, + ErrorSeverity? severity, + Map? context, + }) { + String errorMessage = message ?? exception.toString(); + ErrorType errorType = type ?? ErrorType.unknown; + ErrorSeverity errorSeverity = severity ?? ErrorSeverity.error; + String? stackTrace; + + if (exception is Error) { + stackTrace = exception.stackTrace?.toString(); + } + + final error = AppError( + id: DateTime.now().millisecondsSinceEpoch.toString(), + message: errorMessage, + details: exception.toString(), + type: errorType, + severity: errorSeverity, + timestamp: DateTime.now(), + stackTrace: stackTrace, + context: context, + ); + + addError(error); + } +} + +/// 错误状态Provider +final errorProvider = StateNotifierProvider( + (ref) => ErrorNotifier(), +); + +/// 当前错误Provider +final currentErrorProvider = Provider( + (ref) => ref.watch(errorProvider).currentError, +); + +/// 是否有错误Provider +final hasErrorsProvider = Provider( + (ref) => ref.watch(errorProvider).hasErrors, +); + +/// 错误数量Provider +final errorCountProvider = Provider( + (ref) => ref.watch(errorProvider).errors.length, +); + +/// 网络错误Provider +final networkErrorsProvider = Provider>( + (ref) => ref.watch(errorProvider).errors + .where((error) => error.type == ErrorType.network) + .toList(), +); + +/// 认证错误Provider +final authErrorsProvider = Provider>( + (ref) => ref.watch(errorProvider).errors + .where((error) => error.type == ErrorType.authentication) + .toList(), +); + +/// 严重错误Provider +final criticalErrorsProvider = Provider>( + (ref) => ref.watch(errorProvider).errors + .where((error) => error.severity == ErrorSeverity.critical) + .toList(), +); \ No newline at end of file diff --git a/client/lib/shared/providers/network_provider.dart b/client/lib/shared/providers/network_provider.dart new file mode 100644 index 0000000..5309a6b --- /dev/null +++ b/client/lib/shared/providers/network_provider.dart @@ -0,0 +1,239 @@ +import 'package:flutter/foundation.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import 'package:connectivity_plus/connectivity_plus.dart'; +import 'dart:async'; + +/// 网络连接状态枚举 +enum NetworkStatus { + connected, + disconnected, + unknown, +} + +/// 网络连接类型枚举 +enum NetworkType { + wifi, + mobile, + ethernet, + none, + unknown, +} + +/// 网络状态数据模型 +class NetworkState { + final NetworkStatus status; + final NetworkType type; + final bool isOnline; + final DateTime lastChecked; + + const NetworkState({ + required this.status, + required this.type, + required this.isOnline, + required this.lastChecked, + }); + + NetworkState copyWith({ + NetworkStatus? status, + NetworkType? type, + bool? isOnline, + DateTime? lastChecked, + }) { + return NetworkState( + status: status ?? this.status, + type: type ?? this.type, + isOnline: isOnline ?? this.isOnline, + lastChecked: lastChecked ?? this.lastChecked, + ); + } + + @override + bool operator ==(Object other) { + if (identical(this, other)) return true; + return other is NetworkState && + other.status == status && + other.type == type && + other.isOnline == isOnline; + } + + @override + int get hashCode { + return status.hashCode ^ + type.hashCode ^ + isOnline.hashCode; + } + + @override + String toString() { + return 'NetworkState(status: $status, type: $type, isOnline: $isOnline, lastChecked: $lastChecked)'; + } +} + +/// 网络状态管理Provider +class NetworkNotifier extends StateNotifier { + late StreamSubscription> _connectivitySubscription; + final Connectivity _connectivity = Connectivity(); + + NetworkNotifier() + : super(NetworkState( + status: NetworkStatus.unknown, + type: NetworkType.unknown, + isOnline: false, + lastChecked: DateTime.now(), + )) { + _initializeNetworkMonitoring(); + } + + /// 初始化网络监控 + void _initializeNetworkMonitoring() { + // 监听网络连接状态变化 + _connectivitySubscription = _connectivity.onConnectivityChanged.listen( + (List results) { + _updateNetworkState(results); + }, + ); + + // 初始检查网络状态 + _checkInitialConnectivity(); + } + + /// 检查初始网络连接状态 + Future _checkInitialConnectivity() async { + try { + final results = await _connectivity.checkConnectivity(); + _updateNetworkState(results); + } catch (e) { + if (kDebugMode) { + print('Error checking initial connectivity: $e'); + } + state = state.copyWith( + status: NetworkStatus.unknown, + type: NetworkType.unknown, + isOnline: false, + lastChecked: DateTime.now(), + ); + } + } + + /// 更新网络状态 + void _updateNetworkState(List results) { + // 取第一个有效的连接结果，如果列表为空则认为无连接 + final result = results.isNotEmpty ? results.first : ConnectivityResult.none; + final networkType = _mapConnectivityResultToNetworkType(result); + final isOnline = result != ConnectivityResult.none; + final status = isOnline ? NetworkStatus.connected : NetworkStatus.disconnected; + + state = NetworkState( + status: status, + type: networkType, + isOnline: isOnline, + lastChecked: DateTime.now(), + ); + + if (kDebugMode) { + print('Network state updated: $state'); + } + } + + /// 将ConnectivityResult映射到NetworkType + NetworkType _mapConnectivityResultToNetworkType(ConnectivityResult result) { + switch (result) { + case ConnectivityResult.wifi: + return NetworkType.wifi; + case ConnectivityResult.mobile: + return NetworkType.mobile; + case ConnectivityResult.ethernet: + return NetworkType.ethernet; + case ConnectivityResult.none: + return NetworkType.none; + default: + return NetworkType.unknown; + } + } + + /// 手动刷新网络状态 + Future refreshNetworkStatus() async { + try { + final results = await _connectivity.checkConnectivity(); + _updateNetworkState(results); + } catch (e) { + if (kDebugMode) { + print('Error refreshing network status: $e'); + } + } + } + + /// 检查是否有网络连接 + bool get isConnected => state.isOnline; + + /// 检查是否为WiFi连接 + bool get isWifiConnected => state.type == NetworkType.wifi && state.isOnline; + + /// 检查是否为移动网络连接 + bool get isMobileConnected => state.type == NetworkType.mobile && state.isOnline; + + /// 获取网络类型描述 + String get networkTypeDescription { + switch (state.type) { + case NetworkType.wifi: + return 'WiFi'; + case NetworkType.mobile: + return '移动网络'; + case NetworkType.ethernet: + return '以太网'; + case NetworkType.none: + return '无网络'; + case NetworkType.unknown: + return '未知网络'; + } + } + + /// 获取网络状态描述 + String get statusDescription { + switch (state.status) { + case NetworkStatus.connected: + return '已连接'; + case NetworkStatus.disconnected: + return '已断开'; + case NetworkStatus.unknown: + return '未知状态'; + } + } + + @override + void dispose() { + _connectivitySubscription.cancel(); + super.dispose(); + } +} + +/// 网络状态Provider +final networkProvider = StateNotifierProvider( + (ref) => NetworkNotifier(), +); + +/// 网络连接状态Provider（简化版） +final isConnectedProvider = Provider( + (ref) => ref.watch(networkProvider).isOnline, +); + +/// 网络类型Provider +final networkTypeProvider = Provider( + (ref) => ref.watch(networkProvider).type, +); + +/// WiFi连接状态Provider +final isWifiConnectedProvider = Provider( + (ref) { + final networkState = ref.watch(networkProvider); + return networkState.type == NetworkType.wifi && networkState.isOnline; + }, +); + +/// 移动网络连接状态Provider +final isMobileConnectedProvider = Provider( + (ref) { + final networkState = ref.watch(networkProvider); + return networkState.type == NetworkType.mobile && networkState.isOnline; + }, +); \ No newline at end of file diff --git a/client/lib/shared/providers/notification_provider.dart b/client/lib/shared/providers/notification_provider.dart new file mode 100644 index 0000000..614b97d --- /dev/null +++ b/client/lib/shared/providers/notification_provider.dart @@ -0,0 +1,222 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../models/notification_model.dart'; +import '../services/notification_service.dart'; + +/// 通知状态 +class NotificationState { + final List notifications; + final int total; + final int unreadCount; + final bool isLoading; + final String? error; + + NotificationState({ + this.notifications = const [], + this.total = 0, + this.unreadCount = 0, + this.isLoading = false, + this.error, + }); + + NotificationState copyWith({ + List? notifications, + int? total, + int? unreadCount, + bool? isLoading, + String? error, + }) { + return NotificationState( + notifications: notifications ?? this.notifications, + total: total ?? this.total, + unreadCount: unreadCount ?? this.unreadCount, + isLoading: isLoading ?? this.isLoading, + error: error, + ); + } +} + +/// 通知Notifier +class NotificationNotifier extends StateNotifier { + final NotificationService _service = NotificationService(); + + NotificationNotifier() : super(NotificationState()); + + /// 加载通知列表 + Future loadNotifications({ + int page = 1, + int limit = 10, + bool onlyUnread = false, + }) async { + state = state.copyWith(isLoading: true, error: null); + + try { + final response = await _service.getNotifications( + page: page, + limit: limit, + onlyUnread: onlyUnread, + ); + + if (response.success && response.data != null) { + state = state.copyWith( + notifications: response.data!['notifications'] as List, + total: response.data!['total'] as int, + isLoading: false, + ); + } else { + state = state.copyWith( + isLoading: false, + error: response.message, + ); + } + } catch (e) { + state = state.copyWith( + isLoading: false, + error: '加载通知列表失败: $e', + ); + } + } + + /// 加载未读通知数量 + Future loadUnreadCount() async { + try { + final response = await _service.getUnreadCount(); + + if (response.success && response.data != null) { + state = state.copyWith( + unreadCount: response.data!, + ); + } + } catch (e) { + print('加载未读通知数量失败: $e'); + } + } + + /// 标记通知为已读 + Future markAsRead(int notificationId) async { + try { + final response = await _service.markAsRead(notificationId); + + if (response.success) { + // 更新本地状态 + final updatedNotifications = state.notifications.map((n) { + if (n.id == notificationId) { + return NotificationModel( + id: n.id, + userId: n.userId, + type: n.type, + title: n.title, + content: n.content, + link: n.link, + isRead: true, + priority: n.priority, + createdAt: n.createdAt, + readAt: DateTime.now(), + ); + } + return n; + }).toList(); + + state = state.copyWith( + notifications: updatedNotifications, + unreadCount: state.unreadCount > 0 ? state.unreadCount - 1 : 0, + ); + + return true; + } + return false; + } catch (e) { + print('标记通知已读失败: $e'); + return false; + } + } + + /// 标记所有通知为已读 + Future markAllAsRead() async { + try { + final response = await _service.markAllAsRead(); + + if (response.success) { + // 更新本地状态 + final updatedNotifications = state.notifications.map((n) { + return NotificationModel( + id: n.id, + userId: n.userId, + type: n.type, + title: n.title, + content: n.content, + link: n.link, + isRead: true, + priority: n.priority, + createdAt: n.createdAt, + readAt: DateTime.now(), + ); + }).toList(); + + state = state.copyWith( + notifications: updatedNotifications, + unreadCount: 0, + ); + + return true; + } + return false; + } catch (e) { + print('标记所有通知已读失败: $e'); + return false; + } + } + + /// 删除通知 + Future deleteNotification(int notificationId) async { + try { + final response = await _service.deleteNotification(notificationId); + + if (response.success) { + // 从本地状态中移除 + final updatedNotifications = + state.notifications.where((n) => n.id != notificationId).toList(); + + // 如果删除的是未读通知，更新未读数量 + final deletedNotification = + state.notifications.firstWhere((n) => n.id == notificationId); + final newUnreadCount = deletedNotification.isRead + ? state.unreadCount + : (state.unreadCount > 0 ? state.unreadCount - 1 : 0); + + state = state.copyWith( + notifications: updatedNotifications, + total: state.total - 1, + unreadCount: newUnreadCount, + ); + + return true; + } + return false; + } catch (e) { + print('删除通知失败: $e'); + return false; + } + } + + /// 刷新通知列表 + Future refresh() async { + await loadNotifications(); + await loadUnreadCount(); + } +} + +/// 通知Provider +final notificationProvider = + StateNotifierProvider( + (ref) => NotificationNotifier(), +); + +/// 未读通知数量Provider（便捷访问） +final unreadCountProvider = Provider((ref) { + return ref.watch(notificationProvider).unreadCount; +}); + +/// 通知列表Provider（便捷访问） +final notificationListProvider = Provider>((ref) { + return ref.watch(notificationProvider).notifications; +}); diff --git a/client/lib/shared/providers/vocabulary_provider.dart b/client/lib/shared/providers/vocabulary_provider.dart new file mode 100644 index 0000000..89ad68a --- /dev/null +++ b/client/lib/shared/providers/vocabulary_provider.dart @@ -0,0 +1,369 @@ +import 'package:flutter/foundation.dart'; +import '../models/vocabulary_model.dart'; +import '../models/api_response.dart'; +import '../services/vocabulary_service.dart'; +import '../../core/errors/app_error.dart'; + +/// 词汇学习状态 +enum VocabularyState { + initial, + loading, + loaded, + error, +} + +/// 词汇学习Provider +class VocabularyProvider with ChangeNotifier { + final VocabularyService _vocabularyService; + + VocabularyProvider(this._vocabularyService); + + // 状态管理 + VocabularyState _state = VocabularyState.initial; + String? _errorMessage; + + // 词库数据 + List _vocabularyBooks = []; + VocabularyBookModel? _currentBook; + + // 词汇数据 + List _vocabularies = []; + List _userVocabularies = []; + VocabularyModel? _currentVocabulary; + + // 学习数据 + List _todayReviewWords = []; + List _newWords = []; + Map _learningStats = {}; + + // 分页数据 + int _currentPage = 1; + bool _hasMoreData = true; + + // Getters + VocabularyState get state => _state; + String? get errorMessage => _errorMessage; + List get vocabularyBooks => _vocabularyBooks; + VocabularyBookModel? get currentBook => _currentBook; + List get vocabularies => _vocabularies; + List get userVocabularies => _userVocabularies; + VocabularyModel? get currentVocabulary => _currentVocabulary; + List get todayReviewWords => _todayReviewWords; + List get newWords => _newWords; + Map get learningStats => _learningStats; + int get currentPage => _currentPage; + bool get hasMoreData => _hasMoreData; + + /// 设置状态 + void _setState(VocabularyState newState, [String? error]) { + _state = newState; + _errorMessage = error; + notifyListeners(); + } + + /// 获取词库列表 + Future loadVocabularyBooks() async { + try { + _setState(VocabularyState.loading); + + final response = await _vocabularyService.getVocabularyBooks(); + + if (response.success && response.data != null) { + _vocabularyBooks = response.data!; + _setState(VocabularyState.loaded); + } else { + _setState(VocabularyState.error, response.message); + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + } + } + + /// 设置当前词库 + void setCurrentBook(VocabularyBookModel book) { + _currentBook = book; + _vocabularies.clear(); + _currentPage = 1; + _hasMoreData = true; + notifyListeners(); + } + + /// 获取词汇列表 + Future loadVocabularies({ + String? bookId, + String? search, + String? difficulty, + bool loadMore = false, + }) async { + try { + if (!loadMore) { + _setState(VocabularyState.loading); + _currentPage = 1; + _vocabularies.clear(); + } + + final response = await _vocabularyService.getVocabularies( + bookId: bookId ?? _currentBook?.bookId.toString(), + page: _currentPage, + search: search, + level: difficulty, + ); + + if (response.success && response.data != null) { + final newVocabularies = response.data!.data; + + if (loadMore) { + _vocabularies.addAll(newVocabularies); + } else { + _vocabularies = newVocabularies; + } + + _hasMoreData = response.data!.pagination.hasNextPage; + _currentPage++; + _setState(VocabularyState.loaded); + } else { + _setState(VocabularyState.error, response.message); + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + } + } + + /// 获取单词详情 + Future getWordDetail(String wordId) async { + try { + final response = await _vocabularyService.getWordDetail(wordId); + + if (response.success && response.data != null) { + _currentVocabulary = response.data!; + notifyListeners(); + return response.data!; + } else { + _setState(VocabularyState.error, response.message); + return null; + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + return null; + } + } + + /// 获取用户词汇学习记录 + Future loadUserVocabularies(String userId) async { + try { + final response = await _vocabularyService.getUserVocabularies(); + + if (response.success && response.data != null) { + _userVocabularies = response.data!.data; + notifyListeners(); + } else { + _setState(VocabularyState.error, response.message); + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + } + } + + /// 更新单词学习状态 + Future updateWordStatus(String wordId, LearningStatus status) async { + try { + final response = await _vocabularyService.updateWordStatus( + wordId: wordId, + status: status, + ); + + if (response.success) { + // 更新本地数据 + final index = _userVocabularies.indexWhere((uv) => uv.wordId.toString() == wordId); + if (index != -1) { + // TODO: 实现UserVocabularyModel的copyWith方法 + // _userVocabularies[index] = _userVocabularies[index].copyWith( + // status: status, + // lastStudiedAt: DateTime.now(), + // ); + notifyListeners(); + } + return true; + } else { + _setState(VocabularyState.error, response.message); + return false; + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + return false; + } + } + + /// 添加单词到学习列表 + Future addToLearningList(String wordId) async { + try { + // TODO: 实现addToLearningList方法 + // final response = await _vocabularyService.addToLearningList(wordId); + final response = ApiResponse.success(message: 'Added to learning list'); + + if (response.success) { + // 刷新用户词汇数据 + await loadUserVocabularies('current_user_id'); // TODO: 获取当前用户ID + return true; + } else { + _setState(VocabularyState.error, response.message); + return false; + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + return false; + } + } + + /// 从学习列表移除单词 + Future removeFromLearningList(String wordId) async { + try { + // TODO: 实现removeFromLearningList方法 + // final response = await _vocabularyService.removeFromLearningList(wordId); + final response = ApiResponse.success(message: 'Removed from learning list'); + + if (response.success) { + // 更新本地数据 + _userVocabularies.removeWhere((uv) => uv.wordId.toString() == wordId); + notifyListeners(); + return true; + } else { + _setState(VocabularyState.error, response.message); + return false; + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + return false; + } + } + + /// 获取今日复习单词 + Future loadTodayReviewWords() async { + try { + // TODO: 实现getTodayReviewWords方法 + // final response = await _vocabularyService.getTodayReviewWords(); + final response = ApiResponse>.success( + message: 'Today review words retrieved', + data: [], + ); + + if (response.success && response.data != null) { + _todayReviewWords = response.data ?? []; + notifyListeners(); + } else { + _setState(VocabularyState.error, response.message); + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + } + } + + /// 获取新单词学习 + Future loadNewWords({int limit = 20}) async { + try { + // TODO: 实现getNewWordsForLearning方法 + // final response = await _vocabularyService.getNewWordsForLearning(limit: limit); + final response = ApiResponse>.success( + message: 'New words retrieved', + data: [], + ); + + if (response.success && response.data != null) { + _newWords = response.data ?? []; + notifyListeners(); + } else { + _setState(VocabularyState.error, response.message); + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + } + } + + /// 进行词汇量测试 + Future?> takeVocabularyTest(List> answers) async { + try { + _setState(VocabularyState.loading); + + // TODO: 实现takeVocabularyTest方法 + // final response = await _vocabularyService.takeVocabularyTest(answers); + final response = ApiResponse>.success( + message: 'Vocabulary test completed', + data: {}, + ); + + if (response.success && response.data != null) { + _setState(VocabularyState.loaded); + return response.data!; + } else { + _setState(VocabularyState.error, response.message); + return null; + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + return null; + } + } + + /// 获取学习统计 + Future loadLearningStats() async { + try { + // TODO: 实现getLearningStats方法 + // final response = await _vocabularyService.getLearningStats(); + final response = ApiResponse>.success( + message: 'Learning stats retrieved', + data: {}, + ); + + if (response.success && response.data != null) { + _learningStats = response.data ?? {}; + notifyListeners(); + } else { + _setState(VocabularyState.error, response.message); + } + } catch (e) { + _setState(VocabularyState.error, e.toString()); + } + } + + /// 搜索词汇 + Future searchVocabularies(String query) async { + await loadVocabularies(search: query); + } + + /// 按难度筛选词汇 + Future filterByDifficulty(String difficulty) async { + await loadVocabularies(difficulty: difficulty); + } + + /// 加载更多词汇 + Future loadMoreVocabularies() async { + if (_hasMoreData && _state != VocabularyState.loading) { + await loadVocabularies(loadMore: true); + } + } + + /// 清除错误状态 + void clearError() { + _errorMessage = null; + if (_state == VocabularyState.error) { + _setState(VocabularyState.initial); + } + } + + /// 重置状态 + void reset() { + _state = VocabularyState.initial; + _errorMessage = null; + _vocabularyBooks.clear(); + _currentBook = null; + _vocabularies.clear(); + _userVocabularies.clear(); + _currentVocabulary = null; + _todayReviewWords.clear(); + _newWords.clear(); + _learningStats.clear(); + _currentPage = 1; + _hasMoreData = true; + notifyListeners(); + } +} \ No newline at end of file diff --git a/client/lib/shared/services/audio_service.dart b/client/lib/shared/services/audio_service.dart new file mode 100644 index 0000000..f8c6e4a --- /dev/null +++ b/client/lib/shared/services/audio_service.dart @@ -0,0 +1,332 @@ +import 'dart:io'; +import 'package:path_provider/path_provider.dart'; +import 'package:dio/dio.dart'; +import '../../core/network/api_client.dart'; +import '../../core/errors/app_error.dart'; +import '../models/api_response.dart'; + +/// 音频播放状态 +enum AudioPlayerState { + stopped, + playing, + paused, + loading, + error, +} + +/// 音频服务 +class AudioService { + static final AudioService _instance = AudioService._internal(); + factory AudioService() => _instance; + AudioService._internal(); + + final ApiClient _apiClient = ApiClient.instance; + + AudioPlayerState _state = AudioPlayerState.stopped; + Duration _duration = Duration.zero; + Duration _position = Duration.zero; + double _volume = 1.0; + double _playbackRate = 1.0; + String? _currentUrl; + + // 回调函数 + Function(AudioPlayerState)? onStateChanged; + Function(Duration)? onDurationChanged; + Function(Duration)? onPositionChanged; + Function(String)? onError; + + /// 更新播放状态 + void _updateState(AudioPlayerState state) { + _state = state; + onStateChanged?.call(state); + } + + /// 播放网络音频 + Future playFromUrl(String url) async { + try { + _updateState(AudioPlayerState.loading); + _currentUrl = url; + + // TODO: 实现音频播放逻辑 + _updateState(AudioPlayerState.playing); + } catch (e) { + _updateState(AudioPlayerState.error); + onError?.call('播放失败: $e'); + } + } + + /// 播放本地音频文件 + Future playFromFile(String filePath) async { + try { + _updateState(AudioPlayerState.loading); + _currentUrl = filePath; + + // TODO: 实现本地音频播放逻辑 + _updateState(AudioPlayerState.playing); + } catch (e) { + _updateState(AudioPlayerState.error); + onError?.call('播放失败: $e'); + } + } + + /// 播放资源文件 + Future playFromAsset(String assetPath) async { + try { + _updateState(AudioPlayerState.loading); + _currentUrl = assetPath; + + // TODO: 实现资源音频播放逻辑 + _updateState(AudioPlayerState.playing); + } catch (e) { + _updateState(AudioPlayerState.error); + onError?.call('播放失败: $e'); + } + } + + /// 暂停播放 + Future pause() async { + try { + // TODO: 实现暂停逻辑 + _updateState(AudioPlayerState.paused); + } catch (e) { + onError?.call('暂停失败: $e'); + } + } + + /// 恢复播放 + Future resume() async { + try { + // TODO: 实现恢复播放逻辑 + _updateState(AudioPlayerState.playing); + } catch (e) { + onError?.call('恢复播放失败: $e'); + } + } + + /// 停止播放 + Future stop() async { + try { + // TODO: 实现停止播放逻辑 + _updateState(AudioPlayerState.stopped); + _position = Duration.zero; + } catch (e) { + onError?.call('停止播放失败: $e'); + } + } + + /// 跳转到指定位置 + Future seek(Duration position) async { + try { + // TODO: 实现跳转逻辑 + _position = position; + } catch (e) { + onError?.call('跳转失败: $e'); + } + } + + /// 设置音量 (0.0 - 1.0) + Future setVolume(double volume) async { + try { + _volume = volume.clamp(0.0, 1.0); + // TODO: 实现音量设置逻辑 + } catch (e) { + onError?.call('设置音量失败: $e'); + } + } + + /// 设置播放速度 (0.5 - 2.0) + Future setPlaybackRate(double rate) async { + try { + _playbackRate = rate.clamp(0.5, 2.0); + // TODO: 实现播放速度设置逻辑 + } catch (e) { + onError?.call('设置播放速度失败: $e'); + } + } + + /// 下载音频文件 + Future> downloadAudio({ + required String url, + required String fileName, + Function(int, int)? onProgress, + }) async { + try { + final directory = await getApplicationDocumentsDirectory(); + final audioDir = Directory('${directory.path}/audio'); + + if (!await audioDir.exists()) { + await audioDir.create(recursive: true); + } + + final filePath = '${audioDir.path}/$fileName'; + + // TODO: 实现文件下载逻辑 + final response = await _apiClient.get(url); + final file = File(filePath); + await file.writeAsBytes(response.data); + + return ApiResponse.success( + message: '音频下载成功', + data: filePath, + ); + } catch (e) { + return ApiResponse.failure( + message: '音频下载失败: $e', + error: e.toString(), + ); + } + } + + /// 上传音频文件 + Future>> uploadAudio({ + required String filePath, + required String type, // 'pronunciation', 'speaking', etc. + Map? metadata, + Function(int, int)? onProgress, + }) async { + try { + final file = File(filePath); + if (!await file.exists()) { + return ApiResponse.failure( + message: '音频文件不存在', + error: 'FILE_NOT_FOUND', + ); + } + + final formData = FormData.fromMap({ + 'audio': await MultipartFile.fromFile( + filePath, + filename: file.path.split('/').last, + ), + 'type': type, + if (metadata != null) 'metadata': metadata, + }); + + final response = await _apiClient.post( + '/audio/upload', + data: formData, + ); + + if (response.statusCode == 200) { + return ApiResponse.success( + message: response.data['message'] ?? '音频上传成功', + data: response.data['data'], + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? '音频上传失败', + code: response.statusCode, + ); + } + } catch (e) { + return ApiResponse.failure( + message: '音频上传失败: $e', + error: e.toString(), + ); + } + } + + /// 获取音频文件信息 + Future>> getAudioInfo(String audioId) async { + try { + final response = await _apiClient.get('/audio/$audioId'); + + if (response.statusCode == 200) { + return ApiResponse.success( + message: 'Audio info retrieved successfully', + data: response.data['data'], + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to get audio info', + code: response.statusCode, + ); + } + } catch (e) { + return ApiResponse.failure( + message: 'Failed to get audio info: $e', + error: e.toString(), + ); + } + } + + /// 删除本地音频文件 + Future deleteLocalAudio(String filePath) async { + try { + final file = File(filePath); + if (await file.exists()) { + await file.delete(); + return true; + } + return false; + } catch (e) { + onError?.call('删除音频文件失败: $e'); + return false; + } + } + + /// 清理缓存的音频文件 + Future clearAudioCache() async { + try { + final directory = await getApplicationDocumentsDirectory(); + final audioDir = Directory('${directory.path}/audio'); + + if (await audioDir.exists()) { + await audioDir.delete(recursive: true); + } + } catch (e) { + onError?.call('清理音频缓存失败: $e'); + } + } + + /// 检查音频文件是否存在 + Future isAudioCached(String fileName) async { + try { + final directory = await getApplicationDocumentsDirectory(); + final filePath = '${directory.path}/audio/$fileName'; + final file = File(filePath); + return await file.exists(); + } catch (e) { + return false; + } + } + + /// 获取缓存音频文件路径 + Future getCachedAudioPath(String fileName) async { + try { + final directory = await getApplicationDocumentsDirectory(); + final filePath = '${directory.path}/audio/$fileName'; + final file = File(filePath); + + if (await file.exists()) { + return filePath; + } + return null; + } catch (e) { + return null; + } + } + + /// 释放资源 + Future dispose() async { + // TODO: 实现资源释放逻辑 + } + + // Getters + AudioPlayerState get state => _state; + Duration get duration => _duration; + Duration get position => _position; + double get volume => _volume; + double get playbackRate => _playbackRate; + String? get currentUrl => _currentUrl; + bool get isPlaying => _state == AudioPlayerState.playing; + bool get isPaused => _state == AudioPlayerState.paused; + bool get isStopped => _state == AudioPlayerState.stopped; + bool get isLoading => _state == AudioPlayerState.loading; + + /// 获取播放进度百分比 (0.0 - 1.0) + double get progress { + if (_duration.inMilliseconds == 0) return 0.0; + return _position.inMilliseconds / _duration.inMilliseconds; + } +} \ No newline at end of file diff --git a/client/lib/shared/services/auth_service.dart b/client/lib/shared/services/auth_service.dart new file mode 100644 index 0000000..36d5cfd --- /dev/null +++ b/client/lib/shared/services/auth_service.dart @@ -0,0 +1,371 @@ +import 'package:dio/dio.dart'; +import '../../core/network/api_client.dart'; +import '../../core/storage/storage_service.dart'; +import '../../core/constants/app_constants.dart'; +import '../../core/errors/app_error.dart'; +import '../models/api_response.dart'; +import '../models/user_model.dart'; + +/// 认证服务 +class AuthService { + static final AuthService _instance = AuthService._internal(); + factory AuthService() => _instance; + AuthService._internal(); + + final ApiClient _apiClient = ApiClient.instance; + + /// 用户注册 + Future> register({ + required String username, + required String email, + required String password, + required String nickname, + String? phone, + }) async { + try { + final response = await _apiClient.post( + '/auth/register', + data: { + 'username': username, + 'email': email, + 'password': password, + 'nickname': nickname, + if (phone != null) 'phone': phone, + }, + ); + + if (response.statusCode == 201) { + final authResponse = AuthResponse.fromJson(response.data['data']); + await _saveTokens(authResponse); + + return ApiResponse.success( + message: response.data['message'] ?? '注册成功', + data: authResponse, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? '注册失败', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: '注册失败：$e', + error: e.toString(), + ); + } + } + + /// 用户登录 + Future> login({ + required String account, // 用户名或邮箱 + required String password, + bool rememberMe = false, + }) async { + try { + final response = await _apiClient.post( + '/auth/login', + data: { + 'account': account, + 'password': password, + }, + ); + + if (response.statusCode == 200) { + final authResponse = AuthResponse.fromJson(response.data['data']); + await _saveTokens(authResponse); + + return ApiResponse.success( + message: response.data['message'] ?? '登录成功', + data: authResponse, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? '登录失败', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: '登录失败：$e', + error: e.toString(), + ); + } + } + + /// 刷新Token + Future> refreshToken() async { + try { + final refreshToken = StorageService.getString(AppConstants.refreshTokenKey); + if (refreshToken == null) { + return ApiResponse.failure( + message: 'Refresh token not found', + code: 401, + ); + } + + final response = await _apiClient.post( + '/auth/refresh', + data: { + 'refresh_token': refreshToken, + }, + ); + + if (response.statusCode == 200) { + final authResponse = AuthResponse.fromJson(response.data['data']); + await _saveTokens(authResponse); + + return ApiResponse.success( + message: 'Token refreshed successfully', + data: authResponse, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Token refresh failed', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Token refresh failed: $e', + error: e.toString(), + ); + } + } + + /// 用户登出 + Future> logout() async { + try { + final response = await _apiClient.post('/auth/logout'); + + // 无论服务器响应如何，都清除本地token + await _clearTokens(); + + if (response.statusCode == 200) { + return ApiResponse.success( + message: response.data['message'] ?? '登出成功', + ); + } else { + return ApiResponse.success( + message: '登出成功', + ); + } + } on DioException catch (e) { + // 即使请求失败，也清除本地token + await _clearTokens(); + return ApiResponse.success( + message: '登出成功', + ); + } catch (e) { + await _clearTokens(); + return ApiResponse.success( + message: '登出成功', + ); + } + } + + /// 获取当前用户信息 + Future> getCurrentUser() async { + try { + final response = await _apiClient.get('/auth/me'); + + if (response.statusCode == 200) { + final user = UserModel.fromJson(response.data['data']); + await StorageService.setObject(AppConstants.userInfoKey, user.toJson()); + + return ApiResponse.success( + message: 'User info retrieved successfully', + data: user, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to get user info', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to get user info: $e', + error: e.toString(), + ); + } + } + + /// 更新用户信息 + Future> updateProfile({ + String? nickname, + String? avatar, + String? phone, + DateTime? birthday, + String? gender, + String? bio, + String? learningLevel, + String? targetLanguage, + String? nativeLanguage, + int? dailyGoal, + }) async { + try { + final data = {}; + if (nickname != null) data['nickname'] = nickname; + if (avatar != null) data['avatar'] = avatar; + if (phone != null) data['phone'] = phone; + if (birthday != null) data['birthday'] = birthday.toIso8601String(); + if (gender != null) data['gender'] = gender; + if (bio != null) data['bio'] = bio; + if (learningLevel != null) data['learning_level'] = learningLevel; + if (targetLanguage != null) data['target_language'] = targetLanguage; + if (nativeLanguage != null) data['native_language'] = nativeLanguage; + if (dailyGoal != null) data['daily_goal'] = dailyGoal; + + final response = await _apiClient.put('/auth/profile', data: data); + + if (response.statusCode == 200) { + final user = UserModel.fromJson(response.data['data']); + await StorageService.setObject(AppConstants.userInfoKey, user.toJson()); + + return ApiResponse.success( + message: response.data['message'] ?? '个人信息更新成功', + data: user, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? '个人信息更新失败', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: '个人信息更新失败：$e', + error: e.toString(), + ); + } + } + + /// 修改密码 + Future> changePassword({ + required String currentPassword, + required String newPassword, + required String confirmPassword, + }) async { + try { + final response = await _apiClient.put( + '/auth/change-password', + data: { + 'current_password': currentPassword, + 'new_password': newPassword, + 'confirm_password': confirmPassword, + }, + ); + + if (response.statusCode == 200) { + return ApiResponse.success( + message: response.data['message'] ?? '密码修改成功', + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? '密码修改失败', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: '密码修改失败：$e', + error: e.toString(), + ); + } + } + + /// 检查是否已登录 + bool isLoggedIn() { + final token = StorageService.getString(AppConstants.accessTokenKey); + return token != null && token.isNotEmpty; + } + + /// 获取本地存储的用户信息 + UserModel? getCachedUser() { + final userJson = StorageService.getObject(AppConstants.userInfoKey); + if (userJson != null) { + try { + return UserModel.fromJson(userJson); + } catch (e) { + print('Error parsing cached user: $e'); + return null; + } + } + return null; + } + + /// 保存tokens + Future _saveTokens(AuthResponse authResponse) async { + await StorageService.setString( + AppConstants.accessTokenKey, + authResponse.accessToken, + ); + await StorageService.setString( + AppConstants.refreshTokenKey, + authResponse.refreshToken, + ); + + if (authResponse.user != null) { + await StorageService.setObject( + AppConstants.userInfoKey, + authResponse.user!, + ); + } + } + + /// 清除tokens + Future _clearTokens() async { + await StorageService.remove(AppConstants.accessTokenKey); + await StorageService.remove(AppConstants.refreshTokenKey); + await StorageService.remove(AppConstants.userInfoKey); + } + + /// 处理Dio错误 + ApiResponse _handleDioError(DioException e) { + switch (e.type) { + case DioExceptionType.connectionTimeout: + case DioExceptionType.sendTimeout: + case DioExceptionType.receiveTimeout: + return ApiResponse.failure( + message: '请求超时，请检查网络连接', + error: 'TIMEOUT', + ); + case DioExceptionType.badResponse: + final statusCode = e.response?.statusCode; + final message = e.response?.data?['message'] ?? '请求失败'; + return ApiResponse.failure( + message: message, + code: statusCode, + error: 'BAD_RESPONSE', + ); + case DioExceptionType.cancel: + return ApiResponse.failure( + message: '请求已取消', + error: 'CANCELLED', + ); + case DioExceptionType.connectionError: + return ApiResponse.failure( + message: '网络连接失败，请检查网络设置', + error: 'CONNECTION_ERROR', + ); + default: + return ApiResponse.failure( + message: '未知错误：${e.message}', + error: 'UNKNOWN', + ); + } + } +} \ No newline at end of file diff --git a/client/lib/shared/services/notification_service.dart b/client/lib/shared/services/notification_service.dart new file mode 100644 index 0000000..5ab8ce6 --- /dev/null +++ b/client/lib/shared/services/notification_service.dart @@ -0,0 +1,109 @@ +import '../../../core/models/api_response.dart'; +import '../../../core/services/enhanced_api_service.dart'; +import '../models/notification_model.dart'; + +/// 通知服务 +class NotificationService { + static final NotificationService _instance = NotificationService._internal(); + factory NotificationService() => _instance; + NotificationService._internal(); + + final EnhancedApiService _enhancedApiService = EnhancedApiService(); + + // 缓存时长配置 + static const Duration _shortCacheDuration = Duration(seconds: 30); + + /// 获取通知列表 + Future>> getNotifications({ + int page = 1, + int limit = 10, + bool onlyUnread = false, + }) async { + try { + final response = await _enhancedApiService.get>( + '/notifications', + queryParameters: { + 'page': page, + 'limit': limit, + 'only_unread': onlyUnread, + }, + cacheDuration: _shortCacheDuration, + fromJson: (data) { + final notifications = (data['notifications'] as List?) + ?.map((json) => NotificationModel.fromJson(json)) + .toList() ?? + []; + return { + 'notifications': notifications, + 'total': data['total'] ?? 0, + 'page': data['page'] ?? 1, + 'limit': data['limit'] ?? 10, + }; + }, + ); + + return response; + } catch (e) { + print('获取通知列表异常: $e'); + return ApiResponse.error(message: '获取通知列表失败: $e'); + } + } + + /// 获取未读通知数量 + Future> getUnreadCount() async { + try { + final response = await _enhancedApiService.get( + '/notifications/unread-count', + cacheDuration: _shortCacheDuration, + fromJson: (data) => data['count'] ?? 0, + ); + + return response; + } catch (e) { + print('获取未读通知数量异常: $e'); + return ApiResponse.error(message: '获取未读通知数量失败: $e'); + } + } + + /// 标记通知为已读 + Future> markAsRead(int notificationId) async { + try { + final response = await _enhancedApiService.put( + '/notifications/$notificationId/read', + ); + + return response; + } catch (e) { + print('标记通知已读异常: $e'); + return ApiResponse.error(message: '标记通知已读失败: $e'); + } + } + + /// 标记所有通知为已读 + Future> markAllAsRead() async { + try { + final response = await _enhancedApiService.put( + '/notifications/read-all', + ); + + return response; + } catch (e) { + print('标记所有通知已读异常: $e'); + return ApiResponse.error(message: '标记所有通知已读失败: $e'); + } + } + + /// 删除通知 + Future> deleteNotification(int notificationId) async { + try { + final response = await _enhancedApiService.delete( + '/notifications/$notificationId', + ); + + return response; + } catch (e) { + print('删除通知异常: $e'); + return ApiResponse.error(message: '删除通知失败: $e'); + } + } +} diff --git a/client/lib/shared/services/study_plan_service.dart b/client/lib/shared/services/study_plan_service.dart new file mode 100644 index 0000000..0648bb4 --- /dev/null +++ b/client/lib/shared/services/study_plan_service.dart @@ -0,0 +1,106 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../../shared/services/api_service.dart'; + +/// 学习计划服务 +class StudyPlanService { + final ApiService _apiService; + + StudyPlanService(this._apiService); + + /// 创建学习计划 + Future> createStudyPlan({ + required String planName, + String? description, + required int dailyGoal, + String? bookId, + required String startDate, + String? endDate, + String? remindTime, + String? remindDays, + }) async { + final response = await _apiService.post( + '/study-plans', + data: { + 'plan_name': planName, + 'description': description, + 'daily_goal': dailyGoal, + 'book_id': bookId, + 'start_date': startDate, + 'end_date': endDate, + 'remind_time': remindTime, + 'remind_days': remindDays, + }, + ); + return response['data']; + } + + /// 获取学习计划列表 + Future> getUserStudyPlans({String status = 'all'}) async { + final response = await _apiService.get( + '/study-plans', + queryParameters: {'status': status}, + ); + return response['data']['plans']; + } + + /// 获取今日学习计划 + Future> getTodayStudyPlans() async { + final response = await _apiService.get('/study-plans/today'); + return response['data']['plans']; + } + + /// 获取学习计划详情 + Future> getStudyPlanByID(int planId) async { + final response = await _apiService.get('/study-plans/$planId'); + return response['data']; + } + + /// 更新学习计划 + Future> updateStudyPlan( + int planId, + Map updates, + ) async { + final response = await _apiService.put('/study-plans/$planId', data: updates); + return response['data']; + } + + /// 删除学习计划 + Future deleteStudyPlan(int planId) async { + await _apiService.delete('/study-plans/$planId'); + } + + /// 更新计划状态 + Future updatePlanStatus(int planId, String status) async { + await _apiService.patch( + '/study-plans/$planId/status', + data: {'status': status}, + ); + } + + /// 记录学习进度 + Future recordStudyProgress( + int planId, { + required int wordsStudied, + int studyDuration = 0, + }) async { + await _apiService.post( + '/study-plans/$planId/progress', + data: { + 'words_studied': wordsStudied, + 'study_duration': studyDuration, + }, + ); + } + + /// 获取计划统计 + Future> getStudyPlanStatistics(int planId) async { + final response = await _apiService.get('/study-plans/$planId/statistics'); + return response['data']; + } +} + +/// 学习计划服务提供者 +final studyPlanServiceProvider = Provider((ref) { + final apiService = ref.watch(apiServiceProvider); + return StudyPlanService(apiService); +}); diff --git a/client/lib/shared/services/vocabulary_service.dart b/client/lib/shared/services/vocabulary_service.dart new file mode 100644 index 0000000..4bbe192 --- /dev/null +++ b/client/lib/shared/services/vocabulary_service.dart @@ -0,0 +1,479 @@ +import 'package:dio/dio.dart'; +import '../../core/network/api_client.dart'; +import '../../core/constants/app_constants.dart'; +import '../../core/errors/app_error.dart'; +import '../models/api_response.dart'; +import '../models/vocabulary_model.dart'; + +/// 词汇服务 +class VocabularyService { + static final VocabularyService _instance = VocabularyService._internal(); + factory VocabularyService() => _instance; + VocabularyService._internal(); + + final ApiClient _apiClient = ApiClient.instance; + + /// 获取词库列表 + Future>> getVocabularyBooks({ + String? category, + String? level, + int page = 1, + int limit = 20, + }) async { + try { + final queryParams = { + 'page': page, + 'limit': limit, + }; + + if (category != null) queryParams['category'] = category; + if (level != null) queryParams['level'] = level; + + final response = await _apiClient.get( + '/vocabulary/books', + queryParameters: queryParams, + ); + + if (response.statusCode == 200) { + final List booksJson = response.data['data']['items']; + final books = booksJson + .map((json) => VocabularyBookModel.fromJson(json)) + .toList(); + + return ApiResponse.success( + message: 'Vocabulary books retrieved successfully', + data: books, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to get vocabulary books', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to get vocabulary books: $e', + error: e.toString(), + ); + } + } + + /// 获取词汇列表 + Future>> getVocabularies({ + String? bookId, + String? search, + String? level, + int page = 1, + int limit = 20, + }) async { + try { + final queryParams = { + 'page': page, + 'limit': limit, + }; + + if (bookId != null) queryParams['book_id'] = bookId; + if (search != null) queryParams['search'] = search; + if (level != null) queryParams['level'] = level; + + final response = await _apiClient.get( + '/vocabulary/words', + queryParameters: queryParams, + ); + + if (response.statusCode == 200) { + final paginatedResponse = PaginatedResponse.fromJson( + response.data['data'], + (json) => VocabularyModel.fromJson(json), + ); + + return ApiResponse.success( + message: 'Vocabularies retrieved successfully', + data: paginatedResponse, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to get vocabularies', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to get vocabularies: $e', + error: e.toString(), + ); + } + } + + /// 获取单词详情 + Future> getWordDetail(String wordId) async { + try { + final response = await _apiClient.get('/vocabulary/words/$wordId'); + + if (response.statusCode == 200) { + final word = VocabularyModel.fromJson(response.data['data']); + + return ApiResponse.success( + message: 'Word detail retrieved successfully', + data: word, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to get word detail', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to get word detail: $e', + error: e.toString(), + ); + } + } + + /// 获取用户词汇学习记录 + Future>> getUserVocabularies({ + LearningStatus? status, + String? bookId, + int page = 1, + int limit = 20, + }) async { + try { + final queryParams = { + 'page': page, + 'limit': limit, + }; + + if (status != null) queryParams['status'] = status.name; + if (bookId != null) queryParams['book_id'] = bookId; + + final response = await _apiClient.get( + '/vocabulary/user-words', + queryParameters: queryParams, + ); + + if (response.statusCode == 200) { + final paginatedResponse = PaginatedResponse.fromJson( + response.data['data'], + (json) => UserVocabularyModel.fromJson(json), + ); + + return ApiResponse.success( + message: 'User vocabularies retrieved successfully', + data: paginatedResponse, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to get user vocabularies', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to get user vocabularies: $e', + error: e.toString(), + ); + } + } + + /// 更新单词学习状态 + Future> updateWordStatus({ + required String wordId, + required LearningStatus status, + int? correctCount, + int? wrongCount, + int? reviewCount, + DateTime? nextReviewDate, + Map? metadata, + }) async { + try { + final data = { + 'status': status.name, + }; + + if (correctCount != null) data['correct_count'] = correctCount; + if (wrongCount != null) data['wrong_count'] = wrongCount; + if (reviewCount != null) data['review_count'] = reviewCount; + if (nextReviewDate != null) { + data['next_review_date'] = nextReviewDate.toIso8601String(); + } + if (metadata != null) data['metadata'] = metadata; + + final response = await _apiClient.put( + '/vocabulary/user-words/$wordId', + data: data, + ); + + if (response.statusCode == 200) { + final userWord = UserVocabularyModel.fromJson(response.data['data']); + + return ApiResponse.success( + message: response.data['message'] ?? 'Word status updated successfully', + data: userWord, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to update word status', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to update word status: $e', + error: e.toString(), + ); + } + } + + /// 添加单词到学习列表 + Future> addWordToLearning(String wordId) async { + try { + final response = await _apiClient.post( + '/vocabulary/user-words', + data: {'word_id': wordId}, + ); + + if (response.statusCode == 201) { + final userWord = UserVocabularyModel.fromJson(response.data['data']); + + return ApiResponse.success( + message: response.data['message'] ?? 'Word added to learning list', + data: userWord, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to add word to learning list', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to add word to learning list: $e', + error: e.toString(), + ); + } + } + + /// 从学习列表移除单词 + Future> removeWordFromLearning(String wordId) async { + try { + final response = await _apiClient.delete('/vocabulary/user-words/$wordId'); + + if (response.statusCode == 200) { + return ApiResponse.success( + message: response.data['message'] ?? 'Word removed from learning list', + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to remove word from learning list', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to remove word from learning list: $e', + error: e.toString(), + ); + } + } + + /// 获取今日复习单词 + Future>> getTodayReviewWords() async { + try { + final response = await _apiClient.get('/vocabulary/today-review'); + + if (response.statusCode == 200) { + final List wordsJson = response.data['data']; + final words = wordsJson + .map((json) => UserVocabularyModel.fromJson(json)) + .toList(); + + return ApiResponse.success( + message: 'Today review words retrieved successfully', + data: words, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to get today review words', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to get today review words: $e', + error: e.toString(), + ); + } + } + + /// 获取新单词学习 + Future>> getNewWordsForLearning({ + String? bookId, + int limit = 10, + }) async { + try { + final queryParams = { + 'limit': limit, + }; + + if (bookId != null) queryParams['book_id'] = bookId; + + final response = await _apiClient.get( + '/vocabulary/new-words', + queryParameters: queryParams, + ); + + if (response.statusCode == 200) { + final List wordsJson = response.data['data']; + final words = wordsJson + .map((json) => VocabularyModel.fromJson(json)) + .toList(); + + return ApiResponse.success( + message: 'New words for learning retrieved successfully', + data: words, + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to get new words for learning', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to get new words for learning: $e', + error: e.toString(), + ); + } + } + + /// 词汇量测试 + Future>> vocabularyTest({ + required List wordIds, + required List answers, + }) async { + try { + final response = await _apiClient.post( + '/vocabulary/test', + data: { + 'word_ids': wordIds, + 'answers': answers, + }, + ); + + if (response.statusCode == 200) { + return ApiResponse.success( + message: 'Vocabulary test completed successfully', + data: response.data['data'], + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Vocabulary test failed', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Vocabulary test failed: $e', + error: e.toString(), + ); + } + } + + /// 获取学习统计 + Future>> getLearningStats({ + DateTime? startDate, + DateTime? endDate, + }) async { + try { + final queryParams = {}; + + if (startDate != null) { + queryParams['start_date'] = startDate.toIso8601String(); + } + if (endDate != null) { + queryParams['end_date'] = endDate.toIso8601String(); + } + + final response = await _apiClient.get( + '/vocabulary/stats', + queryParameters: queryParams, + ); + + if (response.statusCode == 200) { + return ApiResponse.success( + message: 'Learning stats retrieved successfully', + data: response.data['data'], + ); + } else { + return ApiResponse.failure( + message: response.data['message'] ?? 'Failed to get learning stats', + code: response.statusCode, + ); + } + } on DioException catch (e) { + return _handleDioError(e); + } catch (e) { + return ApiResponse.failure( + message: 'Failed to get learning stats: $e', + error: e.toString(), + ); + } + } + + /// 处理Dio错误 + ApiResponse _handleDioError(DioException e) { + switch (e.type) { + case DioExceptionType.connectionTimeout: + case DioExceptionType.sendTimeout: + case DioExceptionType.receiveTimeout: + return ApiResponse.failure( + message: '请求超时，请检查网络连接', + error: 'TIMEOUT', + ); + case DioExceptionType.badResponse: + final statusCode = e.response?.statusCode; + final message = e.response?.data?['message'] ?? '请求失败'; + return ApiResponse.failure( + message: message, + code: statusCode, + error: 'BAD_RESPONSE', + ); + case DioExceptionType.cancel: + return ApiResponse.failure( + message: '请求已取消', + error: 'CANCELLED', + ); + case DioExceptionType.connectionError: + return ApiResponse.failure( + message: '网络连接失败，请检查网络设置', + error: 'CONNECTION_ERROR', + ); + default: + return ApiResponse.failure( + message: '未知错误：${e.message}', + error: 'UNKNOWN', + ); + } + } +} \ No newline at end of file diff --git a/client/lib/shared/services/word_book_service.dart b/client/lib/shared/services/word_book_service.dart new file mode 100644 index 0000000..9a3343d --- /dev/null +++ b/client/lib/shared/services/word_book_service.dart @@ -0,0 +1,65 @@ +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../../core/network/api_client.dart'; + +/// 生词本服务 +class WordBookService { + final ApiClient _apiClient = ApiClient.instance; + + WordBookService(); + + /// 切换单词收藏状态 + Future> toggleFavorite(int wordId) async { + final response = await _apiClient.post('/word-book/toggle/$wordId'); + return response.data['data']; + } + + /// 获取生词本列表 + Future> getFavoriteWords({ + int page = 1, + int pageSize = 20, + String sortBy = 'created_at', + String order = 'desc', + }) async { + final response = await _apiClient.get( + '/word-book', + queryParameters: { + 'page': page, + 'page_size': pageSize, + 'sort_by': sortBy, + 'order': order, + }, + ); + return response.data['data']; + } + + /// 获取指定词汇书的生词本 + Future> getFavoriteWordsByBook(String bookId) async { + final response = await _apiClient.get('/word-book/books/$bookId'); + return response.data['data']['words']; + } + + /// 获取生词本统计信息 + Future> getFavoriteStats() async { + final response = await _apiClient.get('/word-book/stats'); + return response.data['data']; + } + + /// 批量添加到生词本 + Future batchAddToFavorite(List wordIds) async { + final response = await _apiClient.post( + '/word-book/batch', + data: {'word_ids': wordIds}, + ); + return response.data['data']['added_count']; + } + + /// 从生词本移除单词 + Future removeFromFavorite(int wordId) async { + await _apiClient.delete('/word-book/$wordId'); + } +} + +/// 生词本服务提供者 +final wordBookServiceProvider = Provider((ref) { + return WordBookService(); +}); diff --git a/client/lib/shared/widgets/custom_app_bar.dart b/client/lib/shared/widgets/custom_app_bar.dart new file mode 100644 index 0000000..d90564a --- /dev/null +++ b/client/lib/shared/widgets/custom_app_bar.dart @@ -0,0 +1,245 @@ +import 'package:flutter/material.dart'; + +/// 自定义应用栏 +class CustomAppBar extends StatelessWidget implements PreferredSizeWidget { + final String title; + final List? actions; + final Widget? leading; + final bool centerTitle; + final Color? backgroundColor; + final Color? foregroundColor; + final double elevation; + final bool automaticallyImplyLeading; + final PreferredSizeWidget? bottom; + final VoidCallback? onBackPressed; + + const CustomAppBar({ + super.key, + required this.title, + this.actions, + this.leading, + this.centerTitle = true, + this.backgroundColor, + this.foregroundColor, + this.elevation = 0, + this.automaticallyImplyLeading = true, + this.bottom, + this.onBackPressed, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return AppBar( + title: Text( + title, + style: theme.textTheme.titleLarge?.copyWith( + fontWeight: FontWeight.w600, + color: foregroundColor ?? theme.colorScheme.onSurface, + ), + ), + centerTitle: centerTitle, + backgroundColor: backgroundColor ?? theme.colorScheme.surface, + foregroundColor: foregroundColor ?? theme.colorScheme.onSurface, + elevation: elevation, + automaticallyImplyLeading: automaticallyImplyLeading, + leading: leading ?? (onBackPressed != null + ? IconButton( + icon: const Icon(Icons.arrow_back_ios), + onPressed: onBackPressed, + ) + : null), + actions: actions, + bottom: bottom, + surfaceTintColor: Colors.transparent, + ); + } + + @override + Size get preferredSize => Size.fromHeight( + kToolbarHeight + (bottom?.preferredSize.height ?? 0.0), + ); +} + +/// 带搜索功能的应用栏 +class SearchAppBar extends StatefulWidget implements PreferredSizeWidget { + final String title; + final String hintText; + final ValueChanged? onSearchChanged; + final VoidCallback? onSearchSubmitted; + final List? actions; + final bool automaticallyImplyLeading; + final VoidCallback? onBackPressed; + + const SearchAppBar({ + super.key, + required this.title, + this.hintText = '搜索...', + this.onSearchChanged, + this.onSearchSubmitted, + this.actions, + this.automaticallyImplyLeading = true, + this.onBackPressed, + }); + + @override + State createState() => _SearchAppBarState(); + + @override + Size get preferredSize => const Size.fromHeight(kToolbarHeight); +} + +class _SearchAppBarState extends State { + bool _isSearching = false; + final TextEditingController _searchController = TextEditingController(); + final FocusNode _searchFocusNode = FocusNode(); + + @override + void dispose() { + _searchController.dispose(); + _searchFocusNode.dispose(); + super.dispose(); + } + + void _startSearch() { + setState(() { + _isSearching = true; + }); + _searchFocusNode.requestFocus(); + } + + void _stopSearch() { + setState(() { + _isSearching = false; + _searchController.clear(); + }); + _searchFocusNode.unfocus(); + widget.onSearchChanged?.call(''); + } + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return AppBar( + title: _isSearching + ? TextField( + controller: _searchController, + focusNode: _searchFocusNode, + decoration: InputDecoration( + hintText: widget.hintText, + border: InputBorder.none, + hintStyle: theme.textTheme.bodyLarge?.copyWith( + color: theme.colorScheme.onSurface.withOpacity(0.6), + ), + ), + style: theme.textTheme.bodyLarge, + onChanged: widget.onSearchChanged, + onSubmitted: (_) => widget.onSearchSubmitted?.call(), + ) + : Text( + widget.title, + style: theme.textTheme.titleLarge?.copyWith( + fontWeight: FontWeight.w600, + ), + ), + centerTitle: !_isSearching, + backgroundColor: theme.colorScheme.surface, + foregroundColor: theme.colorScheme.onSurface, + elevation: 0, + automaticallyImplyLeading: widget.automaticallyImplyLeading && !_isSearching, + leading: _isSearching + ? IconButton( + icon: const Icon(Icons.arrow_back), + onPressed: _stopSearch, + ) + : (widget.onBackPressed != null + ? IconButton( + icon: const Icon(Icons.arrow_back_ios), + onPressed: widget.onBackPressed, + ) + : null), + actions: _isSearching + ? [ + IconButton( + icon: const Icon(Icons.clear), + onPressed: () { + _searchController.clear(); + widget.onSearchChanged?.call(''); + }, + ), + ] + : [ + IconButton( + icon: const Icon(Icons.search), + onPressed: _startSearch, + ), + ...?widget.actions, + ], + surfaceTintColor: Colors.transparent, + ); + } +} + +/// 带标签页的应用栏 +class TabAppBar extends StatelessWidget implements PreferredSizeWidget { + final String title; + final List tabs; + final TabController? controller; + final List? actions; + final bool automaticallyImplyLeading; + final VoidCallback? onBackPressed; + + const TabAppBar({ + super.key, + required this.title, + required this.tabs, + this.controller, + this.actions, + this.automaticallyImplyLeading = true, + this.onBackPressed, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return AppBar( + title: Text( + title, + style: theme.textTheme.titleLarge?.copyWith( + fontWeight: FontWeight.w600, + ), + ), + centerTitle: true, + backgroundColor: theme.colorScheme.surface, + foregroundColor: theme.colorScheme.onSurface, + elevation: 0, + automaticallyImplyLeading: automaticallyImplyLeading, + leading: onBackPressed != null + ? IconButton( + icon: const Icon(Icons.arrow_back_ios), + onPressed: onBackPressed, + ) + : null, + actions: actions, + bottom: TabBar( + controller: controller, + tabs: tabs, + labelColor: theme.colorScheme.primary, + unselectedLabelColor: theme.colorScheme.onSurface.withOpacity(0.6), + indicatorColor: theme.colorScheme.primary, + indicatorWeight: 2, + labelStyle: theme.textTheme.titleSmall?.copyWith( + fontWeight: FontWeight.w600, + ), + unselectedLabelStyle: theme.textTheme.titleSmall, + ), + surfaceTintColor: Colors.transparent, + ); + } + + @override + Size get preferredSize => const Size.fromHeight(kToolbarHeight + kTextTabBarHeight); +} \ No newline at end of file diff --git a/client/lib/shared/widgets/custom_card.dart b/client/lib/shared/widgets/custom_card.dart new file mode 100644 index 0000000..5f95643 --- /dev/null +++ b/client/lib/shared/widgets/custom_card.dart @@ -0,0 +1,440 @@ +import 'package:flutter/material.dart'; + +/// 自定义卡片组件 +class CustomCard extends StatelessWidget { + final Widget child; + final EdgeInsetsGeometry? padding; + final EdgeInsetsGeometry? margin; + final Color? color; + final double? elevation; + final BorderRadius? borderRadius; + final Border? border; + final VoidCallback? onTap; + final bool isSelected; + final Color? selectedColor; + final double? width; + final double? height; + final BoxShadow? shadow; + + const CustomCard({ + super.key, + required this.child, + this.padding, + this.margin, + this.color, + this.elevation, + this.borderRadius, + this.border, + this.onTap, + this.isSelected = false, + this.selectedColor, + this.width, + this.height, + this.shadow, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + final defaultBorderRadius = BorderRadius.circular(12); + + Widget card = Container( + width: width, + height: height, + margin: margin, + decoration: BoxDecoration( + color: isSelected + ? (selectedColor ?? theme.colorScheme.primaryContainer) + : (color ?? theme.colorScheme.surface), + borderRadius: borderRadius ?? defaultBorderRadius, + border: border ?? (isSelected + ? Border.all( + color: theme.colorScheme.primary, + width: 2, + ) + : Border.all( + color: theme.colorScheme.outline.withOpacity(0.2), + width: 1, + )), + boxShadow: shadow != null + ? [shadow!] + : [ + BoxShadow( + color: theme.colorScheme.shadow.withOpacity(0.1), + blurRadius: elevation ?? 4, + offset: const Offset(0, 2), + ), + ], + ), + child: Material( + color: Colors.transparent, + child: InkWell( + onTap: onTap, + borderRadius: borderRadius ?? defaultBorderRadius, + child: Padding( + padding: padding ?? const EdgeInsets.all(16), + child: child, + ), + ), + ), + ); + + return card; + } +} + +/// 信息卡片 +class InfoCard extends StatelessWidget { + final String title; + final String? subtitle; + final Widget? leading; + final Widget? trailing; + final VoidCallback? onTap; + final EdgeInsetsGeometry? padding; + final EdgeInsetsGeometry? margin; + final Color? backgroundColor; + final bool isSelected; + + const InfoCard({ + super.key, + required this.title, + this.subtitle, + this.leading, + this.trailing, + this.onTap, + this.padding, + this.margin, + this.backgroundColor, + this.isSelected = false, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return CustomCard( + onTap: onTap, + padding: padding ?? const EdgeInsets.all(16), + margin: margin, + color: backgroundColor, + isSelected: isSelected, + child: Row( + children: [ + if (leading != null) ...[ + leading!, + const SizedBox(width: 12), + ], + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + mainAxisSize: MainAxisSize.min, + children: [ + Text( + title, + style: theme.textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.w600, + color: isSelected + ? theme.colorScheme.onPrimaryContainer + : theme.colorScheme.onSurface, + ), + ), + if (subtitle != null) ...[ + const SizedBox(height: 4), + Text( + subtitle!, + style: theme.textTheme.bodyMedium?.copyWith( + color: isSelected + ? theme.colorScheme.onPrimaryContainer.withOpacity(0.8) + : theme.colorScheme.onSurface.withOpacity(0.7), + ), + ), + ], + ], + ), + ), + if (trailing != null) ...[ + const SizedBox(width: 12), + trailing!, + ], + ], + ), + ); + } +} + +/// 统计卡片 +class StatCard extends StatelessWidget { + final String title; + final String value; + final String? unit; + final IconData? icon; + final Color? iconColor; + final Color? backgroundColor; + final VoidCallback? onTap; + final EdgeInsetsGeometry? margin; + final Widget? trailing; + + const StatCard({ + super.key, + required this.title, + required this.value, + this.unit, + this.icon, + this.iconColor, + this.backgroundColor, + this.onTap, + this.margin, + this.trailing, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return CustomCard( + onTap: onTap, + margin: margin, + color: backgroundColor, + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + mainAxisSize: MainAxisSize.min, + children: [ + Row( + children: [ + if (icon != null) ...[ + Icon( + icon, + size: 20, + color: iconColor ?? theme.colorScheme.primary, + ), + const SizedBox(width: 8), + ], + Expanded( + child: Text( + title, + style: theme.textTheme.bodyMedium?.copyWith( + color: theme.colorScheme.onSurface.withOpacity(0.7), + ), + ), + ), + if (trailing != null) trailing!, + ], + ), + const SizedBox(height: 8), + Row( + crossAxisAlignment: CrossAxisAlignment.end, + children: [ + Text( + value, + style: theme.textTheme.headlineSmall?.copyWith( + fontWeight: FontWeight.bold, + color: theme.colorScheme.onSurface, + ), + ), + if (unit != null) ...[ + const SizedBox(width: 4), + Padding( + padding: const EdgeInsets.only(bottom: 2), + child: Text( + unit!, + style: theme.textTheme.bodySmall?.copyWith( + color: theme.colorScheme.onSurface.withOpacity(0.6), + ), + ), + ), + ], + ], + ), + ], + ), + ); + } +} + +/// 功能卡片 +class FeatureCard extends StatelessWidget { + final String title; + final String? description; + final IconData icon; + final Color? iconColor; + final Color? backgroundColor; + final VoidCallback? onTap; + final EdgeInsetsGeometry? margin; + final bool isEnabled; + final Widget? badge; + + const FeatureCard({ + super.key, + required this.title, + this.description, + required this.icon, + this.iconColor, + this.backgroundColor, + this.onTap, + this.margin, + this.isEnabled = true, + this.badge, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return CustomCard( + onTap: isEnabled ? onTap : null, + margin: margin, + color: backgroundColor, + child: Stack( + children: [ + Column( + crossAxisAlignment: CrossAxisAlignment.start, + mainAxisSize: MainAxisSize.min, + children: [ + Container( + padding: const EdgeInsets.all(12), + decoration: BoxDecoration( + color: (iconColor ?? theme.colorScheme.primary).withOpacity(0.1), + borderRadius: BorderRadius.circular(8), + ), + child: Icon( + icon, + size: 24, + color: isEnabled + ? (iconColor ?? theme.colorScheme.primary) + : theme.colorScheme.onSurface.withOpacity(0.4), + ), + ), + const SizedBox(height: 12), + Text( + title, + style: theme.textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.w600, + color: isEnabled + ? theme.colorScheme.onSurface + : theme.colorScheme.onSurface.withOpacity(0.4), + ), + ), + if (description != null) ...[ + const SizedBox(height: 4), + Text( + description!, + style: theme.textTheme.bodySmall?.copyWith( + color: isEnabled + ? theme.colorScheme.onSurface.withOpacity(0.7) + : theme.colorScheme.onSurface.withOpacity(0.4), + ), + maxLines: 2, + overflow: TextOverflow.ellipsis, + ), + ], + ], + ), + if (badge != null) + Positioned( + top: 0, + right: 0, + child: badge!, + ), + ], + ), + ); + } +} + +/// 进度卡片 +class ProgressCard extends StatelessWidget { + final String title; + final String? subtitle; + final double progress; + final String? progressText; + final Color? progressColor; + final Color? backgroundColor; + final VoidCallback? onTap; + final EdgeInsetsGeometry? margin; + final Widget? trailing; + + const ProgressCard({ + super.key, + required this.title, + this.subtitle, + required this.progress, + this.progressText, + this.progressColor, + this.backgroundColor, + this.onTap, + this.margin, + this.trailing, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return CustomCard( + onTap: onTap, + margin: margin, + color: backgroundColor, + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + mainAxisSize: MainAxisSize.min, + children: [ + Row( + children: [ + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + title, + style: theme.textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.w600, + ), + ), + if (subtitle != null) ...[ + const SizedBox(height: 2), + Text( + subtitle!, + style: theme.textTheme.bodySmall?.copyWith( + color: theme.colorScheme.onSurface.withOpacity(0.7), + ), + ), + ], + ], + ), + ), + if (trailing != null) ...[ + const SizedBox(width: 12), + trailing!, + ], + ], + ), + const SizedBox(height: 12), + Row( + children: [ + Expanded( + child: LinearProgressIndicator( + value: progress.clamp(0.0, 1.0), + backgroundColor: theme.colorScheme.surfaceVariant, + valueColor: AlwaysStoppedAnimation( + progressColor ?? theme.colorScheme.primary, + ), + minHeight: 6, + ), + ), + if (progressText != null) ...[ + const SizedBox(width: 12), + Text( + progressText!, + style: theme.textTheme.bodySmall?.copyWith( + fontWeight: FontWeight.w500, + color: theme.colorScheme.onSurface.withOpacity(0.8), + ), + ), + ], + ], + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/shared/widgets/error_handler.dart b/client/lib/shared/widgets/error_handler.dart new file mode 100644 index 0000000..59fe018 --- /dev/null +++ b/client/lib/shared/widgets/error_handler.dart @@ -0,0 +1,243 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../providers/error_provider.dart'; + +/// 全局错误处理组件 +class GlobalErrorHandler extends ConsumerWidget { + final Widget child; + + const GlobalErrorHandler({super.key, required this.child}); + + @override + Widget build(BuildContext context, WidgetRef ref) { + final errorState = ref.watch(errorProvider); + + // 监听错误状态变化 + ref.listen(errorProvider, (previous, next) { + if (next.currentError != null) { + _showErrorDialog(context, next.currentError!, ref); + } + }); + + return child; + } + + void _showErrorDialog(BuildContext context, AppError error, WidgetRef ref) { + showDialog( + context: context, + barrierDismissible: false, + builder: (context) => ErrorDialog( + error: error, + onDismiss: () { + Navigator.of(context).pop(); + ref.read(errorProvider.notifier).removeError(error.id); + }, + onRetry: null, + ), + ); + } +} + +/// 错误对话框 +class ErrorDialog extends StatelessWidget { + final AppError error; + final VoidCallback onDismiss; + final VoidCallback? onRetry; + + const ErrorDialog({ + super.key, + required this.error, + required this.onDismiss, + this.onRetry, + }); + + @override + Widget build(BuildContext context) { + return AlertDialog( + title: Row( + children: [ + Icon( + _getErrorIcon(), + color: _getErrorColor(), + ), + const SizedBox(width: 8), + Text(_getErrorTitle()), + ], + ), + content: Column( + mainAxisSize: MainAxisSize.min, + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text(error.message), + if (error.details != null) ...[ + const SizedBox(height: 8), + Text( + error.details!, + style: Theme.of(context).textTheme.bodySmall, + ), + ], + ], + ), + actions: [ + if (onRetry != null) + TextButton( + onPressed: () { + onDismiss(); + onRetry!(); + }, + child: const Text('重试'), + ), + TextButton( + onPressed: onDismiss, + child: const Text('确定'), + ), + ], + ); + } + + IconData _getErrorIcon() { + switch (error.type) { + case ErrorType.network: + return Icons.wifi_off; + case ErrorType.authentication: + return Icons.lock; + case ErrorType.validation: + return Icons.warning; + case ErrorType.server: + return Icons.error; + case ErrorType.unknown: + default: + return Icons.help_outline; + } + } + + Color _getErrorColor() { + switch (error.severity) { + case ErrorSeverity.critical: + return Colors.red; + case ErrorSeverity.error: + return Colors.orange; + case ErrorSeverity.warning: + return Colors.yellow[700]!; + case ErrorSeverity.info: + return Colors.blue; + } + } + + String _getErrorTitle() { + switch (error.type) { + case ErrorType.network: + return '网络错误'; + case ErrorType.authentication: + return '认证错误'; + case ErrorType.validation: + return '验证错误'; + case ErrorType.server: + return '服务器错误'; + case ErrorType.unknown: + default: + return '未知错误'; + } + } +} + +/// 错误横幅组件 +class ErrorBanner extends ConsumerWidget { + const ErrorBanner({super.key}); + + @override + Widget build(BuildContext context, WidgetRef ref) { + final errorState = ref.watch(errorProvider); + + if (!errorState.hasErrors) { + return const SizedBox.shrink(); + } + + final lowSeverityErrors = errorState.errors + .where((error) => error.severity == ErrorSeverity.info) + .toList(); + + if (lowSeverityErrors.isEmpty) { + return const SizedBox.shrink(); + } + + return Container( + width: double.infinity, + padding: const EdgeInsets.all(12), + color: Colors.blue[50], + child: Row( + children: [ + Icon( + Icons.info_outline, + color: Colors.blue[700], + size: 20, + ), + const SizedBox(width: 8), + Expanded( + child: Text( + lowSeverityErrors.first.message, + style: TextStyle( + color: Colors.blue[700], + fontSize: 14, + ), + ), + ), + IconButton( + onPressed: () { + ref.read(errorProvider.notifier).removeError(lowSeverityErrors.first.id); + }, + icon: Icon( + Icons.close, + color: Colors.blue[700], + size: 20, + ), + ), + ], + ), + ); + } +} + +/// 错误重试组件 +class ErrorRetryWidget extends StatelessWidget { + final String message; + final VoidCallback onRetry; + final IconData? icon; + + const ErrorRetryWidget({ + super.key, + required this.message, + required this.onRetry, + this.icon, + }); + + @override + Widget build(BuildContext context) { + return Center( + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + children: [ + Icon( + icon ?? Icons.error_outline, + size: 64, + color: Colors.grey[400], + ), + const SizedBox(height: 16), + Text( + message, + style: Theme.of(context).textTheme.bodyLarge?.copyWith( + color: Colors.grey[600], + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 16), + ElevatedButton.icon( + onPressed: onRetry, + icon: const Icon(Icons.refresh), + label: const Text('重试'), + ), + ], + ), + ); + } +} \ No newline at end of file diff --git a/client/lib/shared/widgets/error_widget.dart b/client/lib/shared/widgets/error_widget.dart new file mode 100644 index 0000000..6551fbe --- /dev/null +++ b/client/lib/shared/widgets/error_widget.dart @@ -0,0 +1,412 @@ +import 'package:flutter/material.dart'; + +/// 错误显示组件 +class ErrorDisplayWidget extends StatelessWidget { + final String message; + final String? title; + final IconData? icon; + final VoidCallback? onRetry; + final String? retryText; + final EdgeInsetsGeometry? padding; + final bool showIcon; + final Color? iconColor; + final TextAlign textAlign; + + const ErrorDisplayWidget({ + super.key, + required this.message, + this.title, + this.icon, + this.onRetry, + this.retryText, + this.padding, + this.showIcon = true, + this.iconColor, + this.textAlign = TextAlign.center, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return Padding( + padding: padding ?? const EdgeInsets.all(24), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + mainAxisSize: MainAxisSize.min, + children: [ + if (showIcon) ...[ + Icon( + icon ?? Icons.error_outline, + size: 64, + color: iconColor ?? theme.colorScheme.error, + ), + const SizedBox(height: 16), + ], + if (title != null) ...[ + Text( + title!, + style: theme.textTheme.titleLarge?.copyWith( + fontWeight: FontWeight.w600, + color: theme.colorScheme.onSurface, + ), + textAlign: textAlign, + ), + const SizedBox(height: 8), + ], + Text( + message, + style: theme.textTheme.bodyMedium?.copyWith( + color: theme.colorScheme.onSurface.withOpacity(0.7), + ), + textAlign: textAlign, + ), + if (onRetry != null) ...[ + const SizedBox(height: 24), + ElevatedButton.icon( + onPressed: onRetry, + icon: const Icon(Icons.refresh), + label: Text(retryText ?? '重试'), + style: ElevatedButton.styleFrom( + backgroundColor: theme.colorScheme.primary, + foregroundColor: theme.colorScheme.onPrimary, + padding: const EdgeInsets.symmetric( + horizontal: 24, + vertical: 12, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + ), + ], + ], + ), + ); + } +} + +/// 页面错误组件 +class PageErrorWidget extends StatelessWidget { + final String message; + final String? title; + final VoidCallback? onRetry; + final bool showAppBar; + final String? appBarTitle; + final VoidCallback? onBack; + + const PageErrorWidget({ + super.key, + required this.message, + this.title, + this.onRetry, + this.showAppBar = false, + this.appBarTitle, + this.onBack, + }); + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: showAppBar + ? AppBar( + title: appBarTitle != null ? Text(appBarTitle!) : null, + backgroundColor: Theme.of(context).colorScheme.surface, + elevation: 0, + leading: onBack != null + ? IconButton( + icon: const Icon(Icons.arrow_back_ios), + onPressed: onBack, + ) + : null, + ) + : null, + body: Center( + child: ErrorDisplayWidget( + title: title ?? '出错了', + message: message, + onRetry: onRetry, + ), + ), + ); + } +} + +/// 网络错误组件 +class NetworkErrorWidget extends StatelessWidget { + final VoidCallback? onRetry; + final String? customMessage; + final EdgeInsetsGeometry? padding; + + const NetworkErrorWidget({ + super.key, + this.onRetry, + this.customMessage, + this.padding, + }); + + @override + Widget build(BuildContext context) { + return ErrorDisplayWidget( + title: '网络连接失败', + message: customMessage ?? '请检查网络连接后重试', + icon: Icons.wifi_off, + onRetry: onRetry, + padding: padding, + ); + } +} + +/// 空数据组件 +class EmptyDataWidget extends StatelessWidget { + final String message; + final String? title; + final IconData? icon; + final VoidCallback? onAction; + final String? actionText; + final EdgeInsetsGeometry? padding; + final Color? iconColor; + + const EmptyDataWidget({ + super.key, + required this.message, + this.title, + this.icon, + this.onAction, + this.actionText, + this.padding, + this.iconColor, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return Padding( + padding: padding ?? const EdgeInsets.all(24), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + mainAxisSize: MainAxisSize.min, + children: [ + Icon( + icon ?? Icons.inbox_outlined, + size: 64, + color: iconColor ?? theme.colorScheme.onSurface.withOpacity(0.4), + ), + const SizedBox(height: 16), + if (title != null) ...[ + Text( + title!, + style: theme.textTheme.titleLarge?.copyWith( + fontWeight: FontWeight.w600, + color: theme.colorScheme.onSurface, + ), + textAlign: TextAlign.center, + ), + const SizedBox(height: 8), + ], + Text( + message, + style: theme.textTheme.bodyMedium?.copyWith( + color: theme.colorScheme.onSurface.withOpacity(0.6), + ), + textAlign: TextAlign.center, + ), + if (onAction != null) ...[ + const SizedBox(height: 24), + OutlinedButton.icon( + onPressed: onAction, + icon: const Icon(Icons.add), + label: Text(actionText ?? '添加'), + style: OutlinedButton.styleFrom( + foregroundColor: theme.colorScheme.primary, + side: BorderSide(color: theme.colorScheme.primary), + padding: const EdgeInsets.symmetric( + horizontal: 24, + vertical: 12, + ), + shape: RoundedRectangleBorder( + borderRadius: BorderRadius.circular(8), + ), + ), + ), + ], + ], + ), + ); + } +} + +/// 搜索无结果组件 +class NoSearchResultWidget extends StatelessWidget { + final String query; + final VoidCallback? onClear; + final EdgeInsetsGeometry? padding; + + const NoSearchResultWidget({ + super.key, + required this.query, + this.onClear, + this.padding, + }); + + @override + Widget build(BuildContext context) { + return EmptyDataWidget( + title: '未找到相关结果', + message: '没有找到与"$query"相关的内容\n请尝试其他关键词', + icon: Icons.search_off, + onAction: onClear, + actionText: '清除搜索', + padding: padding, + ); + } +} + +/// 权限错误组件 +class PermissionErrorWidget extends StatelessWidget { + final String message; + final VoidCallback? onRequestPermission; + final EdgeInsetsGeometry? padding; + + const PermissionErrorWidget({ + super.key, + required this.message, + this.onRequestPermission, + this.padding, + }); + + @override + Widget build(BuildContext context) { + return ErrorDisplayWidget( + title: '权限不足', + message: message, + icon: Icons.lock_outline, + onRetry: onRequestPermission, + retryText: '授权', + padding: padding, + iconColor: Theme.of(context).colorScheme.warning, + ); + } +} + +/// 服务器错误组件 +class ServerErrorWidget extends StatelessWidget { + final String? customMessage; + final VoidCallback? onRetry; + final EdgeInsetsGeometry? padding; + + const ServerErrorWidget({ + super.key, + this.customMessage, + this.onRetry, + this.padding, + }); + + @override + Widget build(BuildContext context) { + return ErrorDisplayWidget( + title: '服务器错误', + message: customMessage ?? '服务器暂时无法响应，请稍后重试', + icon: Icons.cloud_off, + onRetry: onRetry, + padding: padding, + ); + } +} + +/// 通用错误处理器 +class ErrorHandler { + static Widget handleError( + Object error, { + VoidCallback? onRetry, + EdgeInsetsGeometry? padding, + }) { + if (error.toString().contains('network') || + error.toString().contains('connection')) { + return NetworkErrorWidget( + onRetry: onRetry, + padding: padding, + ); + } + + if (error.toString().contains('permission')) { + return PermissionErrorWidget( + message: error.toString(), + onRequestPermission: onRetry, + padding: padding, + ); + } + + if (error.toString().contains('server') || + error.toString().contains('500')) { + return ServerErrorWidget( + onRetry: onRetry, + padding: padding, + ); + } + + return ErrorDisplayWidget( + message: error.toString(), + onRetry: onRetry, + padding: padding, + ); + } +} + +/// 错误边界组件 +class ErrorBoundary extends StatefulWidget { + final Widget child; + final Widget Function(Object error)? errorBuilder; + final void Function(Object error, StackTrace stackTrace)? onError; + + const ErrorBoundary({ + super.key, + required this.child, + this.errorBuilder, + this.onError, + }); + + @override + State createState() => _ErrorBoundaryState(); +} + +class _ErrorBoundaryState extends State { + Object? _error; + + @override + Widget build(BuildContext context) { + if (_error != null) { + return widget.errorBuilder?.call(_error!) ?? + ErrorHandler.handleError(_error!); + } + + return widget.child; + } + + @override + void didChangeDependencies() { + super.didChangeDependencies(); + // 重置错误状态 + if (_error != null) { + setState(() { + _error = null; + }); + } + } + + void _handleError(Object error, StackTrace stackTrace) { + widget.onError?.call(error, stackTrace); + if (mounted) { + setState(() { + _error = error; + }); + } + } +} + +/// 扩展 ColorScheme 以支持警告颜色 +extension ColorSchemeExtension on ColorScheme { + Color get warning => const Color(0xFFFF9800); + Color get onWarning => const Color(0xFF000000); +} \ No newline at end of file diff --git a/client/lib/shared/widgets/loading_widget.dart b/client/lib/shared/widgets/loading_widget.dart new file mode 100644 index 0000000..429dd7a --- /dev/null +++ b/client/lib/shared/widgets/loading_widget.dart @@ -0,0 +1,390 @@ +import 'package:flutter/material.dart'; + +/// 加载组件 +class LoadingWidget extends StatelessWidget { + final String? message; + final double? size; + final Color? color; + final EdgeInsetsGeometry? padding; + final bool showMessage; + + const LoadingWidget({ + super.key, + this.message, + this.size, + this.color, + this.padding, + this.showMessage = true, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return Padding( + padding: padding ?? const EdgeInsets.all(16), + child: Column( + mainAxisAlignment: MainAxisAlignment.center, + mainAxisSize: MainAxisSize.min, + children: [ + SizedBox( + width: size ?? 32, + height: size ?? 32, + child: CircularProgressIndicator( + strokeWidth: 3, + valueColor: AlwaysStoppedAnimation( + color ?? theme.colorScheme.primary, + ), + ), + ), + if (showMessage && message != null) ...[ + const SizedBox(height: 16), + Text( + message!, + style: theme.textTheme.bodyMedium?.copyWith( + color: theme.colorScheme.onSurface.withOpacity(0.7), + ), + textAlign: TextAlign.center, + ), + ], + ], + ), + ); + } +} + +/// 页面加载组件 +class PageLoadingWidget extends StatelessWidget { + final String? message; + final bool showAppBar; + final String? title; + + const PageLoadingWidget({ + super.key, + this.message, + this.showAppBar = false, + this.title, + }); + + @override + Widget build(BuildContext context) { + return Scaffold( + appBar: showAppBar + ? AppBar( + title: title != null ? Text(title!) : null, + backgroundColor: Theme.of(context).colorScheme.surface, + elevation: 0, + ) + : null, + body: Center( + child: LoadingWidget( + message: message ?? '加载中...', + size: 48, + ), + ), + ); + } +} + +/// 列表加载组件 +class ListLoadingWidget extends StatelessWidget { + final int itemCount; + final double itemHeight; + final EdgeInsetsGeometry? padding; + final EdgeInsetsGeometry? margin; + + const ListLoadingWidget({ + super.key, + this.itemCount = 5, + this.itemHeight = 80, + this.padding, + this.margin, + }); + + @override + Widget build(BuildContext context) { + return ListView.builder( + padding: padding, + itemCount: itemCount, + itemBuilder: (context, index) => Container( + height: itemHeight, + margin: margin ?? const EdgeInsets.symmetric( + horizontal: 16, + vertical: 8, + ), + child: const ShimmerWidget(), + ), + ); + } +} + +/// 骨架屏组件 +class ShimmerWidget extends StatefulWidget { + final double? width; + final double? height; + final BorderRadius? borderRadius; + final Color? baseColor; + final Color? highlightColor; + + const ShimmerWidget({ + super.key, + this.width, + this.height, + this.borderRadius, + this.baseColor, + this.highlightColor, + }); + + @override + State createState() => _ShimmerWidgetState(); +} + +class _ShimmerWidgetState extends State + with SingleTickerProviderStateMixin { + late AnimationController _animationController; + late Animation _animation; + + @override + void initState() { + super.initState(); + _animationController = AnimationController( + duration: const Duration(milliseconds: 1500), + vsync: this, + ); + _animation = Tween( + begin: -1.0, + end: 2.0, + ).animate(CurvedAnimation( + parent: _animationController, + curve: Curves.easeInOut, + )); + _animationController.repeat(); + } + + @override + void dispose() { + _animationController.dispose(); + super.dispose(); + } + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + final baseColor = widget.baseColor ?? theme.colorScheme.surfaceVariant; + final highlightColor = widget.highlightColor ?? + theme.colorScheme.surface.withOpacity(0.8); + + return AnimatedBuilder( + animation: _animation, + builder: (context, child) { + return Container( + width: widget.width, + height: widget.height, + decoration: BoxDecoration( + borderRadius: widget.borderRadius ?? BorderRadius.circular(8), + gradient: LinearGradient( + begin: Alignment.centerLeft, + end: Alignment.centerRight, + colors: [ + baseColor, + highlightColor, + baseColor, + ], + stops: [ + _animation.value - 0.3, + _animation.value, + _animation.value + 0.3, + ], + ), + ), + ); + }, + ); + } +} + +/// 卡片骨架屏 +class CardShimmerWidget extends StatelessWidget { + final EdgeInsetsGeometry? margin; + final double? height; + + const CardShimmerWidget({ + super.key, + this.margin, + this.height, + }); + + @override + Widget build(BuildContext context) { + return Container( + margin: margin ?? const EdgeInsets.symmetric( + horizontal: 16, + vertical: 8, + ), + padding: const EdgeInsets.all(16), + decoration: BoxDecoration( + color: Theme.of(context).colorScheme.surface, + borderRadius: BorderRadius.circular(12), + border: Border.all( + color: Theme.of(context).colorScheme.outline.withOpacity(0.2), + ), + ), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + const ShimmerWidget( + width: 40, + height: 40, + borderRadius: BorderRadius.all(Radius.circular(20)), + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + ShimmerWidget( + width: double.infinity, + height: 16, + borderRadius: BorderRadius.circular(4), + ), + const SizedBox(height: 8), + ShimmerWidget( + width: 120, + height: 12, + borderRadius: BorderRadius.circular(4), + ), + ], + ), + ), + ], + ), + if (height != null && height! > 100) ...[ + const SizedBox(height: 16), + ShimmerWidget( + width: double.infinity, + height: 12, + borderRadius: BorderRadius.circular(4), + ), + const SizedBox(height: 8), + ShimmerWidget( + width: double.infinity, + height: 12, + borderRadius: BorderRadius.circular(4), + ), + const SizedBox(height: 8), + ShimmerWidget( + width: 200, + height: 12, + borderRadius: BorderRadius.circular(4), + ), + ], + ], + ), + ); + } +} + +/// 按钮加载状态 +class LoadingButton extends StatelessWidget { + final String text; + final VoidCallback? onPressed; + final bool isLoading; + final IconData? icon; + final Color? backgroundColor; + final Color? foregroundColor; + final EdgeInsetsGeometry? padding; + final double? width; + final double? height; + final BorderRadius? borderRadius; + + const LoadingButton({ + super.key, + required this.text, + this.onPressed, + this.isLoading = false, + this.icon, + this.backgroundColor, + this.foregroundColor, + this.padding, + this.width, + this.height, + this.borderRadius, + }); + + @override + Widget build(BuildContext context) { + final theme = Theme.of(context); + + return SizedBox( + width: width, + height: height ?? 48, + child: ElevatedButton( + onPressed: isLoading ? null : onPressed, + style: ElevatedButton.styleFrom( + backgroundColor: backgroundColor ?? theme.colorScheme.primary, + foregroundColor: foregroundColor ?? theme.colorScheme.onPrimary, + padding: padding ?? const EdgeInsets.symmetric( + horizontal: 24, + vertical: 12, + ), + shape: RoundedRectangleBorder( + borderRadius: borderRadius ?? BorderRadius.circular(8), + ), + elevation: 0, + ), + child: isLoading + ? SizedBox( + width: 20, + height: 20, + child: CircularProgressIndicator( + strokeWidth: 2, + valueColor: AlwaysStoppedAnimation( + foregroundColor ?? theme.colorScheme.onPrimary, + ), + ), + ) + : Row( + mainAxisSize: MainAxisSize.min, + children: [ + if (icon != null) ...[ + Icon(icon, size: 18), + const SizedBox(width: 8), + ], + Text( + text, + style: theme.textTheme.titleSmall?.copyWith( + fontWeight: FontWeight.w600, + ), + ), + ], + ), + ), + ); + } +} + +/// 刷新指示器 +class RefreshIndicatorWidget extends StatelessWidget { + final Widget child; + final Future Function() onRefresh; + final String? refreshText; + + const RefreshIndicatorWidget({ + super.key, + required this.child, + required this.onRefresh, + this.refreshText, + }); + + @override + Widget build(BuildContext context) { + return RefreshIndicator( + onRefresh: onRefresh, + color: Theme.of(context).colorScheme.primary, + backgroundColor: Theme.of(context).colorScheme.surface, + child: child, + ); + } +} \ No newline at end of file diff --git a/client/lib/shared/widgets/network_indicator.dart b/client/lib/shared/widgets/network_indicator.dart new file mode 100644 index 0000000..c5cf023 --- /dev/null +++ b/client/lib/shared/widgets/network_indicator.dart @@ -0,0 +1,224 @@ +import 'package:flutter/material.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; +import '../providers/network_provider.dart'; + +/// 网络状态指示器 +class NetworkIndicator extends ConsumerWidget { + final Widget child; + final bool showBanner; + + const NetworkIndicator({ + super.key, + required this.child, + this.showBanner = true, + }); + + @override + Widget build(BuildContext context, WidgetRef ref) { + final networkState = ref.watch(networkProvider); + + return Column( + children: [ + if (showBanner && networkState.status == NetworkStatus.disconnected) + _buildOfflineBanner(context), + Expanded(child: child), + ], + ); + } + + Widget _buildOfflineBanner(BuildContext context) { + return Container( + width: double.infinity, + padding: const EdgeInsets.symmetric(vertical: 8, horizontal: 16), + color: Colors.red[600], + child: Row( + children: [ + const Icon( + Icons.wifi_off, + color: Colors.white, + size: 20, + ), + const SizedBox(width: 8), + const Expanded( + child: Text( + '网络连接已断开', + style: TextStyle( + color: Colors.white, + fontSize: 14, + fontWeight: FontWeight.w500, + ), + ), + ), + TextButton( + onPressed: () { + // 可以添加重试逻辑 + }, + child: const Text( + '重试', + style: TextStyle( + color: Colors.white, + fontSize: 14, + ), + ), + ), + ], + ), + ); + } +} + +/// 网络状态图标 +class NetworkStatusIcon extends ConsumerWidget { + final double size; + final Color? color; + + const NetworkStatusIcon({ + super.key, + this.size = 24, + this.color, + }); + + @override + Widget build(BuildContext context, WidgetRef ref) { + final networkState = ref.watch(networkProvider); + + return Icon( + _getNetworkIcon(networkState.status, networkState.type), + size: size, + color: color ?? _getNetworkColor(networkState.status), + ); + } + + IconData _getNetworkIcon(NetworkStatus status, NetworkType type) { + if (status == NetworkStatus.disconnected) { + return Icons.wifi_off; + } + + switch (type) { + case NetworkType.wifi: + return Icons.wifi; + case NetworkType.mobile: + return Icons.signal_cellular_4_bar; + case NetworkType.ethernet: + return Icons.cable; + case NetworkType.unknown: + default: + return Icons.device_unknown; + } + } + + Color _getNetworkColor(NetworkStatus status) { + switch (status) { + case NetworkStatus.connected: + return Colors.green; + case NetworkStatus.disconnected: + return Colors.red; + case NetworkStatus.unknown: + return Colors.grey; + } + } +} + +/// 网络状态卡片 +class NetworkStatusCard extends ConsumerWidget { + const NetworkStatusCard({super.key}); + + @override + Widget build(BuildContext context, WidgetRef ref) { + final networkState = ref.watch(networkProvider); + + return Card( + child: Padding( + padding: const EdgeInsets.all(16), + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Row( + children: [ + NetworkStatusIcon( + size: 32, + ), + const SizedBox(width: 12), + Expanded( + child: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + Text( + _getStatusText(networkState.status), + style: Theme.of(context).textTheme.titleMedium?.copyWith( + fontWeight: FontWeight.bold, + ), + ), + Text( + _getTypeText(networkState.type), + style: Theme.of(context).textTheme.bodyMedium?.copyWith( + color: Colors.grey[600], + ), + ), + ], + ), + ), + ], + ), + const SizedBox(height: 12), + Row( + mainAxisAlignment: MainAxisAlignment.spaceBetween, + children: [ + Text( + '最后更新: ${_formatTime(networkState.lastChecked)}', + style: Theme.of(context).textTheme.bodySmall, + ), + TextButton( + onPressed: () { + ref.read(networkProvider.notifier).refreshNetworkStatus(); + }, + child: const Text('刷新'), + ), + ], + ), + ], + ), + ), + ); + } + + String _getStatusText(NetworkStatus status) { + switch (status) { + case NetworkStatus.connected: + return '已连接'; + case NetworkStatus.disconnected: + return '未连接'; + case NetworkStatus.unknown: + return '未知状态'; + } + } + + String _getTypeText(NetworkType type) { + switch (type) { + case NetworkType.wifi: + return 'Wi-Fi'; + case NetworkType.mobile: + return '移动网络'; + case NetworkType.ethernet: + return '以太网'; + case NetworkType.unknown: + default: + return '未知'; + } + } + + String _formatTime(DateTime time) { + final now = DateTime.now(); + final difference = now.difference(time); + + if (difference.inMinutes < 1) { + return '刚刚'; + } else if (difference.inHours < 1) { + return '${difference.inMinutes}分钟前'; + } else if (difference.inDays < 1) { + return '${difference.inHours}小时前'; + } else { + return '${difference.inDays}天前'; + } + } +} \ No newline at end of file diff --git a/client/linux/.gitignore b/client/linux/.gitignore new file mode 100644 index 0000000..d3896c9 --- /dev/null +++ b/client/linux/.gitignore @@ -0,0 +1 @@ +flutter/ephemeral diff --git a/client/linux/CMakeLists.txt b/client/linux/CMakeLists.txt new file mode 100644 index 0000000..85353cc --- /dev/null +++ b/client/linux/CMakeLists.txt @@ -0,0 +1,129 @@ +# Project-level configuration. +cmake_minimum_required(VERSION 3.13) +project(runner LANGUAGES CXX) + +# The name of the executable created for the application. Change this to change +# the on-disk name of your application. +set(BINARY_NAME "client") +# The unique GTK application identifier for this application. See: +# https://wiki.gnome.org/HowDoI/ChooseApplicationID +set(APPLICATION_ID "com.example.client") + +# Explicitly opt in to modern CMake behaviors to avoid warnings with recent +# versions of CMake. +cmake_policy(SET CMP0063 NEW) + +# Load bundled libraries from the lib/ directory relative to the binary. +set(CMAKE_INSTALL_RPATH "$ORIGIN/lib") + +# Root filesystem for cross-building. +if(FLUTTER_TARGET_PLATFORM_SYSROOT) + set(CMAKE_SYSROOT ${FLUTTER_TARGET_PLATFORM_SYSROOT}) + set(CMAKE_FIND_ROOT_PATH ${CMAKE_SYSROOT}) + set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) + set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY) + set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) + set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) +endif() + +# Define build configuration options. +if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES) + set(CMAKE_BUILD_TYPE "Debug" CACHE + STRING "Flutter build mode" FORCE) + set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS + "Debug" "Profile" "Release") +endif() + +# Compilation settings that should be applied to most targets. +# +# Be cautious about adding new options here, as plugins use this function by +# default. In most cases, you should add new options to specific targets instead +# of modifying this function. +function(APPLY_STANDARD_SETTINGS TARGET) + target_compile_features(${TARGET} PUBLIC cxx_std_14) + target_compile_options(${TARGET} PRIVATE -Wall -Werror) + target_compile_options(${TARGET} PRIVATE "$<$>:-O3>") + target_compile_definitions(${TARGET} PRIVATE "$<$>:NDEBUG>") + target_compile_definitions(${TARGET} PRIVATE "APPLICATION_ID=\"${APPLICATION_ID}\"") +endfunction() + +# Flutter library and tool build rules. +set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter") +add_subdirectory(${FLUTTER_MANAGED_DIR}) + +# System-level dependencies. +find_package(PkgConfig REQUIRED) +pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0) + +# Application build; see runner/CMakeLists.txt. +add_subdirectory("runner") + +# Run the Flutter tool portions of the build. This must not be removed. +add_dependencies(${BINARY_NAME} flutter_assemble) + +# Only the install-generated bundle's copy of the executable will launch +# correctly, since the resources must in the right relative locations. To avoid +# people trying to run the unbundled copy, put it in a subdirectory instead of +# the default top-level location. +set_target_properties(${BINARY_NAME} + PROPERTIES + RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/intermediates_do_not_run" +) + + +# Generated plugin build rules, which manage building the plugins and adding +# them to the application. +include(flutter/generated_plugins.cmake) + + +# === Installation === +# By default, "installing" just makes a relocatable bundle in the build +# directory. +set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle") +if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT) + set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE) +endif() + +# Start with a clean build bundle directory every time. +install(CODE " + file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\") + " COMPONENT Runtime) + +set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data") +set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib") + +install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES}) + install(FILES "${bundled_library}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) +endforeach(bundled_library) + +# Copy the native assets provided by the build.dart from all packages. +set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/") +install(DIRECTORY "${NATIVE_ASSETS_DIR}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +# Fully re-copy the assets directory on each build to avoid having stale files +# from a previous install. +set(FLUTTER_ASSET_DIR_NAME "flutter_assets") +install(CODE " + file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\") + " COMPONENT Runtime) +install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}" + DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime) + +# Install the AOT library on non-Debug builds only. +if(NOT CMAKE_BUILD_TYPE MATCHES "Debug") + install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) +endif() diff --git a/client/linux/flutter/CMakeLists.txt b/client/linux/flutter/CMakeLists.txt new file mode 100644 index 0000000..d5bd016 --- /dev/null +++ b/client/linux/flutter/CMakeLists.txt @@ -0,0 +1,88 @@ +# This file controls Flutter-level build steps. It should not be edited. +cmake_minimum_required(VERSION 3.10) + +set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral") + +# Configuration provided via flutter tool. +include(${EPHEMERAL_DIR}/generated_config.cmake) + +# TODO: Move the rest of this into files in ephemeral. See +# https://github.com/flutter/flutter/issues/57146. + +# Serves the same purpose as list(TRANSFORM ... PREPEND ...), +# which isn't available in 3.10. +function(list_prepend LIST_NAME PREFIX) + set(NEW_LIST "") + foreach(element ${${LIST_NAME}}) + list(APPEND NEW_LIST "${PREFIX}${element}") + endforeach(element) + set(${LIST_NAME} "${NEW_LIST}" PARENT_SCOPE) +endfunction() + +# === Flutter Library === +# System-level dependencies. +find_package(PkgConfig REQUIRED) +pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0) +pkg_check_modules(GLIB REQUIRED IMPORTED_TARGET glib-2.0) +pkg_check_modules(GIO REQUIRED IMPORTED_TARGET gio-2.0) + +set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/libflutter_linux_gtk.so") + +# Published to parent scope for install step. +set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE) +set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE) +set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE) +set(AOT_LIBRARY "${PROJECT_DIR}/build/lib/libapp.so" PARENT_SCOPE) + +list(APPEND FLUTTER_LIBRARY_HEADERS + "fl_basic_message_channel.h" + "fl_binary_codec.h" + "fl_binary_messenger.h" + "fl_dart_project.h" + "fl_engine.h" + "fl_json_message_codec.h" + "fl_json_method_codec.h" + "fl_message_codec.h" + "fl_method_call.h" + "fl_method_channel.h" + "fl_method_codec.h" + "fl_method_response.h" + "fl_plugin_registrar.h" + "fl_plugin_registry.h" + "fl_standard_message_codec.h" + "fl_standard_method_codec.h" + "fl_string_codec.h" + "fl_value.h" + "fl_view.h" + "flutter_linux.h" +) +list_prepend(FLUTTER_LIBRARY_HEADERS "${EPHEMERAL_DIR}/flutter_linux/") +add_library(flutter INTERFACE) +target_include_directories(flutter INTERFACE + "${EPHEMERAL_DIR}" +) +target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}") +target_link_libraries(flutter INTERFACE + PkgConfig::GTK + PkgConfig::GLIB + PkgConfig::GIO +) +add_dependencies(flutter flutter_assemble) + +# === Flutter tool backend === +# _phony_ is a non-existent file to force this command to run every time, +# since currently there's no way to get a full input/output list from the +# flutter tool. +add_custom_command( + OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS} + ${CMAKE_CURRENT_BINARY_DIR}/_phony_ + COMMAND ${CMAKE_COMMAND} -E env + ${FLUTTER_TOOL_ENVIRONMENT} + "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.sh" + ${FLUTTER_TARGET_PLATFORM} ${CMAKE_BUILD_TYPE} + VERBATIM +) +add_custom_target(flutter_assemble DEPENDS + "${FLUTTER_LIBRARY}" + ${FLUTTER_LIBRARY_HEADERS} +) diff --git a/client/linux/flutter/generated_plugin_registrant.cc b/client/linux/flutter/generated_plugin_registrant.cc new file mode 100644 index 0000000..64a0ece --- /dev/null +++ b/client/linux/flutter/generated_plugin_registrant.cc @@ -0,0 +1,15 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#include "generated_plugin_registrant.h" + +#include + +void fl_register_plugins(FlPluginRegistry* registry) { + g_autoptr(FlPluginRegistrar) file_selector_linux_registrar = + fl_plugin_registry_get_registrar_for_plugin(registry, "FileSelectorPlugin"); + file_selector_plugin_register_with_registrar(file_selector_linux_registrar); +} diff --git a/client/linux/flutter/generated_plugin_registrant.h b/client/linux/flutter/generated_plugin_registrant.h new file mode 100644 index 0000000..e0f0a47 --- /dev/null +++ b/client/linux/flutter/generated_plugin_registrant.h @@ -0,0 +1,15 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#ifndef GENERATED_PLUGIN_REGISTRANT_ +#define GENERATED_PLUGIN_REGISTRANT_ + +#include + +// Registers Flutter plugins. +void fl_register_plugins(FlPluginRegistry* registry); + +#endif // GENERATED_PLUGIN_REGISTRANT_ diff --git a/client/linux/flutter/generated_plugins.cmake b/client/linux/flutter/generated_plugins.cmake new file mode 100644 index 0000000..2db3c22 --- /dev/null +++ b/client/linux/flutter/generated_plugins.cmake @@ -0,0 +1,24 @@ +# +# Generated file, do not edit. +# + +list(APPEND FLUTTER_PLUGIN_LIST + file_selector_linux +) + +list(APPEND FLUTTER_FFI_PLUGIN_LIST +) + +set(PLUGIN_BUNDLED_LIBRARIES) + +foreach(plugin ${FLUTTER_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/linux plugins/${plugin}) + target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin) + list(APPEND PLUGIN_BUNDLED_LIBRARIES $) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries}) +endforeach(plugin) + +foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/linux plugins/${ffi_plugin}) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries}) +endforeach(ffi_plugin) diff --git a/client/linux/runner/CMakeLists.txt b/client/linux/runner/CMakeLists.txt new file mode 100644 index 0000000..e97dabc --- /dev/null +++ b/client/linux/runner/CMakeLists.txt @@ -0,0 +1,26 @@ +cmake_minimum_required(VERSION 3.13) +project(runner LANGUAGES CXX) + +# Define the application target. To change its name, change BINARY_NAME in the +# top-level CMakeLists.txt, not the value here, or `flutter run` will no longer +# work. +# +# Any new source files that you add to the application should be added here. +add_executable(${BINARY_NAME} + "main.cc" + "my_application.cc" + "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc" +) + +# Apply the standard set of build settings. This can be removed for applications +# that need different build settings. +apply_standard_settings(${BINARY_NAME}) + +# Add preprocessor definitions for the application ID. +add_definitions(-DAPPLICATION_ID="${APPLICATION_ID}") + +# Add dependency libraries. Add any application-specific dependencies here. +target_link_libraries(${BINARY_NAME} PRIVATE flutter) +target_link_libraries(${BINARY_NAME} PRIVATE PkgConfig::GTK) + +target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}") diff --git a/client/linux/runner/main.cc b/client/linux/runner/main.cc new file mode 100644 index 0000000..e7c5c54 --- /dev/null +++ b/client/linux/runner/main.cc @@ -0,0 +1,6 @@ +#include "my_application.h" + +int main(int argc, char** argv) { + g_autoptr(MyApplication) app = my_application_new(); + return g_application_run(G_APPLICATION(app), argc, argv); +} diff --git a/client/linux/runner/my_application.cc b/client/linux/runner/my_application.cc new file mode 100644 index 0000000..e8232e7 --- /dev/null +++ b/client/linux/runner/my_application.cc @@ -0,0 +1,144 @@ +#include "my_application.h" + +#include +#ifdef GDK_WINDOWING_X11 +#include +#endif + +#include "flutter/generated_plugin_registrant.h" + +struct _MyApplication { + GtkApplication parent_instance; + char** dart_entrypoint_arguments; +}; + +G_DEFINE_TYPE(MyApplication, my_application, GTK_TYPE_APPLICATION) + +// Called when first Flutter frame received. +static void first_frame_cb(MyApplication* self, FlView *view) +{ + gtk_widget_show(gtk_widget_get_toplevel(GTK_WIDGET(view))); +} + +// Implements GApplication::activate. +static void my_application_activate(GApplication* application) { + MyApplication* self = MY_APPLICATION(application); + GtkWindow* window = + GTK_WINDOW(gtk_application_window_new(GTK_APPLICATION(application))); + + // Use a header bar when running in GNOME as this is the common style used + // by applications and is the setup most users will be using (e.g. Ubuntu + // desktop). + // If running on X and not using GNOME then just use a traditional title bar + // in case the window manager does more exotic layout, e.g. tiling. + // If running on Wayland assume the header bar will work (may need changing + // if future cases occur). + gboolean use_header_bar = TRUE; +#ifdef GDK_WINDOWING_X11 + GdkScreen* screen = gtk_window_get_screen(window); + if (GDK_IS_X11_SCREEN(screen)) { + const gchar* wm_name = gdk_x11_screen_get_window_manager_name(screen); + if (g_strcmp0(wm_name, "GNOME Shell") != 0) { + use_header_bar = FALSE; + } + } +#endif + if (use_header_bar) { + GtkHeaderBar* header_bar = GTK_HEADER_BAR(gtk_header_bar_new()); + gtk_widget_show(GTK_WIDGET(header_bar)); + gtk_header_bar_set_title(header_bar, "client"); + gtk_header_bar_set_show_close_button(header_bar, TRUE); + gtk_window_set_titlebar(window, GTK_WIDGET(header_bar)); + } else { + gtk_window_set_title(window, "client"); + } + + gtk_window_set_default_size(window, 1280, 720); + + g_autoptr(FlDartProject) project = fl_dart_project_new(); + fl_dart_project_set_dart_entrypoint_arguments(project, self->dart_entrypoint_arguments); + + FlView* view = fl_view_new(project); + GdkRGBA background_color; + // Background defaults to black, override it here if necessary, e.g. #00000000 for transparent. + gdk_rgba_parse(&background_color, "#000000"); + fl_view_set_background_color(view, &background_color); + gtk_widget_show(GTK_WIDGET(view)); + gtk_container_add(GTK_CONTAINER(window), GTK_WIDGET(view)); + + // Show the window when Flutter renders. + // Requires the view to be realized so we can start rendering. + g_signal_connect_swapped(view, "first-frame", G_CALLBACK(first_frame_cb), self); + gtk_widget_realize(GTK_WIDGET(view)); + + fl_register_plugins(FL_PLUGIN_REGISTRY(view)); + + gtk_widget_grab_focus(GTK_WIDGET(view)); +} + +// Implements GApplication::local_command_line. +static gboolean my_application_local_command_line(GApplication* application, gchar*** arguments, int* exit_status) { + MyApplication* self = MY_APPLICATION(application); + // Strip out the first argument as it is the binary name. + self->dart_entrypoint_arguments = g_strdupv(*arguments + 1); + + g_autoptr(GError) error = nullptr; + if (!g_application_register(application, nullptr, &error)) { + g_warning("Failed to register: %s", error->message); + *exit_status = 1; + return TRUE; + } + + g_application_activate(application); + *exit_status = 0; + + return TRUE; +} + +// Implements GApplication::startup. +static void my_application_startup(GApplication* application) { + //MyApplication* self = MY_APPLICATION(object); + + // Perform any actions required at application startup. + + G_APPLICATION_CLASS(my_application_parent_class)->startup(application); +} + +// Implements GApplication::shutdown. +static void my_application_shutdown(GApplication* application) { + //MyApplication* self = MY_APPLICATION(object); + + // Perform any actions required at application shutdown. + + G_APPLICATION_CLASS(my_application_parent_class)->shutdown(application); +} + +// Implements GObject::dispose. +static void my_application_dispose(GObject* object) { + MyApplication* self = MY_APPLICATION(object); + g_clear_pointer(&self->dart_entrypoint_arguments, g_strfreev); + G_OBJECT_CLASS(my_application_parent_class)->dispose(object); +} + +static void my_application_class_init(MyApplicationClass* klass) { + G_APPLICATION_CLASS(klass)->activate = my_application_activate; + G_APPLICATION_CLASS(klass)->local_command_line = my_application_local_command_line; + G_APPLICATION_CLASS(klass)->startup = my_application_startup; + G_APPLICATION_CLASS(klass)->shutdown = my_application_shutdown; + G_OBJECT_CLASS(klass)->dispose = my_application_dispose; +} + +static void my_application_init(MyApplication* self) {} + +MyApplication* my_application_new() { + // Set the program name to the application ID, which helps various systems + // like GTK and desktop environments map this running application to its + // corresponding .desktop file. This ensures better integration by allowing + // the application to be recognized beyond its binary name. + g_set_prgname(APPLICATION_ID); + + return MY_APPLICATION(g_object_new(my_application_get_type(), + "application-id", APPLICATION_ID, + "flags", G_APPLICATION_NON_UNIQUE, + nullptr)); +} diff --git a/client/linux/runner/my_application.h b/client/linux/runner/my_application.h new file mode 100644 index 0000000..72271d5 --- /dev/null +++ b/client/linux/runner/my_application.h @@ -0,0 +1,18 @@ +#ifndef FLUTTER_MY_APPLICATION_H_ +#define FLUTTER_MY_APPLICATION_H_ + +#include + +G_DECLARE_FINAL_TYPE(MyApplication, my_application, MY, APPLICATION, + GtkApplication) + +/** + * my_application_new: + * + * Creates a new Flutter-based application. + * + * Returns: a new #MyApplication. + */ +MyApplication* my_application_new(); + +#endif // FLUTTER_MY_APPLICATION_H_ diff --git a/client/macos/.gitignore b/client/macos/.gitignore new file mode 100644 index 0000000..746adbb --- /dev/null +++ b/client/macos/.gitignore @@ -0,0 +1,7 @@ +# Flutter-related +**/Flutter/ephemeral/ +**/Pods/ + +# Xcode-related +**/dgph +**/xcuserdata/ diff --git a/client/macos/Flutter/Flutter-Debug.xcconfig b/client/macos/Flutter/Flutter-Debug.xcconfig new file mode 100644 index 0000000..c2efd0b --- /dev/null +++ b/client/macos/Flutter/Flutter-Debug.xcconfig @@ -0,0 +1 @@ +#include "ephemeral/Flutter-Generated.xcconfig" diff --git a/client/macos/Flutter/Flutter-Release.xcconfig b/client/macos/Flutter/Flutter-Release.xcconfig new file mode 100644 index 0000000..c2efd0b --- /dev/null +++ b/client/macos/Flutter/Flutter-Release.xcconfig @@ -0,0 +1 @@ +#include "ephemeral/Flutter-Generated.xcconfig" diff --git a/client/macos/Flutter/GeneratedPluginRegistrant.swift b/client/macos/Flutter/GeneratedPluginRegistrant.swift new file mode 100644 index 0000000..a3039e3 --- /dev/null +++ b/client/macos/Flutter/GeneratedPluginRegistrant.swift @@ -0,0 +1,34 @@ +// +// Generated file. Do not edit. +// + +import FlutterMacOS +import Foundation + +import audio_session +import connectivity_plus +import device_info_plus +import file_picker +import file_selector_macos +import flutter_tts +import just_audio +import package_info_plus +import path_provider_foundation +import shared_preferences_foundation +import speech_to_text +import sqflite_darwin + +func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) { + AudioSessionPlugin.register(with: registry.registrar(forPlugin: "AudioSessionPlugin")) + ConnectivityPlusPlugin.register(with: registry.registrar(forPlugin: "ConnectivityPlusPlugin")) + DeviceInfoPlusMacosPlugin.register(with: registry.registrar(forPlugin: "DeviceInfoPlusMacosPlugin")) + FilePickerPlugin.register(with: registry.registrar(forPlugin: "FilePickerPlugin")) + FileSelectorPlugin.register(with: registry.registrar(forPlugin: "FileSelectorPlugin")) + FlutterTtsPlugin.register(with: registry.registrar(forPlugin: "FlutterTtsPlugin")) + JustAudioPlugin.register(with: registry.registrar(forPlugin: "JustAudioPlugin")) + FPPPackageInfoPlusPlugin.register(with: registry.registrar(forPlugin: "FPPPackageInfoPlusPlugin")) + PathProviderPlugin.register(with: registry.registrar(forPlugin: "PathProviderPlugin")) + SharedPreferencesPlugin.register(with: registry.registrar(forPlugin: "SharedPreferencesPlugin")) + SpeechToTextPlugin.register(with: registry.registrar(forPlugin: "SpeechToTextPlugin")) + SqflitePlugin.register(with: registry.registrar(forPlugin: "SqflitePlugin")) +} diff --git a/client/macos/Runner.xcodeproj/project.pbxproj b/client/macos/Runner.xcodeproj/project.pbxproj new file mode 100644 index 0000000..6ee6ffb --- /dev/null +++ b/client/macos/Runner.xcodeproj/project.pbxproj @@ -0,0 +1,705 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 54; + objects = { + +/* Begin PBXAggregateTarget section */ + 33CC111A2044C6BA0003C045 /* Flutter Assemble */ = { + isa = PBXAggregateTarget; + buildConfigurationList = 33CC111B2044C6BA0003C045 /* Build configuration list for PBXAggregateTarget "Flutter Assemble" */; + buildPhases = ( + 33CC111E2044C6BF0003C045 /* ShellScript */, + ); + dependencies = ( + ); + name = "Flutter Assemble"; + productName = FLX; + }; +/* End PBXAggregateTarget section */ + +/* Begin PBXBuildFile section */ + 331C80D8294CF71000263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C80D7294CF71000263BE5 /* RunnerTests.swift */; }; + 335BBD1B22A9A15E00E9071D /* GeneratedPluginRegistrant.swift in Sources */ = {isa = PBXBuildFile; fileRef = 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */; }; + 33CC10F12044A3C60003C045 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 33CC10F02044A3C60003C045 /* AppDelegate.swift */; }; + 33CC10F32044A3C60003C045 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 33CC10F22044A3C60003C045 /* Assets.xcassets */; }; + 33CC10F62044A3C60003C045 /* MainMenu.xib in Resources */ = {isa = PBXBuildFile; fileRef = 33CC10F42044A3C60003C045 /* MainMenu.xib */; }; + 33CC11132044BFA00003C045 /* MainFlutterWindow.swift in Sources */ = {isa = PBXBuildFile; fileRef = 33CC11122044BFA00003C045 /* MainFlutterWindow.swift */; }; +/* End PBXBuildFile section */ + +/* Begin PBXContainerItemProxy section */ + 331C80D9294CF71000263BE5 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = 33CC10E52044A3C60003C045 /* Project object */; + proxyType = 1; + remoteGlobalIDString = 33CC10EC2044A3C60003C045; + remoteInfo = Runner; + }; + 33CC111F2044C79F0003C045 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = 33CC10E52044A3C60003C045 /* Project object */; + proxyType = 1; + remoteGlobalIDString = 33CC111A2044C6BA0003C045; + remoteInfo = FLX; + }; +/* End PBXContainerItemProxy section */ + +/* Begin PBXCopyFilesBuildPhase section */ + 33CC110E2044A8840003C045 /* Bundle Framework */ = { + isa = PBXCopyFilesBuildPhase; + buildActionMask = 2147483647; + dstPath = ""; + dstSubfolderSpec = 10; + files = ( + ); + name = "Bundle Framework"; + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXCopyFilesBuildPhase section */ + +/* Begin PBXFileReference section */ + 331C80D5294CF71000263BE5 /* RunnerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RunnerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; }; + 331C80D7294CF71000263BE5 /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = ""; }; + 333000ED22D3DE5D00554162 /* Warnings.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = Warnings.xcconfig; sourceTree = ""; }; + 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = GeneratedPluginRegistrant.swift; sourceTree = ""; }; + 33CC10ED2044A3C60003C045 /* client.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "client.app"; sourceTree = BUILT_PRODUCTS_DIR; }; + 33CC10F02044A3C60003C045 /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = ""; }; + 33CC10F22044A3C60003C045 /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; name = Assets.xcassets; path = Runner/Assets.xcassets; sourceTree = ""; }; + 33CC10F52044A3C60003C045 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.xib; name = Base; path = Base.lproj/MainMenu.xib; sourceTree = ""; }; + 33CC10F72044A3C60003C045 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; name = Info.plist; path = Runner/Info.plist; sourceTree = ""; }; + 33CC11122044BFA00003C045 /* MainFlutterWindow.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainFlutterWindow.swift; sourceTree = ""; }; + 33CEB47222A05771004F2AC0 /* Flutter-Debug.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = "Flutter-Debug.xcconfig"; sourceTree = ""; }; + 33CEB47422A05771004F2AC0 /* Flutter-Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = "Flutter-Release.xcconfig"; sourceTree = ""; }; + 33CEB47722A0578A004F2AC0 /* Flutter-Generated.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = "Flutter-Generated.xcconfig"; path = "ephemeral/Flutter-Generated.xcconfig"; sourceTree = ""; }; + 33E51913231747F40026EE4D /* DebugProfile.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = DebugProfile.entitlements; sourceTree = ""; }; + 33E51914231749380026EE4D /* Release.entitlements */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.entitlements; path = Release.entitlements; sourceTree = ""; }; + 33E5194F232828860026EE4D /* AppInfo.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = AppInfo.xcconfig; sourceTree = ""; }; + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = Release.xcconfig; sourceTree = ""; }; + 9740EEB21CF90195004384FC /* Debug.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; path = Debug.xcconfig; sourceTree = ""; }; +/* End PBXFileReference section */ + +/* Begin PBXFrameworksBuildPhase section */ + 331C80D2294CF70F00263BE5 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 33CC10EA2044A3C60003C045 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 331C80D6294CF71000263BE5 /* RunnerTests */ = { + isa = PBXGroup; + children = ( + 331C80D7294CF71000263BE5 /* RunnerTests.swift */, + ); + path = RunnerTests; + sourceTree = ""; + }; + 33BA886A226E78AF003329D5 /* Configs */ = { + isa = PBXGroup; + children = ( + 33E5194F232828860026EE4D /* AppInfo.xcconfig */, + 9740EEB21CF90195004384FC /* Debug.xcconfig */, + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */, + 333000ED22D3DE5D00554162 /* Warnings.xcconfig */, + ); + path = Configs; + sourceTree = ""; + }; + 33CC10E42044A3C60003C045 = { + isa = PBXGroup; + children = ( + 33FAB671232836740065AC1E /* Runner */, + 33CEB47122A05771004F2AC0 /* Flutter */, + 331C80D6294CF71000263BE5 /* RunnerTests */, + 33CC10EE2044A3C60003C045 /* Products */, + D73912EC22F37F3D000D13A0 /* Frameworks */, + ); + sourceTree = ""; + }; + 33CC10EE2044A3C60003C045 /* Products */ = { + isa = PBXGroup; + children = ( + 33CC10ED2044A3C60003C045 /* client.app */, + 331C80D5294CF71000263BE5 /* RunnerTests.xctest */, + ); + name = Products; + sourceTree = ""; + }; + 33CC11242044D66E0003C045 /* Resources */ = { + isa = PBXGroup; + children = ( + 33CC10F22044A3C60003C045 /* Assets.xcassets */, + 33CC10F42044A3C60003C045 /* MainMenu.xib */, + 33CC10F72044A3C60003C045 /* Info.plist */, + ); + name = Resources; + path = ..; + sourceTree = ""; + }; + 33CEB47122A05771004F2AC0 /* Flutter */ = { + isa = PBXGroup; + children = ( + 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */, + 33CEB47222A05771004F2AC0 /* Flutter-Debug.xcconfig */, + 33CEB47422A05771004F2AC0 /* Flutter-Release.xcconfig */, + 33CEB47722A0578A004F2AC0 /* Flutter-Generated.xcconfig */, + ); + path = Flutter; + sourceTree = ""; + }; + 33FAB671232836740065AC1E /* Runner */ = { + isa = PBXGroup; + children = ( + 33CC10F02044A3C60003C045 /* AppDelegate.swift */, + 33CC11122044BFA00003C045 /* MainFlutterWindow.swift */, + 33E51913231747F40026EE4D /* DebugProfile.entitlements */, + 33E51914231749380026EE4D /* Release.entitlements */, + 33CC11242044D66E0003C045 /* Resources */, + 33BA886A226E78AF003329D5 /* Configs */, + ); + path = Runner; + sourceTree = ""; + }; + D73912EC22F37F3D000D13A0 /* Frameworks */ = { + isa = PBXGroup; + children = ( + ); + name = Frameworks; + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXNativeTarget section */ + 331C80D4294CF70F00263BE5 /* RunnerTests */ = { + isa = PBXNativeTarget; + buildConfigurationList = 331C80DE294CF71000263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */; + buildPhases = ( + 331C80D1294CF70F00263BE5 /* Sources */, + 331C80D2294CF70F00263BE5 /* Frameworks */, + 331C80D3294CF70F00263BE5 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + 331C80DA294CF71000263BE5 /* PBXTargetDependency */, + ); + name = RunnerTests; + productName = RunnerTests; + productReference = 331C80D5294CF71000263BE5 /* RunnerTests.xctest */; + productType = "com.apple.product-type.bundle.unit-test"; + }; + 33CC10EC2044A3C60003C045 /* Runner */ = { + isa = PBXNativeTarget; + buildConfigurationList = 33CC10FB2044A3C60003C045 /* Build configuration list for PBXNativeTarget "Runner" */; + buildPhases = ( + 33CC10E92044A3C60003C045 /* Sources */, + 33CC10EA2044A3C60003C045 /* Frameworks */, + 33CC10EB2044A3C60003C045 /* Resources */, + 33CC110E2044A8840003C045 /* Bundle Framework */, + 3399D490228B24CF009A79C7 /* ShellScript */, + ); + buildRules = ( + ); + dependencies = ( + 33CC11202044C79F0003C045 /* PBXTargetDependency */, + ); + name = Runner; + productName = Runner; + productReference = 33CC10ED2044A3C60003C045 /* client.app */; + productType = "com.apple.product-type.application"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + 33CC10E52044A3C60003C045 /* Project object */ = { + isa = PBXProject; + attributes = { + BuildIndependentTargetsInParallel = YES; + LastSwiftUpdateCheck = 0920; + LastUpgradeCheck = 1510; + ORGANIZATIONNAME = ""; + TargetAttributes = { + 331C80D4294CF70F00263BE5 = { + CreatedOnToolsVersion = 14.0; + TestTargetID = 33CC10EC2044A3C60003C045; + }; + 33CC10EC2044A3C60003C045 = { + CreatedOnToolsVersion = 9.2; + LastSwiftMigration = 1100; + ProvisioningStyle = Automatic; + SystemCapabilities = { + com.apple.Sandbox = { + enabled = 1; + }; + }; + }; + 33CC111A2044C6BA0003C045 = { + CreatedOnToolsVersion = 9.2; + ProvisioningStyle = Manual; + }; + }; + }; + buildConfigurationList = 33CC10E82044A3C60003C045 /* Build configuration list for PBXProject "Runner" */; + compatibilityVersion = "Xcode 9.3"; + developmentRegion = en; + hasScannedForEncodings = 0; + knownRegions = ( + en, + Base, + ); + mainGroup = 33CC10E42044A3C60003C045; + productRefGroup = 33CC10EE2044A3C60003C045 /* Products */; + projectDirPath = ""; + projectRoot = ""; + targets = ( + 33CC10EC2044A3C60003C045 /* Runner */, + 331C80D4294CF70F00263BE5 /* RunnerTests */, + 33CC111A2044C6BA0003C045 /* Flutter Assemble */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 331C80D3294CF70F00263BE5 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 33CC10EB2044A3C60003C045 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 33CC10F32044A3C60003C045 /* Assets.xcassets in Resources */, + 33CC10F62044A3C60003C045 /* MainMenu.xib in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXShellScriptBuildPhase section */ + 3399D490228B24CF009A79C7 /* ShellScript */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputFileListPaths = ( + ); + inputPaths = ( + ); + outputFileListPaths = ( + ); + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "echo \"$PRODUCT_NAME.app\" > \"$PROJECT_DIR\"/Flutter/ephemeral/.app_filename && \"$FLUTTER_ROOT\"/packages/flutter_tools/bin/macos_assemble.sh embed\n"; + }; + 33CC111E2044C6BF0003C045 /* ShellScript */ = { + isa = PBXShellScriptBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + inputFileListPaths = ( + Flutter/ephemeral/FlutterInputs.xcfilelist, + ); + inputPaths = ( + Flutter/ephemeral/tripwire, + ); + outputFileListPaths = ( + Flutter/ephemeral/FlutterOutputs.xcfilelist, + ); + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "\"$FLUTTER_ROOT\"/packages/flutter_tools/bin/macos_assemble.sh && touch Flutter/ephemeral/tripwire"; + }; +/* End PBXShellScriptBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 331C80D1294CF70F00263BE5 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 331C80D8294CF71000263BE5 /* RunnerTests.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 33CC10E92044A3C60003C045 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 33CC11132044BFA00003C045 /* MainFlutterWindow.swift in Sources */, + 33CC10F12044A3C60003C045 /* AppDelegate.swift in Sources */, + 335BBD1B22A9A15E00E9071D /* GeneratedPluginRegistrant.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin PBXTargetDependency section */ + 331C80DA294CF71000263BE5 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + target = 33CC10EC2044A3C60003C045 /* Runner */; + targetProxy = 331C80D9294CF71000263BE5 /* PBXContainerItemProxy */; + }; + 33CC11202044C79F0003C045 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + target = 33CC111A2044C6BA0003C045 /* Flutter Assemble */; + targetProxy = 33CC111F2044C79F0003C045 /* PBXContainerItemProxy */; + }; +/* End PBXTargetDependency section */ + +/* Begin PBXVariantGroup section */ + 33CC10F42044A3C60003C045 /* MainMenu.xib */ = { + isa = PBXVariantGroup; + children = ( + 33CC10F52044A3C60003C045 /* Base */, + ); + name = MainMenu.xib; + path = Runner; + sourceTree = ""; + }; +/* End PBXVariantGroup section */ + +/* Begin XCBuildConfiguration section */ + 331C80DB294CF71000263BE5 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.client.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/client.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/client"; + }; + name = Debug; + }; + 331C80DC294CF71000263BE5 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.client.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/client.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/client"; + }; + name = Release; + }; + 331C80DD294CF71000263BE5 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.client.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/client.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/client"; + }; + name = Profile; + }; + 338D0CE9231458BD00FA5F75 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CODE_SIGN_IDENTITY = "-"; + COPY_PHASE_STRIP = NO; + DEAD_CODE_STRIPPING = YES; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + MACOSX_DEPLOYMENT_TARGET = 10.15; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = macosx; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + }; + name = Profile; + }; + 338D0CEA231458BD00FA5F75 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CODE_SIGN_ENTITLEMENTS = Runner/DebugProfile.entitlements; + CODE_SIGN_STYLE = Automatic; + COMBINE_HIDPI_IMAGES = YES; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/../Frameworks", + ); + PROVISIONING_PROFILE_SPECIFIER = ""; + SWIFT_VERSION = 5.0; + }; + name = Profile; + }; + 338D0CEB231458BD00FA5F75 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + CODE_SIGN_STYLE = Manual; + PRODUCT_NAME = "$(TARGET_NAME)"; + }; + name = Profile; + }; + 33CC10F92044A3C60003C045 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CODE_SIGN_IDENTITY = "-"; + COPY_PHASE_STRIP = NO; + DEAD_CODE_STRIPPING = YES; + DEBUG_INFORMATION_FORMAT = dwarf; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_TESTABILITY = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_DYNAMIC_NO_PIC = NO; + GCC_NO_COMMON_BLOCKS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "DEBUG=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + MACOSX_DEPLOYMENT_TARGET = 10.15; + MTL_ENABLE_DEBUG_INFO = YES; + ONLY_ACTIVE_ARCH = YES; + SDKROOT = macosx; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + }; + name = Debug; + }; + 33CC10FA2044A3C60003C045 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CODE_SIGN_IDENTITY = "-"; + COPY_PHASE_STRIP = NO; + DEAD_CODE_STRIPPING = YES; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + MACOSX_DEPLOYMENT_TARGET = 10.15; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = macosx; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + }; + name = Release; + }; + 33CC10FC2044A3C60003C045 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CODE_SIGN_ENTITLEMENTS = Runner/DebugProfile.entitlements; + CODE_SIGN_STYLE = Automatic; + COMBINE_HIDPI_IMAGES = YES; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/../Frameworks", + ); + PROVISIONING_PROFILE_SPECIFIER = ""; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + }; + name = Debug; + }; + 33CC10FD2044A3C60003C045 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CODE_SIGN_ENTITLEMENTS = Runner/Release.entitlements; + CODE_SIGN_STYLE = Automatic; + COMBINE_HIDPI_IMAGES = YES; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/../Frameworks", + ); + PROVISIONING_PROFILE_SPECIFIER = ""; + SWIFT_VERSION = 5.0; + }; + name = Release; + }; + 33CC111C2044C6BA0003C045 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + CODE_SIGN_STYLE = Manual; + PRODUCT_NAME = "$(TARGET_NAME)"; + }; + name = Debug; + }; + 33CC111D2044C6BA0003C045 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + CODE_SIGN_STYLE = Automatic; + PRODUCT_NAME = "$(TARGET_NAME)"; + }; + name = Release; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 331C80DE294CF71000263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 331C80DB294CF71000263BE5 /* Debug */, + 331C80DC294CF71000263BE5 /* Release */, + 331C80DD294CF71000263BE5 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 33CC10E82044A3C60003C045 /* Build configuration list for PBXProject "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 33CC10F92044A3C60003C045 /* Debug */, + 33CC10FA2044A3C60003C045 /* Release */, + 338D0CE9231458BD00FA5F75 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 33CC10FB2044A3C60003C045 /* Build configuration list for PBXNativeTarget "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 33CC10FC2044A3C60003C045 /* Debug */, + 33CC10FD2044A3C60003C045 /* Release */, + 338D0CEA231458BD00FA5F75 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 33CC111B2044C6BA0003C045 /* Build configuration list for PBXAggregateTarget "Flutter Assemble" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 33CC111C2044C6BA0003C045 /* Debug */, + 33CC111D2044C6BA0003C045 /* Release */, + 338D0CEB231458BD00FA5F75 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = 33CC10E52044A3C60003C045 /* Project object */; +} diff --git a/client/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/client/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/client/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/client/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/client/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme new file mode 100644 index 0000000..62a651b --- /dev/null +++ b/client/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme @@ -0,0 +1,99 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/client/macos/Runner.xcworkspace/contents.xcworkspacedata b/client/macos/Runner.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..1d526a1 --- /dev/null +++ b/client/macos/Runner.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/client/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/client/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/client/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/client/macos/Runner/AppDelegate.swift b/client/macos/Runner/AppDelegate.swift new file mode 100644 index 0000000..b3c1761 --- /dev/null +++ b/client/macos/Runner/AppDelegate.swift @@ -0,0 +1,13 @@ +import Cocoa +import FlutterMacOS + +@main +class AppDelegate: FlutterAppDelegate { + override func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool { + return true + } + + override func applicationSupportsSecureRestorableState(_ app: NSApplication) -> Bool { + return true + } +} diff --git a/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json new file mode 100644 index 0000000..a2ec33f --- /dev/null +++ b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json @@ -0,0 +1,68 @@ +{ + "images" : [ + { + "size" : "16x16", + "idiom" : "mac", + "filename" : "app_icon_16.png", + "scale" : "1x" + }, + { + "size" : "16x16", + "idiom" : "mac", + "filename" : "app_icon_32.png", + "scale" : "2x" + }, + { + "size" : "32x32", + "idiom" : "mac", + "filename" : "app_icon_32.png", + "scale" : "1x" + }, + { + "size" : "32x32", + "idiom" : "mac", + "filename" : "app_icon_64.png", + "scale" : "2x" + }, + { + "size" : "128x128", + "idiom" : "mac", + "filename" : "app_icon_128.png", + "scale" : "1x" + }, + { + "size" : "128x128", + "idiom" : "mac", + "filename" : "app_icon_256.png", + "scale" : "2x" + }, + { + "size" : "256x256", + "idiom" : "mac", + "filename" : "app_icon_256.png", + "scale" : "1x" + }, + { + "size" : "256x256", + "idiom" : "mac", + "filename" : "app_icon_512.png", + "scale" : "2x" + }, + { + "size" : "512x512", + "idiom" : "mac", + "filename" : "app_icon_512.png", + "scale" : "1x" + }, + { + "size" : "512x512", + "idiom" : "mac", + "filename" : "app_icon_1024.png", + "scale" : "2x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png new file mode 100644 index 0000000..82b6f9d Binary files /dev/null and b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png differ diff --git a/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png new file mode 100644 index 0000000..13b35eb Binary files /dev/null and b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png differ diff --git a/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png new file mode 100644 index 0000000..0a3f5fa Binary files /dev/null and b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png differ diff --git a/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png new file mode 100644 index 0000000..bdb5722 Binary files /dev/null and b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png differ diff --git a/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png new file mode 100644 index 0000000..f083318 Binary files /dev/null and b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png differ diff --git a/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png new file mode 100644 index 0000000..326c0e7 Binary files /dev/null and b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png differ diff --git a/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png new file mode 100644 index 0000000..2f1632c Binary files /dev/null and b/client/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png differ diff --git a/client/macos/Runner/Base.lproj/MainMenu.xib b/client/macos/Runner/Base.lproj/MainMenu.xib new file mode 100644 index 0000000..80e867a --- /dev/null +++ b/client/macos/Runner/Base.lproj/MainMenu.xib @@ -0,0 +1,343 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/client/macos/Runner/Configs/AppInfo.xcconfig b/client/macos/Runner/Configs/AppInfo.xcconfig new file mode 100644 index 0000000..a24a60b --- /dev/null +++ b/client/macos/Runner/Configs/AppInfo.xcconfig @@ -0,0 +1,14 @@ +// Application-level settings for the Runner target. +// +// This may be replaced with something auto-generated from metadata (e.g., pubspec.yaml) in the +// future. If not, the values below would default to using the project name when this becomes a +// 'flutter create' template. + +// The application's name. By default this is also the title of the Flutter window. +PRODUCT_NAME = client + +// The application's bundle identifier +PRODUCT_BUNDLE_IDENTIFIER = com.example.client + +// The copyright displayed in application information +PRODUCT_COPYRIGHT = Copyright © 2025 com.example. All rights reserved. diff --git a/client/macos/Runner/Configs/Debug.xcconfig b/client/macos/Runner/Configs/Debug.xcconfig new file mode 100644 index 0000000..36b0fd9 --- /dev/null +++ b/client/macos/Runner/Configs/Debug.xcconfig @@ -0,0 +1,2 @@ +#include "../../Flutter/Flutter-Debug.xcconfig" +#include "Warnings.xcconfig" diff --git a/client/macos/Runner/Configs/Release.xcconfig b/client/macos/Runner/Configs/Release.xcconfig new file mode 100644 index 0000000..dff4f49 --- /dev/null +++ b/client/macos/Runner/Configs/Release.xcconfig @@ -0,0 +1,2 @@ +#include "../../Flutter/Flutter-Release.xcconfig" +#include "Warnings.xcconfig" diff --git a/client/macos/Runner/Configs/Warnings.xcconfig b/client/macos/Runner/Configs/Warnings.xcconfig new file mode 100644 index 0000000..42bcbf4 --- /dev/null +++ b/client/macos/Runner/Configs/Warnings.xcconfig @@ -0,0 +1,13 @@ +WARNING_CFLAGS = -Wall -Wconditional-uninitialized -Wnullable-to-nonnull-conversion -Wmissing-method-return-type -Woverlength-strings +GCC_WARN_UNDECLARED_SELECTOR = YES +CLANG_UNDEFINED_BEHAVIOR_SANITIZER_NULLABILITY = YES +CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE +CLANG_WARN__DUPLICATE_METHOD_MATCH = YES +CLANG_WARN_PRAGMA_PACK = YES +CLANG_WARN_STRICT_PROTOTYPES = YES +CLANG_WARN_COMMA = YES +GCC_WARN_STRICT_SELECTOR_MATCH = YES +CLANG_WARN_OBJC_REPEATED_USE_OF_WEAK = YES +CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES +GCC_WARN_SHADOW = YES +CLANG_WARN_UNREACHABLE_CODE = YES diff --git a/client/macos/Runner/DebugProfile.entitlements b/client/macos/Runner/DebugProfile.entitlements new file mode 100644 index 0000000..dddb8a3 --- /dev/null +++ b/client/macos/Runner/DebugProfile.entitlements @@ -0,0 +1,12 @@ + + + + + com.apple.security.app-sandbox + + com.apple.security.cs.allow-jit + + com.apple.security.network.server + + + diff --git a/client/macos/Runner/Info.plist b/client/macos/Runner/Info.plist new file mode 100644 index 0000000..4789daa --- /dev/null +++ b/client/macos/Runner/Info.plist @@ -0,0 +1,32 @@ + + + + + CFBundleDevelopmentRegion + $(DEVELOPMENT_LANGUAGE) + CFBundleExecutable + $(EXECUTABLE_NAME) + CFBundleIconFile + + CFBundleIdentifier + $(PRODUCT_BUNDLE_IDENTIFIER) + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + $(PRODUCT_NAME) + CFBundlePackageType + APPL + CFBundleShortVersionString + $(FLUTTER_BUILD_NAME) + CFBundleVersion + $(FLUTTER_BUILD_NUMBER) + LSMinimumSystemVersion + $(MACOSX_DEPLOYMENT_TARGET) + NSHumanReadableCopyright + $(PRODUCT_COPYRIGHT) + NSMainNibFile + MainMenu + NSPrincipalClass + NSApplication + + diff --git a/client/macos/Runner/MainFlutterWindow.swift b/client/macos/Runner/MainFlutterWindow.swift new file mode 100644 index 0000000..3cc05eb --- /dev/null +++ b/client/macos/Runner/MainFlutterWindow.swift @@ -0,0 +1,15 @@ +import Cocoa +import FlutterMacOS + +class MainFlutterWindow: NSWindow { + override func awakeFromNib() { + let flutterViewController = FlutterViewController() + let windowFrame = self.frame + self.contentViewController = flutterViewController + self.setFrame(windowFrame, display: true) + + RegisterGeneratedPlugins(registry: flutterViewController) + + super.awakeFromNib() + } +} diff --git a/client/macos/Runner/Release.entitlements b/client/macos/Runner/Release.entitlements new file mode 100644 index 0000000..852fa1a --- /dev/null +++ b/client/macos/Runner/Release.entitlements @@ -0,0 +1,8 @@ + + + + + com.apple.security.app-sandbox + + + diff --git a/client/macos/RunnerTests/RunnerTests.swift b/client/macos/RunnerTests/RunnerTests.swift new file mode 100644 index 0000000..61f3bd1 --- /dev/null +++ b/client/macos/RunnerTests/RunnerTests.swift @@ -0,0 +1,12 @@ +import Cocoa +import FlutterMacOS +import XCTest + +class RunnerTests: XCTestCase { + + func testExample() { + // If you add code to the Runner application, consider adding tests here. + // See https://developer.apple.com/documentation/xctest for more information about using XCTest. + } + +} diff --git a/client/nginx.conf b/client/nginx.conf new file mode 100644 index 0000000..c8492fa --- /dev/null +++ b/client/nginx.conf @@ -0,0 +1,88 @@ +events { + worker_connections 1024; +} + +http { + include /etc/nginx/mime.types; + default_type application/octet-stream; + + # 日志格式 + log_format main '$remote_addr - $remote_user [$time_local] "$request" ' + '$status $body_bytes_sent "$http_referer" ' + '"$http_user_agent" "$http_x_forwarded_for"'; + + access_log /var/log/nginx/access.log main; + error_log /var/log/nginx/error.log warn; + + sendfile on; + tcp_nopush on; + tcp_nodelay on; + keepalive_timeout 65; + types_hash_max_size 2048; + + # Gzip压缩 + gzip on; + gzip_vary on; + gzip_min_length 1024; + gzip_proxied any; + gzip_comp_level 6; + gzip_types + text/plain + text/css + text/xml + text/javascript + application/json + application/javascript + application/xml+rss + application/atom+xml + image/svg+xml; + + server { + listen 80; + listen [::]:80; + server_name localhost; + + root /usr/share/nginx/html; + index index.html index.htm; + + # Flutter Web应用配置 + location / { + try_files $uri $uri/ /index.html; + + # 添加安全头 + add_header X-Frame-Options "SAMEORIGIN" always; + add_header X-XSS-Protection "1; mode=block" always; + add_header X-Content-Type-Options "nosniff" always; + add_header Referrer-Policy "no-referrer-when-downgrade" always; + add_header Content-Security-Policy "default-src 'self' http: https: data: blob: 'unsafe-inline'" always; + } + + # 静态资源缓存 + location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ { + expires 1y; + add_header Cache-Control "public, immutable"; + } + + # API代理（如果需要） + location /api/ { + proxy_pass http://ai-english-backend:8080/; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } + + # 健康检查 + location /health { + access_log off; + return 200 "healthy\n"; + add_header Content-Type text/plain; + } + + # 错误页面 + error_page 500 502 503 504 /50x.html; + location = /50x.html { + root /usr/share/nginx/html; + } + } +} \ No newline at end of file diff --git a/client/pubspec.yaml b/client/pubspec.yaml new file mode 100644 index 0000000..bb909f4 --- /dev/null +++ b/client/pubspec.yaml @@ -0,0 +1,122 @@ +name: ai_english_learning +description: "AI英语学习平台 - 跨平台移动应用" +publish_to: 'none' + +version: 1.0.0+1 + +environment: + sdk: ^3.9.0 + flutter: ">=3.19.0" + +# Dependencies specify other packages that your package needs in order to work. +# To automatically upgrade your package dependencies to the latest versions +# consider running `flutter pub upgrade --major-versions`. Alternatively, +# dependencies can be manually updated by changing the version numbers below to +# the latest version available on pub.dev. To see which dependencies have newer +# versions available, run `flutter pub outdated`. +dependencies: + flutter: + sdk: flutter + + # UI组件 + cupertino_icons: ^1.0.8 + material_design_icons_flutter: ^7.0.7296 + + # 状态管理 + provider: ^6.1.2 + riverpod: ^2.5.1 + flutter_riverpod: ^2.5.1 + + # 网络请求 + dio: ^5.4.3+1 + retrofit: ^4.1.0 + json_annotation: ^4.9.0 + + # 本地存储 + shared_preferences: ^2.2.3 + hive: ^2.2.3 + hive_flutter: ^1.1.0 + # flutter_secure_storage: ^4.2.1 # 暂时注释掉，Linux平台依赖问题 + + # 路由导航 + go_router: ^14.2.0 + + # 图表和数据可视化 + fl_chart: ^0.68.0 + syncfusion_flutter_charts: ^25.2.7 + + # 音频播放 + just_audio: ^0.9.37 + audio_waveforms: ^1.0.5 + + # 图片处理 + cached_network_image: ^3.3.1 + image_picker: ^1.1.2 + + # 工具类 + intl: ^0.19.0 + uuid: ^4.4.0 + logger: ^2.3.0 + + # 权限管理 + permission_handler: ^11.3.1 + + # 语音识别和TTS + speech_to_text: ^7.0.0 + flutter_tts: ^4.0.2 + + # 动画 + lottie: ^3.1.2 + animations: ^2.0.11 + + # 文件处理 + path_provider: ^2.1.3 + file_picker: ^8.0.3 + + # 设备信息 + device_info_plus: ^10.1.0 + package_info_plus: ^8.0.0 + + # 网络连接检测 + connectivity_plus: ^6.0.3 + +dev_dependencies: + flutter_test: + sdk: flutter + flutter_lints: ^5.0.0 + flutter_launcher_icons: ^0.13.1 + + # 代码生成 + build_runner: ^2.4.9 + json_serializable: ^6.8.0 + retrofit_generator: ^8.1.0 + hive_generator: ^2.0.1 + + # 测试 + mockito: ^5.4.4 + integration_test: + sdk: flutter + +# For information on the generic Dart part of this file, see the +# following page: https://dart.dev/tools/pub/pubspec + +flutter: + uses-material-design: true + + # 资源文件 + assets: + - assets/images/ + - assets/icons/ + - assets/animations/ + - assets/audio/ + - assets/data/ + + # 不配置字体，使用系统默认字体 + +# Flutter Launcher Icons 配置 +flutter_launcher_icons: + android: true + ios: true + image_path: "assets/images/logo.png" + adaptive_icon_background: "#FFFFFF" + adaptive_icon_foreground: "assets/images/logo.png" diff --git a/client/test/widget_test.dart b/client/test/widget_test.dart new file mode 100644 index 0000000..43ea702 --- /dev/null +++ b/client/test/widget_test.dart @@ -0,0 +1,145 @@ +// AI English Learning App Widget Tests +// +// Comprehensive widget tests for the AI English Learning application. + +import 'package:flutter/material.dart'; +import 'package:flutter_test/flutter_test.dart'; +import 'package:flutter_riverpod/flutter_riverpod.dart'; + +// Import the main app +import 'package:ai_english_learning/main.dart'; + +Widget createTestApp() { + return const MaterialApp( + home: Scaffold( + body: Center( + child: Text('AI English Learning Test App'), + ), + ), + ); +} + +void main() { + group('App Initialization Tests', () { + testWidgets('Test app should build correctly', (WidgetTester tester) async { + await tester.pumpWidget(createTestApp()); + await tester.pumpAndSettle(); + + expect(find.text('AI English Learning Test App'), findsOneWidget); + }); + + testWidgets('App should build without errors', (WidgetTester tester) async { + // Build our test app and trigger a frame. + await tester.pumpWidget(createTestApp()); + await tester.pumpAndSettle(); + + // Verify that the app builds successfully + expect(find.byType(MaterialApp), findsOneWidget); + }); + + testWidgets('App should have correct title', (WidgetTester tester) async { + // Build our test app + await tester.pumpWidget(createTestApp()); + await tester.pumpAndSettle(); + + // Get the MaterialApp widget + final materialApp = tester.widget(find.byType(MaterialApp)); + + // Verify the app has a title (test app doesn't have specific title) + expect(materialApp, isNotNull); + }); + + testWidgets('App should use correct theme', (WidgetTester tester) async { + await tester.pumpWidget(createTestApp()); + await tester.pumpAndSettle(); + + // Get the MaterialApp widget + final materialApp = tester.widget(find.byType(MaterialApp)); + + // Verify theme is available + expect(materialApp, isNotNull); + }); + }); + + group('Navigation Tests', () { + testWidgets('App should build without errors', (WidgetTester tester) async { + await tester.pumpWidget(createTestApp()); + await tester.pumpAndSettle(); + + // 验证应用能够正常构建 + expect(find.byType(MaterialApp), findsOneWidget); + }); + }); + + group('Performance Tests', () { + testWidgets('Test app should render quickly', (WidgetTester tester) async { + final stopwatch = Stopwatch()..start(); + + await tester.pumpWidget(createTestApp()); + await tester.pumpAndSettle(); + + stopwatch.stop(); + + // Verify app renders quickly (less than 1 second) + expect(stopwatch.elapsedMilliseconds, lessThan(1000)); + }); + }); + + group('Widget Interaction Tests', () { + testWidgets('App should handle basic interactions', (WidgetTester tester) async { + await tester.pumpWidget(createTestApp()); + await tester.pumpAndSettle(); + + // 验证应用响应基本交互 + expect(find.byType(MaterialApp), findsOneWidget); + }); + }); + + group('Form Validation Tests', () { + testWidgets('App should support text input', (WidgetTester tester) async { + await tester.pumpWidget(createTestApp()); + await tester.pumpAndSettle(); + + // 验证应用支持文本输入功能 + expect(find.byType(MaterialApp), findsOneWidget); + }); + }); + + group('Accessibility Tests', () { + testWidgets('App should support accessibility', (WidgetTester tester) async { + await tester.pumpWidget(createTestApp()); + await tester.pumpAndSettle(); + + // 验证应用支持可访问性 + final semanticsHandle = tester.ensureSemantics(); + expect(find.byType(MaterialApp), findsOneWidget); + semanticsHandle.dispose(); + }); + }); + + group('Error Handling Tests', () { + testWidgets('App should handle errors gracefully', (WidgetTester tester) async { + // Test error boundary behavior + await tester.pumpWidget( + ProviderScope( + child: MaterialApp( + home: Scaffold( + body: Builder( + builder: (context) { + try { + return const Text('正常内容'); + } catch (e) { + return Text('错误: $e'); + } + }, + ), + ), + ), + ), + ); + + // Verify normal content is displayed + expect(find.text('正常内容'), findsOneWidget); + }); + }); +} diff --git a/client/web/favicon.png b/client/web/favicon.png new file mode 100644 index 0000000..8aaa46a Binary files /dev/null and b/client/web/favicon.png differ diff --git a/client/web/icons/Icon-192.png b/client/web/icons/Icon-192.png new file mode 100644 index 0000000..b749bfe Binary files /dev/null and b/client/web/icons/Icon-192.png differ diff --git a/client/web/icons/Icon-512.png b/client/web/icons/Icon-512.png new file mode 100644 index 0000000..88cfd48 Binary files /dev/null and b/client/web/icons/Icon-512.png differ diff --git a/client/web/icons/Icon-maskable-192.png b/client/web/icons/Icon-maskable-192.png new file mode 100644 index 0000000..eb9b4d7 Binary files /dev/null and b/client/web/icons/Icon-maskable-192.png differ diff --git a/client/web/icons/Icon-maskable-512.png b/client/web/icons/Icon-maskable-512.png new file mode 100644 index 0000000..d69c566 Binary files /dev/null and b/client/web/icons/Icon-maskable-512.png differ diff --git a/client/web/index.html b/client/web/index.html new file mode 100644 index 0000000..48f43b0 --- /dev/null +++ b/client/web/index.html @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + AI英语学习平台 + + + + + + + + + + diff --git a/client/web/manifest.json b/client/web/manifest.json new file mode 100644 index 0000000..554b75e --- /dev/null +++ b/client/web/manifest.json @@ -0,0 +1,35 @@ +{ + "name": "client", + "short_name": "client", + "start_url": ".", + "display": "standalone", + "background_color": "#0175C2", + "theme_color": "#0175C2", + "description": "A new Flutter project.", + "orientation": "portrait-primary", + "prefer_related_applications": false, + "icons": [ + { + "src": "icons/Icon-192.png", + "sizes": "192x192", + "type": "image/png" + }, + { + "src": "icons/Icon-512.png", + "sizes": "512x512", + "type": "image/png" + }, + { + "src": "icons/Icon-maskable-192.png", + "sizes": "192x192", + "type": "image/png", + "purpose": "maskable" + }, + { + "src": "icons/Icon-maskable-512.png", + "sizes": "512x512", + "type": "image/png", + "purpose": "maskable" + } + ] +} diff --git a/client/windows/.gitignore b/client/windows/.gitignore new file mode 100644 index 0000000..d492d0d --- /dev/null +++ b/client/windows/.gitignore @@ -0,0 +1,17 @@ +flutter/ephemeral/ + +# Visual Studio user-specific files. +*.suo +*.user +*.userosscache +*.sln.docstates + +# Visual Studio build-related files. +x64/ +x86/ + +# Visual Studio cache files +# files ending in .cache can be ignored +*.[Cc]ache +# but keep track of directories ending in .cache +!*.[Cc]ache/ diff --git a/client/windows/CMakeLists.txt b/client/windows/CMakeLists.txt new file mode 100644 index 0000000..c56e824 --- /dev/null +++ b/client/windows/CMakeLists.txt @@ -0,0 +1,108 @@ +# Project-level configuration. +cmake_minimum_required(VERSION 3.14) +project(client LANGUAGES CXX) + +# The name of the executable created for the application. Change this to change +# the on-disk name of your application. +set(BINARY_NAME "client") + +# Explicitly opt in to modern CMake behaviors to avoid warnings with recent +# versions of CMake. +cmake_policy(VERSION 3.14...3.25) + +# Define build configuration option. +get_property(IS_MULTICONFIG GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG) +if(IS_MULTICONFIG) + set(CMAKE_CONFIGURATION_TYPES "Debug;Profile;Release" + CACHE STRING "" FORCE) +else() + if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES) + set(CMAKE_BUILD_TYPE "Debug" CACHE + STRING "Flutter build mode" FORCE) + set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS + "Debug" "Profile" "Release") + endif() +endif() +# Define settings for the Profile build mode. +set(CMAKE_EXE_LINKER_FLAGS_PROFILE "${CMAKE_EXE_LINKER_FLAGS_RELEASE}") +set(CMAKE_SHARED_LINKER_FLAGS_PROFILE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE}") +set(CMAKE_C_FLAGS_PROFILE "${CMAKE_C_FLAGS_RELEASE}") +set(CMAKE_CXX_FLAGS_PROFILE "${CMAKE_CXX_FLAGS_RELEASE}") + +# Use Unicode for all projects. +add_definitions(-DUNICODE -D_UNICODE) + +# Compilation settings that should be applied to most targets. +# +# Be cautious about adding new options here, as plugins use this function by +# default. In most cases, you should add new options to specific targets instead +# of modifying this function. +function(APPLY_STANDARD_SETTINGS TARGET) + target_compile_features(${TARGET} PUBLIC cxx_std_17) + target_compile_options(${TARGET} PRIVATE /W4 /WX /wd"4100") + target_compile_options(${TARGET} PRIVATE /EHsc) + target_compile_definitions(${TARGET} PRIVATE "_HAS_EXCEPTIONS=0") + target_compile_definitions(${TARGET} PRIVATE "$<$:_DEBUG>") +endfunction() + +# Flutter library and tool build rules. +set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter") +add_subdirectory(${FLUTTER_MANAGED_DIR}) + +# Application build; see runner/CMakeLists.txt. +add_subdirectory("runner") + + +# Generated plugin build rules, which manage building the plugins and adding +# them to the application. +include(flutter/generated_plugins.cmake) + + +# === Installation === +# Support files are copied into place next to the executable, so that it can +# run in place. This is done instead of making a separate bundle (as on Linux) +# so that building and running from within Visual Studio will work. +set(BUILD_BUNDLE_DIR "$") +# Make the "install" step default, as it's required to run. +set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1) +if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT) + set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE) +endif() + +set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data") +set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}") + +install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +if(PLUGIN_BUNDLED_LIBRARIES) + install(FILES "${PLUGIN_BUNDLED_LIBRARIES}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) +endif() + +# Copy the native assets provided by the build.dart from all packages. +set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/") +install(DIRECTORY "${NATIVE_ASSETS_DIR}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +# Fully re-copy the assets directory on each build to avoid having stale files +# from a previous install. +set(FLUTTER_ASSET_DIR_NAME "flutter_assets") +install(CODE " + file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\") + " COMPONENT Runtime) +install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}" + DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime) + +# Install the AOT library on non-Debug builds only. +install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" + CONFIGURATIONS Profile;Release + COMPONENT Runtime) diff --git a/client/windows/flutter/CMakeLists.txt b/client/windows/flutter/CMakeLists.txt new file mode 100644 index 0000000..903f489 --- /dev/null +++ b/client/windows/flutter/CMakeLists.txt @@ -0,0 +1,109 @@ +# This file controls Flutter-level build steps. It should not be edited. +cmake_minimum_required(VERSION 3.14) + +set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral") + +# Configuration provided via flutter tool. +include(${EPHEMERAL_DIR}/generated_config.cmake) + +# TODO: Move the rest of this into files in ephemeral. See +# https://github.com/flutter/flutter/issues/57146. +set(WRAPPER_ROOT "${EPHEMERAL_DIR}/cpp_client_wrapper") + +# Set fallback configurations for older versions of the flutter tool. +if (NOT DEFINED FLUTTER_TARGET_PLATFORM) + set(FLUTTER_TARGET_PLATFORM "windows-x64") +endif() + +# === Flutter Library === +set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/flutter_windows.dll") + +# Published to parent scope for install step. +set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE) +set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE) +set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE) +set(AOT_LIBRARY "${PROJECT_DIR}/build/windows/app.so" PARENT_SCOPE) + +list(APPEND FLUTTER_LIBRARY_HEADERS + "flutter_export.h" + "flutter_windows.h" + "flutter_messenger.h" + "flutter_plugin_registrar.h" + "flutter_texture_registrar.h" +) +list(TRANSFORM FLUTTER_LIBRARY_HEADERS PREPEND "${EPHEMERAL_DIR}/") +add_library(flutter INTERFACE) +target_include_directories(flutter INTERFACE + "${EPHEMERAL_DIR}" +) +target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}.lib") +add_dependencies(flutter flutter_assemble) + +# === Wrapper === +list(APPEND CPP_WRAPPER_SOURCES_CORE + "core_implementations.cc" + "standard_codec.cc" +) +list(TRANSFORM CPP_WRAPPER_SOURCES_CORE PREPEND "${WRAPPER_ROOT}/") +list(APPEND CPP_WRAPPER_SOURCES_PLUGIN + "plugin_registrar.cc" +) +list(TRANSFORM CPP_WRAPPER_SOURCES_PLUGIN PREPEND "${WRAPPER_ROOT}/") +list(APPEND CPP_WRAPPER_SOURCES_APP + "flutter_engine.cc" + "flutter_view_controller.cc" +) +list(TRANSFORM CPP_WRAPPER_SOURCES_APP PREPEND "${WRAPPER_ROOT}/") + +# Wrapper sources needed for a plugin. +add_library(flutter_wrapper_plugin STATIC + ${CPP_WRAPPER_SOURCES_CORE} + ${CPP_WRAPPER_SOURCES_PLUGIN} +) +apply_standard_settings(flutter_wrapper_plugin) +set_target_properties(flutter_wrapper_plugin PROPERTIES + POSITION_INDEPENDENT_CODE ON) +set_target_properties(flutter_wrapper_plugin PROPERTIES + CXX_VISIBILITY_PRESET hidden) +target_link_libraries(flutter_wrapper_plugin PUBLIC flutter) +target_include_directories(flutter_wrapper_plugin PUBLIC + "${WRAPPER_ROOT}/include" +) +add_dependencies(flutter_wrapper_plugin flutter_assemble) + +# Wrapper sources needed for the runner. +add_library(flutter_wrapper_app STATIC + ${CPP_WRAPPER_SOURCES_CORE} + ${CPP_WRAPPER_SOURCES_APP} +) +apply_standard_settings(flutter_wrapper_app) +target_link_libraries(flutter_wrapper_app PUBLIC flutter) +target_include_directories(flutter_wrapper_app PUBLIC + "${WRAPPER_ROOT}/include" +) +add_dependencies(flutter_wrapper_app flutter_assemble) + +# === Flutter tool backend === +# _phony_ is a non-existent file to force this command to run every time, +# since currently there's no way to get a full input/output list from the +# flutter tool. +set(PHONY_OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/_phony_") +set_source_files_properties("${PHONY_OUTPUT}" PROPERTIES SYMBOLIC TRUE) +add_custom_command( + OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS} + ${CPP_WRAPPER_SOURCES_CORE} ${CPP_WRAPPER_SOURCES_PLUGIN} + ${CPP_WRAPPER_SOURCES_APP} + ${PHONY_OUTPUT} + COMMAND ${CMAKE_COMMAND} -E env + ${FLUTTER_TOOL_ENVIRONMENT} + "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.bat" + ${FLUTTER_TARGET_PLATFORM} $ + VERBATIM +) +add_custom_target(flutter_assemble DEPENDS + "${FLUTTER_LIBRARY}" + ${FLUTTER_LIBRARY_HEADERS} + ${CPP_WRAPPER_SOURCES_CORE} + ${CPP_WRAPPER_SOURCES_PLUGIN} + ${CPP_WRAPPER_SOURCES_APP} +) diff --git a/client/windows/flutter/generated_plugin_registrant.cc b/client/windows/flutter/generated_plugin_registrant.cc new file mode 100644 index 0000000..d63f7ce --- /dev/null +++ b/client/windows/flutter/generated_plugin_registrant.cc @@ -0,0 +1,26 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#include "generated_plugin_registrant.h" + +#include +#include +#include +#include +#include + +void RegisterPlugins(flutter::PluginRegistry* registry) { + ConnectivityPlusWindowsPluginRegisterWithRegistrar( + registry->GetRegistrarForPlugin("ConnectivityPlusWindowsPlugin")); + FileSelectorWindowsRegisterWithRegistrar( + registry->GetRegistrarForPlugin("FileSelectorWindows")); + FlutterTtsPluginRegisterWithRegistrar( + registry->GetRegistrarForPlugin("FlutterTtsPlugin")); + PermissionHandlerWindowsPluginRegisterWithRegistrar( + registry->GetRegistrarForPlugin("PermissionHandlerWindowsPlugin")); + SpeechToTextWindowsRegisterWithRegistrar( + registry->GetRegistrarForPlugin("SpeechToTextWindows")); +} diff --git a/client/windows/flutter/generated_plugin_registrant.h b/client/windows/flutter/generated_plugin_registrant.h new file mode 100644 index 0000000..dc139d8 --- /dev/null +++ b/client/windows/flutter/generated_plugin_registrant.h @@ -0,0 +1,15 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#ifndef GENERATED_PLUGIN_REGISTRANT_ +#define GENERATED_PLUGIN_REGISTRANT_ + +#include + +// Registers Flutter plugins. +void RegisterPlugins(flutter::PluginRegistry* registry); + +#endif // GENERATED_PLUGIN_REGISTRANT_ diff --git a/client/windows/flutter/generated_plugins.cmake b/client/windows/flutter/generated_plugins.cmake new file mode 100644 index 0000000..4764e96 --- /dev/null +++ b/client/windows/flutter/generated_plugins.cmake @@ -0,0 +1,28 @@ +# +# Generated file, do not edit. +# + +list(APPEND FLUTTER_PLUGIN_LIST + connectivity_plus + file_selector_windows + flutter_tts + permission_handler_windows + speech_to_text_windows +) + +list(APPEND FLUTTER_FFI_PLUGIN_LIST +) + +set(PLUGIN_BUNDLED_LIBRARIES) + +foreach(plugin ${FLUTTER_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/windows plugins/${plugin}) + target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin) + list(APPEND PLUGIN_BUNDLED_LIBRARIES $) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries}) +endforeach(plugin) + +foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/windows plugins/${ffi_plugin}) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries}) +endforeach(ffi_plugin) diff --git a/client/windows/runner/CMakeLists.txt b/client/windows/runner/CMakeLists.txt new file mode 100644 index 0000000..394917c --- /dev/null +++ b/client/windows/runner/CMakeLists.txt @@ -0,0 +1,40 @@ +cmake_minimum_required(VERSION 3.14) +project(runner LANGUAGES CXX) + +# Define the application target. To change its name, change BINARY_NAME in the +# top-level CMakeLists.txt, not the value here, or `flutter run` will no longer +# work. +# +# Any new source files that you add to the application should be added here. +add_executable(${BINARY_NAME} WIN32 + "flutter_window.cpp" + "main.cpp" + "utils.cpp" + "win32_window.cpp" + "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc" + "Runner.rc" + "runner.exe.manifest" +) + +# Apply the standard set of build settings. This can be removed for applications +# that need different build settings. +apply_standard_settings(${BINARY_NAME}) + +# Add preprocessor definitions for the build version. +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION=\"${FLUTTER_VERSION}\"") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MAJOR=${FLUTTER_VERSION_MAJOR}") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MINOR=${FLUTTER_VERSION_MINOR}") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_PATCH=${FLUTTER_VERSION_PATCH}") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_BUILD=${FLUTTER_VERSION_BUILD}") + +# Disable Windows macros that collide with C++ standard library functions. +target_compile_definitions(${BINARY_NAME} PRIVATE "NOMINMAX") + +# Add dependency libraries and include directories. Add any application-specific +# dependencies here. +target_link_libraries(${BINARY_NAME} PRIVATE flutter flutter_wrapper_app) +target_link_libraries(${BINARY_NAME} PRIVATE "dwmapi.lib") +target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}") + +# Run the Flutter tool portions of the build. This must not be removed. +add_dependencies(${BINARY_NAME} flutter_assemble) diff --git a/client/windows/runner/Runner.rc b/client/windows/runner/Runner.rc new file mode 100644 index 0000000..00295fa --- /dev/null +++ b/client/windows/runner/Runner.rc @@ -0,0 +1,121 @@ +// Microsoft Visual C++ generated resource script. +// +#pragma code_page(65001) +#include "resource.h" + +#define APSTUDIO_READONLY_SYMBOLS +///////////////////////////////////////////////////////////////////////////// +// +// Generated from the TEXTINCLUDE 2 resource. +// +#include "winres.h" + +///////////////////////////////////////////////////////////////////////////// +#undef APSTUDIO_READONLY_SYMBOLS + +///////////////////////////////////////////////////////////////////////////// +// English (United States) resources + +#if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_ENU) +LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US + +#ifdef APSTUDIO_INVOKED +///////////////////////////////////////////////////////////////////////////// +// +// TEXTINCLUDE +// + +1 TEXTINCLUDE +BEGIN + "resource.h\0" +END + +2 TEXTINCLUDE +BEGIN + "#include ""winres.h""\r\n" + "\0" +END + +3 TEXTINCLUDE +BEGIN + "\r\n" + "\0" +END + +#endif // APSTUDIO_INVOKED + + +///////////////////////////////////////////////////////////////////////////// +// +// Icon +// + +// Icon with lowest ID value placed first to ensure application icon +// remains consistent on all systems. +IDI_APP_ICON ICON "resources\\app_icon.ico" + + +///////////////////////////////////////////////////////////////////////////// +// +// Version +// + +#if defined(FLUTTER_VERSION_MAJOR) && defined(FLUTTER_VERSION_MINOR) && defined(FLUTTER_VERSION_PATCH) && defined(FLUTTER_VERSION_BUILD) +#define VERSION_AS_NUMBER FLUTTER_VERSION_MAJOR,FLUTTER_VERSION_MINOR,FLUTTER_VERSION_PATCH,FLUTTER_VERSION_BUILD +#else +#define VERSION_AS_NUMBER 1,0,0,0 +#endif + +#if defined(FLUTTER_VERSION) +#define VERSION_AS_STRING FLUTTER_VERSION +#else +#define VERSION_AS_STRING "1.0.0" +#endif + +VS_VERSION_INFO VERSIONINFO + FILEVERSION VERSION_AS_NUMBER + PRODUCTVERSION VERSION_AS_NUMBER + FILEFLAGSMASK VS_FFI_FILEFLAGSMASK +#ifdef _DEBUG + FILEFLAGS VS_FF_DEBUG +#else + FILEFLAGS 0x0L +#endif + FILEOS VOS__WINDOWS32 + FILETYPE VFT_APP + FILESUBTYPE 0x0L +BEGIN + BLOCK "StringFileInfo" + BEGIN + BLOCK "040904e4" + BEGIN + VALUE "CompanyName", "com.example" "\0" + VALUE "FileDescription", "client" "\0" + VALUE "FileVersion", VERSION_AS_STRING "\0" + VALUE "InternalName", "client" "\0" + VALUE "LegalCopyright", "Copyright (C) 2025 com.example. All rights reserved." "\0" + VALUE "OriginalFilename", "client.exe" "\0" + VALUE "ProductName", "client" "\0" + VALUE "ProductVersion", VERSION_AS_STRING "\0" + END + END + BLOCK "VarFileInfo" + BEGIN + VALUE "Translation", 0x409, 1252 + END +END + +#endif // English (United States) resources +///////////////////////////////////////////////////////////////////////////// + + + +#ifndef APSTUDIO_INVOKED +///////////////////////////////////////////////////////////////////////////// +// +// Generated from the TEXTINCLUDE 3 resource. +// + + +///////////////////////////////////////////////////////////////////////////// +#endif // not APSTUDIO_INVOKED diff --git a/client/windows/runner/flutter_window.cpp b/client/windows/runner/flutter_window.cpp new file mode 100644 index 0000000..955ee30 --- /dev/null +++ b/client/windows/runner/flutter_window.cpp @@ -0,0 +1,71 @@ +#include "flutter_window.h" + +#include + +#include "flutter/generated_plugin_registrant.h" + +FlutterWindow::FlutterWindow(const flutter::DartProject& project) + : project_(project) {} + +FlutterWindow::~FlutterWindow() {} + +bool FlutterWindow::OnCreate() { + if (!Win32Window::OnCreate()) { + return false; + } + + RECT frame = GetClientArea(); + + // The size here must match the window dimensions to avoid unnecessary surface + // creation / destruction in the startup path. + flutter_controller_ = std::make_unique( + frame.right - frame.left, frame.bottom - frame.top, project_); + // Ensure that basic setup of the controller was successful. + if (!flutter_controller_->engine() || !flutter_controller_->view()) { + return false; + } + RegisterPlugins(flutter_controller_->engine()); + SetChildContent(flutter_controller_->view()->GetNativeWindow()); + + flutter_controller_->engine()->SetNextFrameCallback([&]() { + this->Show(); + }); + + // Flutter can complete the first frame before the "show window" callback is + // registered. The following call ensures a frame is pending to ensure the + // window is shown. It is a no-op if the first frame hasn't completed yet. + flutter_controller_->ForceRedraw(); + + return true; +} + +void FlutterWindow::OnDestroy() { + if (flutter_controller_) { + flutter_controller_ = nullptr; + } + + Win32Window::OnDestroy(); +} + +LRESULT +FlutterWindow::MessageHandler(HWND hwnd, UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept { + // Give Flutter, including plugins, an opportunity to handle window messages. + if (flutter_controller_) { + std::optional result = + flutter_controller_->HandleTopLevelWindowProc(hwnd, message, wparam, + lparam); + if (result) { + return *result; + } + } + + switch (message) { + case WM_FONTCHANGE: + flutter_controller_->engine()->ReloadSystemFonts(); + break; + } + + return Win32Window::MessageHandler(hwnd, message, wparam, lparam); +} diff --git a/client/windows/runner/flutter_window.h b/client/windows/runner/flutter_window.h new file mode 100644 index 0000000..6da0652 --- /dev/null +++ b/client/windows/runner/flutter_window.h @@ -0,0 +1,33 @@ +#ifndef RUNNER_FLUTTER_WINDOW_H_ +#define RUNNER_FLUTTER_WINDOW_H_ + +#include +#include + +#include + +#include "win32_window.h" + +// A window that does nothing but host a Flutter view. +class FlutterWindow : public Win32Window { + public: + // Creates a new FlutterWindow hosting a Flutter view running |project|. + explicit FlutterWindow(const flutter::DartProject& project); + virtual ~FlutterWindow(); + + protected: + // Win32Window: + bool OnCreate() override; + void OnDestroy() override; + LRESULT MessageHandler(HWND window, UINT const message, WPARAM const wparam, + LPARAM const lparam) noexcept override; + + private: + // The project to run. + flutter::DartProject project_; + + // The Flutter instance hosted by this window. + std::unique_ptr flutter_controller_; +}; + +#endif // RUNNER_FLUTTER_WINDOW_H_ diff --git a/client/windows/runner/main.cpp b/client/windows/runner/main.cpp new file mode 100644 index 0000000..01431dd --- /dev/null +++ b/client/windows/runner/main.cpp @@ -0,0 +1,43 @@ +#include +#include +#include + +#include "flutter_window.h" +#include "utils.h" + +int APIENTRY wWinMain(_In_ HINSTANCE instance, _In_opt_ HINSTANCE prev, + _In_ wchar_t *command_line, _In_ int show_command) { + // Attach to console when present (e.g., 'flutter run') or create a + // new console when running with a debugger. + if (!::AttachConsole(ATTACH_PARENT_PROCESS) && ::IsDebuggerPresent()) { + CreateAndAttachConsole(); + } + + // Initialize COM, so that it is available for use in the library and/or + // plugins. + ::CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED); + + flutter::DartProject project(L"data"); + + std::vector command_line_arguments = + GetCommandLineArguments(); + + project.set_dart_entrypoint_arguments(std::move(command_line_arguments)); + + FlutterWindow window(project); + Win32Window::Point origin(10, 10); + Win32Window::Size size(1280, 720); + if (!window.Create(L"client", origin, size)) { + return EXIT_FAILURE; + } + window.SetQuitOnClose(true); + + ::MSG msg; + while (::GetMessage(&msg, nullptr, 0, 0)) { + ::TranslateMessage(&msg); + ::DispatchMessage(&msg); + } + + ::CoUninitialize(); + return EXIT_SUCCESS; +} diff --git a/client/windows/runner/resource.h b/client/windows/runner/resource.h new file mode 100644 index 0000000..66a65d1 --- /dev/null +++ b/client/windows/runner/resource.h @@ -0,0 +1,16 @@ +//{{NO_DEPENDENCIES}} +// Microsoft Visual C++ generated include file. +// Used by Runner.rc +// +#define IDI_APP_ICON 101 + +// Next default values for new objects +// +#ifdef APSTUDIO_INVOKED +#ifndef APSTUDIO_READONLY_SYMBOLS +#define _APS_NEXT_RESOURCE_VALUE 102 +#define _APS_NEXT_COMMAND_VALUE 40001 +#define _APS_NEXT_CONTROL_VALUE 1001 +#define _APS_NEXT_SYMED_VALUE 101 +#endif +#endif diff --git a/client/windows/runner/resources/app_icon.ico b/client/windows/runner/resources/app_icon.ico new file mode 100644 index 0000000..c04e20c Binary files /dev/null and b/client/windows/runner/resources/app_icon.ico differ diff --git a/client/windows/runner/runner.exe.manifest b/client/windows/runner/runner.exe.manifest new file mode 100644 index 0000000..153653e --- /dev/null +++ b/client/windows/runner/runner.exe.manifest @@ -0,0 +1,14 @@ + + + + + PerMonitorV2 + + + + + + + + + diff --git a/client/windows/runner/utils.cpp b/client/windows/runner/utils.cpp new file mode 100644 index 0000000..3a0b465 --- /dev/null +++ b/client/windows/runner/utils.cpp @@ -0,0 +1,65 @@ +#include "utils.h" + +#include +#include +#include +#include + +#include + +void CreateAndAttachConsole() { + if (::AllocConsole()) { + FILE *unused; + if (freopen_s(&unused, "CONOUT$", "w", stdout)) { + _dup2(_fileno(stdout), 1); + } + if (freopen_s(&unused, "CONOUT$", "w", stderr)) { + _dup2(_fileno(stdout), 2); + } + std::ios::sync_with_stdio(); + FlutterDesktopResyncOutputStreams(); + } +} + +std::vector GetCommandLineArguments() { + // Convert the UTF-16 command line arguments to UTF-8 for the Engine to use. + int argc; + wchar_t** argv = ::CommandLineToArgvW(::GetCommandLineW(), &argc); + if (argv == nullptr) { + return std::vector(); + } + + std::vector command_line_arguments; + + // Skip the first argument as it's the binary name. + for (int i = 1; i < argc; i++) { + command_line_arguments.push_back(Utf8FromUtf16(argv[i])); + } + + ::LocalFree(argv); + + return command_line_arguments; +} + +std::string Utf8FromUtf16(const wchar_t* utf16_string) { + if (utf16_string == nullptr) { + return std::string(); + } + unsigned int target_length = ::WideCharToMultiByte( + CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string, + -1, nullptr, 0, nullptr, nullptr) + -1; // remove the trailing null character + int input_length = (int)wcslen(utf16_string); + std::string utf8_string; + if (target_length == 0 || target_length > utf8_string.max_size()) { + return utf8_string; + } + utf8_string.resize(target_length); + int converted_length = ::WideCharToMultiByte( + CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string, + input_length, utf8_string.data(), target_length, nullptr, nullptr); + if (converted_length == 0) { + return std::string(); + } + return utf8_string; +} diff --git a/client/windows/runner/utils.h b/client/windows/runner/utils.h new file mode 100644 index 0000000..3879d54 --- /dev/null +++ b/client/windows/runner/utils.h @@ -0,0 +1,19 @@ +#ifndef RUNNER_UTILS_H_ +#define RUNNER_UTILS_H_ + +#include +#include + +// Creates a console for the process, and redirects stdout and stderr to +// it for both the runner and the Flutter library. +void CreateAndAttachConsole(); + +// Takes a null-terminated wchar_t* encoded in UTF-16 and returns a std::string +// encoded in UTF-8. Returns an empty std::string on failure. +std::string Utf8FromUtf16(const wchar_t* utf16_string); + +// Gets the command line arguments passed in as a std::vector, +// encoded in UTF-8. Returns an empty std::vector on failure. +std::vector GetCommandLineArguments(); + +#endif // RUNNER_UTILS_H_ diff --git a/client/windows/runner/win32_window.cpp b/client/windows/runner/win32_window.cpp new file mode 100644 index 0000000..60608d0 --- /dev/null +++ b/client/windows/runner/win32_window.cpp @@ -0,0 +1,288 @@ +#include "win32_window.h" + +#include +#include + +#include "resource.h" + +namespace { + +/// Window attribute that enables dark mode window decorations. +/// +/// Redefined in case the developer's machine has a Windows SDK older than +/// version 10.0.22000.0. +/// See: https://docs.microsoft.com/windows/win32/api/dwmapi/ne-dwmapi-dwmwindowattribute +#ifndef DWMWA_USE_IMMERSIVE_DARK_MODE +#define DWMWA_USE_IMMERSIVE_DARK_MODE 20 +#endif + +constexpr const wchar_t kWindowClassName[] = L"FLUTTER_RUNNER_WIN32_WINDOW"; + +/// Registry key for app theme preference. +/// +/// A value of 0 indicates apps should use dark mode. A non-zero or missing +/// value indicates apps should use light mode. +constexpr const wchar_t kGetPreferredBrightnessRegKey[] = + L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize"; +constexpr const wchar_t kGetPreferredBrightnessRegValue[] = L"AppsUseLightTheme"; + +// The number of Win32Window objects that currently exist. +static int g_active_window_count = 0; + +using EnableNonClientDpiScaling = BOOL __stdcall(HWND hwnd); + +// Scale helper to convert logical scaler values to physical using passed in +// scale factor +int Scale(int source, double scale_factor) { + return static_cast(source * scale_factor); +} + +// Dynamically loads the |EnableNonClientDpiScaling| from the User32 module. +// This API is only needed for PerMonitor V1 awareness mode. +void EnableFullDpiSupportIfAvailable(HWND hwnd) { + HMODULE user32_module = LoadLibraryA("User32.dll"); + if (!user32_module) { + return; + } + auto enable_non_client_dpi_scaling = + reinterpret_cast( + GetProcAddress(user32_module, "EnableNonClientDpiScaling")); + if (enable_non_client_dpi_scaling != nullptr) { + enable_non_client_dpi_scaling(hwnd); + } + FreeLibrary(user32_module); +} + +} // namespace + +// Manages the Win32Window's window class registration. +class WindowClassRegistrar { + public: + ~WindowClassRegistrar() = default; + + // Returns the singleton registrar instance. + static WindowClassRegistrar* GetInstance() { + if (!instance_) { + instance_ = new WindowClassRegistrar(); + } + return instance_; + } + + // Returns the name of the window class, registering the class if it hasn't + // previously been registered. + const wchar_t* GetWindowClass(); + + // Unregisters the window class. Should only be called if there are no + // instances of the window. + void UnregisterWindowClass(); + + private: + WindowClassRegistrar() = default; + + static WindowClassRegistrar* instance_; + + bool class_registered_ = false; +}; + +WindowClassRegistrar* WindowClassRegistrar::instance_ = nullptr; + +const wchar_t* WindowClassRegistrar::GetWindowClass() { + if (!class_registered_) { + WNDCLASS window_class{}; + window_class.hCursor = LoadCursor(nullptr, IDC_ARROW); + window_class.lpszClassName = kWindowClassName; + window_class.style = CS_HREDRAW | CS_VREDRAW; + window_class.cbClsExtra = 0; + window_class.cbWndExtra = 0; + window_class.hInstance = GetModuleHandle(nullptr); + window_class.hIcon = + LoadIcon(window_class.hInstance, MAKEINTRESOURCE(IDI_APP_ICON)); + window_class.hbrBackground = 0; + window_class.lpszMenuName = nullptr; + window_class.lpfnWndProc = Win32Window::WndProc; + RegisterClass(&window_class); + class_registered_ = true; + } + return kWindowClassName; +} + +void WindowClassRegistrar::UnregisterWindowClass() { + UnregisterClass(kWindowClassName, nullptr); + class_registered_ = false; +} + +Win32Window::Win32Window() { + ++g_active_window_count; +} + +Win32Window::~Win32Window() { + --g_active_window_count; + Destroy(); +} + +bool Win32Window::Create(const std::wstring& title, + const Point& origin, + const Size& size) { + Destroy(); + + const wchar_t* window_class = + WindowClassRegistrar::GetInstance()->GetWindowClass(); + + const POINT target_point = {static_cast(origin.x), + static_cast(origin.y)}; + HMONITOR monitor = MonitorFromPoint(target_point, MONITOR_DEFAULTTONEAREST); + UINT dpi = FlutterDesktopGetDpiForMonitor(monitor); + double scale_factor = dpi / 96.0; + + HWND window = CreateWindow( + window_class, title.c_str(), WS_OVERLAPPEDWINDOW, + Scale(origin.x, scale_factor), Scale(origin.y, scale_factor), + Scale(size.width, scale_factor), Scale(size.height, scale_factor), + nullptr, nullptr, GetModuleHandle(nullptr), this); + + if (!window) { + return false; + } + + UpdateTheme(window); + + return OnCreate(); +} + +bool Win32Window::Show() { + return ShowWindow(window_handle_, SW_SHOWNORMAL); +} + +// static +LRESULT CALLBACK Win32Window::WndProc(HWND const window, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept { + if (message == WM_NCCREATE) { + auto window_struct = reinterpret_cast(lparam); + SetWindowLongPtr(window, GWLP_USERDATA, + reinterpret_cast(window_struct->lpCreateParams)); + + auto that = static_cast(window_struct->lpCreateParams); + EnableFullDpiSupportIfAvailable(window); + that->window_handle_ = window; + } else if (Win32Window* that = GetThisFromHandle(window)) { + return that->MessageHandler(window, message, wparam, lparam); + } + + return DefWindowProc(window, message, wparam, lparam); +} + +LRESULT +Win32Window::MessageHandler(HWND hwnd, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept { + switch (message) { + case WM_DESTROY: + window_handle_ = nullptr; + Destroy(); + if (quit_on_close_) { + PostQuitMessage(0); + } + return 0; + + case WM_DPICHANGED: { + auto newRectSize = reinterpret_cast(lparam); + LONG newWidth = newRectSize->right - newRectSize->left; + LONG newHeight = newRectSize->bottom - newRectSize->top; + + SetWindowPos(hwnd, nullptr, newRectSize->left, newRectSize->top, newWidth, + newHeight, SWP_NOZORDER | SWP_NOACTIVATE); + + return 0; + } + case WM_SIZE: { + RECT rect = GetClientArea(); + if (child_content_ != nullptr) { + // Size and position the child window. + MoveWindow(child_content_, rect.left, rect.top, rect.right - rect.left, + rect.bottom - rect.top, TRUE); + } + return 0; + } + + case WM_ACTIVATE: + if (child_content_ != nullptr) { + SetFocus(child_content_); + } + return 0; + + case WM_DWMCOLORIZATIONCOLORCHANGED: + UpdateTheme(hwnd); + return 0; + } + + return DefWindowProc(window_handle_, message, wparam, lparam); +} + +void Win32Window::Destroy() { + OnDestroy(); + + if (window_handle_) { + DestroyWindow(window_handle_); + window_handle_ = nullptr; + } + if (g_active_window_count == 0) { + WindowClassRegistrar::GetInstance()->UnregisterWindowClass(); + } +} + +Win32Window* Win32Window::GetThisFromHandle(HWND const window) noexcept { + return reinterpret_cast( + GetWindowLongPtr(window, GWLP_USERDATA)); +} + +void Win32Window::SetChildContent(HWND content) { + child_content_ = content; + SetParent(content, window_handle_); + RECT frame = GetClientArea(); + + MoveWindow(content, frame.left, frame.top, frame.right - frame.left, + frame.bottom - frame.top, true); + + SetFocus(child_content_); +} + +RECT Win32Window::GetClientArea() { + RECT frame; + GetClientRect(window_handle_, &frame); + return frame; +} + +HWND Win32Window::GetHandle() { + return window_handle_; +} + +void Win32Window::SetQuitOnClose(bool quit_on_close) { + quit_on_close_ = quit_on_close; +} + +bool Win32Window::OnCreate() { + // No-op; provided for subclasses. + return true; +} + +void Win32Window::OnDestroy() { + // No-op; provided for subclasses. +} + +void Win32Window::UpdateTheme(HWND const window) { + DWORD light_mode; + DWORD light_mode_size = sizeof(light_mode); + LSTATUS result = RegGetValue(HKEY_CURRENT_USER, kGetPreferredBrightnessRegKey, + kGetPreferredBrightnessRegValue, + RRF_RT_REG_DWORD, nullptr, &light_mode, + &light_mode_size); + + if (result == ERROR_SUCCESS) { + BOOL enable_dark_mode = light_mode == 0; + DwmSetWindowAttribute(window, DWMWA_USE_IMMERSIVE_DARK_MODE, + &enable_dark_mode, sizeof(enable_dark_mode)); + } +} diff --git a/client/windows/runner/win32_window.h b/client/windows/runner/win32_window.h new file mode 100644 index 0000000..e901dde --- /dev/null +++ b/client/windows/runner/win32_window.h @@ -0,0 +1,102 @@ +#ifndef RUNNER_WIN32_WINDOW_H_ +#define RUNNER_WIN32_WINDOW_H_ + +#include + +#include +#include +#include + +// A class abstraction for a high DPI-aware Win32 Window. Intended to be +// inherited from by classes that wish to specialize with custom +// rendering and input handling +class Win32Window { + public: + struct Point { + unsigned int x; + unsigned int y; + Point(unsigned int x, unsigned int y) : x(x), y(y) {} + }; + + struct Size { + unsigned int width; + unsigned int height; + Size(unsigned int width, unsigned int height) + : width(width), height(height) {} + }; + + Win32Window(); + virtual ~Win32Window(); + + // Creates a win32 window with |title| that is positioned and sized using + // |origin| and |size|. New windows are created on the default monitor. Window + // sizes are specified to the OS in physical pixels, hence to ensure a + // consistent size this function will scale the inputted width and height as + // as appropriate for the default monitor. The window is invisible until + // |Show| is called. Returns true if the window was created successfully. + bool Create(const std::wstring& title, const Point& origin, const Size& size); + + // Show the current window. Returns true if the window was successfully shown. + bool Show(); + + // Release OS resources associated with window. + void Destroy(); + + // Inserts |content| into the window tree. + void SetChildContent(HWND content); + + // Returns the backing Window handle to enable clients to set icon and other + // window properties. Returns nullptr if the window has been destroyed. + HWND GetHandle(); + + // If true, closing this window will quit the application. + void SetQuitOnClose(bool quit_on_close); + + // Return a RECT representing the bounds of the current client area. + RECT GetClientArea(); + + protected: + // Processes and route salient window messages for mouse handling, + // size change and DPI. Delegates handling of these to member overloads that + // inheriting classes can handle. + virtual LRESULT MessageHandler(HWND window, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept; + + // Called when CreateAndShow is called, allowing subclass window-related + // setup. Subclasses should return false if setup fails. + virtual bool OnCreate(); + + // Called when Destroy is called. + virtual void OnDestroy(); + + private: + friend class WindowClassRegistrar; + + // OS callback called by message pump. Handles the WM_NCCREATE message which + // is passed when the non-client area is being created and enables automatic + // non-client DPI scaling so that the non-client area automatically + // responds to changes in DPI. All other messages are handled by + // MessageHandler. + static LRESULT CALLBACK WndProc(HWND const window, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept; + + // Retrieves a class instance pointer for |window| + static Win32Window* GetThisFromHandle(HWND const window) noexcept; + + // Update the window frame's theme to match the system theme. + static void UpdateTheme(HWND const window); + + bool quit_on_close_ = false; + + // window handle for top level window. + HWND window_handle_ = nullptr; + + // window handle for hosted content. + HWND child_content_ = nullptr; +}; + +#endif // RUNNER_WIN32_WINDOW_H_ diff --git a/data/import_college_words.py b/data/import_college_words.py new file mode 100644 index 0000000..e34f6b2 --- /dev/null +++ b/data/import_college_words.py @@ -0,0 +1,266 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""导入大学英语教材词汇到数据库""" + +import pandas as pd +import mysql.connector +from datetime import datetime +import json + +# 数据库配置 +db_config = { + 'host': 'localhost', + 'port': 3306, + 'user': 'root', + 'password': 'JKjk20011115', + 'database': 'ai_english_learning', + 'charset': 'utf8mb4' +} + +# 词汇书ID +BOOK_ID = 'college_textbook' + +def clean_text(text): + """清理文本，处理nan和空值""" + if pd.isna(text) or str(text).strip() == '' or str(text).strip() == 'nan': + return None + return str(text).strip() + +def extract_part_of_speech(translation): + """从中文翻译中提取词性""" + if not translation: + return 'noun' + + pos_map = { + 'v.': 'verb', + 'n.': 'noun', + 'adj.': 'adjective', + 'adv.': 'adverb', + 'prep.': 'preposition', + 'conj.': 'conjunction', + 'pron.': 'pronoun', + 'interj.': 'interjection' + } + + for abbr, full in pos_map.items(): + if abbr in translation or abbr.replace('.', '') in translation: + return full + + # 中文词性判断 + if '动' in translation: + return 'verb' + elif '形' in translation or '容' in translation: + return 'adjective' + elif '副' in translation: + return 'adverb' + elif '介' in translation: + return 'preposition' + elif '连' in translation: + return 'conjunction' + + return 'noun' + +def import_words_from_excel(file_path): + """从Excel导入单词""" + try: + print(f"📖 正在读取文件: {file_path}") + df = pd.read_excel(file_path) + + print(f"📊 文件列名: {df.columns.tolist()}") + print(f"📊 总行数: {len(df)}") + + conn = mysql.connector.connect(**db_config) + cursor = conn.cursor() + + # 清理旧数据 + print("\n清理旧数据...") + cursor.execute("DELETE FROM ai_vocabulary_book_words WHERE book_id = %s", (BOOK_ID,)) + cursor.execute(""" + DELETE v FROM ai_vocabulary v + LEFT JOIN ai_vocabulary_book_words bw ON bw.vocabulary_id = v.id + WHERE bw.id IS NULL + """) + conn.commit() + + # SQL语句 + insert_vocab_sql = """ + INSERT INTO ai_vocabulary + (word, phonetic_us, phonetic_uk, phonetic, level, frequency, is_active, + word_root, synonyms, antonyms, derivatives, collocations, created_at, updated_at) + VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s) + """ + + insert_definition_sql = """ + INSERT INTO ai_vocabulary_definitions + (vocabulary_id, part_of_speech, definition_en, definition_cn, sort_order, created_at) + VALUES (%s, %s, %s, %s, %s, %s) + """ + + insert_example_sql = """ + INSERT INTO ai_vocabulary_examples + (vocabulary_id, sentence_en, sentence_cn, sort_order, created_at) + VALUES (%s, %s, %s, %s, %s) + """ + + insert_book_word_sql = """ + INSERT INTO ai_vocabulary_book_words + (book_id, vocabulary_id, sort_order, created_at) + VALUES (%s, %s, %s, %s) + """ + + success_count = 0 + error_count = 0 + + for index, row in df.iterrows(): + try: + # 尝试多个可能的列名 + word = clean_text(row.get('Word') or row.get('单词(Word)') or row.get('单词')) + if not word: + continue + + # 检查单词是否已存在 + cursor.execute("SELECT id FROM ai_vocabulary WHERE word = %s", (word,)) + existing = cursor.fetchone() + + if existing: + # 单词已存在，使用现有ID + vocab_id = existing[0] + else: + # 单词不存在，插入新记录 + # 音标 + phonetic_us = clean_text(row.get('美式音标')) + phonetic_uk = clean_text(row.get('英式音标')) + phonetic = phonetic_us or phonetic_uk + + # 释义 + translation_cn = clean_text(row.get('中文含义')) + translation_en = clean_text(row.get('英文翻译（对应中文含义）')) + + if not translation_cn: + print(f"⚠️ 跳过 {word}：缺少中文含义") + continue + + if not translation_en: + translation_en = word + + part_of_speech = extract_part_of_speech(translation_cn) + + # 例句 + example_en = clean_text(row.get('例句')) + example_cn = clean_text(row.get('例句中文翻译')) + + # 词根 + word_root = clean_text(row.get('词根') or row.get('词根/词源')) + + # 同义词 + synonyms_text = clean_text(row.get('同义词（含义）')) + synonyms_json = '[]' + if synonyms_text: + syn_list = [syn.strip() for syn in synonyms_text.split('；') if syn.strip()] + synonyms_json = json.dumps(syn_list, ensure_ascii=False) + + # 反义词 + antonyms_text = clean_text(row.get('反义词（含义）')) + antonyms_json = '[]' + if antonyms_text: + ant_list = [ant.strip() for ant in antonyms_text.split('；') if ant.strip()] + antonyms_json = json.dumps(ant_list, ensure_ascii=False) + + # 派生词 + derivatives_text = clean_text(row.get('派生词（含义）')) + derivatives_json = '[]' + if derivatives_text: + der_list = [der.strip() for der in derivatives_text.split('；') if der.strip()] + derivatives_json = json.dumps(der_list, ensure_ascii=False) + + # 词组搭配 + phrases_text = clean_text(row.get('词组搭配（中文含义）')) + collocations_json = '[]' + if phrases_text: + col_list = [phrase.strip() for phrase in phrases_text.split('；') if phrase.strip()] + collocations_json = json.dumps(col_list, ensure_ascii=False) + + # 插入词汇 + now = datetime.now() + cursor.execute(insert_vocab_sql, ( + word, phonetic_us, phonetic_uk, phonetic, + 'intermediate', # 大学难度 + index + 1, True, + word_root, synonyms_json, antonyms_json, + derivatives_json, collocations_json, + now, now + )) + + vocab_id = cursor.lastrowid + + # 插入释义 + cursor.execute(insert_definition_sql, ( + vocab_id, part_of_speech, translation_en, + translation_cn, 0, now + )) + + # 插入例句 + if example_en and example_cn: + examples_en = example_en.split('；') + examples_cn = example_cn.split('；') + + for i, (ex_en, ex_cn) in enumerate(zip(examples_en, examples_cn)): + ex_en = ex_en.strip() + ex_cn = ex_cn.strip() + if ex_en and ex_cn: + cursor.execute(insert_example_sql, ( + vocab_id, ex_en, ex_cn, i, now + )) + + # 关联到词汇书（无论单词是否已存在，都要关联） + now = datetime.now() + try: + cursor.execute(insert_book_word_sql, ( + BOOK_ID, vocab_id, index, now + )) + except Exception as link_error: + # 如果关联已存在，跳过 + if '1062' not in str(link_error): # 不是重复键错误 + raise + + success_count += 1 + if success_count % 100 == 0: + print(f"✅ 已处理 {success_count} 个单词...") + conn.commit() + + except Exception as e: + error_count += 1 + print(f"❌ 导入第 {index + 1} 行失败: {e}") + + conn.commit() + + # 更新词汇书总数 + cursor.execute( + "UPDATE ai_vocabulary_books SET total_words = %s WHERE id = %s", + (success_count, BOOK_ID) + ) + conn.commit() + + print(f"\n🎉 大学英语教材词汇导入完成!") + print(f"✅ 成功: {success_count} 个单词") + print(f"❌ 失败: {error_count} 个单词") + + # 验证 + cursor.execute( + "SELECT COUNT(*) FROM ai_vocabulary_book_words WHERE book_id = %s", + (BOOK_ID,) + ) + print(f"📊 词汇书中共有 {cursor.fetchone()[0]} 个单词") + + except Exception as e: + print(f"❌ 导入失败: {e}") + import traceback + traceback.print_exc() + finally: + if 'cursor' in locals(): + cursor.close() + if 'conn' in locals(): + conn.close() + +if __name__ == '__main__': + import_words_from_excel('data/大学英语教材词汇.xlsx') diff --git a/data/import_primary_words.py b/data/import_primary_words.py new file mode 100644 index 0000000..902b41a --- /dev/null +++ b/data/import_primary_words.py @@ -0,0 +1,210 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""导入小学英语核心词汇到数据库""" + +import pandas as pd +import mysql.connector +from datetime import datetime +import uuid + +# 数据库配置 +db_config = { + 'host': 'localhost', + 'port': 3306, + 'user': 'root', + 'password': 'JKjk20011115', + 'database': 'ai_english_learning', + 'charset': 'utf8mb4' +} + +# 词汇书ID +BOOK_ID = 'primary_core_1000' + +def generate_uuid(): + """生成UUID""" + return str(uuid.uuid4()) + +def import_words_from_excel(file_path): + """从Excel导入单词""" + try: + # 读取Excel文件 + print(f"📖 正在读取文件: {file_path}") + df = pd.read_excel(file_path) + + print(f"📊 文件列名: {df.columns.tolist()}") + print(f"📊 总行数: {len(df)}") + print(f"\n前5行数据预览:") + print(df.head()) + + # 连接数据库 + conn = mysql.connector.connect(**db_config) + cursor = conn.cursor() + + # 准备SQL语句 + insert_vocab_sql = """ + INSERT INTO ai_vocabulary + (word, phonetic, level, frequency, is_active, created_at, updated_at) + VALUES (%s, %s, %s, %s, %s, %s, %s) + ON DUPLICATE KEY UPDATE + id = LAST_INSERT_ID(id), + phonetic = VALUES(phonetic), + level = VALUES(level), + frequency = VALUES(frequency), + updated_at = VALUES(updated_at) + """ + + insert_definition_sql = """ + INSERT INTO ai_vocabulary_definitions + (vocabulary_id, part_of_speech, definition_en, definition_cn, sort_order, created_at) + VALUES (%s, %s, %s, %s, %s, %s) + """ + + insert_example_sql = """ + INSERT INTO ai_vocabulary_examples + (vocabulary_id, sentence_en, sentence_cn, sort_order, created_at) + VALUES (%s, %s, %s, %s, %s) + """ + + insert_book_word_sql = """ + INSERT INTO ai_vocabulary_book_words + (book_id, vocabulary_id, sort_order, created_at) + VALUES (%s, %s, %s, %s) + ON DUPLICATE KEY UPDATE sort_order = VALUES(sort_order) + """ + + success_count = 0 + error_count = 0 + + # 遍历每一行 + for index, row in df.iterrows(): + try: + # 提取数据（根据实际Excel列名调整） + word = str(row.get('Word', '')).strip() + if not word or word == 'nan': + continue + + # 优先使用美式音标 + phonetic = str(row.get('美式音标', '')).strip() + if phonetic == 'nan' or not phonetic: + phonetic = str(row.get('英式音标', '')).strip() + if phonetic == 'nan': + phonetic = None + + translation = str(row.get('中文含义', '')).strip() + if translation == 'nan': + translation = '' + + # 从中文含义中提取词性（如果有的话） + part_of_speech = 'noun' # 默认为名词 + if translation: + if 'v.' in translation or '动' in translation: + part_of_speech = 'verb' + elif 'adj.' in translation or '形' in translation: + part_of_speech = 'adjective' + elif 'adv.' in translation or '副' in translation: + part_of_speech = 'adverb' + elif 'prep.' in translation or '介' in translation: + part_of_speech = 'preposition' + elif 'conj.' in translation or '连' in translation: + part_of_speech = 'conjunction' + + example_en = str(row.get('例句', '')).strip() + if example_en == 'nan' or not example_en: + example_en = None + + example_cn = str(row.get('例句中文翻译', '')).strip() + if example_cn == 'nan' or not example_cn: + example_cn = None + + # 插入词汇 + now = datetime.now() + cursor.execute(insert_vocab_sql, ( + word, + phonetic, + 'beginner', # 小学词汇难度为beginner + index + 1, # 使用行号作为频率 + True, + now, + now + )) + + # 获取插入的ID + vocab_id = cursor.lastrowid + + # 插入释义 + if translation: + cursor.execute(insert_definition_sql, ( + vocab_id, + part_of_speech, + word, # 英文定义暂时用单词本身 + translation, + 0, + now + )) + + # 插入例句（只取第一个例句） + if example_en and example_cn: + # 如果有多个例句，用分号分隔，只取第一个 + first_example_en = example_en.split('；')[0] if '；' in example_en else example_en + first_example_cn = example_cn.split('；')[0] if '；' in example_cn else example_cn + + cursor.execute(insert_example_sql, ( + vocab_id, + first_example_en, + first_example_cn, + 0, + now + )) + + # 关联到词汇书 + cursor.execute(insert_book_word_sql, ( + BOOK_ID, + vocab_id, + index, + now + )) + + success_count += 1 + if success_count % 50 == 0: + print(f"✅ 已导入 {success_count} 个单词...") + conn.commit() + + except Exception as e: + error_count += 1 + print(f"❌ 导入第 {index + 1} 行失败: {e}") + print(f" 数据: {row.to_dict()}") + + # 提交事务 + conn.commit() + + # 更新词汇书的总单词数 + cursor.execute( + "UPDATE ai_vocabulary_books SET total_words = %s WHERE id = %s", + (success_count, BOOK_ID) + ) + conn.commit() + + print(f"\n🎉 导入完成!") + print(f"✅ 成功: {success_count} 个单词") + print(f"❌ 失败: {error_count} 个单词") + + # 验证数据 + cursor.execute( + "SELECT COUNT(*) FROM ai_vocabulary_book_words WHERE book_id = %s", + (BOOK_ID,) + ) + count = cursor.fetchone()[0] + print(f"📊 词汇书中共有 {count} 个单词") + + except Exception as e: + print(f"❌ 导入失败: {e}") + import traceback + traceback.print_exc() + finally: + if cursor: + cursor.close() + if conn: + conn.close() + +if __name__ == '__main__': + import_words_from_excel('data/小学.xlsx') diff --git a/data/import_primary_words_complete.py b/data/import_primary_words_complete.py new file mode 100644 index 0000000..ca23d51 --- /dev/null +++ b/data/import_primary_words_complete.py @@ -0,0 +1,320 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""完整导入小学英语核心词汇到数据库（包含所有字段）""" + +import pandas as pd +import mysql.connector +from datetime import datetime +import re + +# 数据库配置 +db_config = { + 'host': 'localhost', + 'port': 3306, + 'user': 'root', + 'password': 'JKjk20011115', + 'database': 'ai_english_learning', + 'charset': 'utf8mb4' +} + +# 词汇书ID +BOOK_ID = 'primary_core_1000' + +def clean_text(text): + """清理文本，处理nan和空值""" + if pd.isna(text) or str(text).strip() == '' or str(text).strip() == 'nan': + return None + return str(text).strip() + +def extract_part_of_speech(translation): + """从中文翻译中提取词性""" + if not translation: + return 'noun' + + pos_map = { + 'v.': 'verb', + 'n.': 'noun', + 'adj.': 'adjective', + 'adv.': 'adverb', + 'prep.': 'preposition', + 'conj.': 'conjunction', + 'pron.': 'pronoun', + 'interj.': 'interjection' + } + + for abbr, full in pos_map.items(): + if abbr in translation or abbr.replace('.', '') in translation: + return full + + # 中文词性判断 + if '动' in translation: + return 'verb' + elif '形' in translation or '容' in translation: + return 'adjective' + elif '副' in translation: + return 'adverb' + elif '介' in translation: + return 'preposition' + elif '连' in translation: + return 'conjunction' + + return 'noun' # 默认名词 + +def import_words_from_excel(file_path): + """从Excel导入单词""" + try: + # 读取Excel文件 + print(f"📖 正在读取文件: {file_path}") + df = pd.read_excel(file_path) + + print(f"📊 文件列名: {df.columns.tolist()}") + print(f"📊 总行数: {len(df)}") + + # 连接数据库 + conn = mysql.connector.connect(**db_config) + cursor = conn.cursor() + + # 先清空旧数据 + print("\n清理旧数据...") + cursor.execute("DELETE FROM ai_vocabulary_book_words WHERE book_id = %s", (BOOK_ID,)) + cursor.execute(""" + DELETE v FROM ai_vocabulary v + LEFT JOIN ai_vocabulary_book_words bw ON bw.vocabulary_id = v.id + WHERE bw.id IS NULL + """) + conn.commit() + + # 准备SQL语句 + insert_vocab_sql = """ + INSERT INTO ai_vocabulary + (word, phonetic_us, phonetic_uk, phonetic, level, frequency, is_active, + word_root, synonyms, antonyms, derivatives, collocations, created_at, updated_at) + VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s) + """ + + insert_definition_sql = """ + INSERT INTO ai_vocabulary_definitions + (vocabulary_id, part_of_speech, definition_en, definition_cn, sort_order, created_at) + VALUES (%s, %s, %s, %s, %s, %s) + """ + + insert_example_sql = """ + INSERT INTO ai_vocabulary_examples + (vocabulary_id, sentence_en, sentence_cn, sort_order, created_at) + VALUES (%s, %s, %s, %s, %s) + """ + + insert_book_word_sql = """ + INSERT INTO ai_vocabulary_book_words + (book_id, vocabulary_id, sort_order, created_at) + VALUES (%s, %s, %s, %s) + """ + + success_count = 0 + error_count = 0 + + # 遍历每一行 + for index, row in df.iterrows(): + try: + # 提取基本数据 + word = clean_text(row.get('Word')) + if not word: + continue + + # 音标 + phonetic_us = clean_text(row.get('美式音标')) + phonetic_uk = clean_text(row.get('英式音标')) + phonetic = phonetic_us or phonetic_uk + + # 释义 + translation_cn = clean_text(row.get('中文含义')) + translation_en = clean_text(row.get('英文翻译（对应中文含义）')) + + if not translation_cn: + print(f"⚠️ 跳过 {word}：缺少中文含义") + continue + + # 如果没有英文翻译，使用单词本身 + if not translation_en: + translation_en = word + + # 提取词性 + part_of_speech = extract_part_of_speech(translation_cn) + + # 例句 + example_en = clean_text(row.get('例句')) + example_cn = clean_text(row.get('例句中文翻译')) + + # 词根 + word_root = clean_text(row.get('词根')) + + # 同义词（处理为JSON） + synonyms_text = clean_text(row.get('同义词（含义）')) + synonyms_json = '[]' + if synonyms_text: + # 分号分隔，格式：word1（含义1）；word2（含义2） + import json + syn_list = [] + for syn in synonyms_text.split('；'): + syn = syn.strip() + if syn: + syn_list.append(syn) + synonyms_json = json.dumps(syn_list, ensure_ascii=False) + + # 反义词（处理为JSON） + antonyms_text = clean_text(row.get('反义词（含义）')) + antonyms_json = '[]' + if antonyms_text: + import json + ant_list = [] + for ant in antonyms_text.split('；'): + ant = ant.strip() + if ant: + ant_list.append(ant) + antonyms_json = json.dumps(ant_list, ensure_ascii=False) + + # 派生词（处理为JSON） + derivatives_text = clean_text(row.get('派生词（含义）')) + derivatives_json = '[]' + if derivatives_text: + import json + der_list = [] + for der in derivatives_text.split('；'): + der = der.strip() + if der: + der_list.append(der) + derivatives_json = json.dumps(der_list, ensure_ascii=False) + + # 词组搭配（处理为JSON） + phrases_text = clean_text(row.get('词组搭配（中文含义）')) + collocations_json = '[]' + if phrases_text: + import json + col_list = [] + for phrase in phrases_text.split('；'): + phrase = phrase.strip() + if phrase: + col_list.append(phrase) + collocations_json = json.dumps(col_list, ensure_ascii=False) + + # 插入词汇 + now = datetime.now() + cursor.execute(insert_vocab_sql, ( + word, + phonetic_us, + phonetic_uk, + phonetic, + 'beginner', + index + 1, + True, + word_root, + synonyms_json, + antonyms_json, + derivatives_json, + collocations_json, + now, + now + )) + + vocab_id = cursor.lastrowid + + # 插入主要释义 + cursor.execute(insert_definition_sql, ( + vocab_id, + part_of_speech, + translation_en, # ✅ 使用正确的英文翻译 + translation_cn, + 0, + now + )) + + # 插入例句 + if example_en and example_cn: + # 处理多个例句（用分号分隔） + examples_en = example_en.split('；') + examples_cn = example_cn.split('；') + + for i, (ex_en, ex_cn) in enumerate(zip(examples_en, examples_cn)): + ex_en = ex_en.strip() + ex_cn = ex_cn.strip() + if ex_en and ex_cn: + cursor.execute(insert_example_sql, ( + vocab_id, + ex_en, + ex_cn, + i, + now + )) + + # 关联到词汇书 + cursor.execute(insert_book_word_sql, ( + BOOK_ID, + vocab_id, + index, + now + )) + + success_count += 1 + if success_count % 50 == 0: + print(f"✅ 已导入 {success_count} 个单词...") + conn.commit() + + except Exception as e: + error_count += 1 + print(f"❌ 导入第 {index + 1} 行失败: {e}") + print(f" 单词: {word if 'word' in locals() else 'N/A'}") + + # 提交事务 + conn.commit() + + # 更新词汇书的总单词数 + cursor.execute( + "UPDATE ai_vocabulary_books SET total_words = %s WHERE id = %s", + (success_count, BOOK_ID) + ) + conn.commit() + + print(f"\n🎉 导入完成!") + print(f"✅ 成功: {success_count} 个单词") + print(f"❌ 失败: {error_count} 个单词") + + # 验证数据 + cursor.execute( + "SELECT COUNT(*) FROM ai_vocabulary_book_words WHERE book_id = %s", + (BOOK_ID,) + ) + count = cursor.fetchone()[0] + print(f"📊 词汇书中共有 {count} 个单词") + + # 检查释义数量 + cursor.execute(""" + SELECT COUNT(DISTINCT d.vocabulary_id) + FROM ai_vocabulary_book_words bw + JOIN ai_vocabulary_definitions d ON d.vocabulary_id = bw.vocabulary_id + WHERE bw.book_id = %s + """, (BOOK_ID,)) + def_count = cursor.fetchone()[0] + print(f"📊 有释义的单词: {def_count} 个") + + # 检查例句数量 + cursor.execute(""" + SELECT COUNT(DISTINCT e.vocabulary_id) + FROM ai_vocabulary_book_words bw + JOIN ai_vocabulary_examples e ON e.vocabulary_id = bw.vocabulary_id + WHERE bw.book_id = %s + """, (BOOK_ID,)) + ex_count = cursor.fetchone()[0] + print(f"📊 有例句的单词: {ex_count} 个") + + except Exception as e: + print(f"❌ 导入失败: {e}") + import traceback + traceback.print_exc() + finally: + if cursor: + cursor.close() + if conn: + conn.close() + +if __name__ == '__main__': + import_words_from_excel('data/小学.xlsx') diff --git a/data/import_senior_high_words.py b/data/import_senior_high_words.py new file mode 100644 index 0000000..a81eb18 --- /dev/null +++ b/data/import_senior_high_words.py @@ -0,0 +1,265 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""导入高中英语词汇到数据库""" + +import pandas as pd +import mysql.connector +from datetime import datetime +import json + +# 数据库配置 +db_config = { + 'host': 'localhost', + 'port': 3306, + 'user': 'root', + 'password': 'JKjk20011115', + 'database': 'ai_english_learning', + 'charset': 'utf8mb4' +} + +# 词汇书ID +BOOK_ID = 'senior_high_3500' + +def clean_text(text): + """清理文本，处理nan和空值""" + if pd.isna(text) or str(text).strip() == '' or str(text).strip() == 'nan': + return None + return str(text).strip() + +def extract_part_of_speech(translation): + """从中文翻译中提取词性""" + if not translation: + return 'noun' + + pos_map = { + 'v.': 'verb', + 'n.': 'noun', + 'adj.': 'adjective', + 'adv.': 'adverb', + 'prep.': 'preposition', + 'conj.': 'conjunction', + 'pron.': 'pronoun', + 'interj.': 'interjection' + } + + for abbr, full in pos_map.items(): + if abbr in translation or abbr.replace('.', '') in translation: + return full + + # 中文词性判断 + if '动' in translation: + return 'verb' + elif '形' in translation or '容' in translation: + return 'adjective' + elif '副' in translation: + return 'adverb' + elif '介' in translation: + return 'preposition' + elif '连' in translation: + return 'conjunction' + + return 'noun' + +def import_words_from_excel(file_path): + """从Excel导入单词""" + try: + print(f"📖 正在读取文件: {file_path}") + df = pd.read_excel(file_path) + + print(f"📊 文件列名: {df.columns.tolist()}") + print(f"📊 总行数: {len(df)}") + + conn = mysql.connector.connect(**db_config) + cursor = conn.cursor() + + # 清理旧数据 + print("\n清理旧数据...") + cursor.execute("DELETE FROM ai_vocabulary_book_words WHERE book_id = %s", (BOOK_ID,)) + cursor.execute(""" + DELETE v FROM ai_vocabulary v + LEFT JOIN ai_vocabulary_book_words bw ON bw.vocabulary_id = v.id + WHERE bw.id IS NULL + """) + conn.commit() + + # SQL语句 + insert_vocab_sql = """ + INSERT INTO ai_vocabulary + (word, phonetic_us, phonetic_uk, phonetic, level, frequency, is_active, + word_root, synonyms, antonyms, derivatives, collocations, created_at, updated_at) + VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s) + """ + + insert_definition_sql = """ + INSERT INTO ai_vocabulary_definitions + (vocabulary_id, part_of_speech, definition_en, definition_cn, sort_order, created_at) + VALUES (%s, %s, %s, %s, %s, %s) + """ + + insert_example_sql = """ + INSERT INTO ai_vocabulary_examples + (vocabulary_id, sentence_en, sentence_cn, sort_order, created_at) + VALUES (%s, %s, %s, %s, %s) + """ + + insert_book_word_sql = """ + INSERT INTO ai_vocabulary_book_words + (book_id, vocabulary_id, sort_order, created_at) + VALUES (%s, %s, %s, %s) + """ + + success_count = 0 + error_count = 0 + + for index, row in df.iterrows(): + try: + word = clean_text(row.get('Word')) + if not word: + continue + + # 检查单词是否已存在 + cursor.execute("SELECT id FROM ai_vocabulary WHERE word = %s", (word,)) + existing = cursor.fetchone() + + if existing: + # 单词已存在，使用现有ID + vocab_id = existing[0] + else: + # 单词不存在，插入新记录 + # 音标 + phonetic_us = clean_text(row.get('美式音标')) + phonetic_uk = clean_text(row.get('英式音标')) + phonetic = phonetic_us or phonetic_uk + + # 释义 + translation_cn = clean_text(row.get('中文含义')) + translation_en = clean_text(row.get('英文翻译（对应中文含义）')) + + if not translation_cn: + print(f"⚠️ 跳过 {word}：缺少中文含义") + continue + + if not translation_en: + translation_en = word + + part_of_speech = extract_part_of_speech(translation_cn) + + # 例句 + example_en = clean_text(row.get('例句')) + example_cn = clean_text(row.get('例句中文翻译')) + + # 词根 + word_root = clean_text(row.get('词根')) + + # 同义词 + synonyms_text = clean_text(row.get('同义词（含义）')) + synonyms_json = '[]' + if synonyms_text: + syn_list = [syn.strip() for syn in synonyms_text.split('；') if syn.strip()] + synonyms_json = json.dumps(syn_list, ensure_ascii=False) + + # 反义词 + antonyms_text = clean_text(row.get('反义词（含义）')) + antonyms_json = '[]' + if antonyms_text: + ant_list = [ant.strip() for ant in antonyms_text.split('；') if ant.strip()] + antonyms_json = json.dumps(ant_list, ensure_ascii=False) + + # 派生词 + derivatives_text = clean_text(row.get('派生词（含义）')) + derivatives_json = '[]' + if derivatives_text: + der_list = [der.strip() for der in derivatives_text.split('；') if der.strip()] + derivatives_json = json.dumps(der_list, ensure_ascii=False) + + # 词组搭配 + phrases_text = clean_text(row.get('词组搭配（中文含义）')) + collocations_json = '[]' + if phrases_text: + col_list = [phrase.strip() for phrase in phrases_text.split('；') if phrase.strip()] + collocations_json = json.dumps(col_list, ensure_ascii=False) + + # 插入词汇 + now = datetime.now() + cursor.execute(insert_vocab_sql, ( + word, phonetic_us, phonetic_uk, phonetic, + 'intermediate', # 高中难度 + index + 1, True, + word_root, synonyms_json, antonyms_json, + derivatives_json, collocations_json, + now, now + )) + + vocab_id = cursor.lastrowid + + # 插入释义 + cursor.execute(insert_definition_sql, ( + vocab_id, part_of_speech, translation_en, + translation_cn, 0, now + )) + + # 插入例句 + if example_en and example_cn: + examples_en = example_en.split('；') + examples_cn = example_cn.split('；') + + for i, (ex_en, ex_cn) in enumerate(zip(examples_en, examples_cn)): + ex_en = ex_en.strip() + ex_cn = ex_cn.strip() + if ex_en and ex_cn: + cursor.execute(insert_example_sql, ( + vocab_id, ex_en, ex_cn, i, now + )) + + # 关联到词汇书（无论单词是否已存在，都要关联） + now = datetime.now() + try: + cursor.execute(insert_book_word_sql, ( + BOOK_ID, vocab_id, index, now + )) + except Exception as link_error: + # 如果关联已存在，跳过 + if '1062' not in str(link_error): # 不是重复键错误 + raise + + success_count += 1 + if success_count % 100 == 0: + print(f"✅ 已处理 {success_count} 个单词...") + conn.commit() + + except Exception as e: + error_count += 1 + print(f"❌ 导入第 {index + 1} 行失败: {e}") + + conn.commit() + + # 更新词汇书总数 + cursor.execute( + "UPDATE ai_vocabulary_books SET total_words = %s WHERE id = %s", + (success_count, BOOK_ID) + ) + conn.commit() + + print(f"\n🎉 高中词汇导入完成!") + print(f"✅ 成功: {success_count} 个单词") + print(f"❌ 失败: {error_count} 个单词") + + # 验证 + cursor.execute( + "SELECT COUNT(*) FROM ai_vocabulary_book_words WHERE book_id = %s", + (BOOK_ID,) + ) + print(f"📊 词汇书中共有 {cursor.fetchone()[0]} 个单词") + + except Exception as e: + print(f"❌ 导入失败: {e}") + import traceback + traceback.print_exc() + finally: + if 'cursor' in locals(): + cursor.close() + if 'conn' in locals(): + conn.close() + +if __name__ == '__main__': + import_words_from_excel('data/高中英语词汇.xlsx') diff --git a/data/insert_all_vocabulary_books.py b/data/insert_all_vocabulary_books.py new file mode 100644 index 0000000..3b97795 --- /dev/null +++ b/data/insert_all_vocabulary_books.py @@ -0,0 +1,458 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""插入所有词汇书数据到数据库""" + +import mysql.connector +from datetime import datetime + +# 数据库配置 +db_config = { + 'host': 'localhost', + 'port': 3306, + 'user': 'root', + 'password': 'JKjk20011115', + 'database': 'ai_english_learning', + 'charset': 'utf8mb4' +} + +# 所有词汇书数据 +vocabulary_books = [ + # 学段基础词汇 + { + 'id': 'primary_core_1000', + 'name': '小学英语核心词汇', + 'description': '小学阶段必备的1000个核心词汇，涵盖日常生活场景', + 'category': '学段基础词汇', + 'level': 'beginner', + 'total_words': 728, # 已导入 + 'icon': '🎈', + 'color': '#E91E63', + 'sort_order': 1 + }, + { + 'id': 'junior_high_1500', + 'name': '初中英语词汇', + 'description': '初中阶段1500-2500词汇，结合教材要求', + 'category': '学段基础词汇', + 'level': 'elementary', + 'total_words': 1500, + 'icon': '📝', + 'color': '#00BCD4', + 'sort_order': 2 + }, + { + 'id': 'senior_high_3500', + 'name': '高中英语词汇', + 'description': '高中阶段2500-3500词汇，涵盖课标与高考高频词', + 'category': '学段基础词汇', + 'level': 'intermediate', + 'total_words': 3500, + 'icon': '📕', + 'color': '#FF5722', + 'sort_order': 3 + }, + { + 'id': 'college_textbook', + 'name': '大学英语教材词汇', + 'description': '大学英语精读/泛读配套词汇', + 'category': '学段基础词汇', + 'level': 'intermediate', + 'total_words': 2000, + 'icon': '📚', + 'color': '#3F51B5', + 'sort_order': 4 + }, + + # 国内应试类词汇 + { + 'id': 'cet4_core_2500', + 'name': '大学英语四级核心词汇', + 'description': '涵盖CET-4考试核心词汇2500个', + 'category': '国内应试类词汇', + 'level': 'intermediate', + 'total_words': 2500, + 'icon': '📚', + 'color': '#4CAF50', + 'sort_order': 11 + }, + { + 'id': 'cet6_core_3000', + 'name': '大学英语六级核心词汇', + 'description': '涵盖CET-6考试核心词汇3000个', + 'category': '国内应试类词汇', + 'level': 'advanced', + 'total_words': 3000, + 'icon': '📖', + 'color': '#2196F3', + 'sort_order': 12 + }, + { + 'id': 'postgraduate_vocabulary', + 'name': '考研英语核心词汇', + 'description': '考研英语必备核心词汇', + 'category': '国内应试类词汇', + 'level': 'advanced', + 'total_words': 5500, + 'icon': '🎓', + 'color': '#9C27B0', + 'sort_order': 13 + }, + { + 'id': 'tem4_vocabulary', + 'name': '专四词汇(TEM-4)', + 'description': '英语专业四级考试词汇', + 'category': '国内应试类词汇', + 'level': 'advanced', + 'total_words': 8000, + 'icon': '📘', + 'color': '#FF9800', + 'sort_order': 14 + }, + { + 'id': 'tem8_vocabulary', + 'name': '专八词汇(TEM-8)', + 'description': '英语专业八级考试词汇', + 'category': '国内应试类词汇', + 'level': 'expert', + 'total_words': 12000, + 'icon': '📙', + 'color': '#F44336', + 'sort_order': 15 + }, + + # 出国考试类词汇 + { + 'id': 'ielts_high_3500', + 'name': '雅思高频词汇', + 'description': '雅思考试高频词汇3500个', + 'category': '出国考试类词汇', + 'level': 'advanced', + 'total_words': 3500, + 'icon': '🌟', + 'color': '#9C27B0', + 'sort_order': 21 + }, + { + 'id': 'ielts_general', + 'name': '雅思通用词汇(IELTS General)', + 'description': '雅思通用类考试核心词汇', + 'category': '出国考试类词汇', + 'level': 'intermediate', + 'total_words': 6000, + 'icon': '⭐', + 'color': '#673AB7', + 'sort_order': 22 + }, + { + 'id': 'toefl_high_3500', + 'name': '托福高频词汇', + 'description': '托福考试高频词汇3500个', + 'category': '出国考试类词汇', + 'level': 'advanced', + 'total_words': 3500, + 'icon': '🎓', + 'color': '#FF9800', + 'sort_order': 23 + }, + { + 'id': 'toeic_vocabulary', + 'name': '托业词汇(TOEIC)', + 'description': '托业考试职场应用词汇', + 'category': '出国考试类词汇', + 'level': 'intermediate', + 'total_words': 6000, + 'icon': '💼', + 'color': '#00BCD4', + 'sort_order': 24 + }, + { + 'id': 'gre_vocabulary', + 'name': 'GRE词汇', + 'description': 'GRE学术/研究生申请词汇', + 'category': '出国考试类词汇', + 'level': 'expert', + 'total_words': 15000, + 'icon': '🔬', + 'color': '#E91E63', + 'sort_order': 25 + }, + { + 'id': 'gmat_vocabulary', + 'name': 'GMAT词汇', + 'description': 'GMAT商科/管理类研究生词汇', + 'category': '出国考试类词汇', + 'level': 'advanced', + 'total_words': 8000, + 'icon': '📊', + 'color': '#4CAF50', + 'sort_order': 26 + }, + { + 'id': 'sat_vocabulary', + 'name': 'SAT词汇', + 'description': 'SAT美本申请词汇', + 'category': '出国考试类词汇', + 'level': 'intermediate', + 'total_words': 5000, + 'icon': '🎯', + 'color': '#FF5722', + 'sort_order': 27 + }, + + # 职业与专业类词汇 + { + 'id': 'business_core_1000', + 'name': '商务英语核心词汇', + 'description': '商务场景常用核心词汇1000个', + 'category': '职业与专业类词汇', + 'level': 'intermediate', + 'total_words': 1000, + 'icon': '💼', + 'color': '#607D8B', + 'sort_order': 31 + }, + { + 'id': 'bec_preliminary', + 'name': '商务英语初级(BEC Preliminary)', + 'description': 'BEC初级商务英语词汇', + 'category': '职业与专业类词汇', + 'level': 'intermediate', + 'total_words': 3000, + 'icon': '📋', + 'color': '#00BCD4', + 'sort_order': 32 + }, + { + 'id': 'bec_vantage', + 'name': '商务英语中级(BEC Vantage)', + 'description': 'BEC中级商务英语词汇', + 'category': '职业与专业类词汇', + 'level': 'intermediate', + 'total_words': 4000, + 'icon': '📊', + 'color': '#2196F3', + 'sort_order': 33 + }, + { + 'id': 'bec_higher', + 'name': '商务英语高级(BEC Higher)', + 'description': 'BEC高级商务英语词汇', + 'category': '职业与专业类词汇', + 'level': 'advanced', + 'total_words': 5000, + 'icon': '📈', + 'color': '#4CAF50', + 'sort_order': 34 + }, + { + 'id': 'mba_finance', + 'name': 'MBA/金融词汇', + 'description': 'MBA、金融、会计、经济学专业词汇', + 'category': '职业与专业类词汇', + 'level': 'advanced', + 'total_words': 6000, + 'icon': '💰', + 'color': '#FF9800', + 'sort_order': 35 + }, + { + 'id': 'medical_english', + 'name': '医学英语词汇', + 'description': '医学专业英语词汇', + 'category': '职业与专业类词汇', + 'level': 'advanced', + 'total_words': 8000, + 'icon': '⚕️', + 'color': '#F44336', + 'sort_order': 36 + }, + { + 'id': 'legal_english', + 'name': '法律英语词汇', + 'description': '法律专业英语词汇', + 'category': '职业与专业类词汇', + 'level': 'advanced', + 'total_words': 5000, + 'icon': '⚖️', + 'color': '#9C27B0', + 'sort_order': 37 + }, + { + 'id': 'it_engineering', + 'name': '工程与IT英语', + 'description': '计算机科学、人工智能、软件工程词汇', + 'category': '职业与专业类词汇', + 'level': 'intermediate', + 'total_words': 4000, + 'icon': '💻', + 'color': '#3F51B5', + 'sort_order': 38 + }, + { + 'id': 'academic_english', + 'name': '学术英语(EAP)', + 'description': '学术英语写作/阅读/科研常用词汇', + 'category': '职业与专业类词汇', + 'level': 'advanced', + 'total_words': 6000, + 'icon': '🔬', + 'color': '#00BCD4', + 'sort_order': 39 + }, + + # 功能型词库 + { + 'id': 'word_roots_affixes', + 'name': '词根词缀词汇', + 'description': '帮助记忆与扩展的词根词缀词汇', + 'category': '功能型词库', + 'level': 'intermediate', + 'total_words': 3000, + 'icon': '🌱', + 'color': '#4CAF50', + 'sort_order': 41 + }, + { + 'id': 'synonyms_antonyms', + 'name': '同义词/反义词库', + 'description': '同义词、反义词、近义搭配库', + 'category': '功能型词库', + 'level': 'intermediate', + 'total_words': 2500, + 'icon': '🔄', + 'color': '#2196F3', + 'sort_order': 42 + }, + { + 'id': 'daily_spoken_collocations', + 'name': '日常口语搭配库', + 'description': '日常口语常用搭配库', + 'category': '功能型词库', + 'level': 'beginner', + 'total_words': 1500, + 'icon': '💬', + 'color': '#FF9800', + 'sort_order': 43 + }, + { + 'id': 'academic_spoken_collocations', + 'name': '学术口语搭配库', + 'description': '学术口语常用搭配库', + 'category': '功能型词库', + 'level': 'advanced', + 'total_words': 2000, + 'icon': '🎤', + 'color': '#9C27B0', + 'sort_order': 44 + }, + { + 'id': 'academic_writing_collocations', + 'name': '学术写作搭配库', + 'description': '学术写作常用搭配库(Collocations)', + 'category': '功能型词库', + 'level': 'advanced', + 'total_words': 2500, + 'icon': '✍️', + 'color': '#E91E63', + 'sort_order': 45 + }, + { + 'id': 'daily_life_english', + 'name': '日常生活英语', + 'description': '旅游、点餐、购物、出行、租房等日常生活英语', + 'category': '功能型词库', + 'level': 'beginner', + 'total_words': 2000, + 'icon': '🏠', + 'color': '#00BCD4', + 'sort_order': 46 + }, +] + +def main(): + try: + # 连接数据库 + conn = mysql.connector.connect(**db_config) + cursor = conn.cursor() + + print(f"📚 准备插入 {len(vocabulary_books)} 个词汇书...") + + # 插入SQL + insert_sql = """ + INSERT INTO ai_vocabulary_books + (id, name, description, category, level, total_words, icon, color, is_system, is_active, sort_order, created_at, updated_at) + VALUES (%s, %s, %s, %s, %s, %s, %s, %s, TRUE, TRUE, %s, %s, %s) + ON DUPLICATE KEY UPDATE + name = VALUES(name), + description = VALUES(description), + category = VALUES(category), + level = VALUES(level), + icon = VALUES(icon), + color = VALUES(color), + sort_order = VALUES(sort_order), + updated_at = VALUES(updated_at) + """ + + success_count = 0 + update_count = 0 + + for book in vocabulary_books: + now = datetime.now() + + # 检查是否已存在 + cursor.execute("SELECT id FROM ai_vocabulary_books WHERE id = %s", (book['id'],)) + exists = cursor.fetchone() + + cursor.execute(insert_sql, ( + book['id'], + book['name'], + book['description'], + book['category'], + book['level'], + book['total_words'], + book['icon'], + book['color'], + book['sort_order'], + now, + now + )) + + if exists: + update_count += 1 + print(f"🔄 更新词汇书: {book['name']} ({book['category']})") + else: + success_count += 1 + print(f"✅ 插入词汇书: {book['name']} ({book['category']})") + + conn.commit() + + print(f"\n🎉 完成!") + print(f"✅ 新增: {success_count} 个词汇书") + print(f"🔄 更新: {update_count} 个词汇书") + print(f"📊 总计: {success_count + update_count} 个词汇书") + + # 按分类统计 + cursor.execute(""" + SELECT category, COUNT(*) as count + FROM ai_vocabulary_books + WHERE is_system = TRUE AND is_active = TRUE + GROUP BY category + ORDER BY MIN(sort_order) + """) + + print(f"\n📋 分类统计:") + for row in cursor.fetchall(): + print(f" {row[0]}: {row[1]} 个词汇书") + + except mysql.connector.Error as err: + print(f"❌ 数据库错误: {err}") + import traceback + traceback.print_exc() + finally: + if cursor: + cursor.close() + if conn: + conn.close() + +if __name__ == '__main__': + main() diff --git a/data/insert_vocabulary_books.py b/data/insert_vocabulary_books.py new file mode 100644 index 0000000..30adc4f --- /dev/null +++ b/data/insert_vocabulary_books.py @@ -0,0 +1,165 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""插入词汇书数据""" + +import mysql.connector +from datetime import datetime + +# 数据库配置 +db_config = { + 'host': 'localhost', + 'port': 3306, + 'user': 'root', + 'password': 'JKjk20011115', + 'database': 'ai_english_learning', + 'charset': 'utf8mb4' +} + +# 词汇书数据 +vocabulary_books = [ + { + 'id': 'cet4_core_2500', + 'name': '大学英语四级核心词汇', + 'description': '涵盖CET-4考试核心词汇2500个', + 'category': 'CET-4核心词汇', + 'level': 'intermediate', + 'total_words': 2500, + 'icon': '📚', + 'color': '#4CAF50', + 'sort_order': 1 + }, + { + 'id': 'cet6_core_3000', + 'name': '大学英语六级核心词汇', + 'description': '涵盖CET-6考试核心词汇3000个', + 'category': 'CET-6核心词汇', + 'level': 'advanced', + 'total_words': 3000, + 'icon': '📖', + 'color': '#2196F3', + 'sort_order': 2 + }, + { + 'id': 'toefl_high_3500', + 'name': '托福高频词汇', + 'description': '托福考试高频词汇3500个', + 'category': 'TOEFL高频词汇', + 'level': 'advanced', + 'total_words': 3500, + 'icon': '🎓', + 'color': '#FF9800', + 'sort_order': 3 + }, + { + 'id': 'ielts_high_3500', + 'name': '雅思高频词汇', + 'description': '雅思考试高频词汇3500个', + 'category': 'IELTS高频词汇', + 'level': 'advanced', + 'total_words': 3500, + 'icon': '🌟', + 'color': '#9C27B0', + 'sort_order': 4 + }, + { + 'id': 'primary_core_1000', + 'name': '小学英语核心词汇', + 'description': '小学阶段必备核心词汇1000个', + 'category': '小学核心词汇', + 'level': 'beginner', + 'total_words': 1000, + 'icon': '🎈', + 'color': '#E91E63', + 'sort_order': 5 + }, + { + 'id': 'junior_core_1500', + 'name': '初中英语核心词汇', + 'description': '初中阶段必备核心词汇1500个', + 'category': '初中核心词汇', + 'level': 'elementary', + 'total_words': 1500, + 'icon': '📝', + 'color': '#00BCD4', + 'sort_order': 6 + }, + { + 'id': 'senior_core_3500', + 'name': '高中英语核心词汇', + 'description': '高中阶段必备核心词汇3500个', + 'category': '高中核心词汇', + 'level': 'intermediate', + 'total_words': 3500, + 'icon': '📕', + 'color': '#FF5722', + 'sort_order': 7 + }, + { + 'id': 'business_core_1000', + 'name': '商务英语核心词汇', + 'description': '商务场景常用核心词汇1000个', + 'category': '商务英语', + 'level': 'intermediate', + 'total_words': 1000, + 'icon': '💼', + 'color': '#607D8B', + 'sort_order': 8 + } +] + +def main(): + try: + # 连接数据库 + conn = mysql.connector.connect(**db_config) + cursor = conn.cursor() + + print("⏩ 跳过表创建，直接插入数据（表应该已由GORM自动创建）") + + # 插入词汇书数据 + insert_sql = """ + INSERT INTO `ai_vocabulary_books` + (`id`, `name`, `description`, `category`, `level`, `total_words`, `icon`, `color`, `is_system`, `is_active`, `sort_order`) + VALUES (%s, %s, %s, %s, %s, %s, %s, %s, TRUE, TRUE, %s) + ON DUPLICATE KEY UPDATE + `name` = VALUES(`name`), + `description` = VALUES(`description`), + `category` = VALUES(`category`), + `level` = VALUES(`level`), + `total_words` = VALUES(`total_words`), + `icon` = VALUES(`icon`), + `color` = VALUES(`color`), + `sort_order` = VALUES(`sort_order`) + """ + + for book in vocabulary_books: + cursor.execute(insert_sql, ( + book['id'], + book['name'], + book['description'], + book['category'], + book['level'], + book['total_words'], + book['icon'], + book['color'], + book['sort_order'] + )) + print(f"✅ 插入词汇书: {book['name']}") + + conn.commit() + print(f"\n🎉 成功插入 {len(vocabulary_books)} 个词汇书！") + + # 查询验证 + cursor.execute("SELECT COUNT(*) FROM ai_vocabulary_books") + count = cursor.fetchone()[0] + print(f"📊 当前数据库中共有 {count} 个词汇书") + + except mysql.connector.Error as err: + print(f"❌ 数据库错误: {err}") + finally: + if cursor: + cursor.close() + if conn: + conn.close() + +if __name__ == '__main__': + main() diff --git a/data/logo.png b/data/logo.png new file mode 100644 index 0000000..6faf2d5 Binary files /dev/null and b/data/logo.png differ diff --git a/go.work.sum b/go.work.sum new file mode 100644 index 0000000..0621857 --- /dev/null +++ b/go.work.sum @@ -0,0 +1,140 @@ +cloud.google.com/go v0.110.10 h1:LXy9GEO+timppncPIAZoOj3l58LIU9k+kn48AN7IO3Y= +cloud.google.com/go v0.110.10/go.mod h1:v1OoFqYxiBkUrruItNM3eT4lLByNjxmJSV/xDKJNnic= +cloud.google.com/go/compute v1.23.3 h1:6sVlXXBmbd7jNX0Ipq0trII3e4n1/MsADLK6a+aiVlk= +cloud.google.com/go/compute v1.23.3/go.mod h1:VCgBUoMnIVIR0CscqQiPJLAG25E3ZRZMzcFZeQ+h8CI= +cloud.google.com/go/compute/metadata v0.2.3 h1:mg4jlk7mCAj6xXp9UJ4fjI9VUI5rubuGBW5aJ7UnBMY= +cloud.google.com/go/compute/metadata v0.2.3/go.mod h1:VAV5nSsACxMJvgaAuX6Pk2AawlZn8kiOGuCv6gTkwuA= +cloud.google.com/go/firestore v1.14.0 h1:8aLcKnMPoldYU3YHgu4t2exrKhLQkqaXAGqT0ljrFVw= +cloud.google.com/go/firestore v1.14.0/go.mod h1:96MVaHLsEhbvkBEdZgfN+AS/GIkco1LRpH9Xp9YZfzQ= +cloud.google.com/go/iam v1.1.5 h1:1jTsCu4bcsNsE4iiqNT5SHwrDRCfRmIaaaVFhRveTJI= +cloud.google.com/go/iam v1.1.5/go.mod h1:rB6P/Ic3mykPbFio+vo7403drjlgvoWfYpJhMXEbzv8= +cloud.google.com/go/longrunning v0.5.4 h1:w8xEcbZodnA2BbW6sVirkkoC+1gP8wS57EUUgGS0GVg= +cloud.google.com/go/longrunning v0.5.4/go.mod h1:zqNVncI0BOP8ST6XQD1+VcvuShMmq7+xFSzOL++V0dI= +cloud.google.com/go/storage v1.35.1 h1:B59ahL//eDfx2IIKFBeT5Atm9wnNmj3+8xG/W4WB//w= +cloud.google.com/go/storage v1.35.1/go.mod h1:M6M/3V/D3KpzMTJyPOR/HU6n2Si5QdaXYEsng2xgOs8= +github.com/armon/go-metrics v0.4.1 h1:hR91U9KYmb6bLBYLQjyM+3j+rcd/UhE+G78SFnF8gJA= +github.com/armon/go-metrics v0.4.1/go.mod h1:E6amYzXo6aW1tqzoZGT755KkbgrJsSdpwZ+3JqfkOG4= +github.com/coreos/go-semver v0.3.0 h1:wkHLiw0WNATZnSG7epLsujiMCgPAc9xhjJ4tgnAxmfM= +github.com/coreos/go-semver v0.3.0/go.mod h1:nnelYz7RCh+5ahJtPPxZlU+153eP4D4r3EedlOD2RNk= +github.com/coreos/go-systemd/v22 v22.3.2 h1:D9/bQk5vlXQFZ6Kwuu6zaiXJ9oTPe68++AzAJc1DzSI= +github.com/coreos/go-systemd/v22 v22.3.2/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= +github.com/fatih/color v1.14.1 h1:qfhVLaG5s+nCROl1zJsZRxFeYrHLqWroPOQ8BWiNb4w= +github.com/fatih/color v1.14.1/go.mod h1:2oHN61fhTpgcxD3TSWCgKDiH1+x4OiDVVGH8WlgGZGg= +github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q= +github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q= +github.com/golang-jwt/jwt/v5 v5.2.0/go.mod h1:pqrtFR0X4osieyHYxtmOUWsAWrfe1Q5UVIyoH402zdk= +github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da h1:oI5xCqsCo564l8iNU+DwB5epxmsaqB+rhGL0m5jtYqE= +github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= +github.com/golang/protobuf v1.5.0 h1:LUVKkCeviFUMKqHa4tXIIij/lbhnMbP7Fn5wKdKkRh4= +github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk= +github.com/golang/protobuf v1.5.3 h1:KhyjKVUg7Usr/dYsdSqoFveMYd5ko72D+zANwlG1mmg= +github.com/golang/protobuf v1.5.3/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY= +github.com/google/gofuzz v1.0.0 h1:A8PeW59pxE9IoFRqBp37U+mSNaQoZ46F1f0f863XSXw= +github.com/google/s2a-go v0.1.7 h1:60BLSyTrOV4/haCDW4zb1guZItoSq8foHCXrAnjBo/o= +github.com/google/s2a-go v0.1.7/go.mod h1:50CgR4k1jNlWBu4UfS4AcfhVe1r6pdZPygJ3R8F0Qdw= +github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/googleapis/enterprise-certificate-proxy v0.3.2 h1:Vie5ybvEvT75RniqhfFxPRy3Bf7vr3h0cechB90XaQs= +github.com/googleapis/enterprise-certificate-proxy v0.3.2/go.mod h1:VLSiSSBs/ksPL8kq3OBOQ6WRI2QnaFynd1DCjZ62+V0= +github.com/googleapis/gax-go/v2 v2.12.0 h1:A+gCJKdRfqXkr+BIRGtZLibNXf0m1f9E4HG56etFpas= +github.com/googleapis/gax-go/v2 v2.12.0/go.mod h1:y+aIqrI5eb1YGMVJfuV3185Ts/D7qKpsEkdD5+I6QGU= +github.com/googleapis/google-cloud-go-testing v0.0.0-20210719221736-1c9a4c676720 h1:zC34cGQu69FG7qzJ3WiKW244WfhDC3xxYMeNOX2gtUQ= +github.com/googleapis/google-cloud-go-testing v0.0.0-20210719221736-1c9a4c676720/go.mod h1:dvDLG8qkwmyD9a/MJJN3XJcT3xFxOKAvTZGvuZmac9g= +github.com/hashicorp/consul/api v1.25.1 h1:CqrdhYzc8XZuPnhIYZWH45toM0LB9ZeYr/gvpLVI3PE= +github.com/hashicorp/consul/api v1.25.1/go.mod h1:iiLVwR/htV7mas/sy0O+XSuEnrdBUUydemjxcUrAt4g= +github.com/hashicorp/go-cleanhttp v0.5.2 h1:035FKYIWjmULyFRBKPs8TBQoi0x6d9G4xc9neXJWAZQ= +github.com/hashicorp/go-cleanhttp v0.5.2/go.mod h1:kO/YDlP8L1346E6Sodw+PrpBSV4/SoxCXGY6BqNFT48= +github.com/hashicorp/go-hclog v1.5.0 h1:bI2ocEMgcVlz55Oj1xZNBsVi900c7II+fWDyV9o+13c= +github.com/hashicorp/go-hclog v1.5.0/go.mod h1:W4Qnvbt70Wk/zYJryRzDRU/4r0kIg0PVHBcfoyhpF5M= +github.com/hashicorp/go-immutable-radix v1.3.1 h1:DKHmCUm2hRBK510BaiZlwvpD40f8bJFeZnpfm2KLowc= +github.com/hashicorp/go-immutable-radix v1.3.1/go.mod h1:0y9vanUI8NX6FsYoO3zeMjhV/C5i9g4Q3DwcSNZ4P60= +github.com/hashicorp/go-rootcerts v1.0.2 h1:jzhAVGtqPKbwpyCPELlgNWhE1znq+qwJtW5Oi2viEzc= +github.com/hashicorp/go-rootcerts v1.0.2/go.mod h1:pqUvnprVnM5bf7AOirdbb01K4ccR319Vf4pU3K5EGc8= +github.com/hashicorp/golang-lru v0.5.4 h1:YDjusn29QI/Das2iO9M0BHnIbxPeyuCHsjMW+lJfyTc= +github.com/hashicorp/golang-lru v0.5.4/go.mod h1:iADmTwqILo4mZ8BN3D2Q6+9jd8WM5uGBxy+E8yxSoD4= +github.com/hashicorp/serf v0.10.1 h1:Z1H2J60yRKvfDYAOZLd2MU0ND4AH/WDz7xYHDWQsIPY= +github.com/hashicorp/serf v0.10.1/go.mod h1:yL2t6BqATOLGc5HF7qbFkTfXoPIY0WZdWHfEvMqbG+4= +github.com/klauspost/compress v1.17.0 h1:Rnbp4K9EjcDuVuHtd0dgA4qNuv9yKDYKK1ulpJwgrqM= +github.com/klauspost/compress v1.17.0/go.mod h1:ntbaceVETuRiXiv4DpjP66DpAtAGkEQskQzEyD//IeE= +github.com/knz/go-libedit v1.10.1 h1:0pHpWtx9vcvC0xGZqEQlQdfSQs7WRlAjuPvk3fOZDCo= +github.com/kr/fs v0.1.0 h1:Jskdu9ieNAYnjxsi0LbQp1ulIKZV1LAFgK1tWhpZgl8= +github.com/kr/fs v0.1.0/go.mod h1:FFnZGqtBN9Gxj7eW1uZ42v5BccTP0vu6NEaFoC2HwRg= +github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA= +github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg= +github.com/mitchellh/go-homedir v1.1.0 h1:lukF9ziXFxDFPkA1vsr5zpc1XuPDn/wFntq5mG+4E0Y= +github.com/mitchellh/go-homedir v1.1.0/go.mod h1:SfyaCUpYCn1Vlf4IUYiD9fPX4A5wJrkLzIz1N1q0pr0= +github.com/nats-io/nats.go v1.31.0 h1:/WFBHEc/dOKBF6qf1TZhrdEfTmOZ5JzdJ+Y3m6Y/p7E= +github.com/nats-io/nats.go v1.31.0/go.mod h1:di3Bm5MLsoB4Bx61CBTsxuarI36WbhAwOm8QrW39+i8= +github.com/nats-io/nkeys v0.4.6 h1:IzVe95ru2CT6ta874rt9saQRkWfe2nFj1NtvYSLqMzY= +github.com/nats-io/nkeys v0.4.6/go.mod h1:4DxZNzenSVd1cYQoAa8948QY3QDjrHfcfVADymtkpts= +github.com/nats-io/nuid v1.0.1 h1:5iA8DT8V7q8WK2EScv2padNa/rTESc1KdnPw4TC2paw= +github.com/nats-io/nuid v1.0.1/go.mod h1:19wcPz3Ph3q0Jbyiqsd0kePYG7A95tJPxeL+1OSON2c= +github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4= +github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= +github.com/pkg/sftp v1.13.6 h1:JFZT4XbOU7l77xGSpOdW+pwIMqP044IyjXX6FGyEKFo= +github.com/pkg/sftp v1.13.6/go.mod h1:tz1ryNURKu77RL+GuCzmoJYxQczL3wLNNpPWagdg4Qk= +github.com/sagikazarmark/crypt v0.17.0 h1:ZA/7pXyjkHoK4bW4mIdnCLvL8hd+Nrbiw7Dqk7D4qUk= +github.com/sagikazarmark/crypt v0.17.0/go.mod h1:SMtHTvdmsZMuY/bpZoqokSoChIrcJ/epOxZN58PbZDg= +github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY= +github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY= +go.etcd.io/etcd/api/v3 v3.5.10 h1:szRajuUUbLyppkhs9K6BRtjY37l66XQQmw7oZRANE4k= +go.etcd.io/etcd/api/v3 v3.5.10/go.mod h1:TidfmT4Uycad3NM/o25fG3J07odo4GBB9hoxaodFCtI= +go.etcd.io/etcd/client/pkg/v3 v3.5.10 h1:kfYIdQftBnbAq8pUWFXfpuuxFSKzlmM5cSn76JByiT0= +go.etcd.io/etcd/client/pkg/v3 v3.5.10/go.mod h1:DYivfIviIuQ8+/lCq4vcxuseg2P2XbHygkKwFo9fc8U= +go.etcd.io/etcd/client/v2 v2.305.10 h1:MrmRktzv/XF8CvtQt+P6wLUlURaNpSDJHFZhe//2QE4= +go.etcd.io/etcd/client/v2 v2.305.10/go.mod h1:m3CKZi69HzilhVqtPDcjhSGp+kA1OmbNn0qamH80xjA= +go.etcd.io/etcd/client/v3 v3.5.10 h1:W9TXNZ+oB3MCd/8UjxHTWK5J9Nquw9fQBLJd5ne5/Ao= +go.etcd.io/etcd/client/v3 v3.5.10/go.mod h1:RVeBnDz2PUEZqTpgqwAtUd8nAPf5kjyFyND7P1VkOKc= +go.opencensus.io v0.24.0 h1:y73uSU6J157QMP2kn2r30vwW1A2W2WFwSCGnAVxeaD0= +go.opencensus.io v0.24.0/go.mod h1:vNK8G9p7aAivkbmorf4v+7Hgx+Zs0yY+0fOtgBfjQKo= +go.uber.org/zap v1.21.0 h1:WefMeulhovoZ2sYXz7st6K0sLj7bBhpiFaud4r4zST8= +go.uber.org/zap v1.21.0/go.mod h1:wjWOCqI0f2ZZrJF/UufIOkiC8ii6tm1iqIsLo76RfJw= +golang.org/x/crypto v0.17.0/go.mod h1:gCAAfMLgwOJRpTjQ2zCCt2OcSfYMTeZVSRtQlPC7Nq4= +golang.org/x/crypto v0.40.0 h1:r4x+VvoG5Fm+eJcxMaY8CQM7Lb0l1lsmjGBQ6s8BfKM= +golang.org/x/crypto v0.40.0/go.mod h1:Qr1vMER5WyS2dfPHAlsOj01wgLbsyWtFn/aY+5+ZdxY= +golang.org/x/mod v0.8.0 h1:LUYupSeNrTNCGzR/hVBk2NHZO4hXcVaW1k4Qx7rjPx8= +golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= +golang.org/x/mod v0.12.0 h1:rmsUpXtvNzj340zd98LZ4KntptpfRHwpFOHG188oHXc= +golang.org/x/mod v0.12.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= +golang.org/x/mod v0.26.0/go.mod h1:/j6NAhSk8iQ723BGAUyoAcn7SlD7s15Dp9Nd/SfeaFQ= +golang.org/x/net v0.15.0/go.mod h1:idbUs1IY1+zTqbi8yxTbhexhEEk5ur9LInksu6HrEpk= +golang.org/x/net v0.17.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE= +golang.org/x/net v0.21.0/go.mod h1:bIjVDfnllIU7BJ2DNgfnXvpSvtn8VRwhlsaeUTyUS44= +golang.org/x/net v0.41.0/go.mod h1:B/K4NNqkfmg07DQYrbwvSluqCJOOXwUjeb/5lOisjbA= +golang.org/x/oauth2 v0.15.0 h1:s8pnnxNVzjWyrvYdFUQq5llS1PX2zhPXmccZv99h7uQ= +golang.org/x/oauth2 v0.15.0/go.mod h1:q48ptWNTY5XWf+JNten23lcvHpLJ0ZSxF5ttTHKVCAM= +golang.org/x/sync v0.3.0/go.mod h1:FU7BRWz2tNW+3quACPkgCx/L+uEAv1htQ0V83Z9Rj+Y= +golang.org/x/sync v0.5.0 h1:60k92dhOjHxJkrqnwsfl8KuaHbn/5dl0lUPUklKo3qE= +golang.org/x/sync v0.5.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk= +golang.org/x/sync v0.16.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA= +golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.13.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.34.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= +golang.org/x/term v0.20.0 h1:VnkxpohqXaOBYJtBmEppKUG6mXpi+4O6purfc2+sMhw= +golang.org/x/term v0.20.0/go.mod h1:8UkIAJTvZgivsXaD6/pH6U9ecQzZ45awqEOzuCvwpFY= +golang.org/x/term v0.33.0/go.mod h1:s18+ql9tYWp1IfpV9DmCtQDDSRBUjKaw9M1eAv5UeF0= +golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU= +golang.org/x/text v0.27.0/go.mod h1:1D28KMCvyooCX9hBiosv5Tz/+YLxj0j7XhWjpSUF7CU= +golang.org/x/time v0.5.0 h1:o7cqy6amK/52YcAKIPlM3a+Fpj35zvRj2TP+e1xFSfk= +golang.org/x/time v0.5.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM= +golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc= +golang.org/x/tools v0.6.0 h1:BOw41kyTf3PuCW1pVQf8+Cyg8pMlkYB1oo9iJ6D/lKM= +golang.org/x/tools v0.6.0/go.mod h1:Xwgl3UAJ/d3gWutnCtw505GrjyAbvKui8lOU390QaIU= +golang.org/x/tools v0.13.0 h1:Iey4qkscZuv0VvIt8E0neZjtPVQFSc870HQ448QgEmQ= +golang.org/x/tools v0.13.0/go.mod h1:HvlwmtVNQAhOuCjW7xxvovg8wbNq7LwfXh/k7wXUl58= +golang.org/x/tools v0.35.0/go.mod h1:NKdj5HkL/73byiZSJjqJgKn3ep7KjFkBOkR/Hps3VPw= +golang.org/x/xerrors v0.0.0-20220907171357-04be3eba64a2 h1:H2TDz8ibqkAF6YGhCdN3jS9O0/s90v0rJh3X/OLHEUk= +golang.org/x/xerrors v0.0.0-20220907171357-04be3eba64a2/go.mod h1:K8+ghG5WaK9qNqU5K3HdILfMLy1f3aNYFI/wnl100a8= +google.golang.org/api v0.153.0 h1:N1AwGhielyKFaUqH07/ZSIQR3uNPcV7NVw0vj+j4iR4= +google.golang.org/api v0.153.0/go.mod h1:3qNJX5eOmhiWYc67jRA/3GsDw97UFb5ivv7Y2PrriAY= +google.golang.org/appengine v1.6.7 h1:FZR1q0exgwxzPzp/aF+VccGrSfxfPpkBqjIIEq3ru6c= +google.golang.org/appengine v1.6.7/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc= +google.golang.org/genproto v0.0.0-20231106174013-bbf56f31fb17 h1:wpZ8pe2x1Q3f2KyT5f8oP/fa9rHAKgFPr/HZdNuS+PQ= +google.golang.org/genproto v0.0.0-20231106174013-bbf56f31fb17/go.mod h1:J7XzRzVy1+IPwWHZUzoD0IccYZIrXILAQpc+Qy9CMhY= +google.golang.org/genproto/googleapis/api v0.0.0-20231106174013-bbf56f31fb17 h1:JpwMPBpFN3uKhdaekDpiNlImDdkUAyiJ6ez/uxGaUSo= +google.golang.org/genproto/googleapis/api v0.0.0-20231106174013-bbf56f31fb17/go.mod h1:0xJLfVdJqpAPl8tDg1ujOCGzx6LFLttXT5NhllGOXY4= +google.golang.org/genproto/googleapis/rpc v0.0.0-20231120223509-83a465c0220f h1:ultW7fxlIvee4HYrtnaRPon9HpEgFk5zYpmfMgtKB5I= +google.golang.org/genproto/googleapis/rpc v0.0.0-20231120223509-83a465c0220f/go.mod h1:L9KNLi232K1/xB6f7AlSX692koaRnKaWSR0stBki0Yc= +google.golang.org/grpc v1.59.0 h1:Z5Iec2pjwb+LEOqzpB2MR12/eKFhDPhuqW91O+4bwUk= +google.golang.org/grpc v1.59.0/go.mod h1:aUPDwccQo6OTjy7Hct4AfBPD1GptF4fyUjIkQ9YtF98= +nullprogram.com/x/optparse v1.0.0 h1:xGFgVi5ZaWOnYdac2foDT3vg0ZZC9ErXFV57mr4OHrI= +rsc.io/pdf v0.1.1 h1:k1MczvYDUvJBe93bYd7wrZLLUEcLZAuF824/I4e5Xr4= diff --git a/import_cet4_words.py b/import_cet4_words.py new file mode 100644 index 0000000..43b09cc --- /dev/null +++ b/import_cet4_words.py @@ -0,0 +1,266 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""导入大学英语四级核心词汇到数据库""" + +import pandas as pd +import mysql.connector +from datetime import datetime +import json + +# 数据库配置 +db_config = { + 'host': 'localhost', + 'port': 3306, + 'user': 'root', + 'password': 'JKjk20011115', + 'database': 'ai_english_learning', + 'charset': 'utf8mb4' +} + +# 词汇书ID +BOOK_ID = 'cet4_core_2500' + +def clean_text(text): + """清理文本，处理nan和空值""" + if pd.isna(text) or str(text).strip() == '' or str(text).strip() == 'nan': + return None + return str(text).strip() + +def extract_part_of_speech(translation): + """从中文翻译中提取词性""" + if not translation: + return 'noun' + + pos_map = { + 'v.': 'verb', + 'n.': 'noun', + 'adj.': 'adjective', + 'adv.': 'adverb', + 'prep.': 'preposition', + 'conj.': 'conjunction', + 'pron.': 'pronoun', + 'interj.': 'interjection' + } + + for abbr, full in pos_map.items(): + if abbr in translation or abbr.replace('.', '') in translation: + return full + + # 中文词性判断 + if '动' in translation: + return 'verb' + elif '形' in translation or '容' in translation: + return 'adjective' + elif '副' in translation: + return 'adverb' + elif '介' in translation: + return 'preposition' + elif '连' in translation: + return 'conjunction' + + return 'noun' + +def import_words_from_excel(file_path): + """从Excel导入单词""" + try: + print(f"📖 正在读取文件: {file_path}") + df = pd.read_excel(file_path) + + print(f"📊 文件列名: {df.columns.tolist()}") + print(f"📊 总行数: {len(df)}") + + conn = mysql.connector.connect(**db_config) + cursor = conn.cursor() + + # 清理旧数据 + print("\n清理旧数据...") + cursor.execute("DELETE FROM ai_vocabulary_book_words WHERE book_id = %s", (BOOK_ID,)) + cursor.execute(""" + DELETE v FROM ai_vocabulary v + LEFT JOIN ai_vocabulary_book_words bw ON bw.vocabulary_id = v.id + WHERE bw.id IS NULL + """) + conn.commit() + + # SQL语句 + insert_vocab_sql = """ + INSERT INTO ai_vocabulary + (word, phonetic_us, phonetic_uk, phonetic, level, frequency, is_active, + word_root, synonyms, antonyms, derivatives, collocations, created_at, updated_at) + VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s) + """ + + insert_definition_sql = """ + INSERT INTO ai_vocabulary_definitions + (vocabulary_id, part_of_speech, definition_en, definition_cn, sort_order, created_at) + VALUES (%s, %s, %s, %s, %s, %s) + """ + + insert_example_sql = """ + INSERT INTO ai_vocabulary_examples + (vocabulary_id, sentence_en, sentence_cn, sort_order, created_at) + VALUES (%s, %s, %s, %s, %s) + """ + + insert_book_word_sql = """ + INSERT INTO ai_vocabulary_book_words + (book_id, vocabulary_id, sort_order, created_at) + VALUES (%s, %s, %s, %s) + """ + + success_count = 0 + error_count = 0 + + for index, row in df.iterrows(): + try: + # 尝试多个可能的列名 + word = clean_text(row.get('Word') or row.get('单词(Word)') or row.get('单词')) + if not word: + continue + + # 检查单词是否已存在 + cursor.execute("SELECT id FROM ai_vocabulary WHERE word = %s", (word,)) + existing = cursor.fetchone() + + if existing: + # 单词已存在，使用现有ID + vocab_id = existing[0] + else: + # 单词不存在，插入新记录 + # 音标 + phonetic_us = clean_text(row.get('美式音标')) + phonetic_uk = clean_text(row.get('英式音标')) + phonetic = phonetic_us or phonetic_uk + + # 释义 + translation_cn = clean_text(row.get('中文含义')) + translation_en = clean_text(row.get('英文翻译（对应中文含义）') or row.get('英文翻译')) + + if not translation_cn: + print(f"⚠️ 跳过 {word}：缺少中文含义") + continue + + if not translation_en: + translation_en = word + + part_of_speech = extract_part_of_speech(translation_cn) + + # 例句 + example_en = clean_text(row.get('例句')) + example_cn = clean_text(row.get('例句中文翻译')) + + # 词根 + word_root = clean_text(row.get('词根') or row.get('词根/词源')) + + # 同义词 + synonyms_text = clean_text(row.get('同义词（含义）')) + synonyms_json = '[]' + if synonyms_text: + syn_list = [syn.strip() for syn in synonyms_text.split('；') if syn.strip()] + synonyms_json = json.dumps(syn_list, ensure_ascii=False) + + # 反义词 + antonyms_text = clean_text(row.get('反义词（含义）')) + antonyms_json = '[]' + if antonyms_text: + ant_list = [ant.strip() for ant in antonyms_text.split('；') if ant.strip()] + antonyms_json = json.dumps(ant_list, ensure_ascii=False) + + # 派生词 + derivatives_text = clean_text(row.get('派生词（含义）')) + derivatives_json = '[]' + if derivatives_text: + der_list = [der.strip() for der in derivatives_text.split('；') if der.strip()] + derivatives_json = json.dumps(der_list, ensure_ascii=False) + + # 词组搭配 + phrases_text = clean_text(row.get('词组搭配（中文含义）')) + collocations_json = '[]' + if phrases_text: + col_list = [phrase.strip() for phrase in phrases_text.split('；') if phrase.strip()] + collocations_json = json.dumps(col_list, ensure_ascii=False) + + # 插入词汇 + now = datetime.now() + cursor.execute(insert_vocab_sql, ( + word, phonetic_us, phonetic_uk, phonetic, + 'intermediate', # CET-4难度 + index + 1, True, + word_root, synonyms_json, antonyms_json, + derivatives_json, collocations_json, + now, now + )) + + vocab_id = cursor.lastrowid + + # 插入释义 + cursor.execute(insert_definition_sql, ( + vocab_id, part_of_speech, translation_en, + translation_cn, 0, now + )) + + # 插入例句 + if example_en and example_cn: + examples_en = example_en.split('；') + examples_cn = example_cn.split('；') + + for i, (ex_en, ex_cn) in enumerate(zip(examples_en, examples_cn)): + ex_en = ex_en.strip() + ex_cn = ex_cn.strip() + if ex_en and ex_cn: + cursor.execute(insert_example_sql, ( + vocab_id, ex_en, ex_cn, i, now + )) + + # 关联到词汇书（无论单词是否已存在，都要关联） + now = datetime.now() + try: + cursor.execute(insert_book_word_sql, ( + BOOK_ID, vocab_id, index, now + )) + except Exception as link_error: + # 如果关联已存在，跳过 + if '1062' not in str(link_error): # 不是重复键错误 + raise + + success_count += 1 + if success_count % 100 == 0: + print(f"✅ 已处理 {success_count} 个单词...") + conn.commit() + + except Exception as e: + error_count += 1 + print(f"❌ 导入第 {index + 1} 行失败: {e}") + + conn.commit() + + # 更新词汇书总数 + cursor.execute( + "UPDATE ai_vocabulary_books SET total_words = %s WHERE id = %s", + (success_count, BOOK_ID) + ) + conn.commit() + + print(f"\n🎉 大学英语四级核心词汇导入完成!") + print(f"✅ 成功: {success_count} 个单词") + print(f"❌ 失败: {error_count} 个单词") + + # 验证 + cursor.execute( + "SELECT COUNT(*) FROM ai_vocabulary_book_words WHERE book_id = %s", + (BOOK_ID,) + ) + print(f"📊 词汇书中共有 {cursor.fetchone()[0]} 个单词") + + except Exception as e: + print(f"❌ 导入失败: {e}") + import traceback + traceback.print_exc() + finally: + if 'cursor' in locals(): + cursor.close() + if 'conn' in locals(): + conn.close() + +if __name__ == '__main__': + import_words_from_excel('data/大学英语四级核心词汇.xlsx') diff --git a/serve/.dockerignore b/serve/.dockerignore new file mode 100644 index 0000000..44a9a27 --- /dev/null +++ b/serve/.dockerignore @@ -0,0 +1,57 @@ +# Git相关 +.git +.gitignore + +# 构建产物 +main +*.exe +*.dll +*.so +*.dylib + +# 测试文件 +*_test.go +test/ +tests/ + +# 文档 +*.md +README* +DOCS* +docs/ + +# 日志文件 +logs/ +*.log + +# 临时文件 +tmp/ +temp/ +*.tmp +*.temp + +# IDE文件 +.vscode/ +.idea/ +*.swp +*.swo +*~ + +# 操作系统文件 +.DS_Store +Thumbs.db + +# 环境文件 +.env +.env.local +.env.*.local + +# 上传文件 +uploads/ + +# 依赖缓存 +vendor/ + +# 其他 +*.bak +*.backup \ No newline at end of file diff --git a/serve/Dockerfile b/serve/Dockerfile new file mode 100644 index 0000000..7aa078f --- /dev/null +++ b/serve/Dockerfile @@ -0,0 +1,58 @@ +# 使用官方Go镜像作为构建环境 +FROM golang:1.19-alpine AS builder + +# 设置工作目录 +WORKDIR /app + +# 安装必要的包 +RUN apk add --no-cache git ca-certificates tzdata + +# 复制go mod文件 +COPY go.mod go.sum ./ + +# 下载依赖 +RUN go mod download + +# 复制源代码 +COPY . . + +# 构建应用 +RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main . + +# 使用轻量级的alpine镜像作为运行环境 +FROM alpine:latest + +# 安装ca-certificates和tzdata +RUN apk --no-cache add ca-certificates tzdata + +# 设置时区 +RUN cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo "Asia/Shanghai" > /etc/timezone + +# 创建非root用户 +RUN addgroup -g 1001 -S appgroup && \ + adduser -u 1001 -S appuser -G appgroup + +# 设置工作目录 +WORKDIR /root/ + +# 从构建阶段复制二进制文件 +COPY --from=builder /app/main . + +# 复制配置文件 +COPY --from=builder /app/config/config.yaml ./config/ + +# 创建日志目录 +RUN mkdir -p /root/logs && chown -R appuser:appgroup /root + +# 切换到非root用户 +USER appuser + +# 暴露端口 +EXPOSE 8080 + +# 健康检查 +HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \ + CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1 + +# 运行应用 +CMD ["./main"] \ No newline at end of file diff --git a/serve/api/handlers/auth_handler.go b/serve/api/handlers/auth_handler.go new file mode 100644 index 0000000..72a9d5e --- /dev/null +++ b/serve/api/handlers/auth_handler.go @@ -0,0 +1,357 @@ +package handlers + +import ( + "net/http" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/middleware" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" + "github.com/gin-gonic/gin" + "github.com/go-playground/validator/v10" +) + +type AuthHandler struct { + userService *services.UserService + validator *validator.Validate +} + +func NewAuthHandler(userService *services.UserService) *AuthHandler { + return &AuthHandler{ + userService: userService, + validator: validator.New(), + } +} + +// RegisterRequest 注册请求结构 +type RegisterRequest struct { + Username string `json:"username" validate:"required,min=3,max=20"` + Email string `json:"email" validate:"required,email"` + Password string `json:"password" validate:"required,min=6"` + Nickname string `json:"nickname" validate:"required,min=1,max=50"` +} + +// LoginRequest 登录请求结构 +type LoginRequest struct { + Account string `json:"account" validate:"required"` // 用户名或邮箱 + Password string `json:"password" validate:"required"` +} + +// RefreshTokenRequest 刷新令牌请求结构 +type RefreshTokenRequest struct { + RefreshToken string `json:"refresh_token" validate:"required"` +} + +// ChangePasswordRequest 修改密码请求结构 +type ChangePasswordRequest struct { + OldPassword string `json:"old_password" validate:"required"` + NewPassword string `json:"new_password" validate:"required,min=6"` +} + +// AuthResponse 认证响应结构 +type AuthResponse struct { + User *UserInfo `json:"user"` + AccessToken string `json:"access_token"` + RefreshToken string `json:"refresh_token"` + ExpiresIn int64 `json:"expires_in"` +} + +// UserInfo 用户信息结构 +type UserInfo struct { + ID int64 `json:"id"` + Username string `json:"username"` + Email string `json:"email"` + Nickname string `json:"nickname"` + Avatar string `json:"avatar"` + Level string `json:"level"` + Status string `json:"status"` +} + +// Register 用户注册 +func (h *AuthHandler) Register(c *gin.Context) { + var req RegisterRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 验证请求参数 + if err := h.validator.Struct(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 验证邮箱格式 + if !utils.IsValidEmail(req.Email) { + common.BadRequestResponse(c, "邮箱格式不正确") + return + } + + // 验证密码强度 + if !utils.IsStrongPassword(req.Password) { + common.BadRequestResponse(c, "密码强度不足，至少8位且包含大小写字母、数字和特殊字符") + return + } + + // 创建用户 + user, err := h.userService.CreateUser(req.Username, req.Email, req.Password) + if err != nil { + if businessErr, ok := err.(*common.BusinessError); ok { + common.ErrorResponse(c, http.StatusBadRequest, businessErr.Message) + return + } + common.InternalServerErrorResponse(c, "用户创建失败") + return + } + + // 生成令牌 + accessToken, refreshToken, err := middleware.GenerateTokens(user.ID, user.Username, user.Email) + if err != nil { + common.InternalServerErrorResponse(c, "令牌生成失败") + return + } + + // 更新用户登录信息 + h.userService.UpdateLoginInfo(user.ID, utils.GetClientIP(c)) + + // 构造响应 + nickname := "" + if user.Nickname != nil { + nickname = *user.Nickname + } + avatar := "" + if user.Avatar != nil { + avatar = *user.Avatar + } + + userInfo := &UserInfo{ + ID: user.ID, + Username: user.Username, + Email: user.Email, + Nickname: nickname, + Avatar: avatar, + Level: "beginner", + Status: user.Status, + } + + response := &AuthResponse{ + User: userInfo, + AccessToken: accessToken, + RefreshToken: refreshToken, + ExpiresIn: 7200, // 2小时 + } + + common.SuccessResponse(c, response) +} + +// Login 用户登录 +func (h *AuthHandler) Login(c *gin.Context) { + var req LoginRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 验证请求参数 + if err := h.validator.Struct(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 根据账号类型获取用户 + var user *models.User + var err error + + if utils.IsValidEmail(req.Account) { + user, err = h.userService.GetUserByEmail(req.Account) + } else { + user, err = h.userService.GetUserByUsername(req.Account) + } + + if err != nil { + if businessErr, ok := err.(*common.BusinessError); ok { + common.ErrorResponse(c, http.StatusBadRequest, businessErr.Message) + return + } + common.InternalServerErrorResponse(c, "用户查询失败") + return + } + + // 验证密码 + if !utils.CheckPasswordHash(req.Password, user.PasswordHash) { + common.BadRequestResponse(c, "密码错误") + return + } + + // 检查用户状态 + if user.Status != "active" { + common.BadRequestResponse(c, "用户已被禁用") + return + } + + // 生成令牌 + accessToken, refreshToken, err := middleware.GenerateTokens(user.ID, user.Username, user.Email) + if err != nil { + common.InternalServerErrorResponse(c, "令牌生成失败") + return + } + + // 更新用户登录信息 + h.userService.UpdateLoginInfo(user.ID, utils.GetClientIP(c)) + + // 构造响应 + nickname := "" + if user.Nickname != nil { + nickname = *user.Nickname + } + avatar := "" + if user.Avatar != nil { + avatar = *user.Avatar + } + + userInfo := &UserInfo{ + ID: user.ID, + Username: user.Username, + Email: user.Email, + Nickname: nickname, + Avatar: avatar, + Level: "beginner", + Status: user.Status, + } + + response := &AuthResponse{ + User: userInfo, + AccessToken: accessToken, + RefreshToken: refreshToken, + ExpiresIn: 7200, // 2小时 + } + + common.SuccessResponse(c, response) +} + +// RefreshToken 刷新访问令牌 +func (h *AuthHandler) RefreshToken(c *gin.Context) { + var req RefreshTokenRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 验证刷新令牌 + claims, err := middleware.ParseToken(req.RefreshToken) + if err != nil { + common.BadRequestResponse(c, "无效的刷新令牌") + return + } + + // 检查令牌类型 + if claims.Type != "refresh" { + common.BadRequestResponse(c, "令牌类型错误") + return + } + + // 生成新的令牌 + accessToken, newRefreshToken, err := middleware.GenerateTokens(claims.UserID, claims.Username, claims.Email) + if err != nil { + common.InternalServerErrorResponse(c, "令牌生成失败") + return + } + + response := map[string]interface{}{ + "access_token": accessToken, + "refresh_token": newRefreshToken, + "expires_in": 7200, + } + + common.SuccessResponse(c, response) +} + +// Logout 用户登出 +func (h *AuthHandler) Logout(c *gin.Context) { + // 这里可以实现令牌黑名单机制 + // 目前简单返回成功 + common.SuccessResponse(c, map[string]string{"message": "登出成功"}) +} + +// GetProfile 获取用户资料 +func (h *AuthHandler) GetProfile(c *gin.Context) { + // 获取当前用户ID + userID, exists := utils.GetUserIDFromContext(c) + if !exists { + common.BadRequestResponse(c, "请先登录") + return + } + + user, err := h.userService.GetUserByID(userID) + if err != nil { + if businessErr, ok := err.(*common.BusinessError); ok { + common.ErrorResponse(c, http.StatusBadRequest, businessErr.Message) + return + } + common.InternalServerErrorResponse(c, "用户查询失败") + return + } + + nickname := "" + if user.Nickname != nil { + nickname = *user.Nickname + } + avatar := "" + if user.Avatar != nil { + avatar = *user.Avatar + } + + userInfo := &UserInfo{ + ID: user.ID, + Username: user.Username, + Email: user.Email, + Nickname: nickname, + Avatar: avatar, + Level: "beginner", + Status: user.Status, + } + + common.SuccessResponse(c, userInfo) +} + +// ChangePassword 修改密码 +func (h *AuthHandler) ChangePassword(c *gin.Context) { + // 获取当前用户ID + userID, exists := utils.GetUserIDFromContext(c) + if !exists { + common.BadRequestResponse(c, "请先登录") + return + } + + var req ChangePasswordRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 验证请求参数 + if err := h.validator.Struct(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 验证新密码强度 + if !utils.IsStrongPassword(req.NewPassword) { + common.BadRequestResponse(c, "新密码强度不够") + return + } + + // 更新密码 + err := h.userService.UpdatePassword(userID, req.OldPassword, req.NewPassword) + if err != nil { + if businessErr, ok := err.(*common.BusinessError); ok { + common.ErrorResponse(c, http.StatusBadRequest, businessErr.Message) + return + } + common.InternalServerErrorResponse(c, "密码更新失败") + return + } + + common.SuccessResponse(c, map[string]string{"message": "密码修改成功"}) +} \ No newline at end of file diff --git a/serve/api/handlers/health_handler.go b/serve/api/handlers/health_handler.go new file mode 100644 index 0000000..75487a4 --- /dev/null +++ b/serve/api/handlers/health_handler.go @@ -0,0 +1,134 @@ +package handlers + +import ( + "net/http" + "time" + + "github.com/gin-gonic/gin" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/config" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/database" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" +) + +// HealthResponse 健康检查响应结构 +type HealthResponse struct { + Status string `json:"status"` + Timestamp time.Time `json:"timestamp"` + Version string `json:"version"` + Services map[string]string `json:"services"` +} + +// VersionResponse 版本信息响应结构 +type VersionResponse struct { + Name string `json:"name"` + Version string `json:"version"` + Environment string `json:"environment"` + BuildTime string `json:"build_time"` +} + +// HealthCheck 健康检查端点 +func HealthCheck(c *gin.Context) { + services := make(map[string]string) + + // 检查数据库连接 + db := database.GetDB() + if db != nil { + sqlDB, err := db.DB() + if err != nil { + services["database"] = "error" + } else { + if err := sqlDB.Ping(); err != nil { + services["database"] = "down" + } else { + services["database"] = "up" + } + } + } else { + services["database"] = "not_initialized" + } + + // 检查Redis连接（如果配置了Redis） + // TODO: 添加Redis健康检查 + services["redis"] = "not_implemented" + + // 确定整体状态 + status := "healthy" + for _, serviceStatus := range services { + if serviceStatus != "up" && serviceStatus != "not_implemented" { + status = "unhealthy" + break + } + } + + response := HealthResponse{ + Status: status, + Timestamp: time.Now(), + Version: config.GlobalConfig.App.Version, + Services: services, + } + + if status == "healthy" { + common.SuccessResponse(c, response) + } else { + c.JSON(http.StatusServiceUnavailable, gin.H{ + "code": http.StatusServiceUnavailable, + "message": "Service unhealthy", + "data": response, + }) + } +} + +// GetVersion 获取版本信息 +func GetVersion(c *gin.Context) { + response := VersionResponse{ + Name: config.GlobalConfig.App.Name, + Version: config.GlobalConfig.App.Version, + Environment: config.GlobalConfig.App.Environment, + BuildTime: time.Now().Format("2006-01-02 15:04:05"), // 实际项目中应该在编译时注入 + } + + common.SuccessResponse(c, response) +} + +// ReadinessCheck 就绪检查端点（用于Kubernetes等容器编排） +func ReadinessCheck(c *gin.Context) { + // 检查关键服务是否就绪 + db := database.GetDB() + if db == nil { + c.JSON(http.StatusServiceUnavailable, gin.H{ + "status": "not_ready", + "reason": "database_not_initialized", + }) + return + } + + sqlDB, err := db.DB() + if err != nil { + c.JSON(http.StatusServiceUnavailable, gin.H{ + "status": "not_ready", + "reason": "database_connection_error", + }) + return + } + + if err := sqlDB.Ping(); err != nil { + c.JSON(http.StatusServiceUnavailable, gin.H{ + "status": "not_ready", + "reason": "database_ping_failed", + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "status": "ready", + }) +} + +// LivenessCheck 存活检查端点（用于Kubernetes等容器编排） +func LivenessCheck(c *gin.Context) { + // 简单的存活检查，只要服务能响应就认为是存活的 + c.JSON(http.StatusOK, gin.H{ + "status": "alive", + "timestamp": time.Now(), + }) +} \ No newline at end of file diff --git a/serve/api/handlers/hello_handler.go b/serve/api/handlers/hello_handler.go new file mode 100644 index 0000000..f6d8acd --- /dev/null +++ b/serve/api/handlers/hello_handler.go @@ -0,0 +1,15 @@ +// api/handlers/hello_handler.go +package handlers + +import ( + "net/http" + + "github.com/gin-gonic/gin" +) + +// HelloHandler 处理 /hello 请求 +func HelloHandler(c *gin.Context) { + c.JSON(http.StatusOK, gin.H{ + "message": "Hello from a structured project!", + }) +} diff --git a/serve/api/handlers/listening_handler.go b/serve/api/handlers/listening_handler.go new file mode 100644 index 0000000..c00dd2b --- /dev/null +++ b/serve/api/handlers/listening_handler.go @@ -0,0 +1,593 @@ +package handlers + +import ( + "net/http" + "strconv" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/gin-gonic/gin" + "github.com/go-playground/validator/v10" +) + +// ListeningHandler 听力训练处理器 +type ListeningHandler struct { + listeningService *services.ListeningService + validate *validator.Validate +} + +// NewListeningHandler 创建听力训练处理器实例 +func NewListeningHandler(listeningService *services.ListeningService, validate *validator.Validate) *ListeningHandler { + return &ListeningHandler{ + listeningService: listeningService, + validate: validate, + } +} + +func getUserIDString(c *gin.Context) (string, bool) { + uid, exists := c.Get("user_id") + if !exists || uid == nil { + return "", false + } + switch v := uid.(type) { + case string: + return v, true + case int: + return strconv.Itoa(v), true + case int64: + return strconv.FormatInt(v, 10), true + default: + return "", false + } +} + +// CreateMaterialRequest 创建听力材料请求 +type CreateMaterialRequest struct { + Title string `json:"title" validate:"required,max=200"` + Description *string `json:"description"` + AudioURL string `json:"audio_url" validate:"required,url,max=500"` + Transcript *string `json:"transcript"` + Duration int `json:"duration" validate:"min=0"` + Level string `json:"level" validate:"required,oneof=beginner intermediate advanced"` + Category string `json:"category" validate:"max=50"` + Tags *string `json:"tags"` +} + +// UpdateMaterialRequest 更新听力材料请求 +type UpdateMaterialRequest struct { + Title *string `json:"title" validate:"omitempty,max=200"` + Description *string `json:"description"` + AudioURL *string `json:"audio_url" validate:"omitempty,url,max=500"` + Transcript *string `json:"transcript"` + Duration *int `json:"duration" validate:"omitempty,min=0"` + Level *string `json:"level" validate:"omitempty,oneof=beginner intermediate advanced"` + Category *string `json:"category" validate:"omitempty,max=50"` + Tags *string `json:"tags"` +} + +// CreateRecordRequest 创建听力练习记录请求 +type CreateRecordRequest struct { + MaterialID string `json:"material_id" validate:"required"` +} + +// UpdateRecordRequest 更新听力练习记录请求 +type UpdateRecordRequest struct { + Score *float64 `json:"score" validate:"omitempty,min=0,max=100"` + Accuracy *float64 `json:"accuracy" validate:"omitempty,min=0,max=100"` + CompletionRate *float64 `json:"completion_rate" validate:"omitempty,min=0,max=100"` + TimeSpent *int `json:"time_spent" validate:"omitempty,min=0"` + Answers *string `json:"answers"` + Feedback *string `json:"feedback"` + Completed *bool `json:"completed"` +} + +// GetListeningMaterials 获取听力材料列表 +func (h *ListeningHandler) GetListeningMaterials(c *gin.Context) { + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20")) + + if page < 1 { + page = 1 + } + if pageSize < 1 || pageSize > 100 { + pageSize = 20 + } + + materials, total, err := h.listeningService.GetListeningMaterials(level, category, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "code": 500, + "message": "获取听力材料失败", + "error": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "获取成功", + "data": gin.H{ + "materials": materials, + "total": total, + "page": page, + "page_size": pageSize, + "total_pages": (total + int64(pageSize) - 1) / int64(pageSize), + }, + }) +} + +// GetListeningMaterial 获取单个听力材料 +func (h *ListeningHandler) GetListeningMaterial(c *gin.Context) { + id := c.Param("id") + if id == "" { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "材料ID不能为空", + }) + return + } + + material, err := h.listeningService.GetListeningMaterial(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "code": 404, + "message": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "获取成功", + "data": material, + }) +} + +// CreateListeningMaterial 创建听力材料 +func (h *ListeningHandler) CreateListeningMaterial(c *gin.Context) { + var req CreateMaterialRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "请求参数错误", + "error": err.Error(), + }) + return + } + + if err := h.validate.Struct(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "参数验证失败", + "error": err.Error(), + }) + return + } + + material := &models.ListeningMaterial{ + Title: req.Title, + Description: req.Description, + AudioURL: req.AudioURL, + Transcript: req.Transcript, + Duration: req.Duration, + Level: req.Level, + Category: req.Category, + Tags: req.Tags, + } + + if err := h.listeningService.CreateListeningMaterial(material); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "code": 500, + "message": "创建听力材料失败", + "error": err.Error(), + }) + return + } + + c.JSON(http.StatusCreated, gin.H{ + "code": 201, + "message": "创建成功", + "data": material, + }) +} + +// UpdateListeningMaterial 更新听力材料 +func (h *ListeningHandler) UpdateListeningMaterial(c *gin.Context) { + id := c.Param("id") + if id == "" { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "材料ID不能为空", + }) + return + } + + var req UpdateMaterialRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "请求参数错误", + "error": err.Error(), + }) + return + } + + if err := h.validate.Struct(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "参数验证失败", + "error": err.Error(), + }) + return + } + + updates := make(map[string]interface{}) + if req.Title != nil { + updates["title"] = *req.Title + } + if req.Description != nil { + updates["description"] = *req.Description + } + if req.AudioURL != nil { + updates["audio_url"] = *req.AudioURL + } + if req.Transcript != nil { + updates["transcript"] = *req.Transcript + } + if req.Duration != nil { + updates["duration"] = *req.Duration + } + if req.Level != nil { + updates["level"] = *req.Level + } + if req.Category != nil { + updates["category"] = *req.Category + } + if req.Tags != nil { + updates["tags"] = *req.Tags + } + + if err := h.listeningService.UpdateListeningMaterial(id, updates); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "code": 500, + "message": "更新听力材料失败", + "error": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "更新成功", + }) +} + +// DeleteListeningMaterial 删除听力材料 +func (h *ListeningHandler) DeleteListeningMaterial(c *gin.Context) { + id := c.Param("id") + if id == "" { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "材料ID不能为空", + }) + return + } + + if err := h.listeningService.DeleteListeningMaterial(id); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "code": 500, + "message": "删除听力材料失败", + "error": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "删除成功", + }) +} + +// SearchListeningMaterials 搜索听力材料 +func (h *ListeningHandler) SearchListeningMaterials(c *gin.Context) { + keyword := c.Query("q") + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20")) + + if page < 1 { + page = 1 + } + if pageSize < 1 || pageSize > 100 { + pageSize = 20 + } + + materials, total, err := h.listeningService.SearchListeningMaterials(keyword, level, category, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "code": 500, + "message": "搜索听力材料失败", + "error": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "搜索成功", + "data": gin.H{ + "materials": materials, + "total": total, + "page": page, + "page_size": pageSize, + "total_pages": (total + int64(pageSize) - 1) / int64(pageSize), + }, + }) +} + +// CreateListeningRecord 创建听力练习记录 +func (h *ListeningHandler) CreateListeningRecord(c *gin.Context) { + userIDStr, ok := getUserIDString(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{ + "code": 401, + "message": "未授权访问", + }) + return + } + + var req CreateRecordRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "请求参数错误", + "error": err.Error(), + }) + return + } + + if err := h.validate.Struct(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "参数验证失败", + "error": err.Error(), + }) + return + } + + record := &models.ListeningRecord{ + UserID: userIDStr, + MaterialID: req.MaterialID, + } + + if err := h.listeningService.CreateListeningRecord(record); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "code": 500, + "message": "创建听力练习记录失败", + "error": err.Error(), + }) + return + } + + c.JSON(http.StatusCreated, gin.H{ + "code": 201, + "message": "创建成功", + "data": record, + }) +} + +// UpdateListeningRecord 更新听力练习记录 +func (h *ListeningHandler) UpdateListeningRecord(c *gin.Context) { + id := c.Param("id") + if id == "" { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "记录ID不能为空", + }) + return + } + + var req UpdateRecordRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "请求参数错误", + "error": err.Error(), + }) + return + } + + if err := h.validate.Struct(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "参数验证失败", + "error": err.Error(), + }) + return + } + + updates := make(map[string]interface{}) + if req.Score != nil { + updates["score"] = *req.Score + } + if req.Accuracy != nil { + updates["accuracy"] = *req.Accuracy + } + if req.CompletionRate != nil { + updates["completion_rate"] = *req.CompletionRate + } + if req.TimeSpent != nil { + updates["time_spent"] = *req.TimeSpent + } + if req.Answers != nil { + updates["answers"] = *req.Answers + } + if req.Feedback != nil { + updates["feedback"] = *req.Feedback + } + if req.Completed != nil && *req.Completed { + updates["completed_at"] = true // 这会在service中被处理为实际时间 + } + + if err := h.listeningService.UpdateListeningRecord(id, updates); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "code": 500, + "message": "更新听力练习记录失败", + "error": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "更新成功", + }) +} + +// GetUserListeningRecords 获取用户听力练习记录 +func (h *ListeningHandler) GetUserListeningRecords(c *gin.Context) { + userIDStr, ok := getUserIDString(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{ + "code": 401, + "message": "未授权访问", + }) + return + } + + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20")) + + if page < 1 { + page = 1 + } + if pageSize < 1 || pageSize > 100 { + pageSize = 20 + } + + records, total, err := h.listeningService.GetUserListeningRecords(userIDStr, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "code": 500, + "message": "获取听力练习记录失败", + "error": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "获取成功", + "data": gin.H{ + "records": records, + "total": total, + "page": page, + "page_size": pageSize, + "total_pages": (total + int64(pageSize) - 1) / int64(pageSize), + }, + }) +} + +// GetListeningRecord 获取单个听力练习记录 +func (h *ListeningHandler) GetListeningRecord(c *gin.Context) { + id := c.Param("id") + if id == "" { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "记录ID不能为空", + }) + return + } + + record, err := h.listeningService.GetListeningRecord(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "code": 404, + "message": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "获取成功", + "data": record, + }) +} + +// GetUserListeningStats 获取用户听力学习统计 +func (h *ListeningHandler) GetUserListeningStats(c *gin.Context) { + userIDStr, ok := getUserIDString(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{ + "code": 401, + "message": "未授权访问", + }) + return + } + + stats, err := h.listeningService.GetUserListeningStats(userIDStr) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "code": 500, + "message": "获取听力学习统计失败", + "error": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "获取成功", + "data": stats, + }) +} + +// GetListeningProgress 获取用户在特定材料上的学习进度 +func (h *ListeningHandler) GetListeningProgress(c *gin.Context) { + userIDStr, ok := getUserIDString(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{ + "code": 401, + "message": "未授权访问", + }) + return + } + + materialID := c.Param("material_id") + if materialID == "" { + c.JSON(http.StatusBadRequest, gin.H{ + "code": 400, + "message": "材料ID不能为空", + }) + return + } + + progress, err := h.listeningService.GetListeningProgress(userIDStr, materialID) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "code": 500, + "message": "获取学习进度失败", + "error": err.Error(), + }) + return + } + + if progress == nil { + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "暂无学习记录", + "data": nil, + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "code": 200, + "message": "获取成功", + "data": progress, + }) +} \ No newline at end of file diff --git a/serve/api/handlers/reading_handler.go b/serve/api/handlers/reading_handler.go new file mode 100644 index 0000000..b067f6b --- /dev/null +++ b/serve/api/handlers/reading_handler.go @@ -0,0 +1,639 @@ +package handlers + +import ( + "net/http" + "strconv" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" + "github.com/gin-gonic/gin" +) + +// ReadingHandler 阅读理解处理器 +type ReadingHandler struct { + readingService *services.ReadingService +} + +// NewReadingHandler 创建阅读理解处理器实例 +func NewReadingHandler(readingService *services.ReadingService) *ReadingHandler { + return &ReadingHandler{ + readingService: readingService, + } +} + +// ===== 请求结构体定义 ===== + +// CreateReadingMaterialRequest 创建阅读材料请求 +type CreateReadingMaterialRequest struct { + Title string `json:"title" binding:"required"` + Content string `json:"content" binding:"required"` + Summary string `json:"summary"` + Level string `json:"level" binding:"required,oneof=beginner intermediate advanced"` + Category string `json:"category" binding:"required"` + WordCount int `json:"word_count"` + Tags string `json:"tags"` + Source string `json:"source"` + Author string `json:"author"` +} + +// UpdateReadingMaterialRequest 更新阅读材料请求 +type UpdateReadingMaterialRequest struct { + Title *string `json:"title"` + Content *string `json:"content"` + Summary *string `json:"summary"` + Level *string `json:"level"` + Category *string `json:"category"` + WordCount *int `json:"word_count"` + Tags *string `json:"tags"` + Source *string `json:"source"` + Author *string `json:"author"` +} + +// CreateReadingRecordRequest 创建阅读记录请求 +type CreateReadingRecordRequest struct { + MaterialID string `json:"material_id" binding:"required"` +} + +// UpdateReadingRecordRequest 更新阅读记录请求 +type UpdateReadingRecordRequest struct { + ReadingTime *int `json:"reading_time"` + ComprehensionScore *float64 `json:"comprehension_score"` + ReadingSpeed *float64 `json:"reading_speed"` + Notes *string `json:"notes"` + CompletedAt *time.Time `json:"completed_at"` +} + +// ===== 阅读材料管理接口 ===== + +// GetReadingMaterials 获取阅读材料列表 +// @Summary 获取阅读材料列表 +// @Description 获取阅读材料列表，支持按难度级别和分类筛选 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param level query string false "难度级别" +// @Param category query string false "分类" +// @Param page query int false "页码" default(1) +// @Param page_size query int false "每页数量" default(10) +// @Success 200 {object} Response +// @Router /reading/materials [get] +func (h *ReadingHandler) GetReadingMaterials(c *gin.Context) { + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + if page < 1 { + page = 1 + } + if pageSize < 1 || pageSize > 100 { + pageSize = 10 + } + + materials, total, err := h.readingService.GetReadingMaterials(level, category, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "获取阅读材料失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "data": materials, + "pagination": gin.H{ + "page": page, + "page_size": pageSize, + "total": total, + "total_pages": (total + int64(pageSize) - 1) / int64(pageSize), + }, + }) +} + +// GetReadingMaterial 获取单个阅读材料 +// @Summary 获取单个阅读材料 +// @Description 根据ID获取阅读材料详情 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param id path string true "材料ID" +// @Success 200 {object} Response +// @Router /reading/materials/{id} [get] +func (h *ReadingHandler) GetReadingMaterial(c *gin.Context) { + id := c.Param("id") + if id == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "材料ID不能为空"}) + return + } + + material, err := h.readingService.GetReadingMaterial(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "error": "阅读材料不存在", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{"data": material}) +} + +// CreateReadingMaterial 创建阅读材料 +// @Summary 创建阅读材料 +// @Description 创建新的阅读材料 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param request body CreateReadingMaterialRequest true "创建请求" +// @Success 201 {object} Response +// @Router /reading/materials [post] +func (h *ReadingHandler) CreateReadingMaterial(c *gin.Context) { + var req CreateReadingMaterialRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "请求参数错误", + "details": err.Error(), + }) + return + } + + material := &models.ReadingMaterial{ + Title: req.Title, + Content: req.Content, + Summary: &req.Summary, + WordCount: req.WordCount, + Level: req.Level, + Category: req.Category, + Tags: &req.Tags, + Source: &req.Source, + Author: &req.Author, + IsActive: true, + } + + if err := h.readingService.CreateReadingMaterial(material); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "创建阅读材料失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusCreated, gin.H{ + "message": "阅读材料创建成功", + "data": material, + }) +} + +// UpdateReadingMaterial 更新阅读材料 +// @Summary 更新阅读材料 +// @Description 更新阅读材料信息 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param id path string true "材料ID" +// @Param request body UpdateReadingMaterialRequest true "更新请求" +// @Success 200 {object} Response +// @Router /reading/materials/{id} [put] +func (h *ReadingHandler) UpdateReadingMaterial(c *gin.Context) { + id := c.Param("id") + if id == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "材料ID不能为空"}) + return + } + + var req UpdateReadingMaterialRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "请求参数错误", + "details": err.Error(), + }) + return + } + + updates := make(map[string]interface{}) + if req.Title != nil { + updates["title"] = *req.Title + } + if req.Content != nil { + updates["content"] = *req.Content + } + if req.Summary != nil { + updates["summary"] = *req.Summary + } + if req.Level != nil { + updates["level"] = *req.Level + } + if req.Category != nil { + updates["category"] = *req.Category + } + if req.WordCount != nil { + updates["word_count"] = *req.WordCount + } + if req.Tags != nil { + updates["tags"] = *req.Tags + } + if req.Source != nil { + updates["source"] = *req.Source + } + if req.Author != nil { + updates["author"] = *req.Author + } + + if len(updates) == 0 { + c.JSON(http.StatusBadRequest, gin.H{"error": "没有提供更新字段"}) + return + } + + if err := h.readingService.UpdateReadingMaterial(id, updates); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "更新阅读材料失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{"message": "阅读材料更新成功"}) +} + +// DeleteReadingMaterial 删除阅读材料 +// @Summary 删除阅读材料 +// @Description 软删除阅读材料 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param id path string true "材料ID" +// @Success 200 {object} Response +// @Router /reading/materials/{id} [delete] +func (h *ReadingHandler) DeleteReadingMaterial(c *gin.Context) { + id := c.Param("id") + if id == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "材料ID不能为空"}) + return + } + + if err := h.readingService.DeleteReadingMaterial(id); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "删除阅读材料失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{"message": "阅读材料删除成功"}) +} + +// SearchReadingMaterials 搜索阅读材料 +// @Summary 搜索阅读材料 +// @Description 根据关键词搜索阅读材料 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param keyword query string true "搜索关键词" +// @Param level query string false "难度级别" +// @Param category query string false "分类" +// @Param page query int false "页码" default(1) +// @Param page_size query int false "每页数量" default(10) +// @Success 200 {object} Response +// @Router /reading/materials/search [get] +func (h *ReadingHandler) SearchReadingMaterials(c *gin.Context) { + keyword := c.Query("keyword") + if keyword == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "搜索关键词不能为空"}) + return + } + + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + if page < 1 { + page = 1 + } + if pageSize < 1 || pageSize > 100 { + pageSize = 10 + } + + materials, total, err := h.readingService.SearchReadingMaterials(keyword, level, category, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "搜索阅读材料失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "data": materials, + "pagination": gin.H{ + "page": page, + "page_size": pageSize, + "total": total, + "total_pages": (total + int64(pageSize) - 1) / int64(pageSize), + }, + }) +} + +// ===== 阅读记录管理接口 ===== + +// CreateReadingRecord 创建阅读记录 +// @Summary 创建阅读记录 +// @Description 开始阅读材料，创建阅读记录 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param request body CreateReadingRecordRequest true "创建请求" +// @Success 201 {object} Response +// @Router /reading/records [post] +func (h *ReadingHandler) CreateReadingRecord(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + var req CreateReadingRecordRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "请求参数错误", + "details": err.Error(), + }) + return + } + + // 检查是否已有该材料的阅读记录 + existingRecord, err := h.readingService.GetReadingProgress(utils.Int64ToString(userID), req.MaterialID) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "检查阅读记录失败", + "details": err.Error(), + }) + return + } + + if existingRecord != nil { + c.JSON(http.StatusOK, gin.H{ + "message": "阅读记录已存在", + "data": existingRecord, + }) + return + } + + record := &models.ReadingRecord{ + UserID: utils.Int64ToString(userID), + MaterialID: req.MaterialID, + } + + if err := h.readingService.CreateReadingRecord(record); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "创建阅读记录失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusCreated, gin.H{ + "message": "阅读记录创建成功", + "data": record, + }) +} + +// UpdateReadingRecord 更新阅读记录 +// @Summary 更新阅读记录 +// @Description 更新阅读进度和成绩 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param id path string true "记录ID" +// @Param request body UpdateReadingRecordRequest true "更新请求" +// @Success 200 {object} Response +// @Router /reading/records/{id} [put] +func (h *ReadingHandler) UpdateReadingRecord(c *gin.Context) { + id := c.Param("id") + if id == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "记录ID不能为空"}) + return + } + + var req UpdateReadingRecordRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "请求参数错误", + "details": err.Error(), + }) + return + } + + updates := make(map[string]interface{}) + if req.ReadingTime != nil { + updates["reading_time"] = *req.ReadingTime + } + if req.ComprehensionScore != nil { + updates["comprehension_score"] = *req.ComprehensionScore + } + if req.ReadingSpeed != nil { + updates["reading_speed"] = *req.ReadingSpeed + } + if req.Notes != nil { + updates["notes"] = *req.Notes + } + if req.CompletedAt != nil { + updates["completed_at"] = *req.CompletedAt + } + + if len(updates) == 0 { + c.JSON(http.StatusBadRequest, gin.H{"error": "没有提供更新字段"}) + return + } + + if err := h.readingService.UpdateReadingRecord(id, updates); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "更新阅读记录失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{"message": "阅读记录更新成功"}) +} + +// GetUserReadingRecords 获取用户阅读记录 +// @Summary 获取用户阅读记录 +// @Description 获取当前用户的阅读记录列表 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param page query int false "页码" default(1) +// @Param page_size query int false "每页数量" default(10) +// @Success 200 {object} Response +// @Router /reading/records [get] +func (h *ReadingHandler) GetUserReadingRecords(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + if page < 1 { + page = 1 + } + if pageSize < 1 || pageSize > 100 { + pageSize = 10 + } + + records, total, err := h.readingService.GetUserReadingRecords(utils.Int64ToString(userID), page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "获取阅读记录失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "data": records, + "pagination": gin.H{ + "page": page, + "page_size": pageSize, + "total": total, + "total_pages": (total + int64(pageSize) - 1) / int64(pageSize), + }, + }) +} + +// GetReadingRecord 获取单个阅读记录 +// @Summary 获取单个阅读记录 +// @Description 根据ID获取阅读记录详情 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param id path string true "记录ID" +// @Success 200 {object} Response +// @Router /reading/records/{id} [get] +func (h *ReadingHandler) GetReadingRecord(c *gin.Context) { + id := c.Param("id") + if id == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "记录ID不能为空"}) + return + } + + record, err := h.readingService.GetReadingRecord(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "error": "阅读记录不存在", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{"data": record}) +} + +// GetReadingProgress 获取阅读进度 +// @Summary 获取阅读进度 +// @Description 获取用户对特定材料的阅读进度 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param material_id path string true "材料ID" +// @Success 200 {object} Response +// @Router /reading/progress/{material_id} [get] +func (h *ReadingHandler) GetReadingProgress(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + materialID := c.Param("material_id") + if materialID == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "材料ID不能为空"}) + return + } + + record, err := h.readingService.GetReadingProgress(utils.Int64ToString(userID), materialID) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "获取阅读进度失败", + "details": err.Error(), + }) + return + } + + if record == nil { + c.JSON(http.StatusOK, gin.H{ + "data": nil, + "message": "暂无阅读记录", + }) + return + } + + c.JSON(http.StatusOK, gin.H{"data": record}) +} + +// ===== 阅读统计接口 ===== + +// GetReadingStats 获取阅读统计 +// @Summary 获取阅读统计 +// @Description 获取用户阅读统计信息 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Success 200 {object} Response +// @Router /reading/stats [get] +func (h *ReadingHandler) GetReadingStats(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + stats, err := h.readingService.GetUserReadingStats(utils.Int64ToString(userID)) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "获取阅读统计失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{"data": stats}) +} + +// GetRecommendedMaterials 获取推荐阅读材料 +// @Summary 获取推荐阅读材料 +// @Description 根据用户阅读历史推荐合适的阅读材料 +// @Tags 阅读理解 +// @Accept json +// @Produce json +// @Param limit query int false "推荐数量" default(5) +// @Success 200 {object} Response +// @Router /reading/recommendations [get] +func (h *ReadingHandler) GetRecommendedMaterials(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "5")) + if limit < 1 || limit > 20 { + limit = 5 + } + + materials, err := h.readingService.GetRecommendedMaterials(utils.Int64ToString(userID), limit) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "获取推荐材料失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{"data": materials}) +} \ No newline at end of file diff --git a/serve/api/handlers/speaking_handler.go b/serve/api/handlers/speaking_handler.go new file mode 100644 index 0000000..8d3ca47 --- /dev/null +++ b/serve/api/handlers/speaking_handler.go @@ -0,0 +1,449 @@ +package handlers + +import ( + "net/http" + "strconv" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" + "github.com/gin-gonic/gin" +) + +// SpeakingHandler 口语练习处理器 +type SpeakingHandler struct { + speakingService *services.SpeakingService +} + +// NewSpeakingHandler 创建口语练习处理器实例 +func NewSpeakingHandler(speakingService *services.SpeakingService) *SpeakingHandler { + return &SpeakingHandler{ + speakingService: speakingService, + } +} + +// ==================== 口语场景管理 ==================== + +// GetSpeakingScenarios 获取口语场景列表 +func (h *SpeakingHandler) GetSpeakingScenarios(c *gin.Context) { + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20")) + + if page < 1 { + page = 1 + } + if pageSize < 1 || pageSize > 100 { + pageSize = 20 + } + + scenarios, total, err := h.speakingService.GetSpeakingScenarios(level, category, page, pageSize) + if err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "获取口语场景列表失败") + return + } + + response := gin.H{ + "scenarios": scenarios, + "pagination": gin.H{ + "page": page, + "page_size": pageSize, + "total": total, + "total_pages": (total + int64(pageSize) - 1) / int64(pageSize), + }, + } + + common.SuccessResponse(c, response) +} + +// GetSpeakingScenario 获取单个口语场景 +func (h *SpeakingHandler) GetSpeakingScenario(c *gin.Context) { + id := c.Param("id") + if id == "" { + common.ErrorResponse(c, http.StatusBadRequest, "场景ID不能为空") + return + } + + scenario, err := h.speakingService.GetSpeakingScenario(id) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "口语场景不存在") + return + } + + common.SuccessResponse(c, scenario) +} + +// CreateSpeakingScenarioRequest 创建口语场景请求 +type CreateSpeakingScenarioRequest struct { + Title string `json:"title" binding:"required,max=200"` + Description string `json:"description" binding:"required"` + Context *string `json:"context"` + Level string `json:"level" binding:"required,oneof=beginner intermediate advanced"` + Category string `json:"category" binding:"max=50"` + Tags *string `json:"tags"` + Dialogue *string `json:"dialogue"` + KeyPhrases *string `json:"key_phrases"` +} + +// CreateSpeakingScenario 创建口语场景 +func (h *SpeakingHandler) CreateSpeakingScenario(c *gin.Context) { + var req CreateSpeakingScenarioRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, http.StatusBadRequest, "请求参数错误") + return + } + + scenario := &models.SpeakingScenario{ + ID: utils.GenerateUUID(), + Title: req.Title, + Description: req.Description, + Context: req.Context, + Level: req.Level, + Category: req.Category, + Tags: req.Tags, + Dialogue: req.Dialogue, + KeyPhrases: req.KeyPhrases, + IsActive: true, + } + + if err := h.speakingService.CreateSpeakingScenario(scenario); err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "创建口语场景失败") + return + } + + common.SuccessResponse(c, scenario) +} + +// UpdateSpeakingScenarioRequest 更新口语场景请求 +type UpdateSpeakingScenarioRequest struct { + Title *string `json:"title" binding:"omitempty,max=200"` + Description *string `json:"description"` + Context *string `json:"context"` + Level *string `json:"level" binding:"omitempty,oneof=beginner intermediate advanced"` + Category *string `json:"category" binding:"omitempty,max=50"` + Tags *string `json:"tags"` + Dialogue *string `json:"dialogue"` + KeyPhrases *string `json:"key_phrases"` +} + +// UpdateSpeakingScenario 更新口语场景 +func (h *SpeakingHandler) UpdateSpeakingScenario(c *gin.Context) { + id := c.Param("id") + if id == "" { + common.ErrorResponse(c, http.StatusBadRequest, "场景ID不能为空") + return + } + + var req UpdateSpeakingScenarioRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, http.StatusBadRequest, "请求参数错误") + return + } + + updateData := &models.SpeakingScenario{} + if req.Title != nil { + updateData.Title = *req.Title + } + if req.Description != nil { + updateData.Description = *req.Description + } + if req.Context != nil { + updateData.Context = req.Context + } + if req.Level != nil { + updateData.Level = *req.Level + } + if req.Category != nil { + updateData.Category = *req.Category + } + if req.Tags != nil { + updateData.Tags = req.Tags + } + if req.Dialogue != nil { + updateData.Dialogue = req.Dialogue + } + if req.KeyPhrases != nil { + updateData.KeyPhrases = req.KeyPhrases + } + + if err := h.speakingService.UpdateSpeakingScenario(id, updateData); err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "更新口语场景失败") + return + } + + common.SuccessResponse(c, gin.H{"message": "更新成功"}) +} + +// DeleteSpeakingScenario 删除口语场景 +func (h *SpeakingHandler) DeleteSpeakingScenario(c *gin.Context) { + id := c.Param("id") + if id == "" { + common.ErrorResponse(c, http.StatusBadRequest, "场景ID不能为空") + return + } + + if err := h.speakingService.DeleteSpeakingScenario(id); err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "删除口语场景失败") + return + } + + common.SuccessResponse(c, gin.H{"message": "删除成功"}) +} + +// SearchSpeakingScenarios 搜索口语场景 +func (h *SpeakingHandler) SearchSpeakingScenarios(c *gin.Context) { + keyword := c.Query("keyword") + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20")) + + if page < 1 { + page = 1 + } + if pageSize < 1 || pageSize > 100 { + pageSize = 20 + } + + scenarios, total, err := h.speakingService.SearchSpeakingScenarios(keyword, level, category, page, pageSize) + if err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "搜索口语场景失败") + return + } + + response := gin.H{ + "scenarios": scenarios, + "pagination": gin.H{ + "page": page, + "page_size": pageSize, + "total": total, + "total_pages": (total + int64(pageSize) - 1) / int64(pageSize), + }, + } + + common.SuccessResponse(c, response) +} + +// GetRecommendedScenarios 获取推荐的口语场景 +func (h *SpeakingHandler) GetRecommendedScenarios(c *gin.Context) { + userIDInt, exists := utils.GetUserIDFromContext(c) + if !exists { + common.ErrorResponse(c, http.StatusUnauthorized, "用户未认证") + return + } + + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "10")) + if limit < 1 || limit > 50 { + limit = 10 + } + + userID := utils.Int64ToString(userIDInt) + scenarios, err := h.speakingService.GetRecommendedScenarios(userID, limit) + if err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "获取推荐场景失败") + return + } + + common.SuccessResponse(c, scenarios) +} + +// ==================== 口语练习记录管理 ==================== + +// CreateSpeakingRecordRequest 创建口语练习记录请求 +type CreateSpeakingRecordRequest struct { + ScenarioID string `json:"scenario_id" binding:"required"` +} + +// CreateSpeakingRecord 创建口语练习记录 +func (h *SpeakingHandler) CreateSpeakingRecord(c *gin.Context) { + userIDInt, exists := utils.GetUserIDFromContext(c) + if !exists { + common.ErrorResponse(c, http.StatusUnauthorized, "用户未认证") + return + } + + var req CreateSpeakingRecordRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, http.StatusBadRequest, "请求参数错误") + return + } + + now := time.Now() + record := &models.SpeakingRecord{ + ID: utils.GenerateUUID(), + UserID: utils.Int64ToString(userIDInt), + ScenarioID: req.ScenarioID, + StartedAt: now, + CreatedAt: now, + UpdatedAt: now, + } + + if err := h.speakingService.CreateSpeakingRecord(record); err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "创建口语练习记录失败") + return + } + + common.SuccessResponse(c, record) +} + +// GetUserSpeakingRecords 获取用户的口语练习记录 +func (h *SpeakingHandler) GetUserSpeakingRecords(c *gin.Context) { + userIDInt, exists := utils.GetUserIDFromContext(c) + if !exists { + common.ErrorResponse(c, http.StatusUnauthorized, "用户未认证") + return + } + + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20")) + + if page < 1 { + page = 1 + } + if pageSize < 1 || pageSize > 100 { + pageSize = 20 + } + + userID := utils.Int64ToString(userIDInt) + records, total, err := h.speakingService.GetUserSpeakingRecords(userID, page, pageSize) + if err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "获取口语练习记录失败") + return + } + + response := gin.H{ + "records": records, + "pagination": gin.H{ + "page": page, + "page_size": pageSize, + "total": total, + "total_pages": (total + int64(pageSize) - 1) / int64(pageSize), + }, + } + + common.SuccessResponse(c, response) +} + +// GetSpeakingRecord 获取单个口语练习记录 +func (h *SpeakingHandler) GetSpeakingRecord(c *gin.Context) { + id := c.Param("id") + if id == "" { + common.ErrorResponse(c, http.StatusBadRequest, "记录ID不能为空") + return + } + + record, err := h.speakingService.GetSpeakingRecord(id) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "口语练习记录不存在") + return + } + + common.SuccessResponse(c, record) +} + +// SubmitSpeakingRequest 提交口语练习请求 +type SubmitSpeakingRequest struct { + AudioURL string `json:"audio_url" binding:"required"` + Transcript string `json:"transcript"` +} + +// SubmitSpeaking 提交口语练习 +func (h *SpeakingHandler) SubmitSpeaking(c *gin.Context) { + id := c.Param("id") + if id == "" { + common.ErrorResponse(c, http.StatusBadRequest, "记录ID不能为空") + return + } + + var req SubmitSpeakingRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, http.StatusBadRequest, "请求参数错误") + return + } + + if err := h.speakingService.SubmitSpeaking(id, req.AudioURL, req.Transcript); err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "提交口语练习失败") + return + } + + common.SuccessResponse(c, gin.H{"message": "提交成功"}) +} + +// GradeSpeakingRequest 评分口语练习请求 +type GradeSpeakingRequest struct { + PronunciationScore float64 `json:"pronunciation_score" binding:"required,min=0,max=100"` + FluencyScore float64 `json:"fluency_score" binding:"required,min=0,max=100"` + AccuracyScore float64 `json:"accuracy_score" binding:"required,min=0,max=100"` + OverallScore float64 `json:"overall_score" binding:"required,min=0,max=100"` + Feedback string `json:"feedback"` + Suggestions string `json:"suggestions"` +} + +// GradeSpeaking 评分口语练习 +func (h *SpeakingHandler) GradeSpeaking(c *gin.Context) { + id := c.Param("id") + if id == "" { + common.ErrorResponse(c, http.StatusBadRequest, "记录ID不能为空") + return + } + + var req GradeSpeakingRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, http.StatusBadRequest, "请求参数错误") + return + } + + if err := h.speakingService.GradeSpeaking(id, req.PronunciationScore, req.FluencyScore, req.AccuracyScore, req.OverallScore, req.Feedback, req.Suggestions); err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "评分口语练习失败") + return + } + + common.SuccessResponse(c, gin.H{"message": "评分成功"}) +} + +// ==================== 口语学习统计和进度 ==================== + +// GetSpeakingStats 获取口语学习统计 +func (h *SpeakingHandler) GetSpeakingStats(c *gin.Context) { + userIDInt, exists := utils.GetUserIDFromContext(c) + if !exists { + common.ErrorResponse(c, http.StatusUnauthorized, "用户未认证") + return + } + + userID := utils.Int64ToString(userIDInt) + stats, err := h.speakingService.GetUserSpeakingStats(userID) + if err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "获取口语学习统计失败") + return + } + + common.SuccessResponse(c, stats) +} + +// GetSpeakingProgress 获取口语学习进度 +func (h *SpeakingHandler) GetSpeakingProgress(c *gin.Context) { + userIDInt, exists := utils.GetUserIDFromContext(c) + if !exists { + common.ErrorResponse(c, http.StatusUnauthorized, "用户未认证") + return + } + + scenarioID := c.Param("scenario_id") + if scenarioID == "" { + common.ErrorResponse(c, http.StatusBadRequest, "场景ID不能为空") + return + } + + userID := utils.Int64ToString(userIDInt) + progress, err := h.speakingService.GetSpeakingProgress(userID, scenarioID) + if err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "获取口语学习进度失败") + return + } + + common.SuccessResponse(c, progress) +} \ No newline at end of file diff --git a/serve/api/handlers/test_handler.go b/serve/api/handlers/test_handler.go new file mode 100644 index 0000000..065fdd3 --- /dev/null +++ b/serve/api/handlers/test_handler.go @@ -0,0 +1,419 @@ +package handlers + +import ( + "net/http" + "strconv" + + "github.com/gin-gonic/gin" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" +) + +// TestHandler 测试处理器 +type TestHandler struct { + testService *services.TestService +} + +// NewTestHandler 创建测试处理器实例 +func NewTestHandler(testService *services.TestService) *TestHandler { + return &TestHandler{ + testService: testService, + } +} + +// GetTestTemplates 获取测试模板列表 +// @Summary 获取测试模板列表 +// @Tags Test +// @Param type query string false "测试类型" +// @Param difficulty query string false "难度" +// @Param page query int false "页码" +// @Param page_size query int false "每页数量" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/templates [get] +func (h *TestHandler) GetTestTemplates(c *gin.Context) { + typeStr := c.Query("type") + difficultyStr := c.Query("difficulty") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20")) + + var testType *models.TestType + if typeStr != "" { + t := models.TestType(typeStr) + testType = &t + } + + var difficulty *models.TestDifficulty + if difficultyStr != "" { + d := models.TestDifficulty(difficultyStr) + difficulty = &d + } + + templates, total, err := h.testService.GetTestTemplates(testType, difficulty, page, pageSize) + if err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "获取测试模板失败") + return + } + + common.SuccessResponse(c, gin.H{ + "templates": templates, + "pagination": gin.H{ + "page": page, + "page_size": pageSize, + "total": total, + "total_page": (total + int64(pageSize) - 1) / int64(pageSize), + }, + }) +} + +// GetTestTemplateByID 获取测试模板详情 +// @Summary 获取测试模板详情 +// @Tags Test +// @Param id path string true "模板ID" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/templates/{id} [get] +func (h *TestHandler) GetTestTemplateByID(c *gin.Context) { + id := c.Param("id") + + template, err := h.testService.GetTestTemplateByID(id) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "测试模板不存在") + return + } + + common.SuccessResponse(c, gin.H{"data": template}) +} + +// CreateTestSession 创建测试会话 +// @Summary 创建测试会话 +// @Tags Test +// @Param body body object true "请求体" +// @Success 201 {object} common.Response +// @Router /api/v1/tests/sessions [post] +func (h *TestHandler) CreateTestSession(c *gin.Context) { + userID, exists := utils.GetUserIDFromContext(c) + if !exists { + common.BadRequestResponse(c, "请先登录") + return + } + + var req struct { + TemplateID string `json:"template_id" binding:"required"` + } + + if err := c.ShouldBindJSON(&req); err != nil { + common.BadRequestResponse(c, "请求参数错误") + return + } + + session, err := h.testService.CreateTestSession(req.TemplateID, utils.Int64ToString(userID)) + if err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "创建测试会话失败: "+err.Error()) + return + } + + common.SuccessResponseWithStatus(c, http.StatusCreated, gin.H{"data": session}) +} + +// GetTestSession 获取测试会话 +// @Summary 获取测试会话 +// @Tags Test +// @Param id path string true "会话ID" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/sessions/{id} [get] +func (h *TestHandler) GetTestSession(c *gin.Context) { + sessionID := c.Param("id") + + session, err := h.testService.GetTestSession(sessionID) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "测试会话不存在") + return + } + + // 验证用户权限 + userID, _ := utils.GetUserIDFromContext(c) + if session.UserID != utils.Int64ToString(userID) { + common.ErrorResponse(c, http.StatusForbidden, "无权访问此测试会话") + return + } + + common.SuccessResponse(c, gin.H{"data": session}) +} + +// StartTest 开始测试 +// @Summary 开始测试 +// @Tags Test +// @Param id path string true "会话ID" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/sessions/{id}/start [put] +func (h *TestHandler) StartTest(c *gin.Context) { + sessionID := c.Param("id") + + // 验证用户权限 + session, err := h.testService.GetTestSession(sessionID) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "测试会话不存在") + return + } + + userID, _ := utils.GetUserIDFromContext(c) + if session.UserID != utils.Int64ToString(userID) { + common.ErrorResponse(c, http.StatusForbidden, "无权操作此测试会话") + return + } + + updatedSession, err := h.testService.StartTest(sessionID) + if err != nil { + common.ErrorResponse(c, http.StatusBadRequest, err.Error()) + return + } + + common.SuccessResponse(c, gin.H{"data": updatedSession}) +} + +// SubmitAnswer 提交答案 +// @Summary 提交答案 +// @Tags Test +// @Param id path string true "会话ID" +// @Param body body object true "请求体" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/sessions/{id}/answers [post] +func (h *TestHandler) SubmitAnswer(c *gin.Context) { + sessionID := c.Param("id") + + var req struct { + QuestionID string `json:"question_id" binding:"required"` + Answer string `json:"answer" binding:"required"` + } + + if err := c.ShouldBindJSON(&req); err != nil { + common.BadRequestResponse(c, "请求参数错误") + return + } + + // 验证用户权限 + session, err := h.testService.GetTestSession(sessionID) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "测试会话不存在") + return + } + + userID, _ := utils.GetUserIDFromContext(c) + if session.UserID != utils.Int64ToString(userID) { + common.ErrorResponse(c, http.StatusForbidden, "无权操作此测试会话") + return + } + + updatedSession, err := h.testService.SubmitAnswer(sessionID, req.QuestionID, req.Answer) + if err != nil { + common.ErrorResponse(c, http.StatusBadRequest, err.Error()) + return + } + + common.SuccessResponse(c, gin.H{"data": updatedSession}) +} + +// PauseTest 暂停测试 +// @Summary 暂停测试 +// @Tags Test +// @Param id path string true "会话ID" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/sessions/{id}/pause [put] +func (h *TestHandler) PauseTest(c *gin.Context) { + sessionID := c.Param("id") + + // 验证用户权限 + session, err := h.testService.GetTestSession(sessionID) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "测试会话不存在") + return + } + + userID, _ := utils.GetUserIDFromContext(c) + if session.UserID != utils.Int64ToString(userID) { + common.ErrorResponse(c, http.StatusForbidden, "无权操作此测试会话") + return + } + + updatedSession, err := h.testService.PauseTest(sessionID) + if err != nil { + common.ErrorResponse(c, http.StatusBadRequest, err.Error()) + return + } + + common.SuccessResponse(c, gin.H{"data": updatedSession}) +} + +// ResumeTest 恢复测试 +// @Summary 恢复测试 +// @Tags Test +// @Param id path string true "会话ID" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/sessions/{id}/resume [put] +func (h *TestHandler) ResumeTest(c *gin.Context) { + sessionID := c.Param("id") + + // 验证用户权限 + session, err := h.testService.GetTestSession(sessionID) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "测试会话不存在") + return + } + + userID, _ := utils.GetUserIDFromContext(c) + if session.UserID != utils.Int64ToString(userID) { + common.ErrorResponse(c, http.StatusForbidden, "无权操作此测试会话") + return + } + + updatedSession, err := h.testService.ResumeTest(sessionID) + if err != nil { + common.ErrorResponse(c, http.StatusBadRequest, err.Error()) + return + } + + common.SuccessResponse(c, gin.H{"data": updatedSession}) +} + +// CompleteTest 完成测试 +// @Summary 完成测试 +// @Tags Test +// @Param id path string true "会话ID" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/sessions/{id}/complete [put] +func (h *TestHandler) CompleteTest(c *gin.Context) { + sessionID := c.Param("id") + + // 验证用户权限 + session, err := h.testService.GetTestSession(sessionID) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "测试会话不存在") + return + } + + userID, _ := utils.GetUserIDFromContext(c) + if session.UserID != utils.Int64ToString(userID) { + common.ErrorResponse(c, http.StatusForbidden, "无权操作此测试会话") + return + } + + result, err := h.testService.CompleteTest(sessionID) + if err != nil { + common.ErrorResponse(c, http.StatusBadRequest, err.Error()) + return + } + + common.SuccessResponse(c, gin.H{"data": result}) +} + +// GetUserTestHistory 获取用户测试历史 +// @Summary 获取用户测试历史 +// @Tags Test +// @Param page query int false "页码" +// @Param page_size query int false "每页数量" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/sessions [get] +func (h *TestHandler) GetUserTestHistory(c *gin.Context) { + userID, exists := utils.GetUserIDFromContext(c) + if !exists { + common.BadRequestResponse(c, "请先登录") + return + } + + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + results, total, err := h.testService.GetUserTestHistory(utils.Int64ToString(userID), page, pageSize) + if err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "获取测试历史失败") + return + } + + common.SuccessResponse(c, gin.H{ + "sessions": results, + "pagination": gin.H{ + "page": page, + "page_size": pageSize, + "total": total, + "total_page": (total + int64(pageSize) - 1) / int64(pageSize), + }, + }) +} + +// GetTestResultByID 获取测试结果详情 +// @Summary 获取测试结果详情 +// @Tags Test +// @Param id path string true "结果ID" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/results/{id} [get] +func (h *TestHandler) GetTestResultByID(c *gin.Context) { + resultID := c.Param("id") + + result, err := h.testService.GetTestResultByID(resultID) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "测试结果不存在") + return + } + + // 验证用户权限 + userID, _ := utils.GetUserIDFromContext(c) + if result.UserID != utils.Int64ToString(userID) { + common.ErrorResponse(c, http.StatusForbidden, "无权访问此测试结果") + return + } + + common.SuccessResponse(c, gin.H{"data": result}) +} + +// GetUserTestStats 获取用户测试统计 +// @Summary 获取用户测试统计 +// @Tags Test +// @Success 200 {object} common.Response +// @Router /api/v1/tests/stats [get] +func (h *TestHandler) GetUserTestStats(c *gin.Context) { + userID, exists := utils.GetUserIDFromContext(c) + if !exists { + common.BadRequestResponse(c, "请先登录") + return + } + + stats, err := h.testService.GetUserTestStats(utils.Int64ToString(userID)) + if err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "获取测试统计失败") + return + } + + common.SuccessResponse(c, stats) +} + +// DeleteTestResult 删除测试结果 +// @Summary 删除测试结果 +// @Tags Test +// @Param id path string true "结果ID" +// @Success 200 {object} common.Response +// @Router /api/v1/tests/results/{id} [delete] +func (h *TestHandler) DeleteTestResult(c *gin.Context) { + resultID := c.Param("id") + + // 验证用户权限 + result, err := h.testService.GetTestResultByID(resultID) + if err != nil { + common.ErrorResponse(c, http.StatusNotFound, "测试结果不存在") + return + } + + userID, _ := utils.GetUserIDFromContext(c) + if result.UserID != utils.Int64ToString(userID) { + common.ErrorResponse(c, http.StatusForbidden, "无权删除此测试结果") + return + } + + if err := h.testService.DeleteTestResult(resultID); err != nil { + common.ErrorResponse(c, http.StatusInternalServerError, "删除测试结果失败") + return + } + + common.SuccessResponse(c, gin.H{"message": "删除成功"}) +} diff --git a/serve/api/handlers/user_handler.go b/serve/api/handlers/user_handler.go new file mode 100644 index 0000000..ac78a49 --- /dev/null +++ b/serve/api/handlers/user_handler.go @@ -0,0 +1,296 @@ +package handlers + +import ( + "net/http" + "strconv" + + "github.com/gin-gonic/gin" + "github.com/go-playground/validator/v10" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" +) + +// UserHandler 用户处理器 +type UserHandler struct { + userService *services.UserService + validator *validator.Validate +} + +// NewUserHandler 创建用户处理器实例 +func NewUserHandler(userService *services.UserService) *UserHandler { + return &UserHandler{ + userService: userService, + validator: validator.New(), + } +} + +// UpdateUserRequest 更新用户信息请求结构 +type UpdateUserRequest struct { + Username string `json:"username" validate:"omitempty,min=3,max=20"` + Email string `json:"email" validate:"omitempty,email"` + Nickname string `json:"nickname" validate:"omitempty,min=1,max=50"` + Avatar string `json:"avatar" validate:"omitempty,url"` + Timezone string `json:"timezone" validate:"omitempty"` + Language string `json:"language" validate:"omitempty"` +} + +// UpdateUserPreferencesRequest 更新用户偏好设置请求结构 +type UpdateUserPreferencesRequest struct { + DailyGoal int `json:"daily_goal" validate:"omitempty,min=1,max=1000"` + WeeklyGoal int `json:"weekly_goal" validate:"omitempty,min=1,max=7000"` + ReminderEnabled bool `json:"reminder_enabled"` + DifficultyLevel string `json:"difficulty_level" validate:"omitempty,oneof=beginner intermediate advanced"` + LearningMode string `json:"learning_mode" validate:"omitempty,oneof=casual intensive exam"` +} + +// UserStatsResponse 用户学习统计响应结构 +type UserStatsResponse struct { + TotalWords int `json:"total_words"` + LearnedWords int `json:"learned_words"` + MasteredWords int `json:"mastered_words"` + StudyDays int `json:"study_days"` + ConsecutiveDays int `json:"consecutive_days"` + TotalStudyTime int `json:"total_study_time"` // 分钟 +} + +// GetUserProfile 获取用户信息 +func (h *UserHandler) GetUserProfile(c *gin.Context) { + userID, exists := utils.GetUserIDFromContext(c) + if !exists { + common.BadRequestResponse(c, "请先登录") + return + } + + user, err := h.userService.GetUserByID(userID) + if err != nil { + if businessErr, ok := err.(*common.BusinessError); ok { + common.ErrorResponse(c, http.StatusBadRequest, businessErr.Message) + return + } + common.InternalServerErrorResponse(c, "获取用户信息失败") + return + } + + // 获取用户偏好设置 + preferences, err := h.userService.GetUserPreferences(userID) + if err != nil { + // 偏好设置获取失败不影响用户信息返回，记录日志即可 + preferences = nil + } + + // 构造响应数据 + response := map[string]interface{}{ + "id": user.ID, + "username": user.Username, + "email": user.Email, + "nickname": user.Nickname, + "avatar": user.Avatar, + "timezone": user.Timezone, + "language": user.Language, + "status": user.Status, + "created_at": user.CreatedAt, + "updated_at": user.UpdatedAt, + } + + if preferences != nil { + response["preferences"] = map[string]interface{}{ + "daily_goal": preferences.DailyGoal, + "weekly_goal": preferences.WeeklyGoal, + "reminder_enabled": preferences.ReminderEnabled, + "difficulty_level": preferences.DifficultyLevel, + "learning_mode": preferences.LearningMode, + } + } + + common.SuccessResponse(c, response) +} + +// UpdateUserProfile 更新用户信息 +func (h *UserHandler) UpdateUserProfile(c *gin.Context) { + userID, exists := utils.GetUserIDFromContext(c) + if !exists { + common.BadRequestResponse(c, "请先登录") + return + } + + var req UpdateUserRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 验证请求参数 + if err := h.validator.Struct(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 构造更新数据 + updates := make(map[string]interface{}) + if req.Username != "" { + updates["username"] = req.Username + } + if req.Email != "" { + updates["email"] = req.Email + } + if req.Nickname != "" { + updates["nickname"] = req.Nickname + } + if req.Avatar != "" { + updates["avatar"] = req.Avatar + } + if req.Timezone != "" { + updates["timezone"] = req.Timezone + } + if req.Language != "" { + updates["language"] = req.Language + } + + if len(updates) == 0 { + common.BadRequestResponse(c, "没有需要更新的字段") + return + } + + // 更新用户信息 + user, err := h.userService.UpdateUser(userID, updates) + if err != nil { + if businessErr, ok := err.(*common.BusinessError); ok { + common.ErrorResponse(c, http.StatusBadRequest, businessErr.Message) + return + } + common.InternalServerErrorResponse(c, "更新用户信息失败") + return + } + + common.SuccessResponse(c, user) +} + +// UpdateUserPreferences 更新用户偏好设置 +func (h *UserHandler) UpdateUserPreferences(c *gin.Context) { + userID, exists := utils.GetUserIDFromContext(c) + if !exists { + common.BadRequestResponse(c, "请先登录") + return + } + + var req UpdateUserPreferencesRequest + if err := c.ShouldBindJSON(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 验证请求参数 + if err := h.validator.Struct(&req); err != nil { + common.ValidationErrorResponse(c, err) + return + } + + // 构造更新数据 + updates := make(map[string]interface{}) + if req.DailyGoal > 0 { + updates["daily_goal"] = req.DailyGoal + } + if req.WeeklyGoal > 0 { + updates["weekly_goal"] = req.WeeklyGoal + } + updates["reminder_enabled"] = req.ReminderEnabled + if req.DifficultyLevel != "" { + updates["difficulty_level"] = req.DifficultyLevel + } + if req.LearningMode != "" { + updates["learning_mode"] = req.LearningMode + } + + // 更新用户偏好设置 + preferences, err := h.userService.UpdateUserPreferences(userID, updates) + if err != nil { + if businessErr, ok := err.(*common.BusinessError); ok { + common.ErrorResponse(c, http.StatusBadRequest, businessErr.Message) + return + } + common.InternalServerErrorResponse(c, "更新偏好设置失败") + return + } + + common.SuccessResponse(c, preferences) +} + +// GetUserStats 获取用户学习统计 +func (h *UserHandler) GetUserStats(c *gin.Context) { + userID, exists := utils.GetUserIDFromContext(c) + if !exists { + common.BadRequestResponse(c, "请先登录") + return + } + + // 获取时间范围参数 + timeRange := c.DefaultQuery("time_range", "all") // all, week, month, year + + // 这里需要实现具体的统计逻辑，暂时返回模拟数据 + // TODO: 实现真实的统计查询，使用userID和timeRange参数 + _ = userID // 避免未使用变量错误 + _ = timeRange // 避免未使用变量错误 + stats := &UserStatsResponse{ + TotalWords: 1000, + LearnedWords: 750, + MasteredWords: 500, + StudyDays: 30, + ConsecutiveDays: 7, + TotalStudyTime: 1800, // 30小时 + } + + common.SuccessResponse(c, stats) +} + +// GetUserLearningProgress 获取用户学习进度 +func (h *UserHandler) GetUserLearningProgress(c *gin.Context) { + userID, exists := utils.GetUserIDFromContext(c) + if !exists { + common.BadRequestResponse(c, "请先登录") + return + } + + // 获取分页参数 + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "20")) + if page < 1 { + page = 1 + } + if limit < 1 || limit > 100 { + limit = 20 + } + + // 获取过滤参数 + masteryLevel := c.Query("mastery_level") + categoryID := c.Query("category_id") + + // 调用词汇服务获取用户的学习进度 + progressList, total, err := h.userService.GetUserLearningProgress(utils.Int64ToString(userID), page, limit) + if err != nil { + common.InternalServerErrorResponse(c, "获取学习进度失败") + return + } + + totalPages := int64(0) + if limit > 0 { + totalPages = (total + int64(limit) - 1) / int64(limit) + } + + response := map[string]interface{}{ + "progress": progressList, + "pagination": map[string]interface{}{ + "page": page, + "limit": limit, + "total": total, + "total_page": totalPages, + }, + "filters": map[string]interface{}{ + "mastery_level": masteryLevel, + "category_id": categoryID, + }, + } + + common.SuccessResponse(c, response) +} \ No newline at end of file diff --git a/serve/api/handlers/writing_handler.go b/serve/api/handlers/writing_handler.go new file mode 100644 index 0000000..81182af --- /dev/null +++ b/serve/api/handlers/writing_handler.go @@ -0,0 +1,761 @@ +package handlers + +import ( + "net/http" + "strconv" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" + "github.com/gin-gonic/gin" + "github.com/google/uuid" +) + +// WritingHandler 写作练习处理器 +type WritingHandler struct { + writingService *services.WritingService +} + +// NewWritingHandler 创建写作练习处理器实例 +func NewWritingHandler(writingService *services.WritingService) *WritingHandler { + return &WritingHandler{ + writingService: writingService, + } +} + +// ===== 请求和响应结构体 ===== + +// CreateWritingPromptRequest 创建写作题目请求 +type CreateWritingPromptRequest struct { + Title string `json:"title" binding:"required"` + Prompt string `json:"prompt" binding:"required"` + Instructions *string `json:"instructions"` + MinWords *int `json:"min_words"` + MaxWords *int `json:"max_words"` + TimeLimit *int `json:"time_limit"` + Level string `json:"level" binding:"required"` + Category string `json:"category"` + Tags *string `json:"tags"` + SampleAnswer *string `json:"sample_answer"` + Rubric *string `json:"rubric"` +} + +// UpdateWritingPromptRequest 更新写作题目请求 +type UpdateWritingPromptRequest struct { + Title *string `json:"title"` + Prompt *string `json:"prompt"` + Instructions *string `json:"instructions"` + MinWords *int `json:"min_words"` + MaxWords *int `json:"max_words"` + TimeLimit *int `json:"time_limit"` + Level *string `json:"level"` + Category *string `json:"category"` + Tags *string `json:"tags"` + SampleAnswer *string `json:"sample_answer"` + Rubric *string `json:"rubric"` +} + +// CreateWritingSubmissionRequest 创建写作提交请求 +type CreateWritingSubmissionRequest struct { + PromptID string `json:"prompt_id" binding:"required"` +} + +// SubmitWritingRequest 提交写作请求 +type SubmitWritingRequest struct { + Content string `json:"content" binding:"required"` + TimeSpent int `json:"time_spent" binding:"required"` +} + +// GradeWritingRequest AI批改请求 +type GradeWritingRequest struct { + Score float64 `json:"score" binding:"required,min=0,max=100"` + GrammarScore float64 `json:"grammar_score" binding:"required,min=0,max=100"` + VocabScore float64 `json:"vocab_score" binding:"required,min=0,max=100"` + CoherenceScore float64 `json:"coherence_score" binding:"required,min=0,max=100"` + Feedback string `json:"feedback" binding:"required"` + Suggestions string `json:"suggestions"` +} + +// Response 通用响应结构 +type Response struct { + Message string `json:"message"` + Data interface{} `json:"data,omitempty"` + Error string `json:"error,omitempty"` +} + +// ===== 写作题目管理接口 ===== + +// GetWritingPrompts 获取写作题目列表 +// @Summary 获取写作题目列表 +// @Description 获取写作题目列表，支持按难度和分类筛选 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param difficulty query string false "难度筛选" +// @Param category query string false "分类筛选" +// @Param page query int false "页码" default(1) +// @Param limit query int false "每页数量" default(10) +// @Success 200 {object} Response +// @Router /writing/prompts [get] +func (h *WritingHandler) GetWritingPrompts(c *gin.Context) { + difficulty := c.Query("difficulty") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "10")) + + offset := (page - 1) * limit + + prompts, err := h.writingService.GetWritingPrompts(difficulty, category, limit, offset) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "获取写作题目失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "获取写作题目成功", + "data": prompts, + "pagination": gin.H{ + "page": page, + "limit": limit, + "total": len(prompts), + }, + }) +} + +// GetWritingPrompt 获取单个写作题目 +// @Summary 获取写作题目详情 +// @Description 根据ID获取写作题目详情 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param id path string true "题目ID" +// @Success 200 {object} Response +// @Router /writing/prompts/{id} [get] +func (h *WritingHandler) GetWritingPrompt(c *gin.Context) { + id := c.Param("id") + + prompt, err := h.writingService.GetWritingPrompt(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "error": "写作题目不存在", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "获取写作题目成功", + "data": prompt, + }) +} + +// CreateWritingPrompt 创建写作题目 +// @Summary 创建写作题目 +// @Description 创建新的写作题目 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param request body CreateWritingPromptRequest true "创建请求" +// @Success 201 {object} Response +// @Router /writing/prompts [post] +func (h *WritingHandler) CreateWritingPrompt(c *gin.Context) { + var req CreateWritingPromptRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "请求参数错误", + "details": err.Error(), + }) + return + } + + prompt := &models.WritingPrompt{ + ID: uuid.New().String(), + Title: req.Title, + Prompt: req.Prompt, + Instructions: req.Instructions, + MinWords: req.MinWords, + MaxWords: req.MaxWords, + TimeLimit: req.TimeLimit, + Level: req.Level, + Category: req.Category, + Tags: req.Tags, + SampleAnswer: req.SampleAnswer, + Rubric: req.Rubric, + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + if err := h.writingService.CreateWritingPrompt(prompt); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "创建写作题目失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusCreated, gin.H{ + "message": "写作题目创建成功", + "data": prompt, + }) +} + +// UpdateWritingPrompt 更新写作题目 +// @Summary 更新写作题目 +// @Description 更新写作题目信息 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param id path string true "题目ID" +// @Param request body UpdateWritingPromptRequest true "更新请求" +// @Success 200 {object} Response +// @Router /writing/prompts/{id} [put] +func (h *WritingHandler) UpdateWritingPrompt(c *gin.Context) { + id := c.Param("id") + + var req UpdateWritingPromptRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "请求参数错误", + "details": err.Error(), + }) + return + } + + // 检查题目是否存在 + existingPrompt, err := h.writingService.GetWritingPrompt(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "error": "写作题目不存在", + "details": err.Error(), + }) + return + } + + // 构建更新数据 + updateData := &models.WritingPrompt{ + UpdatedAt: time.Now(), + } + + if req.Title != nil { + updateData.Title = *req.Title + } + if req.Prompt != nil { + updateData.Prompt = *req.Prompt + } + if req.Instructions != nil { + updateData.Instructions = req.Instructions + } + if req.MinWords != nil { + updateData.MinWords = req.MinWords + } + if req.MaxWords != nil { + updateData.MaxWords = req.MaxWords + } + if req.TimeLimit != nil { + updateData.TimeLimit = req.TimeLimit + } + if req.Level != nil { + updateData.Level = *req.Level + } + if req.Category != nil { + updateData.Category = *req.Category + } + if req.Tags != nil { + updateData.Tags = req.Tags + } + if req.SampleAnswer != nil { + updateData.SampleAnswer = req.SampleAnswer + } + if req.Rubric != nil { + updateData.Rubric = req.Rubric + } + + if err := h.writingService.UpdateWritingPrompt(id, updateData); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "更新写作题目失败", + "details": err.Error(), + }) + return + } + + // 返回更新后的题目 + updatedPrompt, _ := h.writingService.GetWritingPrompt(id) + c.JSON(http.StatusOK, gin.H{ + "message": "写作题目更新成功", + "data": updatedPrompt, + "original": existingPrompt, + }) +} + +// DeleteWritingPrompt 删除写作题目 +// @Summary 删除写作题目 +// @Description 软删除写作题目 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param id path string true "题目ID" +// @Success 200 {object} Response +// @Router /writing/prompts/{id} [delete] +func (h *WritingHandler) DeleteWritingPrompt(c *gin.Context) { + id := c.Param("id") + + // 检查题目是否存在 + _, err := h.writingService.GetWritingPrompt(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "error": "写作题目不存在", + "details": err.Error(), + }) + return + } + + if err := h.writingService.DeleteWritingPrompt(id); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "删除写作题目失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "写作题目删除成功", + }) +} + +// SearchWritingPrompts 搜索写作题目 +// @Summary 搜索写作题目 +// @Description 根据关键词搜索写作题目 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param keyword query string true "搜索关键词" +// @Param difficulty query string false "难度筛选" +// @Param category query string false "分类筛选" +// @Param page query int false "页码" default(1) +// @Param limit query int false "每页数量" default(10) +// @Success 200 {object} Response +// @Router /writing/prompts/search [get] +func (h *WritingHandler) SearchWritingPrompts(c *gin.Context) { + keyword := c.Query("keyword") + if keyword == "" { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "搜索关键词不能为空", + }) + return + } + + difficulty := c.Query("difficulty") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "10")) + + offset := (page - 1) * limit + + prompts, err := h.writingService.SearchWritingPrompts(keyword, difficulty, category, limit, offset) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "搜索写作题目失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "搜索写作题目成功", + "data": prompts, + "search_params": gin.H{ + "keyword": keyword, + "difficulty": difficulty, + "category": category, + }, + "pagination": gin.H{ + "page": page, + "limit": limit, + "total": len(prompts), + }, + }) +} + +// GetRecommendedPrompts 获取推荐写作题目 +// @Summary 获取推荐写作题目 +// @Description 根据用户历史表现推荐合适的写作题目 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param limit query int false "推荐数量" default(5) +// @Success 200 {object} Response +// @Router /writing/prompts/recommendations [get] +func (h *WritingHandler) GetRecommendedPrompts(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "5")) + + prompts, err := h.writingService.GetRecommendedPrompts(utils.Int64ToString(userID), limit) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "获取推荐题目失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "获取推荐题目成功", + "data": prompts, + }) +} + +// ===== 写作提交管理接口 ===== + +// CreateWritingSubmission 创建写作提交 +// @Summary 创建写作提交 +// @Description 开始写作练习，创建写作提交记录 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param request body CreateWritingSubmissionRequest true "创建请求" +// @Success 201 {object} Response +// @Router /writing/submissions [post] +func (h *WritingHandler) CreateWritingSubmission(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + var req CreateWritingSubmissionRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "请求参数错误", + "details": err.Error(), + }) + return + } + + // 检查是否已有该题目的提交记录 + existingSubmission, err := h.writingService.GetWritingProgress(utils.Int64ToString(userID), req.PromptID) + if err == nil && existingSubmission != nil { + c.JSON(http.StatusOK, gin.H{ + "message": "写作提交记录已存在", + "data": existingSubmission, + }) + return + } + + submission := &models.WritingSubmission{ + ID: uuid.New().String(), + UserID: utils.Int64ToString(userID), + PromptID: req.PromptID, + StartedAt: time.Now(), + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + if err := h.writingService.CreateWritingSubmission(submission); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "创建写作提交失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusCreated, gin.H{ + "message": "写作提交创建成功", + "data": submission, + }) +} + +// SubmitWriting 提交写作作业 +// @Summary 提交写作作业 +// @Description 提交完成的写作内容 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param id path string true "提交ID" +// @Param request body SubmitWritingRequest true "提交请求" +// @Success 200 {object} Response +// @Router /writing/submissions/{id}/submit [put] +func (h *WritingHandler) SubmitWriting(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + submissionID := c.Param("id") + + var req SubmitWritingRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "请求参数错误", + "details": err.Error(), + }) + return + } + + // 检查提交记录是否存在且属于当前用户 + submission, err := h.writingService.GetWritingSubmission(submissionID) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "error": "写作提交不存在", + "details": err.Error(), + }) + return + } + + if submission.UserID != utils.Int64ToString(userID) { + c.JSON(http.StatusForbidden, gin.H{ + "error": "无权限访问此提交记录", + }) + return + } + + if submission.SubmittedAt != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "该写作已经提交，无法重复提交", + }) + return + } + + if err := h.writingService.SubmitWriting(submissionID, req.Content, req.TimeSpent); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "提交写作失败", + "details": err.Error(), + }) + return + } + + // 返回更新后的提交记录 + updatedSubmission, _ := h.writingService.GetWritingSubmission(submissionID) + c.JSON(http.StatusOK, gin.H{ + "message": "写作提交成功", + "data": updatedSubmission, + }) +} + +// GradeWriting AI批改写作 +// @Summary AI批改写作 +// @Description 对提交的写作进行AI批改和评分 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param id path string true "提交ID" +// @Param request body GradeWritingRequest true "批改请求" +// @Success 200 {object} Response +// @Router /writing/submissions/{id}/grade [put] +func (h *WritingHandler) GradeWriting(c *gin.Context) { + submissionID := c.Param("id") + + var req GradeWritingRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "请求参数错误", + "details": err.Error(), + }) + return + } + + // 检查提交记录是否存在 + submission, err := h.writingService.GetWritingSubmission(submissionID) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "error": "写作提交不存在", + "details": err.Error(), + }) + return + } + + if submission.SubmittedAt == nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "该写作尚未提交，无法批改", + }) + return + } + + if submission.GradedAt != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "该写作已经批改，无法重复批改", + }) + return + } + + if err := h.writingService.GradeWriting( + submissionID, + req.Score, + req.GrammarScore, + req.VocabScore, + req.CoherenceScore, + req.Feedback, + req.Suggestions, + ); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "批改写作失败", + "details": err.Error(), + }) + return + } + + // 返回更新后的提交记录 + updatedSubmission, _ := h.writingService.GetWritingSubmission(submissionID) + c.JSON(http.StatusOK, gin.H{ + "message": "写作批改成功", + "data": updatedSubmission, + }) +} + +// GetWritingSubmission 获取写作提交详情 +// @Summary 获取写作提交详情 +// @Description 根据ID获取写作提交详情 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param id path string true "提交ID" +// @Success 200 {object} Response +// @Router /writing/submissions/{id} [get] +func (h *WritingHandler) GetWritingSubmission(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + submissionID := c.Param("id") + + submission, err := h.writingService.GetWritingSubmission(submissionID) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "error": "写作提交不存在", + "details": err.Error(), + }) + return + } + + // 检查权限 + if submission.UserID != utils.Int64ToString(userID) { + c.JSON(http.StatusForbidden, gin.H{ + "error": "无权限访问此提交记录", + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "获取写作提交成功", + "data": submission, + }) +} + +// GetUserWritingSubmissions 获取用户写作提交列表 +// @Summary 获取用户写作提交列表 +// @Description 获取当前用户的写作提交列表 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param page query int false "页码" default(1) +// @Param limit query int false "每页数量" default(10) +// @Success 200 {object} Response +// @Router /writing/submissions [get] +func (h *WritingHandler) GetUserWritingSubmissions(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "10")) + + offset := (page - 1) * limit + + submissions, err := h.writingService.GetUserWritingSubmissions(utils.Int64ToString(userID), limit, offset) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "获取写作提交列表失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "获取写作提交列表成功", + "data": submissions, + "pagination": gin.H{ + "page": page, + "limit": limit, + "total": len(submissions), + }, + }) +} + +// ===== 写作统计和进度接口 ===== + +// GetWritingStats 获取用户写作统计 +// @Summary 获取用户写作统计 +// @Description 获取用户写作学习统计数据 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Success 200 {object} Response +// @Router /writing/stats [get] +func (h *WritingHandler) GetWritingStats(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + stats, err := h.writingService.GetUserWritingStats(utils.Int64ToString(userID)) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "获取写作统计失败", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "获取写作统计成功", + "data": stats, + }) +} + +// GetWritingProgress 获取写作进度 +// @Summary 获取写作进度 +// @Description 获取用户在特定题目上的写作进度 +// @Tags 写作练习 +// @Accept json +// @Produce json +// @Param prompt_id path string true "题目ID" +// @Success 200 {object} Response +// @Router /writing/progress/{prompt_id} [get] +func (h *WritingHandler) GetWritingProgress(c *gin.Context) { + userID, ok := utils.GetUserIDFromContext(c) + if !ok { + c.JSON(http.StatusUnauthorized, gin.H{"error": "用户未认证"}) + return + } + + promptID := c.Param("prompt_id") + + progress, err := h.writingService.GetWritingProgress(utils.Int64ToString(userID), promptID) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{ + "error": "写作进度不存在", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "获取写作进度成功", + "data": progress, + }) +} \ No newline at end of file diff --git a/serve/api/middleware.go b/serve/api/middleware.go new file mode 100644 index 0000000..2c2e9df --- /dev/null +++ b/serve/api/middleware.go @@ -0,0 +1,61 @@ +package api + +import ( + "net/http" + "strings" + + "github.com/gin-gonic/gin" +) + +// AuthMiddleware JWT认证中间件 +func AuthMiddleware() gin.HandlerFunc { + return func(c *gin.Context) { + // 获取Authorization头 + authHeader := c.GetHeader("Authorization") + if authHeader == "" { + c.JSON(http.StatusUnauthorized, gin.H{ + "code": 401, + "message": "Authorization header is required", + }) + c.Abort() + return + } + + // 检查Bearer token格式 + tokenString := strings.TrimPrefix(authHeader, "Bearer ") + if tokenString == authHeader { + c.JSON(http.StatusUnauthorized, gin.H{ + "code": 401, + "message": "Invalid authorization header format", + }) + c.Abort() + return + } + + // TODO: 验证JWT token + // 这里应该验证token的有效性，解析用户信息等 + // 暂时跳过验证，直接放行 + + // 设置用户ID到上下文中（示例） + c.Set("user_id", "example_user_id") + + c.Next() + } +} + +// CORSMiddleware CORS中间件 +func CORSMiddleware() gin.HandlerFunc { + return func(c *gin.Context) { + c.Header("Access-Control-Allow-Origin", "*") + c.Header("Access-Control-Allow-Credentials", "true") + c.Header("Access-Control-Allow-Headers", "Content-Type, Content-Length, Accept-Encoding, X-CSRF-Token, Authorization, accept, origin, Cache-Control, X-Requested-With") + c.Header("Access-Control-Allow-Methods", "POST, OPTIONS, GET, PUT, DELETE") + + if c.Request.Method == "OPTIONS" { + c.AbortWithStatus(204) + return + } + + c.Next() + } +} \ No newline at end of file diff --git a/serve/api/router.go b/serve/api/router.go new file mode 100644 index 0000000..c923348 --- /dev/null +++ b/serve/api/router.go @@ -0,0 +1,373 @@ +// api/router.go +package api + +import ( + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/api/handlers" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/config" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/database" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/handler" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/middleware" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/gin-gonic/gin" + "github.com/go-playground/validator/v10" +) + +// SetupRouter 配置所有路由 +func SetupRouter() *gin.Engine { + // 根据环境设置Gin模式 + gin.SetMode(config.GlobalConfig.Server.Mode) + + // 创建路由引擎，不使用默认中间件 + router := gin.New() + + // 添加自定义中间件 + router.Use(middleware.RequestID()) + router.Use(middleware.RequestResponseLogger()) + router.Use(middleware.ErrorHandler()) + router.Use(middleware.CORS()) + router.Use(middleware.RateLimiter()) + + // 静态文件服务 - 提供上传文件的访问 + router.Static("/uploads", "./uploads") + + // 初始化数据库连接 + db := database.GetDB() + + // 初始化验证器 + validate := validator.New() + + // 初始化服务 + userService := services.NewUserService(db) + vocabularyService := services.NewVocabularyService(db) + learningSessionService := services.NewLearningSessionService(db) + listeningService := services.NewListeningService(db) + readingService := services.NewReadingService(db) + writingService := services.NewWritingService(db) + speakingService := services.NewSpeakingService(db) + testService := services.NewTestService(db) + notificationService := services.NewNotificationService(db) + wordBookService := services.NewWordBookService(db) + studyPlanService := services.NewStudyPlanService(db) + + // 初始化处理器 + authHandler := handlers.NewAuthHandler(userService) + userHandler := handlers.NewUserHandler(userService) + vocabularyHandler := handler.NewVocabularyHandler(vocabularyService) + learningSessionHandler := handler.NewLearningSessionHandler(learningSessionService) + listeningHandler := handlers.NewListeningHandler(listeningService, validate) + readingHandler := handlers.NewReadingHandler(readingService) + writingHandler := handlers.NewWritingHandler(writingService) + speakingHandler := handlers.NewSpeakingHandler(speakingService) + testHandler := handlers.NewTestHandler(testService) + notificationHandler := handler.NewNotificationHandler(notificationService) + wordBookHandler := handler.NewWordBookHandler(wordBookService) + studyPlanHandler := handler.NewStudyPlanHandler(studyPlanService) + aiHandler := handler.NewAIHandler() + uploadHandler := handler.NewUploadHandler() + + + + // 健康检查和系统信息路由 + router.GET("/health", handlers.HealthCheck) + router.GET("/health/readiness", handlers.ReadinessCheck) + router.GET("/health/liveness", handlers.LivenessCheck) + router.GET("/version", handlers.GetVersion) + + // 为 /hello 路径注册 HelloHandler + router.GET("/hello", handlers.HelloHandler) + + // 认证相关路由（无需认证） + auth := router.Group("/api/v1/auth") + { + auth.POST("/register", authHandler.Register) + auth.POST("/login", authHandler.Login) + auth.POST("/refresh", authHandler.RefreshToken) + } + + // 用户相关路由（需要认证） + user := router.Group("/api/v1/user") + user.Use(middleware.AuthMiddleware()) + { + user.GET("/profile", userHandler.GetUserProfile) + user.PUT("/profile", userHandler.UpdateUserProfile) + user.GET("/stats", userHandler.GetUserStats) + user.GET("/learning-progress", userHandler.GetUserLearningProgress) + user.POST("/change-password", authHandler.ChangePassword) + } + + // 词汇相关路由 + vocabulary := router.Group("/api/v1/vocabulary") + vocabulary.Use(middleware.AuthMiddleware()) + { + // 词汇分类 + vocabulary.GET("/categories", vocabularyHandler.GetCategories) + vocabulary.POST("/categories", vocabularyHandler.CreateCategory) + vocabulary.PUT("/categories/:id", vocabularyHandler.UpdateCategory) + vocabulary.DELETE("/categories/:id", vocabularyHandler.DeleteCategory) + + // 词汇管理 + vocabulary.GET("/categories/:id/vocabularies", vocabularyHandler.GetVocabulariesByCategory) + vocabulary.GET("/:id", vocabularyHandler.GetVocabularyByID) + vocabulary.POST("/", vocabularyHandler.CreateVocabulary) + vocabulary.GET("/search", vocabularyHandler.SearchVocabularies) + + // 用户单词学习进度 + vocabulary.GET("/words/:id/progress", vocabularyHandler.GetUserWordProgress) + vocabulary.PUT("/words/:id/progress", vocabularyHandler.UpdateUserWordProgress) + + // 用户词汇进度 + vocabulary.GET("/progress/:id", vocabularyHandler.GetUserVocabularyProgress) + vocabulary.PUT("/progress/:id", vocabularyHandler.UpdateUserVocabularyProgress) + vocabulary.GET("/stats", vocabularyHandler.GetUserVocabularyStats) + + // 词汇测试 + vocabulary.POST("/tests", vocabularyHandler.CreateVocabularyTest) + vocabulary.GET("/tests/:id", vocabularyHandler.GetVocabularyTest) + vocabulary.PUT("/tests/:id/result", vocabularyHandler.UpdateVocabularyTestResult) + + // 每日学习统计 + vocabulary.GET("/daily", vocabularyHandler.GetDailyVocabularyStats) + + // 学习相关API + vocabulary.GET("/study/today", vocabularyHandler.GetTodayStudyWords) + vocabulary.GET("/study/statistics", vocabularyHandler.GetStudyStatistics) + vocabulary.GET("/study/statistics/history", vocabularyHandler.GetStudyStatisticsHistory) + + // 词汇书相关API + vocabulary.GET("/books/categories", vocabularyHandler.GetVocabularyBookCategories) + vocabulary.GET("/books/system", vocabularyHandler.GetSystemVocabularyBooks) + vocabulary.GET("/books/:id/words", vocabularyHandler.GetVocabularyBookWords) + vocabulary.GET("/books/:id/progress", vocabularyHandler.GetVocabularyBookProgress) + + // 学习会话相关API + vocabulary.POST("/books/:id/learn", learningSessionHandler.StartLearning) + vocabulary.GET("/books/:id/tasks", learningSessionHandler.GetTodayTasks) + vocabulary.GET("/books/:id/statistics", learningSessionHandler.GetLearningStatistics) + vocabulary.POST("/words/:id/study", learningSessionHandler.SubmitWordStudy) + } + + // 学习统计相关路由（全局统计，不限词汇书） + learning := router.Group("/api/v1/learning") + learning.Use(middleware.AuthMiddleware()) + { + learning.GET("/today/statistics", learningSessionHandler.GetTodayOverallStatistics) + learning.GET("/today/review-words", learningSessionHandler.GetTodayReviewWords) + } + + // 听力训练相关路由 + listening := router.Group("/api/v1/listening") + listening.Use(middleware.AuthMiddleware()) + { + // 听力材料管理 + listening.GET("/materials", listeningHandler.GetListeningMaterials) + listening.GET("/materials/:id", listeningHandler.GetListeningMaterial) + listening.POST("/materials", listeningHandler.CreateListeningMaterial) + listening.PUT("/materials/:id", listeningHandler.UpdateListeningMaterial) + listening.DELETE("/materials/:id", listeningHandler.DeleteListeningMaterial) + listening.GET("/materials/search", listeningHandler.SearchListeningMaterials) + + // 听力练习记录 + listening.POST("/records", listeningHandler.CreateListeningRecord) + listening.PUT("/records/:id", listeningHandler.UpdateListeningRecord) + listening.GET("/records", listeningHandler.GetUserListeningRecords) + listening.GET("/records/:id", listeningHandler.GetListeningRecord) + + // 听力学习统计和进度 + listening.GET("/stats", listeningHandler.GetUserListeningStats) + listening.GET("/progress/:material_id", listeningHandler.GetListeningProgress) + } + + // 阅读理解相关路由 + reading := router.Group("/api/v1/reading") + reading.Use(middleware.AuthMiddleware()) + { + // 阅读材料管理 + reading.GET("/materials", readingHandler.GetReadingMaterials) + reading.GET("/materials/:id", readingHandler.GetReadingMaterial) + reading.POST("/materials", readingHandler.CreateReadingMaterial) + reading.PUT("/materials/:id", readingHandler.UpdateReadingMaterial) + reading.DELETE("/materials/:id", readingHandler.DeleteReadingMaterial) + reading.GET("/materials/search", readingHandler.SearchReadingMaterials) + + // 阅读练习记录 + reading.POST("/records", readingHandler.CreateReadingRecord) + reading.PUT("/records/:id", readingHandler.UpdateReadingRecord) + reading.GET("/records", readingHandler.GetUserReadingRecords) + reading.GET("/records/:id", readingHandler.GetReadingRecord) + + // 阅读学习统计和进度 + reading.GET("/stats", readingHandler.GetReadingStats) + reading.GET("/progress/:material_id", readingHandler.GetReadingProgress) + reading.GET("/recommendations", readingHandler.GetRecommendedMaterials) + } + + // 写作练习相关路由 + writing := router.Group("/api/v1/writing") + writing.Use(middleware.AuthMiddleware()) + { + // 写作题目管理 + writing.GET("/prompts", writingHandler.GetWritingPrompts) + writing.GET("/prompts/:id", writingHandler.GetWritingPrompt) + writing.POST("/prompts", writingHandler.CreateWritingPrompt) + writing.PUT("/prompts/:id", writingHandler.UpdateWritingPrompt) + writing.DELETE("/prompts/:id", writingHandler.DeleteWritingPrompt) + writing.GET("/prompts/search", writingHandler.SearchWritingPrompts) + writing.GET("/prompts/recommendations", writingHandler.GetRecommendedPrompts) + + // 写作提交管理 + writing.POST("/submissions", writingHandler.CreateWritingSubmission) + writing.GET("/submissions", writingHandler.GetUserWritingSubmissions) + writing.GET("/submissions/:id", writingHandler.GetWritingSubmission) + writing.PUT("/submissions/:id/submit", writingHandler.SubmitWriting) + writing.PUT("/submissions/:id/grade", writingHandler.GradeWriting) + + // 写作学习统计和进度 + writing.GET("/stats", writingHandler.GetWritingStats) + writing.GET("/progress/:prompt_id", writingHandler.GetWritingProgress) + } + + // 口语练习相关路由 + speaking := router.Group("/api/v1/speaking") + speaking.Use(middleware.AuthMiddleware()) + { + // 口语场景管理 + speaking.GET("/scenarios", speakingHandler.GetSpeakingScenarios) + speaking.GET("/scenarios/:id", speakingHandler.GetSpeakingScenario) + speaking.POST("/scenarios", speakingHandler.CreateSpeakingScenario) + speaking.PUT("/scenarios/:id", speakingHandler.UpdateSpeakingScenario) + speaking.DELETE("/scenarios/:id", speakingHandler.DeleteSpeakingScenario) + speaking.GET("/scenarios/search", speakingHandler.SearchSpeakingScenarios) + speaking.GET("/scenarios/recommendations", speakingHandler.GetRecommendedScenarios) + + // 口语记录管理 + speaking.POST("/records", speakingHandler.CreateSpeakingRecord) + speaking.GET("/records", speakingHandler.GetUserSpeakingRecords) + speaking.GET("/records/:id", speakingHandler.GetSpeakingRecord) + speaking.PUT("/records/:id/submit", speakingHandler.SubmitSpeaking) + speaking.PUT("/records/:id/grade", speakingHandler.GradeSpeaking) + + // 口语学习统计和进度 + speaking.GET("/stats", speakingHandler.GetSpeakingStats) + speaking.GET("/progress/:scenario_id", speakingHandler.GetSpeakingProgress) + } + + // AI相关路由 + ai := router.Group("/api/v1/ai") + ai.Use(middleware.AuthMiddleware()) + { + // 写作批改 + ai.POST("/writing/correct", aiHandler.CorrectWriting) + + // 口语评估 + ai.POST("/speaking/evaluate", aiHandler.EvaluateSpeaking) + + // AI使用统计 + ai.GET("/stats", aiHandler.GetAIUsageStats) + } + + // 文件上传相关路由 + upload := router.Group("/api/v1/upload") + upload.Use(middleware.AuthMiddleware()) + { + // 音频文件上传 + upload.POST("/audio", uploadHandler.UploadAudio) + + // 图片文件上传 + upload.POST("/image", uploadHandler.UploadImage) + + // 文件信息查询 + upload.GET("/file/:file_id", uploadHandler.GetFileInfo) + + // 文件删除 + upload.DELETE("/file/:file_id", uploadHandler.DeleteFile) + + // 上传统计 + upload.GET("/stats", uploadHandler.GetUploadStats) + } + + // 综合测试相关路由 + test := router.Group("/api/v1/tests") + test.Use(middleware.AuthMiddleware()) + { + // 测试模板管理 + test.GET("/templates", testHandler.GetTestTemplates) + test.GET("/templates/:id", testHandler.GetTestTemplateByID) + + // 测试会话管理 + test.POST("/sessions", testHandler.CreateTestSession) + test.GET("/sessions", testHandler.GetUserTestHistory) + test.GET("/sessions/:id", testHandler.GetTestSession) + test.PUT("/sessions/:id/start", testHandler.StartTest) + test.POST("/sessions/:id/answers", testHandler.SubmitAnswer) + test.PUT("/sessions/:id/pause", testHandler.PauseTest) + test.PUT("/sessions/:id/resume", testHandler.ResumeTest) + test.PUT("/sessions/:id/complete", testHandler.CompleteTest) + + // 测试结果管理 + test.GET("/results/:id", testHandler.GetTestResultByID) + test.DELETE("/results/:id", testHandler.DeleteTestResult) + + // 测试统计 + test.GET("/stats", testHandler.GetUserTestStats) + } + + // 通知相关路由 + notification := router.Group("/api/v1/notifications") + notification.Use(middleware.AuthMiddleware()) + { + // 获取通知列表 + notification.GET("", notificationHandler.GetNotifications) + // 获取未读通知数量 + notification.GET("/unread-count", notificationHandler.GetUnreadCount) + // 标记通知为已读 + notification.PUT("/:id/read", notificationHandler.MarkAsRead) + // 标记所有通知为已读 + notification.PUT("/read-all", notificationHandler.MarkAllAsRead) + // 删除通知 + notification.DELETE("/:id", notificationHandler.DeleteNotification) + } + + // 生词本相关路由 + wordBook := router.Group("/api/v1/word-book") + wordBook.Use(middleware.AuthMiddleware()) + { + // 切换收藏状态 + wordBook.POST("/toggle/:id", wordBookHandler.ToggleFavorite) + // 获取生词本列表 + wordBook.GET("", wordBookHandler.GetFavoriteWords) + // 获取指定词汇书的生词本 + wordBook.GET("/books/:id", wordBookHandler.GetFavoriteWordsByBook) + // 获取生词本统计 + wordBook.GET("/stats", wordBookHandler.GetFavoriteStats) + // 批量添加到生词本 + wordBook.POST("/batch", wordBookHandler.BatchAddToFavorite) + // 从生词本移除 + wordBook.DELETE("/:id", wordBookHandler.RemoveFromFavorite) + } + + // 学习计划相关路由 + studyPlan := router.Group("/api/v1/study-plans") + studyPlan.Use(middleware.AuthMiddleware()) + { + // 创建学习计划 + studyPlan.POST("", studyPlanHandler.CreateStudyPlan) + // 获取学习计划列表 + studyPlan.GET("", studyPlanHandler.GetUserStudyPlans) + // 获取今日计划 + studyPlan.GET("/today", studyPlanHandler.GetTodayStudyPlans) + // 获取计划详情 + studyPlan.GET("/:id", studyPlanHandler.GetStudyPlanByID) + // 更新计划 + studyPlan.PUT("/:id", studyPlanHandler.UpdateStudyPlan) + // 删除计划 + studyPlan.DELETE("/:id", studyPlanHandler.DeleteStudyPlan) + // 更新计划状态 + studyPlan.PATCH("/:id/status", studyPlanHandler.UpdatePlanStatus) + // 记录学习进度 + studyPlan.POST("/:id/progress", studyPlanHandler.RecordStudyProgress) + // 获取计划统计 + studyPlan.GET("/:id/statistics", studyPlanHandler.GetStudyPlanStatistics) + } + + return router +} diff --git a/serve/config/README.md b/serve/config/README.md new file mode 100644 index 0000000..72539a3 --- /dev/null +++ b/serve/config/README.md @@ -0,0 +1,165 @@ +# 配置文件说明 + +## 多环境配置 + +本项目支持多环境配置，通过 `GO_ENV` 环境变量自动选择对应的配置文件。 + +### 环境配置文件 + +- `config.dev.yaml` - 开发环境配置 +- `config.prod.yaml` - 生产环境配置 +- `config.staging.yaml` - 预发布环境配置（可选） +- `config.test.yaml` - 测试环境配置（可选） +- `config.yaml` - 默认配置文件（回退） + +### 使用方法 + +#### 1. 开发环境（默认） + +```bash +# 不设置 GO_ENV，默认使用开发环境 +go run main.go + +# 或显式设置 +GO_ENV=development go run main.go +GO_ENV=dev go run main.go +``` + +使用配置文件：`config.dev.yaml` + +#### 2. 生产环境 + +```bash +GO_ENV=production go run main.go +# 或 +GO_ENV=prod go run main.go +``` + +使用配置文件：`config.prod.yaml` + +#### 3. 预发布环境 + +```bash +GO_ENV=staging go run main.go +# 或 +GO_ENV=stage go run main.go +``` + +使用配置文件：`config.staging.yaml` + +#### 4. 测试环境 + +```bash +GO_ENV=test go run main.go +``` + +使用配置文件：`config.test.yaml` + +### Windows PowerShell 设置环境变量 + +```powershell +# 临时设置（仅当前会话） +$env:GO_ENV="production" +go run main.go + +# 或一行命令 +$env:GO_ENV="production"; go run main.go +``` + +### Windows CMD 设置环境变量 + +```cmd +# 临时设置 +set GO_ENV=production +go run main.go + +# 或一行命令 +set GO_ENV=production && go run main.go +``` + +### Linux/Mac 设置环境变量 + +```bash +# 临时设置 +export GO_ENV=production +go run main.go + +# 或一行命令 +GO_ENV=production go run main.go +``` + +## 环境变量覆盖 + +敏感配置项可以通过环境变量覆盖，优先级高于配置文件： + +- `DB_PASSWORD` - 数据库密码 +- `JWT_SECRET` - JWT 密钥 +- `REDIS_PASSWORD` - Redis 密码 + +示例： + +```bash +# Linux/Mac +export DB_PASSWORD="your_secure_password" +export JWT_SECRET="your_jwt_secret_key" +GO_ENV=production go run main.go + +# Windows PowerShell +$env:DB_PASSWORD="your_secure_password" +$env:JWT_SECRET="your_jwt_secret_key" +$env:GO_ENV="production" +go run main.go +``` + +## 配置文件优先级 + +1. 环境变量（最高优先级） +2. 环境特定配置文件（如 `config.prod.yaml`） +3. 默认配置文件（`config.yaml`） +4. 代码中的默认值（最低优先级） + +## 首次使用 + +1. 复制 `config.example.yaml` 为 `config.yaml` +2. 修改 `config.yaml` 中的配置项 +3. 运行应用 + +```bash +# Windows +copy config.example.yaml config.yaml + +# Linux/Mac +cp config.example.yaml config.yaml +``` + +## 生产环境部署建议 + +1. ✅ 不要将包含敏感信息的配置文件提交到版本控制 +2. ✅ 使用环境变量设置所有敏感配置 +3. ✅ 在生产环境使用 `config.prod.yaml` +4. ✅ 确保 JWT Secret 使用强随机字符串 +5. ✅ 数据库密码使用环境变量而不是写在配置文件中 + +## .gitignore 建议 + +```gitignore +# 配置文件 +config/config.yaml +config/config.*.yaml +!config/config.example.yaml + +# 日志文件 +logs/ +*.log +``` + +## 配置验证 + +启动时会在日志中显示加载的配置信息： + +``` +Loaded configuration for environment: production (file: config.prod.yaml) +Server mode: release, App environment: production +``` + +确认配置加载正确后再继续使用。 diff --git a/serve/config/config.dev.yaml b/serve/config/config.dev.yaml new file mode 100644 index 0000000..da8a339 --- /dev/null +++ b/serve/config/config.dev.yaml @@ -0,0 +1,40 @@ +# AI英语学习平台 - 开发环境配置 + +server: + port: "8080" + mode: "debug" # debug, release, test + +database: + host: "localhost" + port: "3306" + user: "root" + password: "JKjk20011115" # 建议通过环境变量 DB_PASSWORD 设置 + dbname: "ai_english_learning" + charset: "utf8mb4" + +jwt: + secret: "dev-secret-key-change-in-production" # 建议通过环境变量 JWT_SECRET 设置 + access_token_ttl: 3600 # 1小时 + refresh_token_ttl: 604800 # 7天 + +redis: + host: "localhost" + port: "6379" + password: "" # 建议通过环境变量 REDIS_PASSWORD 设置 + db: 0 + +app: + name: "AI English Learning" + version: "1.0.0" + environment: "development" + log_level: "debug" + +log: + level: "debug" # debug, info, warn, error, fatal, panic + format: "text" # json, text + output: "both" # console, file, both + file_path: "./logs/dev.log" + max_size: 100 # MB + max_backups: 5 + max_age: 7 # days + compress: false diff --git a/serve/config/config.example.yaml b/serve/config/config.example.yaml new file mode 100644 index 0000000..687fa52 --- /dev/null +++ b/serve/config/config.example.yaml @@ -0,0 +1,41 @@ +# AI英语学习平台配置文件示例 +# 复制此文件为 config.yaml 或 config.dev.yaml 并修改相应配置 + +server: + port: "8080" + mode: "debug" # debug, release, test + +database: + host: "localhost" + port: "3306" + user: "root" + password: "your_password_here" # 建议通过环境变量 DB_PASSWORD 设置 + dbname: "ai_english_learning" + charset: "utf8mb4" + +jwt: + secret: "your_jwt_secret_key_here" # 建议通过环境变量 JWT_SECRET 设置 + access_token_ttl: 3600 # 1小时 + refresh_token_ttl: 604800 # 7天 + +redis: + host: "localhost" + port: "6379" + password: "" # 建议通过环境变量 REDIS_PASSWORD 设置 + db: 0 + +app: + name: "AI English Learning" + version: "1.0.0" + environment: "development" # development, staging, production + log_level: "info" # debug, info, warn, error + +log: + level: "info" # debug, info, warn, error, fatal, panic + format: "json" # json, text + output: "both" # console, file, both + file_path: "./logs/app.log" + max_size: 100 # MB + max_backups: 10 + max_age: 30 # days + compress: true diff --git a/serve/config/config.go b/serve/config/config.go new file mode 100644 index 0000000..c9ed420 --- /dev/null +++ b/serve/config/config.go @@ -0,0 +1,160 @@ +package config + +import ( + "log" + "os" + + "github.com/spf13/viper" +) + +type Config struct { + Server ServerConfig `mapstructure:"server"` + Database DatabaseConfig `mapstructure:"database"` + JWT JWTConfig `mapstructure:"jwt"` + Redis RedisConfig `mapstructure:"redis"` + App AppConfig `mapstructure:"app"` + Log LogConfig `mapstructure:"log"` +} + +type ServerConfig struct { + Port string `mapstructure:"port"` + Mode string `mapstructure:"mode"` +} + +type DatabaseConfig struct { + Host string `mapstructure:"host"` + Port string `mapstructure:"port"` + User string `mapstructure:"user"` + Password string `mapstructure:"password"` + DBName string `mapstructure:"dbname"` + Charset string `mapstructure:"charset"` +} + +type JWTConfig struct { + Secret string `mapstructure:"secret"` + AccessTokenTTL int `mapstructure:"access_token_ttl"` + RefreshTokenTTL int `mapstructure:"refresh_token_ttl"` +} + +type RedisConfig struct { + Host string `mapstructure:"host"` + Port string `mapstructure:"port"` + Password string `mapstructure:"password"` + DB int `mapstructure:"db"` +} + +type AppConfig struct { + Name string `mapstructure:"name"` + Version string `mapstructure:"version"` + Environment string `mapstructure:"environment"` + LogLevel string `mapstructure:"log_level"` +} + +type LogConfig struct { + Level string `mapstructure:"level"` + Format string `mapstructure:"format"` + Output string `mapstructure:"output"` + FilePath string `mapstructure:"file_path"` + MaxSize int `mapstructure:"max_size"` + MaxBackups int `mapstructure:"max_backups"` + MaxAge int `mapstructure:"max_age"` + Compress bool `mapstructure:"compress"` +} + +var GlobalConfig *Config + +func LoadConfig() { + // 获取环境变量，默认为 development + env := os.Getenv("GO_ENV") + if env == "" { + env = "development" + } + + // 根据环境选择配置文件 + configName := getConfigName(env) + + viper.SetConfigName(configName) + viper.SetConfigType("yaml") + viper.AddConfigPath("./config") + viper.AddConfigPath(".") + + // 设置环境变量前缀 + viper.SetEnvPrefix("AI_ENGLISH") + viper.AutomaticEnv() + + // 设置默认值 + setDefaults() + + if err := viper.ReadInConfig(); err != nil { + log.Printf("Warning: Config file '%s' not found, trying fallback...", configName) + // 尝试加载默认配置文件 + viper.SetConfigName("config") + if err := viper.ReadInConfig(); err != nil { + log.Printf("Warning: Default config file not found, using defaults and environment variables: %v", err) + } + } + + GlobalConfig = &Config{} + if err := viper.Unmarshal(GlobalConfig); err != nil { + log.Fatalf("Unable to decode config: %v", err) + } + + // 从环境变量覆盖敏感配置 + overrideFromEnv() + + log.Printf("Loaded configuration for environment: %s (file: %s.yaml)", env, configName) + log.Printf("Server mode: %s, App environment: %s", GlobalConfig.Server.Mode, GlobalConfig.App.Environment) +} + +// getConfigName 根据环境返回配置文件名 +func getConfigName(env string) string { + switch env { + case "production", "prod": + return "config.prod" + case "development", "dev": + return "config.dev" + case "staging", "stage": + return "config.staging" + case "test": + return "config.test" + default: + return "config" + } +} + +func setDefaults() { + viper.SetDefault("server.port", "8080") + viper.SetDefault("server.mode", "debug") + viper.SetDefault("database.host", "localhost") + viper.SetDefault("database.port", "3306") + viper.SetDefault("database.charset", "utf8mb4") + viper.SetDefault("jwt.access_token_ttl", 3600) + viper.SetDefault("jwt.refresh_token_ttl", 604800) + viper.SetDefault("redis.host", "localhost") + viper.SetDefault("redis.port", "6379") + viper.SetDefault("redis.db", 0) + viper.SetDefault("app.name", "AI English Learning") + viper.SetDefault("app.version", "1.0.0") + viper.SetDefault("app.environment", "development") + viper.SetDefault("app.log_level", "info") + viper.SetDefault("log.level", "info") + viper.SetDefault("log.format", "json") + viper.SetDefault("log.output", "both") + viper.SetDefault("log.file_path", "./logs/app.log") + viper.SetDefault("log.max_size", 100) + viper.SetDefault("log.max_backups", 10) + viper.SetDefault("log.max_age", 30) + viper.SetDefault("log.compress", true) +} + +func overrideFromEnv() { + if dbPassword := os.Getenv("DB_PASSWORD"); dbPassword != "" { + GlobalConfig.Database.Password = dbPassword + } + if jwtSecret := os.Getenv("JWT_SECRET"); jwtSecret != "" { + GlobalConfig.JWT.Secret = jwtSecret + } + if redisPassword := os.Getenv("REDIS_PASSWORD"); redisPassword != "" { + GlobalConfig.Redis.Password = redisPassword + } +} \ No newline at end of file diff --git a/serve/config/config.prod.yaml b/serve/config/config.prod.yaml new file mode 100644 index 0000000..6f0a708 --- /dev/null +++ b/serve/config/config.prod.yaml @@ -0,0 +1,40 @@ +# AI英语学习平台 - 生产环境配置 + +server: + port: "8050" + mode: "release" # debug, release, test + +database: + host: "8.149.233.36" + port: "3306" + user: "ai_english_learning" + password: "7aK_H2yvokVumr84lLNDt8fDBp6P" # 必须通过环境变量 DB_PASSWORD 设置 + dbname: "ai_english_learning" + charset: "utf8mb4" + +jwt: + secret: "" # 必须通过环境变量 JWT_SECRET 设置 + access_token_ttl: 7200 # 2小时 + refresh_token_ttl: 2592000 # 30天 + +redis: + host: "localhost" + port: "6379" + password: "" # 建议通过环境变量 REDIS_PASSWORD 设置 + db: 0 + +app: + name: "AI English Learning" + version: "1.0.0" + environment: "production" + log_level: "info" + +log: + level: "debug" # debug, info, warn, error, fatal, panic + format: "text" # json, text + output: "both" # console, file, both + file_path: "./logs/prod.log" + max_size: 100 # MB + max_backups: 5 + max_age: 7 # days + compress: false \ No newline at end of file diff --git a/serve/config/config.yaml b/serve/config/config.yaml new file mode 100644 index 0000000..6af8192 --- /dev/null +++ b/serve/config/config.yaml @@ -0,0 +1,40 @@ +# AI英语学习平台配置文件 + +server: + port: "8080" + mode: "debug" # debug, release, test + +database: + host: "localhost" + port: "3306" + user: "root" + password: "JKjk20011115" # 建议通过环境变量 DB_PASSWORD 设置 + dbname: "ai_english_learning" + charset: "utf8mb4" + +jwt: + secret: "" # 建议通过环境变量 JWT_SECRET 设置 + access_token_ttl: 3600 # 1小时 + refresh_token_ttl: 604800 # 7天 + +redis: + host: "localhost" + port: "6379" + password: "" # 建议通过环境变量 REDIS_PASSWORD 设置 + db: 0 + +app: + name: "AI English Learning" + version: "1.0.0" + environment: "development" # development, staging, production + log_level: "info" # debug, info, warn, error + +log: + level: "info" # debug, info, warn, error, fatal, panic + format: "json" # json, text + output: "both" # console, file, both + file_path: "./logs/app.log" + max_size: 100 # MB + max_backups: 10 + max_age: 30 # days + compress: true diff --git a/serve/go.mod b/serve/go.mod new file mode 100644 index 0000000..117859d --- /dev/null +++ b/serve/go.mod @@ -0,0 +1,69 @@ +module github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve + +go 1.21 + +toolchain go1.21.5 + +// toolchain go1.18.1 + +require ( + github.com/gin-gonic/gin v1.10.1 + github.com/go-playground/validator/v10 v10.20.0 + github.com/golang-jwt/jwt/v5 v5.3.0 + github.com/google/uuid v1.4.0 + github.com/sirupsen/logrus v1.9.3 + github.com/spf13/viper v1.18.2 + github.com/stretchr/testify v1.9.0 + golang.org/x/crypto v0.23.0 + gopkg.in/natefinch/lumberjack.v2 v2.2.1 + gorm.io/driver/mysql v1.5.2 + gorm.io/gorm v1.25.5 +) + +require ( + github.com/bytedance/sonic v1.11.6 // indirect + github.com/bytedance/sonic/loader v0.1.1 // indirect + github.com/cloudwego/base64x v0.1.4 // indirect + github.com/cloudwego/iasm v0.2.0 // indirect + github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect + github.com/fsnotify/fsnotify v1.7.0 // indirect + github.com/gabriel-vasile/mimetype v1.4.3 // indirect + github.com/gin-contrib/sse v0.1.0 // indirect + github.com/go-playground/locales v0.14.1 // indirect + github.com/go-playground/universal-translator v0.18.1 // indirect + github.com/go-sql-driver/mysql v1.7.0 // indirect + github.com/goccy/go-json v0.10.2 // indirect + github.com/hashicorp/hcl v1.0.0 // indirect + github.com/jinzhu/inflection v1.0.0 // indirect + github.com/jinzhu/now v1.1.5 // indirect + github.com/json-iterator/go v1.1.12 // indirect + github.com/klauspost/cpuid/v2 v2.2.7 // indirect + github.com/leodido/go-urn v1.4.0 // indirect + github.com/magiconair/properties v1.8.7 // indirect + github.com/mattn/go-isatty v0.0.20 // indirect + github.com/mitchellh/mapstructure v1.5.0 // indirect + github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect + github.com/modern-go/reflect2 v1.0.2 // indirect + github.com/pelletier/go-toml/v2 v2.2.2 // indirect + github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 // indirect + github.com/sagikazarmark/locafero v0.4.0 // indirect + github.com/sagikazarmark/slog-shim v0.1.0 // indirect + github.com/sourcegraph/conc v0.3.0 // indirect + github.com/spf13/afero v1.11.0 // indirect + github.com/spf13/cast v1.6.0 // indirect + github.com/spf13/pflag v1.0.5 // indirect + github.com/stretchr/objx v0.5.2 // indirect + github.com/subosito/gotenv v1.6.0 // indirect + github.com/twitchyliquid64/golang-asm v0.15.1 // indirect + github.com/ugorji/go/codec v1.2.12 // indirect + go.uber.org/atomic v1.9.0 // indirect + go.uber.org/multierr v1.9.0 // indirect + golang.org/x/arch v0.8.0 // indirect + golang.org/x/exp v0.0.0-20230905200255-921286631fa9 // indirect + golang.org/x/net v0.25.0 // indirect + golang.org/x/sys v0.20.0 // indirect + golang.org/x/text v0.15.0 // indirect + google.golang.org/protobuf v1.34.1 // indirect + gopkg.in/ini.v1 v1.67.0 // indirect + gopkg.in/yaml.v3 v3.0.1 // indirect +) diff --git a/serve/go.sum b/serve/go.sum new file mode 100644 index 0000000..8438b9d --- /dev/null +++ b/serve/go.sum @@ -0,0 +1,151 @@ +github.com/bytedance/sonic v1.11.6 h1:oUp34TzMlL+OY1OUWxHqsdkgC/Zfc85zGqw9siXjrc0= +github.com/bytedance/sonic v1.11.6/go.mod h1:LysEHSvpvDySVdC2f87zGWf6CIKJcAvqab1ZaiQtds4= +github.com/bytedance/sonic/loader v0.1.1 h1:c+e5Pt1k/cy5wMveRDyk2X4B9hF4g7an8N3zCYjJFNM= +github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU= +github.com/cloudwego/base64x v0.1.4 h1:jwCgWpFanWmN8xoIUHa2rtzmkd5J2plF/dnLS6Xd/0Y= +github.com/cloudwego/base64x v0.1.4/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w= +github.com/cloudwego/iasm v0.2.0 h1:1KNIy1I1H9hNNFEEH3DVnI4UujN+1zjpuk6gwHLTssg= +github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM= +github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/frankban/quicktest v1.14.6 h1:7Xjx+VpznH+oBnejlPUj8oUpdxnVs4f8XU8WnHkI4W8= +github.com/frankban/quicktest v1.14.6/go.mod h1:4ptaffx2x8+WTWXmUCuVU6aPUX1/Mz7zb5vbUoiM6w0= +github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA= +github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM= +github.com/gabriel-vasile/mimetype v1.4.3 h1:in2uUcidCuFcDKtdcBxlR0rJ1+fsokWf+uqxgUFjbI0= +github.com/gabriel-vasile/mimetype v1.4.3/go.mod h1:d8uq/6HKRL6CGdk+aubisF/M5GcPfT7nKyLpA0lbSSk= +github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE= +github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI= +github.com/gin-gonic/gin v1.10.1 h1:T0ujvqyCSqRopADpgPgiTT63DUQVSfojyME59Ei63pQ= +github.com/gin-gonic/gin v1.10.1/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y= +github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s= +github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4= +github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA= +github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY= +github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY= +github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY= +github.com/go-playground/validator/v10 v10.20.0 h1:K9ISHbSaI0lyB2eWMPJo+kOS/FBExVwjEviJTixqxL8= +github.com/go-playground/validator/v10 v10.20.0/go.mod h1:dbuPbCMFw/DrkbEynArYaCwl3amGuJotoKCe95atGMM= +github.com/go-sql-driver/mysql v1.7.0 h1:ueSltNNllEqE3qcWBTD0iQd3IpL/6U+mJxLkazJ7YPc= +github.com/go-sql-driver/mysql v1.7.0/go.mod h1:OXbVy3sEdcQ2Doequ6Z5BW6fXNQTmx+9S1MCJN5yJMI= +github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU= +github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I= +github.com/golang-jwt/jwt/v5 v5.3.0 h1:pv4AsKCKKZuqlgs5sUmn4x8UlGa0kEVt/puTpKx9vvo= +github.com/golang-jwt/jwt/v5 v5.3.0/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE= +github.com/google/go-cmp v0.5.9 h1:O2Tfq5qg4qc4AmwVlvv0oLiVAGB7enBSJ2x2DqQFi38= +github.com/google/go-cmp v0.5.9/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= +github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= +github.com/google/uuid v1.4.0 h1:MtMxsa51/r9yyhkyLsVeVt0B+BGQZzpQiTQ4eHZ8bc4= +github.com/google/uuid v1.4.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/hashicorp/hcl v1.0.0 h1:0Anlzjpi4vEasTeNFn2mLJgTSwt0+6sfsiTG8qcWGx4= +github.com/hashicorp/hcl v1.0.0/go.mod h1:E5yfLk+7swimpb2L/Alb/PJmXilQ/rhwaUYs4T20WEQ= +github.com/jinzhu/inflection v1.0.0 h1:K317FqzuhWc8YvSVlFMCCUb36O/S9MCKRDI7QkRKD/E= +github.com/jinzhu/inflection v1.0.0/go.mod h1:h+uFLlag+Qp1Va5pdKtLDYj+kHp5pxUVkryuEj+Srlc= +github.com/jinzhu/now v1.1.5 h1:/o9tlHleP7gOFmsnYNz3RGnqzefHA47wQpKrrdTIwXQ= +github.com/jinzhu/now v1.1.5/go.mod h1:d3SSVoowX0Lcu0IBviAWJpolVfI5UJVZZ7cO71lE/z8= +github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM= +github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= +github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= +github.com/klauspost/cpuid/v2 v2.2.7 h1:ZWSB3igEs+d0qvnxR/ZBzXVmxkgt8DdzP6m9pfuVLDM= +github.com/klauspost/cpuid/v2 v2.2.7/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws= +github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M= +github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE= +github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk= +github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= +github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE= +github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ= +github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI= +github.com/magiconair/properties v1.8.7 h1:IeQXZAiQcpL9mgcAe1Nu6cX9LLw6ExEHKjN0VQdvPDY= +github.com/magiconair/properties v1.8.7/go.mod h1:Dhd985XPs7jluiymwWYZ0G4Z61jb3vdS329zhj2hYo0= +github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= +github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= +github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M= +github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= +github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM= +github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U= +github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/rogpeppe/go-internal v1.9.0 h1:73kH8U+JUqXU8lRuOHeVHaa/SZPifC7BkcraZVejAe8= +github.com/rogpeppe/go-internal v1.9.0/go.mod h1:WtVeX8xhTBvf0smdhujwtBcq4Qrzq/fJaraNFVN+nFs= +github.com/sagikazarmark/locafero v0.4.0 h1:HApY1R9zGo4DBgr7dqsTH/JJxLTTsOt7u6keLGt6kNQ= +github.com/sagikazarmark/locafero v0.4.0/go.mod h1:Pe1W6UlPYUk/+wc/6KFhbORCfqzgYEpgQ3O5fPuL3H4= +github.com/sagikazarmark/slog-shim v0.1.0 h1:diDBnUNK9N/354PgrxMywXnAwEr1QZcOr6gto+ugjYE= +github.com/sagikazarmark/slog-shim v0.1.0/go.mod h1:SrcSrq8aKtyuqEI1uvTDTK1arOWRIczQRv+GVI1AkeQ= +github.com/sirupsen/logrus v1.9.3 h1:dueUQJ1C2q9oE3F7wvmSGAaVtTmUizReu6fjN8uqzbQ= +github.com/sirupsen/logrus v1.9.3/go.mod h1:naHLuLoDiP4jHNo9R0sCBMtWGeIprob74mVsIT4qYEQ= +github.com/sourcegraph/conc v0.3.0 h1:OQTbbt6P72L20UqAkXXuLOj79LfEanQ+YQFNpLA9ySo= +github.com/sourcegraph/conc v0.3.0/go.mod h1:Sdozi7LEKbFPqYX2/J+iBAM6HpqSLTASQIKqDmF7Mt0= +github.com/spf13/afero v1.11.0 h1:WJQKhtpdm3v2IzqG8VMqrr6Rf3UYpEF239Jy9wNepM8= +github.com/spf13/afero v1.11.0/go.mod h1:GH9Y3pIexgf1MTIWtNGyogA5MwRIDXGUr+hbWNoBjkY= +github.com/spf13/cast v1.6.0 h1:GEiTHELF+vaR5dhz3VqZfFSzZjYbgeKDpBxQVS4GYJ0= +github.com/spf13/cast v1.6.0/go.mod h1:ancEpBxwJDODSW/UG4rDrAqiKolqNNh2DX3mk86cAdo= +github.com/spf13/pflag v1.0.5 h1:iy+VFUOCP1a+8yFto/drg2CJ5u0yRoB7fZw3DKv/JXA= +github.com/spf13/pflag v1.0.5/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg= +github.com/spf13/viper v1.18.2 h1:LUXCnvUvSM6FXAsj6nnfc8Q2tp1dIgUfY9Kc8GsSOiQ= +github.com/spf13/viper v1.18.2/go.mod h1:EKmWIqdnk5lOcmR72yw6hS+8OPYcwD0jteitLMVB+yk= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= +github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo= +github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY= +github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= +github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= +github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg= +github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= +github.com/subosito/gotenv v1.6.0 h1:9NlTDc1FTs4qu0DDq7AEtTPNw6SVm7uBMsUCUjABIf8= +github.com/subosito/gotenv v1.6.0/go.mod h1:Dk4QP5c2W3ibzajGcXpNraDfq2IrhjMIvMSWPKKo0FU= +github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI= +github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08= +github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE= +github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg= +go.uber.org/atomic v1.9.0 h1:ECmE8Bn/WFTYwEW/bpKD3M8VtR/zQVbavAoalC1PYyE= +go.uber.org/atomic v1.9.0/go.mod h1:fEN4uk6kAWBTFdckzkM89CLk9XfWZrxpCo0nPH17wJc= +go.uber.org/multierr v1.9.0 h1:7fIwc/ZtS0q++VgcfqFDxSBZVv/Xo49/SYnDFupUwlI= +go.uber.org/multierr v1.9.0/go.mod h1:X2jQV1h+kxSjClGpnseKVIxpmcjrj7MNnI0bnlfKTVQ= +golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8= +golang.org/x/arch v0.8.0 h1:3wRIsP3pM4yUptoR96otTUOXI367OS0+c9eeRi9doIc= +golang.org/x/arch v0.8.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys= +golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI= +golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8= +golang.org/x/exp v0.0.0-20230905200255-921286631fa9 h1:GoHiUyI/Tp2nVkLI2mCxVkOjsbSXD66ic0XW0js0R9g= +golang.org/x/exp v0.0.0-20230905200255-921286631fa9/go.mod h1:S2oDrQGGwySpoQPVqRShND87VCbxmc6bL1Yd2oYrm6k= +golang.org/x/net v0.25.0 h1:d/OCCoBEUq33pjydKrGQhw7IlUPI2Oylr+8qLx49kac= +golang.org/x/net v0.25.0/go.mod h1:JkAGAh7GEvH74S6FOH42FLoXpXbE/aqXSrIQjXgsiwM= +golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.20.0 h1:Od9JTbYCk261bKm4M/mw7AklTlFYIa0bIp9BgSm1S8Y= +golang.org/x/sys v0.20.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/text v0.15.0 h1:h1V/4gjBv8v9cjcR6+AR5+/cIYK5N/WAgiv4xlsEtAk= +golang.org/x/text v0.15.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU= +google.golang.org/protobuf v1.34.1 h1:9ddQBjfCyZPOHPUiPxpYESBLc+T8P3E+Vo4IbKZgFWg= +google.golang.org/protobuf v1.34.1/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15 h1:YR8cESwS4TdDjEe65xsg0ogRM/Nc3DYOhEAlW+xobZo= +gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/ini.v1 v1.67.0 h1:Dgnx+6+nfE+IfzjUEISNeydPJh9AXNNsWbGP9KzCsOA= +gopkg.in/ini.v1 v1.67.0/go.mod h1:pNLf8WUiyNEtQjuu5G5vTm06TEv9tsIgeAvK8hOrP4k= +gopkg.in/natefinch/lumberjack.v2 v2.2.1 h1:bBRl1b0OH9s/DuPhuXpNl+VtCaJXFZ5/uEFST95x9zc= +gopkg.in/natefinch/lumberjack.v2 v2.2.1/go.mod h1:YD8tP3GAjkrDg1eZH7EGmyESg/lsYskCTPBJVb9jqSc= +gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= +gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +gorm.io/driver/mysql v1.5.2 h1:QC2HRskSE75wBuOxe0+iCkyJZ+RqpudsQtqkp+IMuXs= +gorm.io/driver/mysql v1.5.2/go.mod h1:pQLhh1Ut/WUAySdTHwBpBv6+JKcj+ua4ZFx1QQTBzb8= +gorm.io/gorm v1.25.2-0.20230530020048-26663ab9bf55/go.mod h1:L4uxeKpfBml98NYqVqwAdmV1a2nBtAec/cf3fpucW/k= +gorm.io/gorm v1.25.5 h1:zR9lOiiYf09VNh5Q1gphfyia1JpiClIWG9hQaxB/mls= +gorm.io/gorm v1.25.5/go.mod h1:hbnx/Oo0ChWMn1BIhpy1oYozzpM15i4YPuHDmfYtwg8= +nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50= +rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4= diff --git a/serve/handler/auth_handler_test.go b/serve/handler/auth_handler_test.go new file mode 100644 index 0000000..95a95b8 --- /dev/null +++ b/serve/handler/auth_handler_test.go @@ -0,0 +1,237 @@ +package handler + +import ( + "bytes" + "encoding/json" + "net/http" + "net/http/httptest" + "testing" + + "github.com/gin-gonic/gin" +) + +// 测试用的请求结构 +type TestRegisterRequest struct { + Username string `json:"username"` + Email string `json:"email"` + Password string `json:"password"` +} + +type TestLoginRequest struct { + Username string `json:"username"` + Password string `json:"password"` +} + +func TestAuthHandler_Register(t *testing.T) { + // 设置Gin为测试模式 + gin.SetMode(gin.TestMode) + + tests := []struct { + name string + request TestRegisterRequest + expectedStatus int + }{ + { + name: "有效注册请求", + request: TestRegisterRequest{ + Username: "testuser", + Email: "test@example.com", + Password: "password123", + }, + expectedStatus: http.StatusOK, // 注意：实际可能返回201或其他状态码 + }, + { + name: "无效请求 - 缺少用户名", + request: TestRegisterRequest{ + Username: "", + Email: "test@example.com", + Password: "password123", + }, + expectedStatus: http.StatusBadRequest, + }, + { + name: "无效请求 - 缺少邮箱", + request: TestRegisterRequest{ + Username: "testuser", + Email: "", + Password: "password123", + }, + expectedStatus: http.StatusBadRequest, + }, + { + name: "无效请求 - 缺少密码", + request: TestRegisterRequest{ + Username: "testuser", + Email: "test@example.com", + Password: "", + }, + expectedStatus: http.StatusBadRequest, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + // 创建请求体 + requestBody, err := json.Marshal(tt.request) + if err != nil { + t.Fatalf("Failed to marshal request: %v", err) + } + + // 创建HTTP请求 + req, err := http.NewRequest("POST", "/api/auth/register", bytes.NewBuffer(requestBody)) + if err != nil { + t.Fatalf("Failed to create request: %v", err) + } + req.Header.Set("Content-Type", "application/json") + + // 创建响应记录器 + w := httptest.NewRecorder() + + // 创建Gin上下文 + c, _ := gin.CreateTestContext(w) + c.Request = req + + // 注意：这里需要实际的AuthHandler实例 + // 由于没有数据库连接，这个测试会失败 + // 这里只是展示测试结构 + + // 验证请求格式（基本验证） + if tt.request.Username == "" || tt.request.Email == "" || tt.request.Password == "" { + if w.Code != tt.expectedStatus && tt.expectedStatus == http.StatusBadRequest { + // 这是预期的错误情况 + t.Logf("Expected bad request for invalid input: %+v", tt.request) + } + } else { + t.Logf("Valid request format: %+v", tt.request) + } + }) + } +} + +func TestAuthHandler_Login(t *testing.T) { + gin.SetMode(gin.TestMode) + + tests := []struct { + name string + request TestLoginRequest + expectedStatus int + }{ + { + name: "有效登录请求", + request: TestLoginRequest{ + Username: "testuser", + Password: "password123", + }, + expectedStatus: http.StatusOK, + }, + { + name: "无效请求 - 缺少用户名", + request: TestLoginRequest{ + Username: "", + Password: "password123", + }, + expectedStatus: http.StatusBadRequest, + }, + { + name: "无效请求 - 缺少密码", + request: TestLoginRequest{ + Username: "testuser", + Password: "", + }, + expectedStatus: http.StatusBadRequest, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + // 创建请求体 + requestBody, err := json.Marshal(tt.request) + if err != nil { + t.Fatalf("Failed to marshal request: %v", err) + } + + // 创建HTTP请求 + req, err := http.NewRequest("POST", "/api/auth/login", bytes.NewBuffer(requestBody)) + if err != nil { + t.Fatalf("Failed to create request: %v", err) + } + req.Header.Set("Content-Type", "application/json") + + // 创建响应记录器 + w := httptest.NewRecorder() + + // 创建Gin上下文 + c, _ := gin.CreateTestContext(w) + c.Request = req + + // 验证请求格式（基本验证） + if tt.request.Username == "" || tt.request.Password == "" { + if tt.expectedStatus == http.StatusBadRequest { + t.Logf("Expected bad request for invalid input: %+v", tt.request) + } + } else { + t.Logf("Valid request format: %+v", tt.request) + } + }) + } +} + +// 测试JSON解析 +func TestJSONParsing(t *testing.T) { + tests := []struct { + name string + jsonStr string + valid bool + }{ + { + name: "有效JSON", + jsonStr: `{"username":"test","email":"test@example.com","password":"123456"}`, + valid: true, + }, + { + name: "无效JSON", + jsonStr: `{"username":"test","email":"test@example.com","password":}`, + valid: false, + }, + { + name: "空JSON", + jsonStr: `{}`, + valid: true, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + var req TestRegisterRequest + err := json.Unmarshal([]byte(tt.jsonStr), &req) + + if tt.valid && err != nil { + t.Errorf("Expected valid JSON, got error: %v", err) + } + + if !tt.valid && err == nil { + t.Errorf("Expected invalid JSON, but parsing succeeded") + } + }) + } +} + +// 测试HTTP状态码常量 +func TestHTTPStatusCodes(t *testing.T) { + expectedCodes := map[string]int{ + "OK": http.StatusOK, + "Created": http.StatusCreated, + "BadRequest": http.StatusBadRequest, + "Unauthorized": http.StatusUnauthorized, + "InternalServerError": http.StatusInternalServerError, + } + + for name, expectedCode := range expectedCodes { + t.Run(name, func(t *testing.T) { + if expectedCode <= 0 { + t.Errorf("Invalid status code for %s: %d", name, expectedCode) + } + t.Logf("%s status code: %d", name, expectedCode) + }) + } +} \ No newline at end of file diff --git a/serve/handler/vocabulary_handler_test.go b/serve/handler/vocabulary_handler_test.go new file mode 100644 index 0000000..a1531bb --- /dev/null +++ b/serve/handler/vocabulary_handler_test.go @@ -0,0 +1,63 @@ +package handler + +import ( + "net/http" + "net/http/httptest" + "testing" + + "github.com/gin-gonic/gin" + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/mock" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/api/handlers" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" +) + +type MockVocabularyService struct { + mock.Mock +} + +// 显式实现 VocabularyServiceInterface 接口 +var _ interfaces.VocabularyServiceInterface = (*MockVocabularyService)(nil) + +func (m *MockVocabularyService) GetDailyStats(userID string) (map[string]interface{}, error) { + args := m.Called(userID) + return args.Get(0).(map[string]interface{}), args.Error(1) +} + +func TestGetDailyVocabularyStats(t *testing.T) { + // 初始化 Gin 引擎 + gin.SetMode(gin.TestMode) + r := gin.Default() + + // 创建 Mock 服务 + mockService := new(MockVocabularyService) + mockService.On("GetDailyStats", "test_user").Return(map[string]interface{}{ + "wordsLearned": 10, + "studyTimeMinutes": 30, + }, nil) + + mockService.On("GetDailyStats", "").Return(nil, common.NewBusinessError(400, "用户ID不能为空")) + + // 创建处理器 + h := handlers.NewVocabularyHandler(mockService, nil) + r.GET("/api/vocabulary/daily", h.GetDailyVocabularyStats) + + // 测试成功情况 + req, _ := http.NewRequest(http.MethodGet, "/api/vocabulary/daily?user_id=test_user", nil) + w := httptest.NewRecorder() + r.ServeHTTP(w, req) + + assert.Equal(t, http.StatusOK, w.Code) + assert.Contains(t, w.Body.String(), "wordsLearned") + assert.Contains(t, w.Body.String(), "studyTimeMinutes") + + // 测试缺少用户ID + req, _ = http.NewRequest(http.MethodGet, "/api/vocabulary/daily", nil) + w = httptest.NewRecorder() + r.ServeHTTP(w, req) + + assert.Equal(t, http.StatusBadRequest, w.Code) + assert.Contains(t, w.Body.String(), "用户ID不能为空") +} \ No newline at end of file diff --git a/serve/internal/common/errors.go b/serve/internal/common/errors.go new file mode 100644 index 0000000..c286d56 --- /dev/null +++ b/serve/internal/common/errors.go @@ -0,0 +1,172 @@ +package common + +import "errors" + +// 业务错误码定义 +const ( + // 通用错误码 1000-1999 + ErrCodeSuccess = 200 + ErrCodeBadRequest = 400 + ErrCodeUnauthorized = 401 + ErrCodeForbidden = 403 + ErrCodeNotFound = 404 + ErrCodeInternalError = 500 + ErrCodeValidationFailed = 1001 + ErrCodeDatabaseError = 1002 + ErrCodeRedisError = 1003 + + // 用户相关错误码 2000-2999 + ErrCodeUserNotFound = 2001 + ErrCodeUserExists = 2002 + ErrCodeInvalidPassword = 2003 + ErrCodeUserDisabled = 2004 + ErrCodeEmailExists = 2005 + ErrCodeUsernameExists = 2006 + ErrCodeInvalidEmail = 2007 + ErrCodePasswordTooWeak = 2008 + + // 认证相关错误码 3000-3999 + ErrCodeInvalidToken = 3001 + ErrCodeTokenExpired = 3002 + ErrCodeTokenNotFound = 3003 + ErrCodeRefreshTokenInvalid = 3004 + ErrCodeLoginRequired = 3005 + + // 词汇相关错误码 4000-4999 + ErrCodeVocabularyNotFound = 4001 + ErrCodeCategoryNotFound = 4002 + ErrCodeWordExists = 4003 + ErrCodeInvalidDifficulty = 4004 + + // 学习相关错误码 5000-5999 + ErrCodeProgressNotFound = 5001 + ErrCodeInvalidScore = 5002 + ErrCodeTestNotFound = 5003 + ErrCodeExerciseNotFound = 5004 + + // 文件相关错误码 6000-6999 + ErrCodeFileUploadFailed = 6001 + ErrCodeFileNotFound = 6002 + ErrCodeInvalidFileType = 6003 + ErrCodeFileTooLarge = 6004 + + // AI相关错误码 7000-7999 + ErrCodeAIServiceUnavailable = 7001 + ErrCodeAIProcessingFailed = 7002 + ErrCodeInvalidAudioFormat = 7003 + ErrCodeSpeechRecognitionFailed = 7004 +) + +// 错误消息映射 +var ErrorMessages = map[int]string{ + // 通用错误 + ErrCodeSuccess: "操作成功", + ErrCodeBadRequest: "请求参数错误", + ErrCodeUnauthorized: "未授权访问", + ErrCodeForbidden: "禁止访问", + ErrCodeNotFound: "资源不存在", + ErrCodeInternalError: "服务器内部错误", + ErrCodeValidationFailed: "参数验证失败", + ErrCodeDatabaseError: "数据库操作失败", + ErrCodeRedisError: "缓存操作失败", + + // 用户相关错误 + ErrCodeUserNotFound: "用户不存在", + ErrCodeUserExists: "用户已存在", + ErrCodeInvalidPassword: "密码错误", + ErrCodeUserDisabled: "用户已被禁用", + ErrCodeEmailExists: "邮箱已被注册", + ErrCodeUsernameExists: "用户名已被注册", + ErrCodeInvalidEmail: "邮箱格式不正确", + ErrCodePasswordTooWeak: "密码强度不够", + + // 认证相关错误 + ErrCodeInvalidToken: "无效的访问令牌", + ErrCodeTokenExpired: "访问令牌已过期", + ErrCodeTokenNotFound: "访问令牌不存在", + ErrCodeRefreshTokenInvalid: "刷新令牌无效", + ErrCodeLoginRequired: "请先登录", + + // 词汇相关错误 + ErrCodeVocabularyNotFound: "词汇不存在", + ErrCodeCategoryNotFound: "词汇分类不存在", + ErrCodeWordExists: "词汇已存在", + ErrCodeInvalidDifficulty: "无效的难度等级", + + // 学习相关错误 + ErrCodeProgressNotFound: "学习进度不存在", + ErrCodeInvalidScore: "无效的分数", + ErrCodeTestNotFound: "测试不存在", + ErrCodeExerciseNotFound: "练习不存在", + + // 文件相关错误 + ErrCodeFileUploadFailed: "文件上传失败", + ErrCodeFileNotFound: "文件不存在", + ErrCodeInvalidFileType: "不支持的文件类型", + ErrCodeFileTooLarge: "文件大小超出限制", + + // AI相关错误 + ErrCodeAIServiceUnavailable: "AI服务暂不可用", + ErrCodeAIProcessingFailed: "AI处理失败", + ErrCodeInvalidAudioFormat: "不支持的音频格式", + ErrCodeSpeechRecognitionFailed: "语音识别失败", +} + +// BusinessError 业务错误结构 +type BusinessError struct { + Code int `json:"code"` + Message string `json:"message"` +} + +func (e *BusinessError) Error() string { + return e.Message +} + +// NewBusinessError 创建业务错误 +func NewBusinessError(code int, message string) *BusinessError { + if message == "" { + if msg, exists := ErrorMessages[code]; exists { + message = msg + } else { + message = "未知错误" + } + } + return &BusinessError{ + Code: code, + Message: message, + } +} + +// 预定义的常用错误 +var ( + ErrUserNotFound = NewBusinessError(ErrCodeUserNotFound, "") + ErrUserExists = NewBusinessError(ErrCodeUserExists, "") + ErrInvalidPassword = NewBusinessError(ErrCodeInvalidPassword, "") + ErrInvalidToken = NewBusinessError(ErrCodeInvalidToken, "") + ErrTokenExpired = NewBusinessError(ErrCodeTokenExpired, "") + ErrEmailExists = NewBusinessError(ErrCodeEmailExists, "") + ErrUsernameExists = NewBusinessError(ErrCodeUsernameExists, "") + ErrVocabularyNotFound = NewBusinessError(ErrCodeVocabularyNotFound, "") + ErrVocabularyTestNotFound = NewBusinessError(ErrCodeTestNotFound, "") + ErrDatabaseError = NewBusinessError(ErrCodeDatabaseError, "") +) + +// 通用系统错误 +var ( + ErrInvalidInput = errors.New("invalid input") + ErrNotFound = errors.New("not found") + ErrUnauthorized = errors.New("unauthorized") + ErrForbidden = errors.New("forbidden") +) + +// IsBusinessError 判断是否为业务错误 +func IsBusinessError(err error) bool { + if err == nil { + return false + } + if _, ok := err.(*BusinessError); ok { + return true + } + var be *BusinessError + return errors.As(err, &be) +} \ No newline at end of file diff --git a/serve/internal/common/response.go b/serve/internal/common/response.go new file mode 100644 index 0000000..a5f7d86 --- /dev/null +++ b/serve/internal/common/response.go @@ -0,0 +1,125 @@ +package common + +import ( + "net/http" + "time" + + "github.com/gin-gonic/gin" +) + +// Response 通用响应结构 +type Response struct { + Code int `json:"code"` + Message string `json:"message"` + Data interface{} `json:"data,omitempty"` + Timestamp string `json:"timestamp"` +} + +// PaginationResponse 分页响应结构 +type PaginationResponse struct { + Code int `json:"code"` + Message string `json:"message"` + Data interface{} `json:"data"` + Timestamp string `json:"timestamp"` +} + +// PaginationData 分页数据结构 +type PaginationData struct { + Items interface{} `json:"items"` + Pagination *Pagination `json:"pagination"` +} + +// Pagination 分页信息 +type Pagination struct { + Page int `json:"page"` + PageSize int `json:"page_size"` + Total int `json:"total"` + TotalPages int `json:"total_pages"` +} + +// SuccessResponse 成功响应 +func SuccessResponse(c *gin.Context, data interface{}) { + c.JSON(http.StatusOK, Response{ + Code: http.StatusOK, + Message: "success", + Data: data, + Timestamp: time.Now().UTC().Format(time.RFC3339), + }) +} + +// SuccessWithMessage 带消息的成功响应 +func SuccessWithMessage(c *gin.Context, message string, data interface{}) { + c.JSON(http.StatusOK, Response{ + Code: http.StatusOK, + Message: message, + Data: data, + Timestamp: time.Now().UTC().Format(time.RFC3339), + }) +} + +// PaginationSuccessResponse 分页成功响应 +func PaginationSuccessResponse(c *gin.Context, items interface{}, pagination *Pagination) { + c.JSON(http.StatusOK, PaginationResponse{ + Code: http.StatusOK, + Message: "success", + Data: PaginationData{ + Items: items, + Pagination: pagination, + }, + Timestamp: time.Now().UTC().Format(time.RFC3339), + }) +} + +// ErrorResponse 错误响应 +func ErrorResponse(c *gin.Context, code int, message string) { + c.JSON(code, Response{ + Code: code, + Message: message, + Timestamp: time.Now().UTC().Format(time.RFC3339), + }) +} + +// BadRequestResponse 400错误响应 +func BadRequestResponse(c *gin.Context, message string) { + ErrorResponse(c, http.StatusBadRequest, message) +} + +// UnauthorizedResponse 401错误响应 +func UnauthorizedResponse(c *gin.Context, message string) { + ErrorResponse(c, http.StatusUnauthorized, message) +} + +// ForbiddenResponse 403错误响应 +func ForbiddenResponse(c *gin.Context, message string) { + ErrorResponse(c, http.StatusForbidden, message) +} + +// NotFoundResponse 404错误响应 +func NotFoundResponse(c *gin.Context, message string) { + ErrorResponse(c, http.StatusNotFound, message) +} + +// InternalServerErrorResponse 500错误响应 +func InternalServerErrorResponse(c *gin.Context, message string) { + ErrorResponse(c, http.StatusInternalServerError, message) +} + +// ValidationErrorResponse 参数验证错误响应 +func ValidationErrorResponse(c *gin.Context, errors interface{}) { + c.JSON(http.StatusBadRequest, Response{ + Code: http.StatusBadRequest, + Message: "参数验证失败", + Data: errors, + Timestamp: time.Now().UTC().Format(time.RFC3339), + }) +} + +// SuccessResponseWithStatus 带自定义状态码的成功响应 +func SuccessResponseWithStatus(c *gin.Context, statusCode int, data interface{}) { + c.JSON(statusCode, Response{ + Code: statusCode, + Message: "success", + Data: data, + Timestamp: time.Now().UTC().Format(time.RFC3339), + }) +} \ No newline at end of file diff --git a/serve/internal/database/database.go b/serve/internal/database/database.go new file mode 100644 index 0000000..4c2c505 --- /dev/null +++ b/serve/internal/database/database.go @@ -0,0 +1,89 @@ +package database + +import ( + "fmt" + "log" + "os" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/config" + "gorm.io/driver/mysql" + "gorm.io/gorm" + "gorm.io/gorm/logger" +) + +var DB *gorm.DB + +// InitDatabase 初始化数据库连接 +func InitDatabase() { + cfg := config.GlobalConfig + + // 构建DSN + dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=%s&parseTime=True&loc=Local&multiStatements=true", + cfg.Database.User, + cfg.Database.Password, + cfg.Database.Host, + cfg.Database.Port, + cfg.Database.DBName, + cfg.Database.Charset, + ) + + // 配置GORM日志 - 使用自定义logger输出详细的SQL日志 + gormLogger := logger.New( + log.New(os.Stdout, "\r\n", log.LstdFlags), // io writer + logger.Config{ + SlowThreshold: time.Second, // 慢SQL阈值 + LogLevel: logger.Info, // 日志级别：Info会显示所有SQL + IgnoreRecordNotFoundError: true, // 忽略ErrRecordNotFound错误 + Colorful: true, // 彩色输出 + }, + ) + + // 连接数据库 + var err error + DB, err = gorm.Open(mysql.Open(dsn), &gorm.Config{ + Logger: gormLogger, + DisableForeignKeyConstraintWhenMigrating: true, + }) + if err != nil { + log.Fatalf("Failed to connect to database: %v", err) + } + + // 获取底层sql.DB对象进行连接池配置 + sqlDB, err := DB.DB() + if err != nil { + log.Fatalf("Failed to get underlying sql.DB: %v", err) + } + + // 设置连接池参数 + sqlDB.SetMaxIdleConns(10) // 最大空闲连接数 + sqlDB.SetMaxOpenConns(100) // 最大打开连接数 + sqlDB.SetConnMaxLifetime(time.Hour) // 连接最大生存时间 + sqlDB.SetConnMaxIdleTime(time.Minute * 30) // 连接最大空闲时间 + + // 测试连接 + if err := sqlDB.Ping(); err != nil { + log.Fatalf("Failed to ping database: %v", err) + } + + log.Println("Database connected successfully") +} + +// CloseDatabase 关闭数据库连接 +func CloseDatabase() { + if DB != nil { + sqlDB, err := DB.DB() + if err != nil { + log.Printf("Failed to get underlying sql.DB: %v", err) + return + } + if err := sqlDB.Close(); err != nil { + log.Printf("Failed to close database: %v", err) + } + } +} + +// GetDB 获取数据库实例 +func GetDB() *gorm.DB { + return DB +} \ No newline at end of file diff --git a/serve/internal/database/migrate.go b/serve/internal/database/migrate.go new file mode 100644 index 0000000..4b9ff47 --- /dev/null +++ b/serve/internal/database/migrate.go @@ -0,0 +1,172 @@ +package database + +import ( + "log" + "os" + "path/filepath" + "strings" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "gorm.io/gorm" +) + +// AutoMigrate 自动迁移数据库表结构 +func AutoMigrate(db *gorm.DB) error { + log.Println("开始数据库迁移...") + + // 用户相关表 + err := db.AutoMigrate( + &models.User{}, + &models.UserSocialLink{}, + &models.UserPreference{}, + ) + if err != nil { + return err + } + + // 词汇相关表迁移由 SQL 脚本维护，避免与既有外键/类型冲突 + // （跳过 Vocabulary* / UserVocabularyProgress / VocabularyTest 的 AutoMigrate） + + // 词汇书相关表（新增） + err = db.AutoMigrate( + &models.VocabularyBook{}, + &models.VocabularyBookWord{}, + ) + if err != nil { + return err + } + + // 学习相关表 + err = db.AutoMigrate( + &models.Notification{}, + &models.StudyPlan{}, + &models.StudyPlanRecord{}, + &models.ListeningMaterial{}, + &models.ListeningRecord{}, + &models.ReadingMaterial{}, + &models.ReadingRecord{}, + &models.WritingPrompt{}, + &models.WritingSubmission{}, + &models.SpeakingScenario{}, + &models.SpeakingRecord{}, + ) + if err != nil { + return err + } + + log.Println("数据库迁移完成") + return nil +} + +// CreateIndexes 创建额外的索引 +func CreateIndexes(db *gorm.DB) error { + log.Println("开始创建索引...") + + // 创建索引的辅助函数 + createIndexIfNotExists := func(indexName, tableName, columns string) { + // 检查索引是否存在 + var count int64 + db.Raw("SELECT COUNT(*) FROM information_schema.statistics WHERE table_schema = DATABASE() AND table_name = ? AND index_name = ?", tableName, indexName).Scan(&count) + if count == 0 { + // 索引不存在，创建索引 + sql := "CREATE INDEX " + indexName + " ON " + tableName + "(" + columns + ")" + result := db.Exec(sql) + if result.Error != nil { + log.Printf("创建索引 %s 失败: %v", indexName, result.Error) + } + } + } + + // 用户表索引 + createIndexIfNotExists("idx_users_email_verified", "ai_users", "email_verified") + createIndexIfNotExists("idx_users_status", "ai_users", "status") + createIndexIfNotExists("idx_users_created_at", "ai_users", "created_at") + + // 词汇表索引 + createIndexIfNotExists("idx_vocabulary_level", "ai_vocabulary", "level") + createIndexIfNotExists("idx_vocabulary_frequency", "ai_vocabulary", "frequency") + createIndexIfNotExists("idx_vocabulary_is_active", "ai_vocabulary", "is_active") + + // 用户词汇进度索引 + createIndexIfNotExists("idx_user_vocabulary_progress_user_vocab", "ai_user_vocabulary_progress", "user_id, vocabulary_id") + createIndexIfNotExists("idx_user_vocabulary_progress_mastery", "ai_user_vocabulary_progress", "mastery_level") + createIndexIfNotExists("idx_user_vocabulary_progress_next_review", "ai_user_vocabulary_progress", "next_review_at") + + // 学习记录索引 + createIndexIfNotExists("idx_listening_records_user_material", "ai_listening_records", "user_id, material_id") + createIndexIfNotExists("idx_reading_records_user_material", "ai_reading_records", "user_id, material_id") + createIndexIfNotExists("idx_writing_submissions_user_prompt", "ai_writing_submissions", "user_id, prompt_id") + createIndexIfNotExists("idx_speaking_records_user_scenario", "ai_speaking_records", "user_id, scenario_id") + + // 材料表索引 + createIndexIfNotExists("idx_listening_materials_level", "ai_listening_materials", "level") + createIndexIfNotExists("idx_reading_materials_level", "ai_reading_materials", "level") + createIndexIfNotExists("idx_writing_prompts_level", "ai_writing_prompts", "level") + createIndexIfNotExists("idx_speaking_scenarios_level", "ai_speaking_scenarios", "level") + + log.Println("索引创建完成") + return nil +} + +// ApplyMergedSchemaIfNeeded 读取并执行合并后的SQL脚本，用于创建视图、触发器及扩展表 +func ApplyMergedSchemaIfNeeded(db *gorm.DB) error { + // 检查一个扩展表是否存在，作为是否需要执行脚本的依据 + var count int64 + db.Raw("SELECT COUNT(*) FROM information_schema.tables WHERE table_schema = DATABASE() AND table_name = 'ai_vocabulary_books'").Scan(&count) + if count > 0 { + // 已存在扩展结构，跳过 + return nil + } + + // 读取脚本文件（从 serve 目录运行，脚本位于 ../docs/） + candidates := []string{ + "../docs/database_schema_merged.sql", + "../docs/database_schema.sql", + } + var content []byte + var readErr error + for _, p := range candidates { + abs, _ := filepath.Abs(p) + content, readErr = os.ReadFile(abs) + if readErr == nil { + break + } + } + if readErr != nil { + log.Printf("读取数据库脚本失败: %v", readErr) + return nil + } + + sql := string(content) + // 移除 DELIMITER 指令并将触发器结束符 // 转为 ; + lines := strings.Split(sql, "\n") + var cleaned []string + for _, line := range lines { + trimmed := strings.TrimSpace(line) + if strings.HasPrefix(trimmed, "DELIMITER") { + continue + } + // 将以 // 结尾的行替换为 ; + if strings.HasSuffix(trimmed, "//") { + cleaned = append(cleaned, strings.TrimSuffix(line, "//")+";") + continue + } + cleaned = append(cleaned, line) + } + cleanedSQL := strings.Join(cleaned, "\n") + + // 关闭外键检查以避免初始化时的顺序问题 + if err := db.Exec("SET FOREIGN_KEY_CHECKS=0;").Error; err != nil { + log.Printf("关闭外键检查失败: %v", err) + } + // 执行脚本（依赖 multiStatements=true） + if err := db.Exec(cleanedSQL).Error; err != nil { + log.Printf("执行合并SQL失败: %v", err) + } + // 恢复外键检查 + if err := db.Exec("SET FOREIGN_KEY_CHECKS=1;").Error; err != nil { + log.Printf("开启外键检查失败: %v", err) + } + + return nil +} \ No newline at end of file diff --git a/serve/internal/database/seed.go b/serve/internal/database/seed.go new file mode 100644 index 0000000..b594d71 --- /dev/null +++ b/serve/internal/database/seed.go @@ -0,0 +1,553 @@ +package database + +import ( + "log" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" + "gorm.io/gorm" +) + +// stringPtr 返回字符串指针 +func stringPtr(s string) *string { + return &s +} + +// SeedData 初始化种子数据 +func SeedData(db *gorm.DB) error { + log.Println("开始初始化种子数据...") + + // 检查是否已有数据 + var userCount int64 + db.Model(&models.User{}).Count(&userCount) + if userCount > 0 { + log.Println("数据库已有数据，跳过种子数据初始化") + return nil + } + + // 创建词汇分类 + if err := createVocabularyCategories(db); err != nil { + return err + } + + // 创建示例词汇 + if err := createSampleVocabularies(db); err != nil { + return err + } + + // 创建测试用户 + if err := createTestUsers(db); err != nil { + return err + } + + // 创建听力材料 + if err := createListeningMaterials(db); err != nil { + return err + } + + // 创建阅读材料 + if err := createReadingMaterials(db); err != nil { + return err + } + + // 创建写作提示 + if err := createWritingPrompts(db); err != nil { + return err + } + + // 创建口语场景 + if err := createSpeakingScenarios(db); err != nil { + return err + } + + log.Println("种子数据初始化完成") + return nil +} + +// createVocabularyCategories 创建词汇分类 +func createVocabularyCategories(db *gorm.DB) error { + categories := []models.VocabularyCategory{ + { + ID: utils.GenerateUUID(), + Name: "日常生活", + Description: stringPtr("日常生活中常用的词汇"), + Level: "beginner", + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + { + ID: utils.GenerateUUID(), + Name: "商务英语", + Description: stringPtr("商务场景中使用的专业词汇"), + Level: "intermediate", + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + { + ID: utils.GenerateUUID(), + Name: "学术英语", + Description: stringPtr("学术研究和论文写作中的词汇"), + Level: "advanced", + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + { + ID: utils.GenerateUUID(), + Name: "旅游英语", + Description: stringPtr("旅游出行相关的实用词汇"), + Level: "beginner", + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + { + ID: utils.GenerateUUID(), + Name: "科技英语", + Description: stringPtr("科技和互联网相关词汇"), + Level: "intermediate", + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + } + + for _, category := range categories { + if err := db.Create(&category).Error; err != nil { + return err + } + } + + log.Println("词汇分类创建完成") + return nil +} + +// createSampleVocabularies 创建示例词汇 +func createSampleVocabularies(db *gorm.DB) error { + // 获取第一个分类ID + var category models.VocabularyCategory + if err := db.First(&category).Error; err != nil { + return err + } + + vocabularies := []struct { + Word string + Phonetic string + Level string + Frequency int + Definitions []models.VocabularyDefinition + Examples []models.VocabularyExample + }{ + { + Word: "hello", + Phonetic: "/həˈloʊ/", + Level: "beginner", + Frequency: 100, + Definitions: []models.VocabularyDefinition{ + { + PartOfSpeech: "interjection", + Definition: "used as a greeting or to begin a phone conversation", + Translation: "你好", + SortOrder: 0, + CreatedAt: time.Now(), + }, + }, + Examples: []models.VocabularyExample{ + { + Example: "Hello, how are you?", + Translation: "你好，你好吗？", + SortOrder: 0, + CreatedAt: time.Now(), + }, + }, + }, + { + Word: "world", + Phonetic: "/wɜːrld/", + Level: "beginner", + Frequency: 95, + Definitions: []models.VocabularyDefinition{ + { + PartOfSpeech: "noun", + Definition: "the earth, together with all of its countries and peoples", + Translation: "世界", + SortOrder: 0, + CreatedAt: time.Now(), + }, + }, + Examples: []models.VocabularyExample{ + { + Example: "The world is a beautiful place.", + Translation: "世界是一个美丽的地方。", + SortOrder: 0, + CreatedAt: time.Now(), + }, + }, + }, + { + Word: "learn", + Phonetic: "/lɜːrn/", + Level: "beginner", + Frequency: 90, + Definitions: []models.VocabularyDefinition{ + { + PartOfSpeech: "verb", + Definition: "acquire knowledge of or skill in something", + Translation: "学习", + SortOrder: 0, + CreatedAt: time.Now(), + }, + }, + Examples: []models.VocabularyExample{ + { + Example: "I want to learn English.", + Translation: "我想学习英语。", + SortOrder: 0, + CreatedAt: time.Now(), + }, + }, + }, + { + Word: "study", + Phonetic: "/ˈstʌdi/", + Level: "beginner", + Frequency: 85, + Definitions: []models.VocabularyDefinition{ + { + PartOfSpeech: "verb", + Definition: "devote time and attention to acquiring knowledge", + Translation: "学习，研究", + SortOrder: 0, + CreatedAt: time.Now(), + }, + }, + Examples: []models.VocabularyExample{ + { + Example: "She studies hard every day.", + Translation: "她每天都努力学习。", + SortOrder: 0, + CreatedAt: time.Now(), + }, + }, + }, + { + Word: "practice", + Phonetic: "/ˈpræktɪs/", + Level: "intermediate", + Frequency: 80, + Definitions: []models.VocabularyDefinition{ + { + PartOfSpeech: "verb", + Definition: "perform an activity repeatedly to improve one's skill", + Translation: "练习", + SortOrder: 0, + CreatedAt: time.Now(), + }, + }, + Examples: []models.VocabularyExample{ + { + Example: "Practice makes perfect.", + Translation: "熟能生巧。", + SortOrder: 0, + CreatedAt: time.Now(), + }, + }, + }, + } + + for _, vocabData := range vocabularies { + // 检查词汇是否已存在 + var existingVocab models.Vocabulary + if err := db.Where("word = ?", vocabData.Word).First(&existingVocab).Error; err == nil { + // 词汇已存在，跳过 + log.Printf("词汇 '%s' 已存在，跳过创建", vocabData.Word) + continue + } + + // 创建词汇 + vocab := models.Vocabulary{ + Word: vocabData.Word, + Phonetic: &vocabData.Phonetic, + Level: vocabData.Level, + Frequency: vocabData.Frequency, + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + if err := db.Create(&vocab).Error; err != nil { + return err + } + + // 关联分类 + if err := db.Model(&vocab).Association("Categories").Append(&category); err != nil { + return err + } + + // 创建定义 + for _, def := range vocabData.Definitions { + def.VocabularyID = vocab.ID + if err := db.Create(&def).Error; err != nil { + return err + } + } + + // 创建例句 + for _, example := range vocabData.Examples { + example.VocabularyID = vocab.ID + if err := db.Create(&example).Error; err != nil { + return err + } + } + } + + log.Println("示例词汇创建完成") + return nil +} + +// createTestUsers 创建测试用户 +func createTestUsers(db *gorm.DB) error { + users := []models.User{ + { + ID: 0, // 让数据库自动生成 + Username: "testuser", + Email: "test@example.com", + PasswordHash: "$2a$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi", // password + Nickname: stringPtr("测试用户"), + Avatar: stringPtr("https://via.placeholder.com/150"), + Gender: stringPtr("other"), + BirthDate: nil, + Location: stringPtr("北京"), + Bio: stringPtr("这是一个测试用户"), + EmailVerified: true, + Status: "active", + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + { + ID: 0, // 让数据库自动生成 + Username: "demo", + Email: "demo@example.com", + PasswordHash: "$2a$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi", // password + Nickname: stringPtr("演示用户"), + Avatar: stringPtr("https://via.placeholder.com/150"), + Gender: stringPtr("other"), + BirthDate: nil, + Location: stringPtr("上海"), + Bio: stringPtr("这是一个演示用户"), + EmailVerified: true, + Status: "active", + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + } + + for _, user := range users { + if err := db.Create(&user).Error; err != nil { + return err + } + + // 创建用户偏好设置 + preference := models.UserPreference{ + ID: 0, // 让数据库自动生成 + UserID: user.ID, + DailyGoal: 30, + WeeklyGoal: 210, + ReminderEnabled: true, + ReminderTime: stringPtr("09:00:00"), + DifficultyLevel: "intermediate", + LearningMode: "casual", + PreferredTopics: stringPtr("[\"vocabulary\", \"listening\"]"), + NotificationSettings: stringPtr("{\"email\": true, \"push\": true}"), + PrivacySettings: stringPtr("{\"profile_public\": false}"), + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + if err := db.Create(&preference).Error; err != nil { + return err + } + } + + log.Println("测试用户创建完成") + return nil +} + +// createListeningMaterials 创建听力材料 +func createListeningMaterials(db *gorm.DB) error { + materials := []models.ListeningMaterial{ + { + ID: utils.GenerateUUID(), + Title: "Daily Conversation", + Description: stringPtr("Basic daily conversation practice"), + Level: "beginner", + Duration: 180, // 3 minutes + AudioURL: "https://example.com/audio/daily-conversation.mp3", + Transcript: stringPtr("A: Hello, how are you today? B: I'm fine, thank you. How about you?"), + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + { + ID: utils.GenerateUUID(), + Title: "Business Meeting", + Description: stringPtr("Business meeting discussion"), + Level: "intermediate", + Duration: 300, // 5 minutes + AudioURL: "https://example.com/audio/business-meeting.mp3", + Transcript: stringPtr("Let's discuss the quarterly report and our future plans."), + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + } + + for _, material := range materials { + if err := db.Create(&material).Error; err != nil { + return err + } + } + + log.Println("听力材料创建完成") + return nil +} + +// intPtr 返回整数指针 +func intPtr(i int) *int { + return &i +} + +// createReadingMaterials 创建阅读材料 +func createReadingMaterials(db *gorm.DB) error { + materials := []models.ReadingMaterial{ + { + ID: utils.GenerateUUID(), + Title: "The Benefits of Reading", + Content: "Reading is one of the most beneficial activities for the human mind. It improves vocabulary, enhances critical thinking, and provides entertainment.", + Level: "beginner", + WordCount: 25, + + Summary: stringPtr("这是一篇关于阅读益处的文章"), + Source: stringPtr("Education Weekly"), + Author: stringPtr("Reading Expert"), + Tags: stringPtr("[\"reading\", \"education\"]"), + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + { + ID: utils.GenerateUUID(), + Title: "Climate Change and Technology", + Content: "Climate change represents one of the most pressing challenges of our time. Technology plays a crucial role in both contributing to and solving environmental problems.", + Level: "intermediate", + WordCount: 30, + + Summary: stringPtr("这是一篇关于气候变化与科技的文章"), + Source: stringPtr("Science Today"), + Author: stringPtr("Climate Researcher"), + Tags: stringPtr("[\"climate\", \"technology\"]"), + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + } + + for _, material := range materials { + if err := db.Create(&material).Error; err != nil { + return err + } + } + + log.Println("阅读材料创建完成") + return nil +} + +// createWritingPrompts 创建写作提示 +func createWritingPrompts(db *gorm.DB) error { + prompts := []models.WritingPrompt{ + { + ID: utils.GenerateUUID(), + Title: "My Daily Routine", + Prompt: "Describe your daily routine from morning to evening. Include what you do, when you do it, and why.", + Level: "beginner", + MinWords: intPtr(100), + MaxWords: intPtr(200), + TimeLimit: intPtr(1800), // 30 minutes + Instructions: stringPtr("Write a clear and descriptive essay"), + Tags: stringPtr("[\"daily\", \"routine\"]"), + SampleAnswer: stringPtr("Every morning, I wake up at 7 AM and start my day..."), + Rubric: stringPtr("{\"grammar\": 25, \"vocabulary\": 25, \"coherence\": 25, \"content\": 25}"), + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + { + ID: utils.GenerateUUID(), + Title: "The Impact of Social Media", + Prompt: "Discuss the positive and negative impacts of social media on modern society. Provide specific examples and your personal opinion.", + Level: "intermediate", + MinWords: intPtr(250), + MaxWords: intPtr(400), + TimeLimit: intPtr(2700), // 45 minutes + Instructions: stringPtr("Write a balanced argumentative essay"), + Tags: stringPtr("[\"social media\", \"society\"]"), + SampleAnswer: stringPtr("Social media has transformed how we communicate..."), + Rubric: stringPtr("{\"grammar\": 30, \"vocabulary\": 20, \"coherence\": 25, \"content\": 25}"), + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + } + + for _, prompt := range prompts { + if err := db.Create(&prompt).Error; err != nil { + return err + } + } + + log.Println("写作提示创建完成") + return nil +} + +// createSpeakingScenarios 创建口语场景 +func createSpeakingScenarios(db *gorm.DB) error { + scenarios := []models.SpeakingScenario{ + { + ID: utils.GenerateUUID(), + Title: "Restaurant Ordering", + Description: "You are at a restaurant and want to order food. The waiter will take your order.", + Level: "beginner", + Context: stringPtr("You are at a restaurant with friends"), + Tags: stringPtr("[\"restaurant\", \"food\"]"), + Dialogue: stringPtr("[{\"speaker\": \"waiter\", \"text\": \"Good evening, welcome to our restaurant!\"}]"), + KeyPhrases: stringPtr("[\"I'd like to order\", \"Could I have\", \"The bill, please\"]"), + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + { + ID: utils.GenerateUUID(), + Title: "Job Interview", + Description: "You are in a job interview for a position you really want. Answer the interviewer's questions confidently.", + Level: "intermediate", + Context: stringPtr("You are applying for a job"), + Tags: stringPtr("[\"interview\", \"job\"]"), + Dialogue: stringPtr("[{\"speaker\": \"interviewer\", \"text\": \"Tell me about yourself\"}]"), + KeyPhrases: stringPtr("[\"I have experience in\", \"My strengths are\", \"I'm interested in\"]"), + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + }, + } + + for _, scenario := range scenarios { + if err := db.Create(&scenario).Error; err != nil { + return err + } + } + + log.Println("口语场景创建完成") + return nil +} \ No newline at end of file diff --git a/serve/internal/database/user_repository.go b/serve/internal/database/user_repository.go new file mode 100644 index 0000000..20949c8 --- /dev/null +++ b/serve/internal/database/user_repository.go @@ -0,0 +1,56 @@ +package database + +import ( + "errors" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/model" +) + +type UserRepository struct { + // 实际项目中这里会有数据库连接 +} + +func NewUserRepository() *UserRepository { + return &UserRepository{} +} + +// 创建用户 +func (r *UserRepository) Create(user *model.User) (string, error) { + // 实际项目中这里会执行数据库插入操作 + // 模拟生成用户ID + user.ID = "user-123" + return user.ID, nil +} + +// 根据ID获取用户 +func (r *UserRepository) GetByID(id string) (*model.User, error) { + // 实际项目中这里会执行数据库查询操作 + if id == "user-123" { + return &model.User{ + ID: id, + Username: "testuser", + Email: "test@example.com", + Avatar: "", + }, nil + } + return nil, errors.New("用户不存在") +} + +// 根据邮箱获取用户 +func (r *UserRepository) GetByEmail(email string) (*model.User, error) { + // 实际项目中这里会执行数据库查询操作 + if email == "test@example.com" { + return &model.User{ + ID: "user-123", + Username: "testuser", + Email: email, + Password: "password123", // 实际项目中密码应该是加密的 + }, nil + } + return nil, errors.New("用户不存在") +} + +// 更新用户信息 +func (r *UserRepository) Update(user *model.User) error { + // 实际项目中这里会执行数据库更新操作 + return nil +} \ No newline at end of file diff --git a/serve/internal/handler/ai_handler.go b/serve/internal/handler/ai_handler.go new file mode 100644 index 0000000..9417653 --- /dev/null +++ b/serve/internal/handler/ai_handler.go @@ -0,0 +1,105 @@ +package handler + +import ( + "net/http" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/service" + "github.com/gin-gonic/gin" +) + +// AIHandler AI相关处理器 +type AIHandler struct { + aiService service.AIService +} + +// NewAIHandler 创建AI处理器 +func NewAIHandler() *AIHandler { + return &AIHandler{ + aiService: service.NewAIService(), + } +} + +// WritingCorrectionRequest 写作批改请求 +type WritingCorrectionRequest struct { + Content string `json:"content" binding:"required"` + TaskType string `json:"task_type" binding:"required"` +} + +// CorrectWriting 写作批改 +func (h *AIHandler) CorrectWriting(c *gin.Context) { + var req WritingCorrectionRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "Invalid request parameters", + "details": err.Error(), + }) + return + } + + // 调用AI服务进行写作批改 + result, err := h.aiService.CorrectWriting(c.Request.Context(), req.Content, req.TaskType) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "AI service error", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "Writing correction completed", + "data": result, + }) +} + +// SpeakingEvaluationRequest 口语评估请求 +type SpeakingEvaluationRequest struct { + AudioText string `json:"audio_text" binding:"required"` + Prompt string `json:"prompt" binding:"required"` +} + +// EvaluateSpeaking 口语评估 +func (h *AIHandler) EvaluateSpeaking(c *gin.Context) { + var req SpeakingEvaluationRequest + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "Invalid request parameters", + "details": err.Error(), + }) + return + } + + // 调用AI服务进行口语评估 + result, err := h.aiService.EvaluateSpeaking(c.Request.Context(), req.AudioText, req.Prompt) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "AI service error", + "details": err.Error(), + }) + return + } + + c.JSON(http.StatusOK, gin.H{ + "message": "Speaking evaluation completed", + "data": result, + }) +} + +// GetAIUsageStats 获取AI使用统计 +func (h *AIHandler) GetAIUsageStats(c *gin.Context) { + // TODO: 实现实际的统计查询逻辑 + // 目前返回模拟数据 + stats := gin.H{ + "writing_corrections": 15, + "speaking_evaluations": 8, + "recommendations": 5, + "exercises_generated": 12, + "total_requests": 40, + "this_month_requests": 15, + } + + c.JSON(http.StatusOK, gin.H{ + "message": "AI usage statistics", + "data": stats, + }) +} \ No newline at end of file diff --git a/serve/internal/handler/learning_session_handler.go b/serve/internal/handler/learning_session_handler.go new file mode 100644 index 0000000..5306691 --- /dev/null +++ b/serve/internal/handler/learning_session_handler.go @@ -0,0 +1,145 @@ +package handler + +import ( + "strconv" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/gin-gonic/gin" +) + +type LearningSessionHandler struct { + sessionService *services.LearningSessionService +} + +func NewLearningSessionHandler(sessionService *services.LearningSessionService) *LearningSessionHandler { + return &LearningSessionHandler{sessionService: sessionService} +} + +// StartLearning 开始学习 +// POST /api/v1/vocabulary/books/:id/learn +func (h *LearningSessionHandler) StartLearning(c *gin.Context) { + userID := c.GetInt64("user_id") + bookID := c.Param("id") + + var req struct { + DailyGoal int `json:"dailyGoal" binding:"required,min=1,max=100"` + } + + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, 400, "参数错误："+err.Error()) + return + } + + // 创建学习会话 + session, err := h.sessionService.StartLearningSession(userID, bookID, req.DailyGoal) + if err != nil { + common.ErrorResponse(c, 500, "创建学习会话失败") + return + } + + // 获取今日学习任务（新词数 = 用户选择，复习词 = 所有到期） + tasks, err := h.sessionService.GetTodayLearningTasks(userID, bookID, req.DailyGoal) + if err != nil { + common.ErrorResponse(c, 500, "获取学习任务失败") + return + } + + common.SuccessResponse(c, gin.H{ + "session": session, + "tasks": tasks, + }) +} + +// GetTodayTasks 获取今日学习任务 +// GET /api/v1/vocabulary/books/:id/tasks +func (h *LearningSessionHandler) GetTodayTasks(c *gin.Context) { + userID := c.GetInt64("user_id") + bookID := c.Param("id") + + newWordsLimit, _ := strconv.Atoi(c.DefaultQuery("newWords", "20")) + + // 获取学习任务（复习词不限数量） + tasks, err := h.sessionService.GetTodayLearningTasks(userID, bookID, newWordsLimit) + if err != nil { + common.ErrorResponse(c, 500, "获取学习任务失败") + return + } + + common.SuccessResponse(c, tasks) +} + +// SubmitWordStudy 提交单词学习结果 +// POST /api/v1/vocabulary/words/:id/study +func (h *LearningSessionHandler) SubmitWordStudy(c *gin.Context) { + userID := c.GetInt64("user_id") + wordIDStr := c.Param("id") + + wordID, err := strconv.ParseInt(wordIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的单词ID") + return + } + + var req struct { + Difficulty string `json:"difficulty" binding:"required,oneof=forgot hard good easy perfect"` + SessionID int64 `json:"sessionId"` + } + + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, 400, "参数错误："+err.Error()) + return + } + + // 记录学习结果 + progress, err := h.sessionService.RecordWordStudy(userID, wordID, req.Difficulty) + if err != nil { + common.ErrorResponse(c, 500, "记录学习结果失败") + return + } + + common.SuccessResponse(c, progress) +} + +// GetLearningStatistics 获取学习统计 +// GET /api/v1/vocabulary/books/:id/statistics +func (h *LearningSessionHandler) GetLearningStatistics(c *gin.Context) { + userID := c.GetInt64("user_id") + bookID := c.Param("id") + + stats, err := h.sessionService.GetLearningStatistics(userID, bookID) + if err != nil { + common.ErrorResponse(c, 500, "获取学习统计失败") + return + } + + common.SuccessResponse(c, stats) +} + +// GetTodayOverallStatistics 获取今日总体学习统计 +// GET /api/v1/learning/today/statistics +func (h *LearningSessionHandler) GetTodayOverallStatistics(c *gin.Context) { + userID := c.GetInt64("user_id") + + stats, err := h.sessionService.GetTodayOverallStatistics(userID) + if err != nil { + common.ErrorResponse(c, 500, "获取今日学习统计失败") + return + } + + common.SuccessResponse(c, stats) +} + +// GetTodayReviewWords 获取今日需要复习的单词 +// GET /api/v1/learning/today/review-words +func (h *LearningSessionHandler) GetTodayReviewWords(c *gin.Context) { + userID := c.GetInt64("user_id") + + words, err := h.sessionService.GetTodayReviewWords(userID) + if err != nil { + common.ErrorResponse(c, 500, "获取今日复习单词失败") + return + } + + common.SuccessResponse(c, words) +} diff --git a/serve/internal/handler/listening_handler.go b/serve/internal/handler/listening_handler.go new file mode 100644 index 0000000..11ec634 --- /dev/null +++ b/serve/internal/handler/listening_handler.go @@ -0,0 +1,232 @@ +package handler + +import ( + "net/http" + "strconv" + + "github.com/gin-gonic/gin" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" +) + +type ListeningHandler struct { + listeningService *services.ListeningService +} + +func NewListeningHandler(listeningService *services.ListeningService) *ListeningHandler { + return &ListeningHandler{listeningService: listeningService} +} + +func getUserIDString(c *gin.Context) string { + uid, exists := c.Get("user_id") + if !exists || uid == nil { + return "" + } + switch v := uid.(type) { + case string: + return v + case int: + return strconv.Itoa(v) + case int64: + return strconv.FormatInt(v, 10) + default: + return "" + } +} + +// GetListeningMaterials 获取听力材料列表 +func (h *ListeningHandler) GetListeningMaterials(c *gin.Context) { + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + materials, total, err := h.listeningService.GetListeningMaterials(level, category, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"materials": materials, "total": total}) +} + +// GetListeningMaterial 获取听力材料详情 +func (h *ListeningHandler) GetListeningMaterial(c *gin.Context) { + id := c.Param("id") + + material, err := h.listeningService.GetListeningMaterial(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Listening material not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"material": material}) +} + +// CreateListeningMaterial 创建听力材料 +func (h *ListeningHandler) CreateListeningMaterial(c *gin.Context) { + var material models.ListeningMaterial + if err := c.ShouldBindJSON(&material); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.listeningService.CreateListeningMaterial(&material); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusCreated, gin.H{"material": material}) +} + +// UpdateListeningMaterial 更新听力材料 +func (h *ListeningHandler) UpdateListeningMaterial(c *gin.Context) { + id := c.Param("id") + + var updates map[string]interface{} + if err := c.ShouldBindJSON(&updates); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.listeningService.UpdateListeningMaterial(id, updates); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + // 返回最新数据 + material, err := h.listeningService.GetListeningMaterial(id) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + c.JSON(http.StatusOK, gin.H{"material": material}) +} + +// DeleteListeningMaterial 删除听力材料 +func (h *ListeningHandler) DeleteListeningMaterial(c *gin.Context) { + id := c.Param("id") + + if err := h.listeningService.DeleteListeningMaterial(id); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"message": "Listening material deleted successfully"}) +} + +// SearchListeningMaterials 搜索听力材料 +func (h *ListeningHandler) SearchListeningMaterials(c *gin.Context) { + keyword := c.Query("keyword") + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + materials, total, err := h.listeningService.SearchListeningMaterials(keyword, level, category, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"materials": materials, "total": total}) +} + +// 已移除未实现的 GetRecommendedMaterials，避免编译错误 + +// CreateListeningRecord 创建听力记录 +func (h *ListeningHandler) CreateListeningRecord(c *gin.Context) { + var record models.ListeningRecord + if err := c.ShouldBindJSON(&record); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + record.UserID = getUserIDString(c) + if err := h.listeningService.CreateListeningRecord(&record); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusCreated, gin.H{"record": record}) +} + +// UpdateListeningRecord 更新听力记录 +func (h *ListeningHandler) UpdateListeningRecord(c *gin.Context) { + id := c.Param("id") + + var updates map[string]interface{} + if err := c.ShouldBindJSON(&updates); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.listeningService.UpdateListeningRecord(id, updates); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + record, err := h.listeningService.GetListeningRecord(id) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + c.JSON(http.StatusOK, gin.H{"record": record}) +} + +// GetListeningRecord 获取听力记录详情 +func (h *ListeningHandler) GetListeningRecord(c *gin.Context) { + id := c.Param("id") + + record, err := h.listeningService.GetListeningRecord(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Listening record not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"record": record}) +} + +// GetUserListeningRecords 获取用户听力记录列表 +func (h *ListeningHandler) GetUserListeningRecords(c *gin.Context) { + userID := getUserIDString(c) + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + records, total, err := h.listeningService.GetUserListeningRecords(userID, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"data": records, "total": total}) +} + +// 移除未实现的 SubmitListening 与 GradeListening，避免编译错误 + +// GetUserListeningStats 获取用户听力统计 +func (h *ListeningHandler) GetUserListeningStats(c *gin.Context) { + userID := getUserIDString(c) + + stats, err := h.listeningService.GetUserListeningStats(userID) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"stats": stats}) +} + +// GetListeningProgress 获取听力进度 +func (h *ListeningHandler) GetListeningProgress(c *gin.Context) { + userID := getUserIDString(c) + materialID := c.Param("material_id") + + progress, err := h.listeningService.GetListeningProgress(userID, materialID) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Listening progress not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"progress": progress}) +} \ No newline at end of file diff --git a/serve/internal/handler/notification_handler.go b/serve/internal/handler/notification_handler.go new file mode 100644 index 0000000..5830d67 --- /dev/null +++ b/serve/internal/handler/notification_handler.go @@ -0,0 +1,144 @@ +package handler + +import ( + "log" + "net/http" + "strconv" + + "github.com/gin-gonic/gin" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" +) + +// NotificationHandler 通知处理器 +type NotificationHandler struct { + notificationService *services.NotificationService +} + +// NewNotificationHandler 创建通知处理器 +func NewNotificationHandler(notificationService *services.NotificationService) *NotificationHandler { + return &NotificationHandler{ + notificationService: notificationService, + } +} + +// GetNotifications 获取通知列表 +// @Summary 获取用户通知列表 +// @Tags notification +// @Param page query int false "页码" default(1) +// @Param limit query int false "每页数量" default(10) +// @Param only_unread query bool false "只显示未读" default(false) +// @Success 200 {object} common.Response +// @Router /api/v1/notifications [get] +func (h *NotificationHandler) GetNotifications(c *gin.Context) { + userID := c.GetInt64("user_id") + + // 解析分页参数 + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "10")) + onlyUnread, _ := strconv.ParseBool(c.DefaultQuery("only_unread", "false")) + + if page < 1 { + page = 1 + } + if limit < 1 || limit > 100 { + limit = 10 + } + + notifications, total, err := h.notificationService.GetUserNotifications(userID, page, limit, onlyUnread) + if err != nil { + log.Printf("[ERROR] 获取通知列表失败: userID=%d, error=%v", userID, err) + common.ErrorResponse(c, http.StatusInternalServerError, "获取通知列表失败") + return + } + + common.SuccessResponse(c, gin.H{ + "notifications": notifications, + "total": total, + "page": page, + "limit": limit, + }) +} + +// GetUnreadCount 获取未读通知数量 +// @Summary 获取未读通知数量 +// @Tags notification +// @Success 200 {object} common.Response +// @Router /api/v1/notifications/unread-count [get] +func (h *NotificationHandler) GetUnreadCount(c *gin.Context) { + userID := c.GetInt64("user_id") + + count, err := h.notificationService.GetUnreadCount(userID) + if err != nil { + log.Printf("[ERROR] 获取未读通知数量失败: userID=%d, error=%v", userID, err) + common.ErrorResponse(c, http.StatusInternalServerError, "获取未读通知数量失败") + return + } + + common.SuccessResponse(c, gin.H{ + "count": count, + }) +} + +// MarkAsRead 标记通知为已读 +// @Summary 标记通知为已读 +// @Tags notification +// @Param id path int true "通知ID" +// @Success 200 {object} common.Response +// @Router /api/v1/notifications/:id/read [put] +func (h *NotificationHandler) MarkAsRead(c *gin.Context) { + userID := c.GetInt64("user_id") + notificationID, err := strconv.ParseInt(c.Param("id"), 10, 64) + if err != nil { + common.ErrorResponse(c, http.StatusBadRequest, "无效的通知ID") + return + } + + if err := h.notificationService.MarkAsRead(userID, notificationID); err != nil { + log.Printf("[ERROR] 标记通知已读失败: userID=%d, notificationID=%d, error=%v", userID, notificationID, err) + common.ErrorResponse(c, http.StatusInternalServerError, err.Error()) + return + } + + common.SuccessResponse(c, nil) +} + +// MarkAllAsRead 标记所有通知为已读 +// @Summary 标记所有通知为已读 +// @Tags notification +// @Success 200 {object} common.Response +// @Router /api/v1/notifications/read-all [put] +func (h *NotificationHandler) MarkAllAsRead(c *gin.Context) { + userID := c.GetInt64("user_id") + + if err := h.notificationService.MarkAllAsRead(userID); err != nil { + log.Printf("[ERROR] 标记所有通知已读失败: userID=%d, error=%v", userID, err) + common.ErrorResponse(c, http.StatusInternalServerError, "标记所有通知已读失败") + return + } + + common.SuccessResponse(c, nil) +} + +// DeleteNotification 删除通知 +// @Summary 删除通知 +// @Tags notification +// @Param id path int true "通知ID" +// @Success 200 {object} common.Response +// @Router /api/v1/notifications/:id [delete] +func (h *NotificationHandler) DeleteNotification(c *gin.Context) { + userID := c.GetInt64("user_id") + notificationID, err := strconv.ParseInt(c.Param("id"), 10, 64) + if err != nil { + common.ErrorResponse(c, http.StatusBadRequest, "无效的通知ID") + return + } + + if err := h.notificationService.DeleteNotification(userID, notificationID); err != nil { + log.Printf("[ERROR] 删除通知失败: userID=%d, notificationID=%d, error=%v", userID, notificationID, err) + common.ErrorResponse(c, http.StatusInternalServerError, err.Error()) + return + } + + common.SuccessResponse(c, nil) +} diff --git a/serve/internal/handler/reading_handler.go b/serve/internal/handler/reading_handler.go new file mode 100644 index 0000000..af37ccd --- /dev/null +++ b/serve/internal/handler/reading_handler.go @@ -0,0 +1,226 @@ +package handler + +import ( + "net/http" + "strconv" + + "github.com/gin-gonic/gin" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" +) + +type ReadingHandler struct { + readingService *services.ReadingService +} + +func NewReadingHandler(readingService *services.ReadingService) *ReadingHandler { + return &ReadingHandler{readingService: readingService} +} + +// GetReadingMaterials 获取阅读材料列表 +func (h *ReadingHandler) GetReadingMaterials(c *gin.Context) { + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + materials, total, err := h.readingService.GetReadingMaterials(level, category, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"materials": materials, "total": total}) +} + +// GetReadingMaterial 获取阅读材料详情 +func (h *ReadingHandler) GetReadingMaterial(c *gin.Context) { + id := c.Param("id") + + material, err := h.readingService.GetReadingMaterial(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Reading material not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"material": material}) +} + +// CreateReadingMaterial 创建阅读材料 +func (h *ReadingHandler) CreateReadingMaterial(c *gin.Context) { + var material models.ReadingMaterial + if err := c.ShouldBindJSON(&material); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.readingService.CreateReadingMaterial(&material); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusCreated, gin.H{"material": material}) +} + +// UpdateReadingMaterial 更新阅读材料 +func (h *ReadingHandler) UpdateReadingMaterial(c *gin.Context) { + id := c.Param("id") + + var updates map[string]interface{} + if err := c.ShouldBindJSON(&updates); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.readingService.UpdateReadingMaterial(id, updates); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + material, err := h.readingService.GetReadingMaterial(id) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + c.JSON(http.StatusOK, gin.H{"material": material}) +} + +// DeleteReadingMaterial 删除阅读材料 +func (h *ReadingHandler) DeleteReadingMaterial(c *gin.Context) { + id := c.Param("id") + + if err := h.readingService.DeleteReadingMaterial(id); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"message": "Reading material deleted successfully"}) +} + +// SearchReadingMaterials 搜索阅读材料 +func (h *ReadingHandler) SearchReadingMaterials(c *gin.Context) { + keyword := c.Query("keyword") + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + materials, total, err := h.readingService.SearchReadingMaterials(keyword, level, category, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"materials": materials, "total": total}) +} + +// GetRecommendedMaterials 获取推荐阅读材料 +func (h *ReadingHandler) GetRecommendedMaterials(c *gin.Context) { + userID := c.GetString("user_id") + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "5")) + + materials, err := h.readingService.GetRecommendedMaterials(userID, limit) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"materials": materials}) +} + +// CreateReadingRecord 创建阅读记录 +func (h *ReadingHandler) CreateReadingRecord(c *gin.Context) { + var record models.ReadingRecord + if err := c.ShouldBindJSON(&record); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + record.UserID = c.GetString("user_id") + if err := h.readingService.CreateReadingRecord(&record); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusCreated, gin.H{"record": record}) +} + +// UpdateReadingRecord 更新阅读记录 +func (h *ReadingHandler) UpdateReadingRecord(c *gin.Context) { + id := c.Param("id") + + var updates map[string]interface{} + if err := c.ShouldBindJSON(&updates); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.readingService.UpdateReadingRecord(id, updates); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + record, err := h.readingService.GetReadingRecord(id) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + c.JSON(http.StatusOK, gin.H{"record": record}) +} + +// GetReadingRecord 获取阅读记录详情 +func (h *ReadingHandler) GetReadingRecord(c *gin.Context) { + id := c.Param("id") + + record, err := h.readingService.GetReadingRecord(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Reading record not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"record": record}) +} + +// GetUserReadingRecords 获取用户阅读记录列表 +func (h *ReadingHandler) GetUserReadingRecords(c *gin.Context) { + userID := c.GetString("user_id") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + records, total, err := h.readingService.GetUserReadingRecords(userID, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"records": records, "total": total}) +} + +// 已移除未实现的 SubmitReading 与 GradeReading，避免编译错误 + +// GetUserReadingStats 获取用户阅读统计 +func (h *ReadingHandler) GetUserReadingStats(c *gin.Context) { + userID := c.GetString("user_id") + + stats, err := h.readingService.GetUserReadingStats(userID) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"stats": stats}) +} + +// GetReadingProgress 获取阅读进度 +func (h *ReadingHandler) GetReadingProgress(c *gin.Context) { + userID := c.GetString("user_id") + materialID := c.Param("material_id") + + progress, err := h.readingService.GetReadingProgress(userID, materialID) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Reading progress not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"progress": progress}) +} \ No newline at end of file diff --git a/serve/internal/handler/speaking_handler.go b/serve/internal/handler/speaking_handler.go new file mode 100644 index 0000000..ee58683 --- /dev/null +++ b/serve/internal/handler/speaking_handler.go @@ -0,0 +1,276 @@ +package handler + +import ( + "net/http" + "strconv" + + "github.com/gin-gonic/gin" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" +) + +type SpeakingHandler struct { + speakingService *services.SpeakingService +} + +func NewSpeakingHandler(speakingService *services.SpeakingService) *SpeakingHandler { + return &SpeakingHandler{speakingService: speakingService} +} + +// GetSpeakingScenarios 获取口语场景列表 +func (h *SpeakingHandler) GetSpeakingScenarios(c *gin.Context) { + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + scenarios, total, err := h.speakingService.GetSpeakingScenarios(level, category, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"scenarios": scenarios, "total": total}) +} + +// GetSpeakingScenario 获取单个口语场景 +func (h *SpeakingHandler) GetSpeakingScenario(c *gin.Context) { + id := c.Param("id") + + scenario, err := h.speakingService.GetSpeakingScenario(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Speaking scenario not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"scenario": scenario}) +} + +// CreateSpeakingScenario 创建口语场景 +func (h *SpeakingHandler) CreateSpeakingScenario(c *gin.Context) { + var scenario models.SpeakingScenario + if err := c.ShouldBindJSON(&scenario); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.speakingService.CreateSpeakingScenario(&scenario); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusCreated, gin.H{"scenario": scenario}) +} + +// UpdateSpeakingScenario 更新口语场景 +func (h *SpeakingHandler) UpdateSpeakingScenario(c *gin.Context) { + id := c.Param("id") + + var updates models.SpeakingScenario + if err := c.ShouldBindJSON(&updates); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.speakingService.UpdateSpeakingScenario(id, &updates); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + scenario, err := h.speakingService.GetSpeakingScenario(id) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"scenario": scenario}) +} + +// DeleteSpeakingScenario 删除口语场景 +func (h *SpeakingHandler) DeleteSpeakingScenario(c *gin.Context) { + id := c.Param("id") + + if err := h.speakingService.DeleteSpeakingScenario(id); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"message": "Speaking scenario deleted successfully"}) +} + +// SearchSpeakingScenarios 搜索口语场景 +func (h *SpeakingHandler) SearchSpeakingScenarios(c *gin.Context) { + keyword := c.Query("keyword") + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + scenarios, total, err := h.speakingService.SearchSpeakingScenarios(keyword, level, category, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"scenarios": scenarios, "total": total}) +} + +// GetRecommendedScenarios 获取推荐口语场景 +func (h *SpeakingHandler) GetRecommendedScenarios(c *gin.Context) { + userID := c.GetString("user_id") + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "5")) + + scenarios, err := h.speakingService.GetRecommendedScenarios(userID, limit) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"scenarios": scenarios}) +} + +// CreateSpeakingRecord 创建口语记录 +func (h *SpeakingHandler) CreateSpeakingRecord(c *gin.Context) { + var record models.SpeakingRecord + if err := c.ShouldBindJSON(&record); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + record.UserID = c.GetString("user_id") + if err := h.speakingService.CreateSpeakingRecord(&record); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusCreated, gin.H{"record": record}) +} + +// UpdateSpeakingRecord 更新口语记录 +func (h *SpeakingHandler) UpdateSpeakingRecord(c *gin.Context) { + id := c.Param("id") + + var updates models.SpeakingRecord + if err := c.ShouldBindJSON(&updates); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + if err := h.speakingService.UpdateSpeakingRecord(id, &updates); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + record, err := h.speakingService.GetSpeakingRecord(id) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"record": record}) +} + +// GetSpeakingRecord 获取口语记录详情 +func (h *SpeakingHandler) GetSpeakingRecord(c *gin.Context) { + id := c.Param("id") + + record, err := h.speakingService.GetSpeakingRecord(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Speaking record not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"record": record}) +} + +// GetUserSpeakingRecords 获取用户口语记录列表 +func (h *SpeakingHandler) GetUserSpeakingRecords(c *gin.Context) { + userID := c.GetString("user_id") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + records, total, err := h.speakingService.GetUserSpeakingRecords(userID, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{ + "records": records, + "total": total, + }) +} + +// SubmitSpeaking 提交口语练习 +func (h *SpeakingHandler) SubmitSpeaking(c *gin.Context) { + id := c.Param("id") + + var req struct { + AudioURL string `json:"audio_url"` + Transcript string `json:"transcript"` + } + + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.speakingService.SubmitSpeaking(id, req.AudioURL, req.Transcript); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"message": "Speaking submitted successfully"}) +} + +// GradeSpeaking AI评分口语练习 +func (h *SpeakingHandler) GradeSpeaking(c *gin.Context) { + id := c.Param("id") + + var req struct { + Pronunciation float64 `json:"pronunciation"` + Fluency float64 `json:"fluency"` + Accuracy float64 `json:"accuracy"` + Score float64 `json:"score"` + Feedback string `json:"feedback"` + Suggestions string `json:"suggestions"` + } + + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.speakingService.GradeSpeaking(id, req.Pronunciation, req.Fluency, req.Accuracy, req.Score, req.Feedback, req.Suggestions); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"message": "Speaking graded successfully"}) +} + +// GetUserSpeakingStats 获取用户口语统计 +func (h *SpeakingHandler) GetUserSpeakingStats(c *gin.Context) { + userID := c.GetString("user_id") + + stats, err := h.speakingService.GetUserSpeakingStats(userID) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"stats": stats}) +} + +// GetSpeakingProgress 获取口语进度 +func (h *SpeakingHandler) GetSpeakingProgress(c *gin.Context) { + userID := c.GetString("user_id") + scenarioID := c.Param("scenario_id") + + progress, err := h.speakingService.GetSpeakingProgress(userID, scenarioID) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Speaking progress not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"progress": progress}) +} \ No newline at end of file diff --git a/serve/internal/handler/study_plan_handler.go b/serve/internal/handler/study_plan_handler.go new file mode 100644 index 0000000..574ce4c --- /dev/null +++ b/serve/internal/handler/study_plan_handler.go @@ -0,0 +1,270 @@ +package handler + +import ( + "strconv" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/gin-gonic/gin" +) + +// StudyPlanHandler 学习计划处理器 +type StudyPlanHandler struct { + studyPlanService *services.StudyPlanService +} + +func NewStudyPlanHandler(studyPlanService *services.StudyPlanService) *StudyPlanHandler { + return &StudyPlanHandler{studyPlanService: studyPlanService} +} + +// CreateStudyPlan 创建学习计划 +// POST /api/v1/study-plans +func (h *StudyPlanHandler) CreateStudyPlan(c *gin.Context) { + userID := c.GetInt64("user_id") + + var req struct { + PlanName string `json:"plan_name" binding:"required,min=1,max=200"` + Description *string `json:"description"` + DailyGoal int `json:"daily_goal" binding:"required,min=1,max=200"` + BookID *string `json:"book_id"` + StartDate string `json:"start_date" binding:"required"` // YYYY-MM-DD + EndDate *string `json:"end_date"` // YYYY-MM-DD + RemindTime *string `json:"remind_time"` // HH:mm + RemindDays *string `json:"remind_days"` // "1,2,3,4,5" 表示周一到周五 + } + + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, 400, "参数错误: "+err.Error()) + return + } + + // 解析日期 + startDate, err := time.Parse("2006-01-02", req.StartDate) + if err != nil { + common.ErrorResponse(c, 400, "开始日期格式错误") + return + } + + var endDate *time.Time + if req.EndDate != nil { + parsedEndDate, err := time.Parse("2006-01-02", *req.EndDate) + if err != nil { + common.ErrorResponse(c, 400, "结束日期格式错误") + return + } + endDate = &parsedEndDate + } + + plan, err := h.studyPlanService.CreateStudyPlan( + userID, + req.PlanName, + req.Description, + req.DailyGoal, + req.BookID, + startDate, + endDate, + req.RemindTime, + req.RemindDays, + ) + + if err != nil { + common.ErrorResponse(c, 500, "创建学习计划失败: "+err.Error()) + return + } + + common.SuccessResponse(c, plan) +} + +// GetUserStudyPlans 获取用户的学习计划列表 +// GET /api/v1/study-plans +func (h *StudyPlanHandler) GetUserStudyPlans(c *gin.Context) { + userID := c.GetInt64("user_id") + status := c.DefaultQuery("status", "all") // all, active, paused, completed, cancelled + + plans, err := h.studyPlanService.GetUserStudyPlans(userID, status) + if err != nil { + common.ErrorResponse(c, 500, "获取学习计划失败: "+err.Error()) + return + } + + common.SuccessResponse(c, gin.H{ + "plans": plans, + "total": len(plans), + }) +} + +// GetStudyPlanByID 获取学习计划详情 +// GET /api/v1/study-plans/:id +func (h *StudyPlanHandler) GetStudyPlanByID(c *gin.Context) { + userID := c.GetInt64("user_id") + planIDStr := c.Param("id") + + planID, err := strconv.ParseInt(planIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的计划ID") + return + } + + plan, err := h.studyPlanService.GetStudyPlanByID(planID, userID) + if err != nil { + common.ErrorResponse(c, 404, "学习计划不存在") + return + } + + common.SuccessResponse(c, plan) +} + +// UpdateStudyPlan 更新学习计划 +// PUT /api/v1/study-plans/:id +func (h *StudyPlanHandler) UpdateStudyPlan(c *gin.Context) { + userID := c.GetInt64("user_id") + planIDStr := c.Param("id") + + planID, err := strconv.ParseInt(planIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的计划ID") + return + } + + var updates map[string]interface{} + if err := c.ShouldBindJSON(&updates); err != nil { + common.ErrorResponse(c, 400, "参数错误: "+err.Error()) + return + } + + plan, err := h.studyPlanService.UpdateStudyPlan(planID, userID, updates) + if err != nil { + common.ErrorResponse(c, 500, "更新学习计划失败: "+err.Error()) + return + } + + common.SuccessResponse(c, plan) +} + +// DeleteStudyPlan 删除学习计划 +// DELETE /api/v1/study-plans/:id +func (h *StudyPlanHandler) DeleteStudyPlan(c *gin.Context) { + userID := c.GetInt64("user_id") + planIDStr := c.Param("id") + + planID, err := strconv.ParseInt(planIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的计划ID") + return + } + + err = h.studyPlanService.DeleteStudyPlan(planID, userID) + if err != nil { + common.ErrorResponse(c, 500, "删除学习计划失败: "+err.Error()) + return + } + + common.SuccessResponse(c, gin.H{ + "message": "学习计划已删除", + }) +} + +// UpdatePlanStatus 更新计划状态 +// PATCH /api/v1/study-plans/:id/status +func (h *StudyPlanHandler) UpdatePlanStatus(c *gin.Context) { + userID := c.GetInt64("user_id") + planIDStr := c.Param("id") + + planID, err := strconv.ParseInt(planIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的计划ID") + return + } + + var req struct { + Status string `json:"status" binding:"required,oneof=active paused completed cancelled"` + } + + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, 400, "参数错误: "+err.Error()) + return + } + + err = h.studyPlanService.UpdatePlanStatus(planID, userID, req.Status) + if err != nil { + common.ErrorResponse(c, 500, "更新状态失败: "+err.Error()) + return + } + + common.SuccessResponse(c, gin.H{ + "message": "状态更新成功", + "status": req.Status, + }) +} + +// RecordStudyProgress 记录学习进度 +// POST /api/v1/study-plans/:id/progress +func (h *StudyPlanHandler) RecordStudyProgress(c *gin.Context) { + userID := c.GetInt64("user_id") + planIDStr := c.Param("id") + + planID, err := strconv.ParseInt(planIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的计划ID") + return + } + + var req struct { + WordsStudied int `json:"words_studied" binding:"required,min=1"` + StudyDuration int `json:"study_duration"` // 学习时长(分钟) + } + + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, 400, "参数错误: "+err.Error()) + return + } + + err = h.studyPlanService.RecordStudyProgress(planID, userID, req.WordsStudied, req.StudyDuration) + if err != nil { + common.ErrorResponse(c, 500, "记录进度失败: "+err.Error()) + return + } + + common.SuccessResponse(c, gin.H{ + "message": "进度记录成功", + }) +} + +// GetStudyPlanStatistics 获取学习计划统计 +// GET /api/v1/study-plans/:id/statistics +func (h *StudyPlanHandler) GetStudyPlanStatistics(c *gin.Context) { + userID := c.GetInt64("user_id") + planIDStr := c.Param("id") + + planID, err := strconv.ParseInt(planIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的计划ID") + return + } + + stats, err := h.studyPlanService.GetStudyPlanStatistics(planID, userID) + if err != nil { + common.ErrorResponse(c, 500, "获取统计信息失败: "+err.Error()) + return + } + + common.SuccessResponse(c, stats) +} + +// GetTodayStudyPlans 获取今日需要执行的学习计划 +// GET /api/v1/study-plans/today +func (h *StudyPlanHandler) GetTodayStudyPlans(c *gin.Context) { + userID := c.GetInt64("user_id") + + plans, err := h.studyPlanService.GetTodayStudyPlans(userID) + if err != nil { + common.ErrorResponse(c, 500, "获取今日计划失败: "+err.Error()) + return + } + + common.SuccessResponse(c, gin.H{ + "plans": plans, + "total": len(plans), + }) +} diff --git a/serve/internal/handler/upload_handler.go b/serve/internal/handler/upload_handler.go new file mode 100644 index 0000000..191ea23 --- /dev/null +++ b/serve/internal/handler/upload_handler.go @@ -0,0 +1,222 @@ +package handler + +import ( + "net/http" + "path/filepath" + "strconv" + "strings" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/service" + "github.com/gin-gonic/gin" +) + +// UploadHandler 文件上传处理器 +type UploadHandler struct { + uploadService service.UploadService +} + +// NewUploadHandler 创建文件上传处理器 +func NewUploadHandler() *UploadHandler { + uploadService := service.NewUploadService("./uploads", "http://localhost:8080") + return &UploadHandler{ + uploadService: uploadService, + } +} + +// UploadAudio 上传音频文件 +func (h *UploadHandler) UploadAudio(c *gin.Context) { + // 获取上传的文件 + file, err := c.FormFile("audio") + if err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "获取文件失败", + "details": err.Error(), + }) + return + } + + // 验证文件类型 + ext := strings.ToLower(filepath.Ext(file.Filename)) + allowedTypes := []string{".mp3", ".wav", ".m4a", ".aac"} + isValidType := false + for _, allowedType := range allowedTypes { + if ext == allowedType { + isValidType = true + break + } + } + + if !isValidType { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "不支持的文件类型", + "details": "只支持 mp3, wav, m4a, aac 格式", + }) + return + } + + // 验证文件大小 (最大10MB) + maxSize := int64(10 * 1024 * 1024) + if file.Size > maxSize { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "文件过大", + "details": "文件大小不能超过10MB", + }) + return + } + + // 使用上传服务保存文件 + result, err := h.uploadService.UploadAudio(file) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "文件上传失败", + "details": err.Error(), + }) + return + } + + // 返回上传结果 + c.JSON(http.StatusOK, gin.H{ + "message": "音频文件上传成功", + "data": result, + }) +} + +// UploadImage 上传图片文件 +func (h *UploadHandler) UploadImage(c *gin.Context) { + // 获取上传的文件 + file, err := c.FormFile("image") + if err != nil { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "获取文件失败", + "details": err.Error(), + }) + return + } + + // 验证文件类型 + ext := strings.ToLower(filepath.Ext(file.Filename)) + allowedTypes := []string{".jpg", ".jpeg", ".png", ".gif", ".webp"} + isValidType := false + for _, allowedType := range allowedTypes { + if ext == allowedType { + isValidType = true + break + } + } + + if !isValidType { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "不支持的文件类型", + "details": "只支持 jpg, jpeg, png, gif, webp 格式", + }) + return + } + + // 验证文件大小 (最大5MB) + maxSize := int64(5 * 1024 * 1024) + if file.Size > maxSize { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "文件过大", + "details": "文件大小不能超过5MB", + }) + return + } + + // 使用上传服务保存文件 + result, err := h.uploadService.UploadImage(file) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{ + "error": "文件上传失败", + "details": err.Error(), + }) + return + } + + // 返回上传结果 + c.JSON(http.StatusOK, gin.H{ + "message": "图片文件上传成功", + "data": result, + }) +} + +// DeleteFile 删除文件 +func (h *UploadHandler) DeleteFile(c *gin.Context) { + fileID := c.Param("file_id") + if fileID == "" { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "File ID is required", + }) + return + } + + // TODO: 实现实际的文件删除逻辑 + // 目前返回模拟响应 + c.JSON(http.StatusOK, gin.H{ + "message": "File deleted successfully", + "data": gin.H{ + "file_id": fileID, + "deleted": true, + }, + }) +} + +// GetFileInfo 获取文件信息 +func (h *UploadHandler) GetFileInfo(c *gin.Context) { + fileID := c.Param("file_id") + if fileID == "" { + c.JSON(http.StatusBadRequest, gin.H{ + "error": "File ID is required", + }) + return + } + + // TODO: 实现实际的文件信息查询逻辑 + // 目前返回模拟数据 + result := gin.H{ + "file_id": fileID, + "filename": "example.mp3", + "size": 1024000, + "url": "/uploads/audio/" + fileID + ".mp3", + "type": "audio", + "format": "mp3", + "upload_at": "2024-01-15T10:30:00Z", + } + + c.JSON(http.StatusOK, gin.H{ + "message": "File information retrieved", + "data": result, + }) +} + +// GetUploadStats 获取上传统计 +func (h *UploadHandler) GetUploadStats(c *gin.Context) { + // 获取查询参数 + days := c.DefaultQuery("days", "30") + daysInt, err := strconv.Atoi(days) + if err != nil || daysInt <= 0 { + daysInt = 30 + } + + // TODO: 实现实际的统计查询逻辑 + // 目前返回模拟数据 + stats := gin.H{ + "period_days": daysInt, + "total_files": 156, + "audio_files": 89, + "image_files": 67, + "total_size": "245.6MB", + "average_size": "1.6MB", + "upload_trend": []gin.H{ + {"date": "2024-01-10", "count": 12}, + {"date": "2024-01-11", "count": 8}, + {"date": "2024-01-12", "count": 15}, + {"date": "2024-01-13", "count": 10}, + {"date": "2024-01-14", "count": 18}, + }, + } + + c.JSON(http.StatusOK, gin.H{ + "message": "Upload statistics", + "data": stats, + }) +} \ No newline at end of file diff --git a/serve/internal/handler/user_handler.go b/serve/internal/handler/user_handler.go new file mode 100644 index 0000000..c777868 --- /dev/null +++ b/serve/internal/handler/user_handler.go @@ -0,0 +1,88 @@ +package handler + +import ( + "net/http" + "encoding/json" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/service" +) + +type UserHandler struct { + userService *service.UserService +} + +func NewUserHandler(userService *service.UserService) *UserHandler { + return &UserHandler{userService: userService} +} + +// 用户注册 +func (h *UserHandler) Register(w http.ResponseWriter, r *http.Request) { + var req struct { + Username string `json:"username"` + Email string `json:"email"` + Password string `json:"password"` + } + if err := json.NewDecoder(r.Body).Decode(&req); err != nil { + w.WriteHeader(http.StatusBadRequest) + json.NewEncoder(w).Encode(map[string]string{"message": "参数错误"}) + return + } + userID, err := h.userService.Register(req.Username, req.Email, req.Password) + if err != nil { + w.WriteHeader(http.StatusInternalServerError) + json.NewEncoder(w).Encode(map[string]string{"message": err.Error()}) + return + } + json.NewEncoder(w).Encode(map[string]interface{}{"userID": userID, "message": "注册成功"}) +} + +// 用户登录 +func (h *UserHandler) Login(w http.ResponseWriter, r *http.Request) { + var req struct { + Email string `json:"email"` + Password string `json:"password"` + } + if err := json.NewDecoder(r.Body).Decode(&req); err != nil { + w.WriteHeader(http.StatusBadRequest) + json.NewEncoder(w).Encode(map[string]string{"message": "参数错误"}) + return + } + token, userID, err := h.userService.Login(req.Email, req.Password) + if err != nil { + w.WriteHeader(http.StatusUnauthorized) + json.NewEncoder(w).Encode(map[string]string{"message": err.Error()}) + return + } + json.NewEncoder(w).Encode(map[string]interface{}{"token": token, "userID": userID, "message": "登录成功"}) +} + +// 获取用户信息 +func (h *UserHandler) GetProfile(w http.ResponseWriter, r *http.Request) { + userID := r.Context().Value("userID").(string) + profile, err := h.userService.GetProfile(userID) + if err != nil { + w.WriteHeader(http.StatusNotFound) + json.NewEncoder(w).Encode(map[string]string{"message": err.Error()}) + return + } + json.NewEncoder(w).Encode(profile) +} + +// 更新用户信息 +func (h *UserHandler) UpdateProfile(w http.ResponseWriter, r *http.Request) { + userID := r.Context().Value("userID").(string) + var req struct { + Username string `json:"username"` + Avatar string `json:"avatar"` + } + if err := json.NewDecoder(r.Body).Decode(&req); err != nil { + w.WriteHeader(http.StatusBadRequest) + json.NewEncoder(w).Encode(map[string]string{"message": "参数错误"}) + return + } + if err := h.userService.UpdateProfile(userID, req.Username, req.Avatar); err != nil { + w.WriteHeader(http.StatusInternalServerError) + json.NewEncoder(w).Encode(map[string]string{"message": err.Error()}) + return + } + json.NewEncoder(w).Encode(map[string]string{"message": "更新成功"}) +} \ No newline at end of file diff --git a/serve/internal/handler/vocabulary_handler.go b/serve/internal/handler/vocabulary_handler.go new file mode 100644 index 0000000..ad8106f --- /dev/null +++ b/serve/internal/handler/vocabulary_handler.go @@ -0,0 +1,533 @@ +package handler + +import ( + "log" + "net/http" + "strconv" + "time" + + "github.com/gin-gonic/gin" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" +) + +type VocabularyHandler struct { + vocabularyService *services.VocabularyService +} + +func NewVocabularyHandler(vocabularyService *services.VocabularyService) *VocabularyHandler { + return &VocabularyHandler{vocabularyService: vocabularyService} +} + +// GetCategories 获取词汇分类列表 +func (h *VocabularyHandler) GetCategories(c *gin.Context) { + level := c.Query("level") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + categories, err := h.vocabularyService.GetCategories(page, pageSize, level) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"categories": categories}) +} + +// CreateCategory 创建词汇分类 +func (h *VocabularyHandler) CreateCategory(c *gin.Context) { + var category models.VocabularyCategory + if err := c.ShouldBindJSON(&category); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + // 将模型转换为服务所需参数 + desc := "" + if category.Description != nil { + desc = *category.Description + } + + createdCategory, err := h.vocabularyService.CreateCategory(category.Name, desc, category.Level) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusCreated, gin.H{"category": createdCategory}) +} + +// GetVocabulariesByCategory 根据分类获取词汇列表 +func (h *VocabularyHandler) GetVocabulariesByCategory(c *gin.Context) { + categoryID := c.Param("id") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + level := c.Query("level") + + vocabularies, err := h.vocabularyService.GetVocabulariesByCategory(categoryID, page, pageSize, level) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"vocabularies": vocabularies}) +} + +// GetVocabularyByID 获取词汇详情 +func (h *VocabularyHandler) GetVocabularyByID(c *gin.Context) { + vocabularyID := c.Param("id") + + vocabulary, err := h.vocabularyService.GetVocabularyByID(vocabularyID) + if err != nil { + if common.IsBusinessError(err) { + c.JSON(http.StatusNotFound, gin.H{"error": err.Error()}) + } else { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + } + return + } + + c.JSON(http.StatusOK, gin.H{"vocabulary": vocabulary}) +} + +// SearchVocabularies 搜索词汇 +func (h *VocabularyHandler) SearchVocabularies(c *gin.Context) { + keyword := c.Query("keyword") + level := c.Query("level") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + vocabularies, err := h.vocabularyService.SearchVocabularies(keyword, level, page, pageSize) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"vocabularies": vocabularies}) +} + +// GetUserVocabularyProgress 获取用户词汇学习进度 +func (h *VocabularyHandler) GetUserVocabularyProgress(c *gin.Context) { + userID := c.GetInt64("user_id") + vocabularyID := c.Param("id") + + progress, err := h.vocabularyService.GetUserVocabularyProgress(userID, vocabularyID) + if err != nil { + if common.IsBusinessError(err) { + c.JSON(http.StatusNotFound, gin.H{"error": err.Error()}) + } else { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + } + return + } + + c.JSON(http.StatusOK, gin.H{"progress": progress}) +} + +// UpdateUserVocabularyProgress 更新用户词汇学习进度 +func (h *VocabularyHandler) UpdateUserVocabularyProgress(c *gin.Context) { + userID := c.GetInt64("user_id") + vocabularyID := c.Param("id") + + var updates map[string]interface{} + if err := c.ShouldBindJSON(&updates); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + progress, err := h.vocabularyService.UpdateUserVocabularyProgress(userID, vocabularyID, updates) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"progress": progress}) +} + +// GetUserVocabularyStats 获取用户词汇学习统计 +func (h *VocabularyHandler) GetUserVocabularyStats(c *gin.Context) { + userID := c.GetInt64("user_id") + + stats, err := h.vocabularyService.GetUserVocabularyStats(userID) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"stats": stats}) +} + +// UpdateCategory 更新词汇分类 +func (h *VocabularyHandler) UpdateCategory(c *gin.Context) { + categoryID := c.Param("id") + if categoryID == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "分类ID不能为空"}) + return + } + + var updates map[string]interface{} + if err := c.ShouldBindJSON(&updates); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + category, err := h.vocabularyService.UpdateCategory(categoryID, updates) + if err != nil { + if common.IsBusinessError(err) { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + } else { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + } + return + } + + c.JSON(http.StatusOK, gin.H{"category": category}) +} + +// DeleteCategory 删除词汇分类 +func (h *VocabularyHandler) DeleteCategory(c *gin.Context) { + categoryID := c.Param("id") + if categoryID == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "分类ID不能为空"}) + return + } + + if err := h.vocabularyService.DeleteCategory(categoryID); err != nil { + if common.IsBusinessError(err) { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + } else { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + } + return + } + + c.JSON(http.StatusOK, gin.H{"message": "分类已删除"}) +} + +// CreateVocabulary 创建词汇 +func (h *VocabularyHandler) CreateVocabulary(c *gin.Context) { + type reqBody struct { + Word string `json:"word"` + Phonetic string `json:"phonetic"` + Level string `json:"level"` + Frequency int `json:"frequency"` + CategoryID string `json:"category_id"` + Definitions []string `json:"definitions"` + Examples []string `json:"examples"` + Images []string `json:"images"` + } + + var req reqBody + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + vocab, err := h.vocabularyService.CreateVocabulary( + req.Word, req.Phonetic, req.Level, req.Frequency, req.CategoryID, + req.Definitions, req.Examples, req.Images, + ) + if err != nil { + if common.IsBusinessError(err) { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + } else { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + } + return + } + + c.JSON(http.StatusCreated, gin.H{"vocabulary": vocab}) +} + +// GetDailyVocabularyStats 获取每日学习单词统计 +func (h *VocabularyHandler) GetDailyVocabularyStats(c *gin.Context) { + userID := c.GetInt64("user_id") + userIDStr := strconv.FormatInt(userID, 10) + + stats, err := h.vocabularyService.GetDailyStats(userIDStr) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"stats": stats}) +} + +// CreateVocabularyTest 创建词汇测试 +func (h *VocabularyHandler) CreateVocabularyTest(c *gin.Context) { + type reqBody struct { + TestType string `json:"test_type"` + Level string `json:"level"` + TotalWords int `json:"total_words"` + } + var req reqBody + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + userID := c.GetInt64("user_id") + + test, err := h.vocabularyService.CreateVocabularyTest(userID, req.TestType, req.Level, req.TotalWords) + if err != nil { + if common.IsBusinessError(err) { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + } else { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + } + return + } + + c.JSON(http.StatusCreated, gin.H{"test": test}) +} + +// GetVocabularyTest 获取词汇测试 +func (h *VocabularyHandler) GetVocabularyTest(c *gin.Context) { + testID := c.Param("id") + if testID == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "测试ID不能为空"}) + return + } + + test, err := h.vocabularyService.GetVocabularyTest(testID) + if err != nil { + if common.IsBusinessError(err) { + c.JSON(http.StatusNotFound, gin.H{"error": err.Error()}) + } else { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + } + return + } + + c.JSON(http.StatusOK, gin.H{"test": test}) +} + +// UpdateVocabularyTestResult 更新词汇测试结果 +func (h *VocabularyHandler) UpdateVocabularyTestResult(c *gin.Context) { + testID := c.Param("id") + if testID == "" { + c.JSON(http.StatusBadRequest, gin.H{"error": "测试ID不能为空"}) + return + } + + type reqBody struct { + CorrectWords int `json:"correct_words"` + Score float64 `json:"score"` + Duration int `json:"duration"` + } + var req reqBody + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.vocabularyService.UpdateVocabularyTestResult(testID, req.CorrectWords, req.Score, req.Duration); err != nil { + if common.IsBusinessError(err) { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + } else { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + } + return + } + + c.JSON(http.StatusOK, gin.H{"message": "测试结果更新成功"}) +} + +// GetTodayStudyWords 获取今日学习单词 +func (h *VocabularyHandler) GetTodayStudyWords(c *gin.Context) { + userID := c.GetInt64("user_id") + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "20")) + + words, err := h.vocabularyService.GetTodayStudyWords(userID, limit) + if err != nil { + common.ErrorResponse(c, 500, "获取今日单词失败") + return + } + + // 确保返回空数组而不是null + if words == nil { + words = []map[string]interface{}{} + } + + common.SuccessResponse(c, gin.H{"words": words}) +} + +// GetStudyStatistics 获取学习统计 +func (h *VocabularyHandler) GetStudyStatistics(c *gin.Context) { + userID := c.GetInt64("user_id") + date := c.Query("date") + + stats, err := h.vocabularyService.GetStudyStatistics(userID, date) + if err != nil { + common.ErrorResponse(c, 500, "获取学习统计失败") + return + } + + common.SuccessResponse(c, stats) +} + +// GetStudyStatisticsHistory 获取学习统计历史 +func (h *VocabularyHandler) GetStudyStatisticsHistory(c *gin.Context) { + userID := c.GetInt64("user_id") + startDate := c.Query("startDate") + endDate := c.Query("endDate") + + history, err := h.vocabularyService.GetStudyStatisticsHistory(userID, startDate, endDate) + if err != nil { + log.Printf("[ERROR] GetStudyStatisticsHistory failed: userID=%d, startDate=%s, endDate=%s, error=%v", userID, startDate, endDate, err) + common.ErrorResponse(c, 500, "获取学习历史失败") + return + } + + common.SuccessResponse(c, history) +} + +// GetSystemVocabularyBooks 获取系统词汇书列表 +func (h *VocabularyHandler) GetSystemVocabularyBooks(c *gin.Context) { + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "20")) + category := c.Query("category") + + books, total, err := h.vocabularyService.GetSystemVocabularyBooks(page, limit, category) + if err != nil { + common.ErrorResponse(c, 500, "获取系统词汇书失败") + return + } + + totalPages := (int(total) + limit - 1) / limit + pagination := &common.Pagination{ + Page: page, + PageSize: limit, + Total: int(total), + TotalPages: totalPages, + } + common.PaginationSuccessResponse(c, books, pagination) +} + +// GetVocabularyBookCategories 获取词汇书分类列表 +func (h *VocabularyHandler) GetVocabularyBookCategories(c *gin.Context) { + categories, err := h.vocabularyService.GetVocabularyBookCategories() + if err != nil { + common.ErrorResponse(c, 500, "获取词汇书分类失败") + return + } + + common.SuccessResponse(c, categories) +} + +// GetVocabularyBookProgress 获取词汇书学习进度 +func (h *VocabularyHandler) GetVocabularyBookProgress(c *gin.Context) { + bookID := c.Param("id") + if bookID == "" { + common.ErrorResponse(c, 400, "词汇书ID不能为空") + return + } + + userID := c.GetInt64("user_id") + + progress, err := h.vocabularyService.GetVocabularyBookProgress(userID, bookID) + if err != nil { + // 如果没有进度记录，返回默认进度 + now := time.Now() + defaultProgress := &models.UserVocabularyBookProgress{ + ID: 0, + UserID: userID, + BookID: bookID, + LearnedWords: 0, + MasteredWords: 0, + ProgressPercentage: 0.0, + StreakDays: 0, + TotalStudyDays: 0, + AverageDailyWords: 0.0, + EstimatedCompletionDate: nil, + IsCompleted: false, + CompletedAt: nil, + StartedAt: now, + LastStudiedAt: now, + } + common.SuccessResponse(c, defaultProgress) + return + } + + common.SuccessResponse(c, progress) +} + +// GetVocabularyBookWords 获取词汇书单词列表 +func (h *VocabularyHandler) GetVocabularyBookWords(c *gin.Context) { + bookID := c.Param("id") + if bookID == "" { + common.ErrorResponse(c, 400, "词汇书ID不能为空") + return + } + + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "100")) + + words, total, err := h.vocabularyService.GetVocabularyBookWords(bookID, page, limit) + if err != nil { + common.ErrorResponse(c, 500, "获取词汇书单词失败") + return + } + + totalPages := (int(total) + limit - 1) / limit + pagination := &common.Pagination{ + Page: page, + PageSize: limit, + Total: int(total), + TotalPages: totalPages, + } + common.PaginationSuccessResponse(c, words, pagination) +} + +// GetUserWordProgress 获取用户单词学习进度 +func (h *VocabularyHandler) GetUserWordProgress(c *gin.Context) { + userID := c.GetInt64("user_id") + wordIDStr := c.Param("id") + + wordID, err := strconv.ParseInt(wordIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的单词ID") + return + } + + // 查询用户单词进度 + progress, err := h.vocabularyService.GetUserWordProgress(userID, wordID) + if err != nil { + common.ErrorResponse(c, 500, "获取单词进度失败") + return + } + + common.SuccessResponse(c, progress) +} + +// UpdateUserWordProgress 更新用户单词学习进度 +func (h *VocabularyHandler) UpdateUserWordProgress(c *gin.Context) { + userID := c.GetInt64("user_id") + wordIDStr := c.Param("id") + + wordID, err := strconv.ParseInt(wordIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的单词ID") + return + } + + var req struct { + Status string `json:"status"` + IsCorrect *bool `json:"isCorrect"` + } + + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, 400, "无效的请求参数") + return + } + + // 更新单词进度 + progress, err := h.vocabularyService.UpdateUserWordProgress(userID, wordID, req.Status, req.IsCorrect) + if err != nil { + common.ErrorResponse(c, 500, "更新单词进度失败") + return + } + + common.SuccessResponse(c, progress) +} \ No newline at end of file diff --git a/serve/internal/handler/word_book_handler.go b/serve/internal/handler/word_book_handler.go new file mode 100644 index 0000000..5c29631 --- /dev/null +++ b/serve/internal/handler/word_book_handler.go @@ -0,0 +1,152 @@ +package handler + +import ( + "strconv" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/gin-gonic/gin" +) + +// WordBookHandler 生词本处理器 +type WordBookHandler struct { + wordBookService *services.WordBookService +} + +func NewWordBookHandler(wordBookService *services.WordBookService) *WordBookHandler { + return &WordBookHandler{wordBookService: wordBookService} +} + +// ToggleFavorite 切换单词收藏状态 +// POST /api/v1/word-book/toggle/:id +func (h *WordBookHandler) ToggleFavorite(c *gin.Context) { + userID := c.GetInt64("user_id") + wordIDStr := c.Param("id") + + wordID, err := strconv.ParseInt(wordIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的单词ID") + return + } + + isFavorite, err := h.wordBookService.ToggleFavorite(userID, wordID) + if err != nil { + common.ErrorResponse(c, 500, "操作失败: "+err.Error()) + return + } + + common.SuccessResponse(c, gin.H{ + "is_favorite": isFavorite, + "message": func() string { + if isFavorite { + return "已添加到生词本" + } + return "已从生词本移除" + }(), + }) +} + +// GetFavoriteWords 获取生词本列表 +// GET /api/v1/word-book +func (h *WordBookHandler) GetFavoriteWords(c *gin.Context) { + userID := c.GetInt64("user_id") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20")) + sortBy := c.DefaultQuery("sort_by", "created_at") // created_at, proficiency, word + order := c.DefaultQuery("order", "desc") // asc, desc + + words, total, err := h.wordBookService.GetFavoriteWords(userID, page, pageSize, sortBy, order) + if err != nil { + common.ErrorResponse(c, 500, "获取生词本失败: "+err.Error()) + return + } + + common.SuccessResponse(c, gin.H{ + "words": words, + "total": total, + "page": page, + "page_size": pageSize, + "total_pages": (total + int64(pageSize) - 1) / int64(pageSize), + }) +} + +// GetFavoriteWordsByBook 获取指定词汇书的生词本 +// GET /api/v1/word-book/books/:id +func (h *WordBookHandler) GetFavoriteWordsByBook(c *gin.Context) { + userID := c.GetInt64("user_id") + bookID := c.Param("id") + + words, err := h.wordBookService.GetFavoriteWordsByBook(userID, bookID) + if err != nil { + common.ErrorResponse(c, 500, "获取生词本失败: "+err.Error()) + return + } + + common.SuccessResponse(c, gin.H{ + "words": words, + "total": len(words), + }) +} + +// GetFavoriteStats 获取生词本统计信息 +// GET /api/v1/word-book/stats +func (h *WordBookHandler) GetFavoriteStats(c *gin.Context) { + userID := c.GetInt64("user_id") + + stats, err := h.wordBookService.GetFavoriteStats(userID) + if err != nil { + common.ErrorResponse(c, 500, "获取统计信息失败: "+err.Error()) + return + } + + common.SuccessResponse(c, stats) +} + +// BatchAddToFavorite 批量添加到生词本 +// POST /api/v1/word-book/batch +func (h *WordBookHandler) BatchAddToFavorite(c *gin.Context) { + userID := c.GetInt64("user_id") + + var req struct { + WordIDs []int64 `json:"word_ids" binding:"required,min=1"` + } + + if err := c.ShouldBindJSON(&req); err != nil { + common.ErrorResponse(c, 400, "参数错误: "+err.Error()) + return + } + + count, err := h.wordBookService.BatchAddToFavorite(userID, req.WordIDs) + if err != nil { + common.ErrorResponse(c, 500, "批量添加失败: "+err.Error()) + return + } + + common.SuccessResponse(c, gin.H{ + "added_count": count, + "message": "批量添加成功", + }) +} + +// RemoveFromFavorite 从生词本移除单词 +// DELETE /api/v1/word-book/:id +func (h *WordBookHandler) RemoveFromFavorite(c *gin.Context) { + userID := c.GetInt64("user_id") + wordIDStr := c.Param("id") + + wordID, err := strconv.ParseInt(wordIDStr, 10, 64) + if err != nil { + common.ErrorResponse(c, 400, "无效的单词ID") + return + } + + err = h.wordBookService.RemoveFromFavorite(userID, wordID) + if err != nil { + common.ErrorResponse(c, 500, "移除失败: "+err.Error()) + return + } + + common.SuccessResponse(c, gin.H{ + "message": "已从生词本移除", + }) +} diff --git a/serve/internal/handler/writing_handler.go b/serve/internal/handler/writing_handler.go new file mode 100644 index 0000000..5354984 --- /dev/null +++ b/serve/internal/handler/writing_handler.go @@ -0,0 +1,268 @@ +package handler + +import ( + "net/http" + "strconv" + + "github.com/gin-gonic/gin" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/services" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" +) + +type WritingHandler struct { + writingService *services.WritingService +} + +func NewWritingHandler(writingService *services.WritingService) *WritingHandler { + return &WritingHandler{writingService: writingService} +} + +// GetWritingPrompts 获取写作题目列表 +func (h *WritingHandler) GetWritingPrompts(c *gin.Context) { + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + // 转换为 limit/offset 以匹配服务方法签名 + limit := pageSize + offset := (page - 1) * pageSize + prompts, err := h.writingService.GetWritingPrompts(level, category, limit, offset) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"prompts": prompts}) +} + +// GetWritingPrompt 获取单个写作题目 +func (h *WritingHandler) GetWritingPrompt(c *gin.Context) { + id := c.Param("id") + + prompt, err := h.writingService.GetWritingPrompt(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Writing prompt not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"prompt": prompt}) +} + +// CreateWritingPrompt 创建写作题目 +func (h *WritingHandler) CreateWritingPrompt(c *gin.Context) { + var prompt models.WritingPrompt + if err := c.ShouldBindJSON(&prompt); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.writingService.CreateWritingPrompt(&prompt); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusCreated, gin.H{"prompt": prompt}) +} + +// UpdateWritingPrompt 更新写作题目 +func (h *WritingHandler) UpdateWritingPrompt(c *gin.Context) { + id := c.Param("id") + + var prompt models.WritingPrompt + if err := c.ShouldBindJSON(&prompt); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + prompt.ID = id // 确保ID匹配 + if err := h.writingService.UpdateWritingPrompt(id, &prompt); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"prompt": prompt}) +} + +// DeleteWritingPrompt 删除写作题目 +func (h *WritingHandler) DeleteWritingPrompt(c *gin.Context) { + id := c.Param("id") + + if err := h.writingService.DeleteWritingPrompt(id); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"message": "Writing prompt deleted successfully"}) +} + +// SearchWritingPrompts 搜索写作题目 +func (h *WritingHandler) SearchWritingPrompts(c *gin.Context) { + keyword := c.Query("keyword") + level := c.Query("level") + category := c.Query("category") + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + + // 转换为 limit/offset 以匹配服务方法签名 + limit := pageSize + offset := (page - 1) * pageSize + prompts, err := h.writingService.SearchWritingPrompts(keyword, level, category, limit, offset) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"prompts": prompts}) +} + +// GetRecommendedPrompts 获取推荐写作题目 +func (h *WritingHandler) GetRecommendedPrompts(c *gin.Context) { + userID := c.GetString("user_id") // 假设用户ID已经通过中间件设置 + limit, _ := strconv.Atoi(c.DefaultQuery("limit", "5")) + prompts, err := h.writingService.GetRecommendedPrompts(userID, limit) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"prompts": prompts}) +} + +// CreateWritingSubmission 创建写作提交 +func (h *WritingHandler) CreateWritingSubmission(c *gin.Context) { + var submission models.WritingSubmission + if err := c.ShouldBindJSON(&submission); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.writingService.CreateWritingSubmission(&submission); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusCreated, gin.H{"submission": submission}) +} + +// UpdateWritingSubmission 更新写作提交 +func (h *WritingHandler) UpdateWritingSubmission(c *gin.Context) { + id := c.Param("id") + + var submission models.WritingSubmission + if err := c.ShouldBindJSON(&submission); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + submission.ID = id // 确保ID匹配 + if err := h.writingService.UpdateWritingSubmission(id, &submission); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"submission": submission}) +} + +// GetWritingSubmission 获取写作提交详情 +func (h *WritingHandler) GetWritingSubmission(c *gin.Context) { + id := c.Param("id") + + submission, err := h.writingService.GetWritingSubmission(id) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Writing submission not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"submission": submission}) +} + +// GetUserWritingSubmissions 获取用户写作提交列表 +func (h *WritingHandler) GetUserWritingSubmissions(c *gin.Context) { + userID := c.GetString("user_id") // 假设用户ID已经通过中间件设置 + page, _ := strconv.Atoi(c.DefaultQuery("page", "1")) + pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "10")) + // 转换为 limit/offset 以匹配服务方法签名 + limit := pageSize + offset := (page - 1) * pageSize + submissions, err := h.writingService.GetUserWritingSubmissions(userID, limit, offset) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"data": submissions}) +} + +// SubmitWriting 提交写作作业 +func (h *WritingHandler) SubmitWriting(c *gin.Context) { + id := c.Param("id") + var req struct { + Content string `json:"content"` + TimeSpent int `json:"time_spent"` + } + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.writingService.SubmitWriting(id, req.Content, req.TimeSpent); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"id": id, "message": "Writing submitted successfully"}) +} + +// GradeWriting AI批改写作 +func (h *WritingHandler) GradeWriting(c *gin.Context) { + id := c.Param("id") + + var req struct { + Score float64 `json:"score" binding:"required"` + GrammarScore float64 `json:"grammar_score"` + VocabularyScore float64 `json:"vocabulary_score"` + CoherenceScore float64 `json:"coherence_score"` + Feedback string `json:"feedback"` + Suggestions string `json:"suggestions"` + } + + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + return + } + + if err := h.writingService.GradeWriting(id, req.Score, req.GrammarScore, req.VocabularyScore, req.CoherenceScore, req.Feedback, req.Suggestions); err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"id": id, "message": "Writing graded successfully"}) +} + +// GetUserWritingStats 获取用户写作统计 +func (h *WritingHandler) GetUserWritingStats(c *gin.Context) { + userID := c.GetString("user_id") // 假设用户ID已经通过中间件设置 + + stats, err := h.writingService.GetUserWritingStats(userID) + if err != nil { + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + return + } + + c.JSON(http.StatusOK, gin.H{"stats": stats}) +} + +// GetWritingProgress 获取写作进度 +func (h *WritingHandler) GetWritingProgress(c *gin.Context) { + userID := c.GetString("user_id") // 假设用户ID已经通过中间件设置 + promptID := c.Param("prompt_id") + + progress, err := h.writingService.GetWritingProgress(userID, promptID) + if err != nil { + c.JSON(http.StatusNotFound, gin.H{"error": "Writing progress not found"}) + return + } + + c.JSON(http.StatusOK, gin.H{"progress": progress}) +} \ No newline at end of file diff --git a/serve/internal/handlers/auth_handler_integration_test.go b/serve/internal/handlers/auth_handler_integration_test.go new file mode 100644 index 0000000..4847da9 --- /dev/null +++ b/serve/internal/handlers/auth_handler_integration_test.go @@ -0,0 +1,131 @@ +package handlers + +import ( + "bytes" + "encoding/json" + "net/http" + "net/http/httptest" + "testing" + + "github.com/gin-gonic/gin" +) + +// TestAuthHandlerIntegration 集成测试 +func TestAuthHandlerIntegration(t *testing.T) { + // 设置Gin为测试模式 + gin.SetMode(gin.TestMode) + + // 创建路由器 + router := gin.New() + + // 注册路由（这里需要根据实际的路由注册方式调整） + // router.POST("/api/auth/register", RegisterHandler) + // router.POST("/api/auth/login", LoginHandler) + + t.Run("Integration Test Framework", func(t *testing.T) { + // 测试注册请求 + registerData := map[string]interface{}{ + "username": "testuser", + "email": "test@example.com", + "password": "password123", + } + + jsonData, _ := json.Marshal(registerData) + req := httptest.NewRequest("POST", "/api/auth/register", bytes.NewBuffer(jsonData)) + req.Header.Set("Content-Type", "application/json") + + w := httptest.NewRecorder() + router.ServeHTTP(w, req) + + // 验证响应（这里只是框架，实际需要根据具体实现调整） + if w.Code != http.StatusOK && w.Code != http.StatusNotFound { + t.Logf("Register request status: %d", w.Code) + } + }) + + t.Run("Login Integration Test", func(t *testing.T) { + // 测试登录请求 + loginData := map[string]interface{}{ + "email": "test@example.com", + "password": "password123", + } + + jsonData, _ := json.Marshal(loginData) + req := httptest.NewRequest("POST", "/api/auth/login", bytes.NewBuffer(jsonData)) + req.Header.Set("Content-Type", "application/json") + + w := httptest.NewRecorder() + router.ServeHTTP(w, req) + + // 验证响应 + if w.Code != http.StatusOK && w.Code != http.StatusNotFound { + t.Logf("Login request status: %d", w.Code) + } + }) + + t.Run("API Endpoint Validation", func(t *testing.T) { + // 测试API端点是否正确配置 + req := httptest.NewRequest("GET", "/health", nil) + w := httptest.NewRecorder() + router.ServeHTTP(w, req) + + // 记录健康检查状态 + t.Logf("Health check status: %d", w.Code) + }) +} + +// TestAPIResponseFormat 测试API响应格式 +func TestAPIResponseFormat(t *testing.T) { + gin.SetMode(gin.TestMode) + + t.Run("JSON Response Format", func(t *testing.T) { + // 测试JSON响应格式 + response := map[string]interface{}{ + "success": true, + "message": "操作成功", + "data": nil, + } + + jsonData, err := json.Marshal(response) + if err != nil { + t.Errorf("JSON marshal error: %v", err) + } + + var parsed map[string]interface{} + err = json.Unmarshal(jsonData, &parsed) + if err != nil { + t.Errorf("JSON unmarshal error: %v", err) + } + + if parsed["success"] != true { + t.Error("Response format validation failed") + } + }) +} + +// TestErrorHandling 测试错误处理 +func TestErrorHandling(t *testing.T) { + t.Run("Error Response Structure", func(t *testing.T) { + // 测试错误响应结构 + errorResponse := map[string]interface{}{ + "success": false, + "message": "请求失败", + "error": "详细错误信息", + } + + jsonData, err := json.Marshal(errorResponse) + if err != nil { + t.Errorf("Error response marshal failed: %v", err) + } + + var parsed map[string]interface{} + err = json.Unmarshal(jsonData, &parsed) + if err != nil { + t.Errorf("Error response unmarshal failed: %v", err) + } + + if parsed["success"] != false { + t.Error("Error response validation failed") + } + }) +} \ No newline at end of file diff --git a/serve/internal/interfaces/vocabulary_service_interface.go b/serve/internal/interfaces/vocabulary_service_interface.go new file mode 100644 index 0000000..a95816b --- /dev/null +++ b/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) +} \ No newline at end of file diff --git a/serve/internal/interfaces/writing_service_interface.go b/serve/internal/interfaces/writing_service_interface.go new file mode 100644 index 0000000..7942dfb --- /dev/null +++ b/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) +} \ No newline at end of file diff --git a/serve/internal/logger/logger.go b/serve/internal/logger/logger.go new file mode 100644 index 0000000..cc66b06 --- /dev/null +++ b/serve/internal/logger/logger.go @@ -0,0 +1,245 @@ +package logger + +import ( + "fmt" + "io" + "os" + "path/filepath" + "time" + + "github.com/sirupsen/logrus" + "gopkg.in/natefinch/lumberjack.v2" +) + +var Logger *logrus.Logger + +// LogConfig 日志配置 +type LogConfig struct { + Level string `json:"level"` // 日志级别 + Format string `json:"format"` // 日志格式 json/text + Output string `json:"output"` // 输出方式 console/file/both + FilePath string `json:"file_path"` // 日志文件路径 + MaxSize int `json:"max_size"` // 单个日志文件最大大小(MB) + MaxBackups int `json:"max_backups"` // 保留的旧日志文件数量 + MaxAge int `json:"max_age"` // 日志文件保留天数 + Compress bool `json:"compress"` // 是否压缩旧日志文件 +} + +// InitLogger 初始化日志系统 +func InitLogger(config LogConfig) { + Logger = logrus.New() + + // 设置日志级别 + setLogLevel(config.Level) + + // 设置日志格式 + setLogFormat(config.Format) + + // 设置日志输出 + setLogOutput(config) + + // 添加钩子 + addHooks() + + Logger.Info("Logger initialized successfully") +} + +// setLogLevel 设置日志级别 +func setLogLevel(level string) { + switch level { + case "debug": + Logger.SetLevel(logrus.DebugLevel) + case "info": + Logger.SetLevel(logrus.InfoLevel) + case "warn": + Logger.SetLevel(logrus.WarnLevel) + case "error": + Logger.SetLevel(logrus.ErrorLevel) + case "fatal": + Logger.SetLevel(logrus.FatalLevel) + case "panic": + Logger.SetLevel(logrus.PanicLevel) + default: + Logger.SetLevel(logrus.InfoLevel) + } +} + +// setLogFormat 设置日志格式 +func setLogFormat(format string) { + switch format { + case "json": + Logger.SetFormatter(&logrus.JSONFormatter{ + TimestampFormat: time.RFC3339, + }) + case "text": + Logger.SetFormatter(&logrus.TextFormatter{ + FullTimestamp: true, + TimestampFormat: "2006-01-02 15:04:05", + }) + default: + Logger.SetFormatter(&logrus.JSONFormatter{ + TimestampFormat: time.RFC3339, + }) + } +} + +// setLogOutput 设置日志输出 +func setLogOutput(config LogConfig) { + switch config.Output { + case "console": + Logger.SetOutput(os.Stdout) + case "file": + setFileOutput(config) + case "both": + setBothOutput(config) + default: + Logger.SetOutput(os.Stdout) + } +} + +// setFileOutput 设置文件输出 +func setFileOutput(config LogConfig) { + // 确保日志目录存在 + logDir := filepath.Dir(config.FilePath) + if err := os.MkdirAll(logDir, 0755); err != nil { + fmt.Printf("Failed to create log directory: %v\n", err) + return + } + + // 配置日志轮转 + lumberjackLogger := &lumberjack.Logger{ + Filename: config.FilePath, + MaxSize: config.MaxSize, + MaxBackups: config.MaxBackups, + MaxAge: config.MaxAge, + Compress: config.Compress, + } + + Logger.SetOutput(lumberjackLogger) +} + +// setBothOutput 设置同时输出到控制台和文件 +func setBothOutput(config LogConfig) { + // 确保日志目录存在 + logDir := filepath.Dir(config.FilePath) + if err := os.MkdirAll(logDir, 0755); err != nil { + fmt.Printf("Failed to create log directory: %v\n", err) + Logger.SetOutput(os.Stdout) + return + } + + // 配置日志轮转 + lumberjackLogger := &lumberjack.Logger{ + Filename: config.FilePath, + MaxSize: config.MaxSize, + MaxBackups: config.MaxBackups, + MaxAge: config.MaxAge, + Compress: config.Compress, + } + + // 同时输出到控制台和文件，避免嵌套/转义问题 + Logger.SetOutput(io.MultiWriter(os.Stdout, lumberjackLogger)) +} + +// addHooks 添加日志钩子 +func addHooks() { + // 添加调用者信息钩子 + Logger.AddHook(&CallerHook{}) +} + +// FileHook 文件输出钩子 +type FileHook struct { + Writer *lumberjack.Logger +} + +func (hook *FileHook) Fire(entry *logrus.Entry) error { + line, err := entry.String() + if err != nil { + return err + } + _, err = hook.Writer.Write([]byte(line)) + return err +} + +func (hook *FileHook) Levels() []logrus.Level { + return logrus.AllLevels +} + +// CallerHook 调用者信息钩子 +type CallerHook struct{} + +func (hook *CallerHook) Fire(entry *logrus.Entry) error { + if entry.HasCaller() { + entry.Data["file"] = fmt.Sprintf("%s:%d", filepath.Base(entry.Caller.File), entry.Caller.Line) + entry.Data["function"] = entry.Caller.Function + } + return nil +} + +func (hook *CallerHook) Levels() []logrus.Level { + return logrus.AllLevels +} + +// 便捷方法 +func Debug(args ...interface{}) { + Logger.Debug(args...) +} + +func Debugf(format string, args ...interface{}) { + Logger.Debugf(format, args...) +} + +func Info(args ...interface{}) { + Logger.Info(args...) +} + +func Infof(format string, args ...interface{}) { + Logger.Infof(format, args...) +} + +func Warn(args ...interface{}) { + Logger.Warn(args...) +} + +func Warnf(format string, args ...interface{}) { + Logger.Warnf(format, args...) +} + +func Error(args ...interface{}) { + Logger.Error(args...) +} + +func Errorf(format string, args ...interface{}) { + Logger.Errorf(format, args...) +} + +func Fatal(args ...interface{}) { + Logger.Fatal(args...) +} + +func Fatalf(format string, args ...interface{}) { + Logger.Fatalf(format, args...) +} + +func Panic(args ...interface{}) { + Logger.Panic(args...) +} + +func Panicf(format string, args ...interface{}) { + Logger.Panicf(format, args...) +} + +// WithFields 创建带字段的日志条目 +func WithFields(fields logrus.Fields) *logrus.Entry { + return Logger.WithFields(fields) +} + +// WithField 创建带单个字段的日志条目 +func WithField(key string, value interface{}) *logrus.Entry { + return Logger.WithField(key, value) +} + +// WithError 创建带错误信息的日志条目 +func WithError(err error) *logrus.Entry { + return Logger.WithError(err) +} \ No newline at end of file diff --git a/serve/internal/middleware/auth.go b/serve/internal/middleware/auth.go new file mode 100644 index 0000000..127a0f5 --- /dev/null +++ b/serve/internal/middleware/auth.go @@ -0,0 +1,183 @@ +package middleware + +import ( + "net/http" + "strings" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/config" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" + "github.com/gin-gonic/gin" + "github.com/golang-jwt/jwt/v5" +) + +// JWTClaims JWT声明结构 +type JWTClaims struct { + UserID int64 `json:"user_id"` + Username string `json:"username"` + Email string `json:"email"` + Type string `json:"type"` // access, refresh + jwt.RegisteredClaims +} + +// GenerateTokens 生成访问令牌和刷新令牌 +func GenerateTokens(userID int64, username, email string) (accessToken, refreshToken string, err error) { + cfg := config.GlobalConfig + now := time.Now() + + // 生成访问令牌 + accessClaims := JWTClaims{ + UserID: userID, + Username: username, + Email: email, + Type: "access", + RegisteredClaims: jwt.RegisteredClaims{ + ExpiresAt: jwt.NewNumericDate(now.Add(time.Duration(cfg.JWT.AccessTokenTTL) * time.Second)), + IssuedAt: jwt.NewNumericDate(now), + NotBefore: jwt.NewNumericDate(now), + Issuer: cfg.App.Name, + Subject: utils.Int64ToString(userID), + ID: utils.GenerateUUID(), + }, + } + + accessTokenObj := jwt.NewWithClaims(jwt.SigningMethodHS256, accessClaims) + accessToken, err = accessTokenObj.SignedString([]byte(cfg.JWT.Secret)) + if err != nil { + return "", "", err + } + + // 生成刷新令牌 + refreshClaims := JWTClaims{ + UserID: userID, + Username: username, + Email: email, + Type: "refresh", + RegisteredClaims: jwt.RegisteredClaims{ + ExpiresAt: jwt.NewNumericDate(now.Add(time.Duration(cfg.JWT.RefreshTokenTTL) * time.Second)), + IssuedAt: jwt.NewNumericDate(now), + NotBefore: jwt.NewNumericDate(now), + Issuer: cfg.App.Name, + Subject: utils.Int64ToString(userID), + ID: utils.GenerateUUID(), + }, + } + + refreshTokenObj := jwt.NewWithClaims(jwt.SigningMethodHS256, refreshClaims) + refreshToken, err = refreshTokenObj.SignedString([]byte(cfg.JWT.Secret)) + if err != nil { + return "", "", err + } + + return accessToken, refreshToken, nil +} + +// ParseToken 解析JWT令牌 +func ParseToken(tokenString string) (*JWTClaims, error) { + cfg := config.GlobalConfig + + token, err := jwt.ParseWithClaims(tokenString, &JWTClaims{}, func(token *jwt.Token) (interface{}, error) { + return []byte(cfg.JWT.Secret), nil + }) + + if err != nil { + return nil, err + } + + if claims, ok := token.Claims.(*JWTClaims); ok && token.Valid { + return claims, nil + } + + return nil, jwt.ErrInvalidKey +} + +// AuthMiddleware JWT认证中间件 +func AuthMiddleware() gin.HandlerFunc { + return func(c *gin.Context) { + // 从请求头获取token + authHeader := c.GetHeader("Authorization") + if authHeader == "" { + common.UnauthorizedResponse(c, "缺少认证令牌") + c.Abort() + return + } + + // 检查Bearer前缀 + parts := strings.SplitN(authHeader, " ", 2) + if len(parts) != 2 || parts[0] != "Bearer" { + common.UnauthorizedResponse(c, "认证令牌格式错误") + c.Abort() + return + } + + tokenString := parts[1] + + // 解析token + claims, err := ParseToken(tokenString) + if err != nil { + if err == jwt.ErrTokenExpired { + common.ErrorResponse(c, http.StatusUnauthorized, "访问令牌已过期") + } else { + common.UnauthorizedResponse(c, "无效的访问令牌") + } + c.Abort() + return + } + + // 检查token类型 + if claims.Type != "access" { + common.UnauthorizedResponse(c, "令牌类型错误") + c.Abort() + return + } + + // 将用户信息存储到上下文中 + c.Set("user_id", claims.UserID) + c.Set("username", claims.Username) + c.Set("email", claims.Email) + + c.Next() + } +} + +// OptionalAuthMiddleware 可选认证中间件（不强制要求登录） +func OptionalAuthMiddleware() gin.HandlerFunc { + return func(c *gin.Context) { + // 从请求头获取token + authHeader := c.GetHeader("Authorization") + if authHeader == "" { + c.Next() + return + } + + // 检查Bearer前缀 + parts := strings.SplitN(authHeader, " ", 2) + if len(parts) != 2 || parts[0] != "Bearer" { + c.Next() + return + } + + tokenString := parts[1] + + // 解析token + claims, err := ParseToken(tokenString) + if err != nil { + c.Next() + return + } + + // 检查token类型 + if claims.Type != "access" { + c.Next() + return + } + + // 将用户信息存储到上下文中 + c.Set("user_id", claims.UserID) + c.Set("username", claims.Username) + c.Set("email", claims.Email) + + c.Next() + } +} \ No newline at end of file diff --git a/serve/internal/middleware/cors.go b/serve/internal/middleware/cors.go new file mode 100644 index 0000000..a2ba2d1 --- /dev/null +++ b/serve/internal/middleware/cors.go @@ -0,0 +1,40 @@ +package middleware + +import ( + "net/http" + + "github.com/gin-gonic/gin" +) + +// CORS 跨域中间件 +func CORS() gin.HandlerFunc { + return func(c *gin.Context) { + method := c.Request.Method + origin := c.Request.Header.Get("Origin") + + // 设置允许的域名 + if origin != "" { + c.Header("Access-Control-Allow-Origin", origin) + } + + // 设置允许的请求头 + c.Header("Access-Control-Allow-Headers", "Content-Type, Content-Length, Accept-Encoding, X-CSRF-Token, Authorization, accept, origin, Cache-Control, X-Requested-With") + + // 设置允许的请求方法 + c.Header("Access-Control-Allow-Methods", "POST, OPTIONS, GET, PUT, DELETE, PATCH") + + // 设置是否允许携带凭证 + c.Header("Access-Control-Allow-Credentials", "true") + + // 设置预检请求的缓存时间 + c.Header("Access-Control-Max-Age", "86400") + + // 处理预检请求 + if method == "OPTIONS" { + c.AbortWithStatus(http.StatusNoContent) + return + } + + c.Next() + } +} \ No newline at end of file diff --git a/serve/internal/middleware/error_handler.go b/serve/internal/middleware/error_handler.go new file mode 100644 index 0000000..f506f61 --- /dev/null +++ b/serve/internal/middleware/error_handler.go @@ -0,0 +1,68 @@ +package middleware + +import ( + "net/http" + "runtime/debug" + + "github.com/gin-gonic/gin" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/logger" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" +) + +// ErrorHandler 全局错误处理中间件 +func ErrorHandler() gin.HandlerFunc { + return gin.CustomRecovery(func(c *gin.Context, recovered interface{}) { + if err, ok := recovered.(string); ok { + logger.WithFields(map[string]interface{}{ + "error": err, + "method": c.Request.Method, + "path": c.Request.URL.Path, + "ip": c.ClientIP(), + "user_agent": c.Request.UserAgent(), + "stack": string(debug.Stack()), + }).Error("Panic recovered") + } + if err, ok := recovered.(error); ok { + logger.WithFields(map[string]interface{}{ + "error": err.Error(), + "method": c.Request.Method, + "path": c.Request.URL.Path, + "ip": c.ClientIP(), + "user_agent": c.Request.UserAgent(), + "stack": string(debug.Stack()), + }).Error("Panic recovered") + } + + // 返回统一的错误响应 + common.ErrorResponse(c, http.StatusInternalServerError, "Internal server error") + c.Abort() + }) +} + +// RequestLogger 请求日志中间件 +func RequestLogger() gin.HandlerFunc { + return gin.LoggerWithFormatter(func(param gin.LogFormatterParams) string { + logger.WithFields(map[string]interface{}{ + "timestamp": param.TimeStamp.Format("2006-01-02 15:04:05"), + "status_code": param.StatusCode, + "latency": param.Latency.String(), + "client_ip": param.ClientIP, + "method": param.Method, + "path": param.Path, + "user_agent": param.Request.UserAgent(), + "error": param.ErrorMessage, + }).Info("HTTP Request") + return "" + }) +} + + + +// RateLimiter 简单的速率限制中间件（基于IP） +func RateLimiter() gin.HandlerFunc { + // 这里可以集成更复杂的限流库，如 golang.org/x/time/rate + return func(c *gin.Context) { + // 简单实现，实际项目中应该使用更完善的限流算法 + c.Next() + } +} \ No newline at end of file diff --git a/serve/internal/middleware/logger.go b/serve/internal/middleware/logger.go new file mode 100644 index 0000000..1966757 --- /dev/null +++ b/serve/internal/middleware/logger.go @@ -0,0 +1,304 @@ +package middleware + +import ( + "bytes" + "fmt" + "io" + "encoding/json" + "strings" + "time" + + "github.com/gin-gonic/gin" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/logger" +) + +// Logger 保留原始Gin格式化日志（如需） +func Logger() gin.HandlerFunc { + return gin.LoggerWithFormatter(func(param gin.LogFormatterParams) string { + return fmt.Sprintf("%s - [%s] \"%s %s %s %d %s \"%s\" %s\"\n", + param.ClientIP, + param.TimeStamp.Format(time.RFC1123), + param.Method, + param.Path, + param.Request.Proto, + param.StatusCode, + param.Latency, + param.Request.UserAgent(), + param.ErrorMessage, + ) + }) +} + +// Recovery 恢复中间件 +func Recovery() gin.HandlerFunc { + return gin.Recovery() +} + +// bodyLogWriter 用于捕获响应体内容 +type bodyLogWriter struct { + gin.ResponseWriter + body *bytes.Buffer +} + +func (w *bodyLogWriter) Write(b []byte) (int, error) { + if w.body != nil { + w.body.Write(b) + } + return w.ResponseWriter.Write(b) +} + +// RequestResponseLogger 记录清晰的请求入参与响应信息 +func RequestResponseLogger() gin.HandlerFunc { + const maxBodyLogSize = 10000 // 最大记录的body长度，超过则截断（增加到10000） + return func(c *gin.Context) { + start := time.Now() + + // 捕获请求体（仅记录JSON，避免记录文件/二进制数据） + reqCT := c.GetHeader("Content-Type") + var reqBodyStr string + if strings.Contains(reqCT, "application/json") { + if c.Request.Body != nil { + data, _ := io.ReadAll(c.Request.Body) + // 复位Body以便后续业务读取 + c.Request.Body = io.NopCloser(bytes.NewBuffer(data)) + reqBodyStr = maskSensitiveJSON(string(data)) + reqBodyStr = truncate(reqBodyStr, maxBodyLogSize) + } + } else { + // 对于表单/多部分/其他类型，不直接记录内容，避免污染日志与隐私泄露 + reqBodyStr = "(body skipped for non-JSON content)" + } + + // 包装响应写入器，捕获响应体 + blw := &bodyLogWriter{ResponseWriter: c.Writer, body: &bytes.Buffer{}} + c.Writer = blw + + // 执行后续处理 + c.Next() + + latency := time.Since(start) + status := c.Writer.Status() + respCT := c.Writer.Header().Get("Content-Type") + respBodyStr := blw.body.String() + if strings.Contains(respCT, "application/json") { + respBodyStr = truncate(respBodyStr, maxBodyLogSize) + } else if respBodyStr != "" { + respBodyStr = fmt.Sprintf("(non-JSON response, %d bytes)", len(respBodyStr)) + } else { + respBodyStr = "(empty)" + } + + // 路径（优先使用路由匹配的完整路径） + path := c.FullPath() + if path == "" { + path = c.Request.URL.Path + } + + // 头信息（仅记录关键字段，并进行脱敏） + auth := c.GetHeader("Authorization") + if auth != "" { + auth = maskToken(auth) + } + + // 错误聚合 + var errMsg string + if len(c.Errors) > 0 { + errMsg = c.Errors.String() + } + + // 根据状态码选择emoji和日志级别 + statusEmoji := getStatusEmoji(status) + logLevel := getLogLevel(status) + + // 获取或生成Request ID + requestID := c.GetString("request_id") + if requestID == "" { + requestID = "N/A" + } + + // 获取User ID（如果有） + userID := "N/A" + if uid, exists := c.Get("user_id"); exists { + userID = fmt.Sprintf("%v", uid) + } + + // 格式化耗时 + latencyStr := formatLatency(latency) + + // 构建美化的控制台日志 + separator := "================================================================================" + fmt.Printf("\n%s\n", separator) + fmt.Printf("🌐 %s %s | %s %d | ⏱️ %s\n", c.Request.Method, path, statusEmoji, status, latencyStr) + fmt.Printf("📍 IP: %s | 🆔 Request ID: %s | 👤 User ID: %s\n", c.ClientIP(), requestID, userID) + + if c.Request.URL.RawQuery != "" { + fmt.Printf("🔗 Query: %s\n", c.Request.URL.RawQuery) + } + + fmt.Printf("🔍 User-Agent: %s\n", c.Request.UserAgent()) + + // 显示请求体（如果有） + if reqBodyStr != "" && reqBodyStr != "(body skipped for non-JSON content)" { + fmt.Printf("📤 Request Body:\n %s\n", reqBodyStr) + } + + // 显示响应体 + if respBodyStr != "" && respBodyStr != "(empty)" { + fmt.Printf("📥 Response Body:\n %s\n", respBodyStr) + } + + // 显示错误（如果有） + if errMsg != "" { + fmt.Printf("❌ Error: %s\n", errMsg) + } + + fmt.Printf("🕐 Time: %s\n", time.Now().Format("2006-01-02 15:04:05")) + fmt.Printf("%s\n", separator) + + // 同时记录结构化日志到文件 + logEntry := logger.WithFields(map[string]interface{}{ + "type": "http_request", + "timestamp": time.Now().Unix(), + "method": c.Request.Method, + "path": path, + "raw_query": c.Request.URL.RawQuery, + "ip": c.ClientIP(), + "user_agent": truncate(c.Request.UserAgent(), 200), + "status": status, + "request_id": requestID, + "user_id": userID, + "duration": latency.Milliseconds(), + }) + + logMsg := fmt.Sprintf("HTTP Request") + + // 根据状态码选择日志级别 + switch logLevel { + case "error": + logEntry.Error(logMsg) + case "warn": + logEntry.Warn(logMsg) + default: + logEntry.Info(logMsg) + } + } +} + +// formatLatency 格式化延迟时间 +func formatLatency(d time.Duration) string { + if d < time.Millisecond { + return fmt.Sprintf("%dµs", d.Microseconds()) + } else if d < time.Second { + return fmt.Sprintf("%dms", d.Milliseconds()) + } else { + return fmt.Sprintf("%.1fs", d.Seconds()) + } +} + +// getStatusEmoji 根据HTTP状态码返回对应的emoji +func getStatusEmoji(status int) string { + switch { + case status >= 200 && status < 300: + return "✅" // 成功 + case status >= 300 && status < 400: + return "🔄" // 重定向 + case status >= 400 && status < 500: + return "⚠️" // 客户端错误 + case status >= 500: + return "❌" // 服务器错误 + default: + return "📝" // 其他 + } +} + +// getMethodEmoji 根据HTTP方法返回对应的emoji +func getMethodEmoji(method string) string { + switch method { + case "GET": + return "📖" // 读取 + case "POST": + return "📝" // 创建 + case "PUT": + return "✏️" // 更新 + case "DELETE": + return "🗑️" // 删除 + case "PATCH": + return "🔧" // 修补 + case "OPTIONS": + return "🔍" // 选项 + default: + return "📌" // 其他 + } +} + +// getLogLevel 根据状态码返回日志级别 +func getLogLevel(status int) string { + switch { + case status >= 500: + return "error" + case status >= 400: + return "warn" + default: + return "info" + } +} + +// truncate 截断过长日志内容 +func truncate(s string, max int) string { + if len(s) <= max { + return s + } + if max <= 3 { + return s[:max] + } + return s[:max-3] + "..." +} + +// maskToken 脱敏令牌或认证头 +func maskToken(s string) string { + if s == "" { + return s + } + // 只保留前后少量字符 + if len(s) <= 10 { + return "***" + } + return s[:6] + "***" + s[len(s)-4:] +} + +// maskSensitiveJSON 尝试解析并递归脱敏JSON中的敏感字段 +func maskSensitiveJSON(s string) string { + var obj interface{} + if err := json.Unmarshal([]byte(s), &obj); err != nil { + // 解析失败时直接返回原始字符串（随后由truncate处理） + return s + } + masked := maskRecursive(obj) + b, err := json.Marshal(masked) + if err != nil { + return s + } + return string(b) +} + +func maskRecursive(v interface{}) interface{} { + switch t := v.(type) { + case map[string]interface{}: + for k, val := range t { + lk := strings.ToLower(k) + if lk == "password" || lk == "token" || lk == "secret" || lk == "authorization" { + t[k] = "***" + continue + } + t[k] = maskRecursive(val) + } + return t + case []interface{}: + for i := range t { + t[i] = maskRecursive(t[i]) + } + return t + default: + return v + } +} \ No newline at end of file diff --git a/serve/internal/middleware/request_id.go b/serve/internal/middleware/request_id.go new file mode 100644 index 0000000..4f4c35a --- /dev/null +++ b/serve/internal/middleware/request_id.go @@ -0,0 +1,27 @@ +package middleware + +import ( + "github.com/gin-gonic/gin" + "github.com/google/uuid" +) + +// RequestID 为每个请求生成唯一ID +func RequestID() gin.HandlerFunc { + return func(c *gin.Context) { + // 尝试从请求头获取Request ID + requestID := c.GetHeader("X-Request-ID") + + // 如果没有，生成新的UUID + if requestID == "" { + requestID = uuid.New().String() + } + + // 设置到上下文中 + c.Set("request_id", requestID) + + // 设置到响应头中 + c.Header("X-Request-ID", requestID) + + c.Next() + } +} diff --git a/serve/internal/model/ai_models.go b/serve/internal/model/ai_models.go new file mode 100644 index 0000000..1229a5a --- /dev/null +++ b/serve/internal/model/ai_models.go @@ -0,0 +1,99 @@ +package model + +import "time" + +// WritingCorrection 写作批改结果 +type WritingCorrection struct { + ID uint `json:"id" gorm:"primaryKey"` + UserID uint `json:"user_id"` + Content string `json:"content"` + TaskType string `json:"task_type"` + OverallScore int `json:"overall_score"` + GrammarScore int `json:"grammar_score"` + VocabularyScore int `json:"vocabulary_score"` + StructureScore int `json:"structure_score"` + ContentScore int `json:"content_score"` + Corrections []WritingError `json:"corrections"` + Suggestions []string `json:"suggestions" gorm:"type:json"` + Strengths []string `json:"strengths" gorm:"type:json"` + Weaknesses []string `json:"weaknesses" gorm:"type:json"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` +} + +// WritingError 写作错误 +type WritingError struct { + ID uint `json:"id" gorm:"primaryKey"` + CorrectionID uint `json:"correction_id"` + Original string `json:"original"` + Corrected string `json:"corrected"` + Explanation string `json:"explanation"` + ErrorType string `json:"error_type"` // grammar, vocabulary, structure, etc. +} + +// SpeakingEvaluation 口语评估结果 +type SpeakingEvaluation struct { + ID uint `json:"id" gorm:"primaryKey"` + UserID uint `json:"user_id"` + AudioText string `json:"audio_text"` + Prompt string `json:"prompt"` + OverallScore int `json:"overall_score"` + PronunciationScore int `json:"pronunciation_score"` + FluencyScore int `json:"fluency_score"` + GrammarScore int `json:"grammar_score"` + VocabularyScore int `json:"vocabulary_score"` + Feedback string `json:"feedback"` + Strengths []string `json:"strengths" gorm:"type:json"` + Improvements []string `json:"improvements" gorm:"type:json"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` +} + +// AIRecommendation AI推荐 +type AIRecommendation struct { + ID uint `json:"id" gorm:"primaryKey"` + UserID uint `json:"user_id"` + UserLevel string `json:"user_level"` + RecommendedTopics []string `json:"recommended_topics" gorm:"type:json"` + DifficultyLevel string `json:"difficulty_level"` + StudyPlan []string `json:"study_plan" gorm:"type:json"` + FocusAreas []string `json:"focus_areas" gorm:"type:json"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` +} + +// Exercise 练习题 +type Exercise struct { + ID uint `json:"id" gorm:"primaryKey"` + Title string `json:"title"` + Instructions string `json:"instructions"` + Content string `json:"content"` + ExerciseType string `json:"exercise_type"` + Questions []Question `json:"questions"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` +} + +// Question 问题 +type Question struct { + ID uint `json:"id" gorm:"primaryKey"` + ExerciseID uint `json:"exercise_id"` + Question string `json:"question"` + Options []string `json:"options" gorm:"type:json"` + CorrectAnswer string `json:"correct_answer"` + Explanation string `json:"explanation"` +} + +// AIRequest AI请求记录 +type AIRequest struct { + ID uint `json:"id" gorm:"primaryKey"` + UserID uint `json:"user_id"` + RequestType string `json:"request_type"` // writing_correction, speaking_evaluation, recommendation, exercise_generation + Prompt string `json:"prompt"` + Response string `json:"response"` + TokensUsed int `json:"tokens_used"` + Cost float64 `json:"cost"` + Status string `json:"status"` // success, error, pending + ErrorMsg string `json:"error_msg,omitempty"` + CreatedAt time.Time `json:"created_at"` +} \ No newline at end of file diff --git a/serve/internal/model/user.go b/serve/internal/model/user.go new file mode 100644 index 0000000..e2419bf --- /dev/null +++ b/serve/internal/model/user.go @@ -0,0 +1,9 @@ +package model + +type User struct { + ID string `json:"id"` + Username string `json:"username"` + Email string `json:"email"` + Password string `json:"password,omitempty"` // omitempty 表示在序列化为 JSON 时如果为空则忽略 + Avatar string `json:"avatar,omitempty"` +} \ No newline at end of file diff --git a/serve/internal/models/learning.go b/serve/internal/models/learning.go new file mode 100644 index 0000000..cccd6f0 --- /dev/null +++ b/serve/internal/models/learning.go @@ -0,0 +1,216 @@ +package models + +import ( + "time" + + "gorm.io/gorm" +) + +// ListeningMaterial 听力材料模型 +type ListeningMaterial struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:材料ID"` + Title string `json:"title" gorm:"type:varchar(200);not null;comment:标题"` + Description *string `json:"description" gorm:"type:text;comment:描述"` + AudioURL string `json:"audio_url" gorm:"type:varchar(500);not null;comment:音频URL"` + Transcript *string `json:"transcript" gorm:"type:longtext;comment:音频文本"` + Duration int `json:"duration" gorm:"type:int;comment:时长(秒)"` + Level string `json:"level" gorm:"type:enum('beginner','intermediate','advanced');not null;comment:难度级别"` + Category string `json:"category" gorm:"type:varchar(50);comment:分类"` + Tags *string `json:"tags" gorm:"type:json;comment:标签(JSON数组)"` + IsActive bool `json:"is_active" gorm:"type:boolean;default:true;comment:是否启用"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + DeletedAt gorm.DeletedAt `json:"-" gorm:"index;comment:删除时间"` + + // 关联关系 + ListeningRecords []ListeningRecord `json:"listening_records,omitempty" gorm:"foreignKey:MaterialID"` +} + +// ListeningRecord 听力练习记录模型 +type ListeningRecord struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:记录ID"` + UserID string `json:"user_id" gorm:"type:varchar(36);not null;index;comment:用户ID"` + MaterialID string `json:"material_id" gorm:"type:varchar(36);not null;index;comment:材料ID"` + Score *float64 `json:"score" gorm:"type:decimal(5,2);comment:得分"` + Accuracy *float64 `json:"accuracy" gorm:"type:decimal(5,2);comment:准确率"` + CompletionRate *float64 `json:"completion_rate" gorm:"type:decimal(5,2);comment:完成率"` + TimeSpent int `json:"time_spent" gorm:"type:int;comment:用时(秒)"` + Answers *string `json:"answers" gorm:"type:json;comment:答案(JSON对象)"` + Feedback *string `json:"feedback" gorm:"type:text;comment:AI反馈"` + StartedAt time.Time `json:"started_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:开始时间"` + CompletedAt *time.Time `json:"completed_at" gorm:"type:timestamp;comment:完成时间"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + User User `json:"-" gorm:"foreignKey:UserID"` + Material ListeningMaterial `json:"-" gorm:"foreignKey:MaterialID"` +} + +// ReadingMaterial 阅读材料模型 +type ReadingMaterial struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:材料ID"` + Title string `json:"title" gorm:"type:varchar(200);not null;comment:标题"` + Content string `json:"content" gorm:"type:longtext;not null;comment:内容"` + Summary *string `json:"summary" gorm:"type:text;comment:摘要"` + WordCount int `json:"word_count" gorm:"type:int;comment:字数"` + Level string `json:"level" gorm:"type:enum('beginner','intermediate','advanced');not null;comment:难度级别"` + Category string `json:"category" gorm:"type:varchar(50);comment:分类"` + Tags *string `json:"tags" gorm:"type:json;comment:标签(JSON数组)"` + Source *string `json:"source" gorm:"type:varchar(200);comment:来源"` + Author *string `json:"author" gorm:"type:varchar(100);comment:作者"` + IsActive bool `json:"is_active" gorm:"type:boolean;default:true;comment:是否启用"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + DeletedAt gorm.DeletedAt `json:"-" gorm:"index;comment:删除时间"` + + // 关联关系 + ReadingRecords []ReadingRecord `json:"reading_records,omitempty" gorm:"foreignKey:MaterialID"` +} + +// ReadingRecord 阅读练习记录模型 +type ReadingRecord struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:记录ID"` + UserID string `json:"user_id" gorm:"type:varchar(36);not null;index;comment:用户ID"` + MaterialID string `json:"material_id" gorm:"type:varchar(36);not null;index;comment:材料ID"` + ReadingTime int `json:"reading_time" gorm:"type:int;comment:阅读时间(秒)"` + ComprehensionScore *float64 `json:"comprehension_score" gorm:"type:decimal(5,2);comment:理解得分"` + ReadingSpeed *float64 `json:"reading_speed" gorm:"type:decimal(8,2);comment:阅读速度(词/分钟)"` + Progress float64 `json:"progress" gorm:"type:decimal(5,2);default:0;comment:阅读进度"` + Bookmarks *string `json:"bookmarks" gorm:"type:json;comment:书签(JSON数组)"` + Notes *string `json:"notes" gorm:"type:text;comment:笔记"` + QuizAnswers *string `json:"quiz_answers" gorm:"type:json;comment:测验答案(JSON对象)"` + StartedAt time.Time `json:"started_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:开始时间"` + CompletedAt *time.Time `json:"completed_at" gorm:"type:timestamp;comment:完成时间"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + User User `json:"-" gorm:"foreignKey:UserID"` + Material ReadingMaterial `json:"-" gorm:"foreignKey:MaterialID"` +} + +// WritingPrompt 写作题目模型 +type WritingPrompt struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:题目ID"` + Title string `json:"title" gorm:"type:varchar(200);not null;comment:标题"` + Prompt string `json:"prompt" gorm:"type:text;not null;comment:题目内容"` + Instructions *string `json:"instructions" gorm:"type:text;comment:写作要求"` + MinWords *int `json:"min_words" gorm:"type:int;comment:最少字数"` + MaxWords *int `json:"max_words" gorm:"type:int;comment:最多字数"` + TimeLimit *int `json:"time_limit" gorm:"type:int;comment:时间限制(分钟)"` + Level string `json:"level" gorm:"type:enum('beginner','intermediate','advanced');not null;comment:难度级别"` + Category string `json:"category" gorm:"type:varchar(50);comment:分类"` + Tags *string `json:"tags" gorm:"type:json;comment:标签(JSON数组)"` + SampleAnswer *string `json:"sample_answer" gorm:"type:longtext;comment:参考答案"` + Rubric *string `json:"rubric" gorm:"type:json;comment:评分标准(JSON对象)"` + IsActive bool `json:"is_active" gorm:"type:boolean;default:true;comment:是否启用"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + DeletedAt gorm.DeletedAt `json:"-" gorm:"index;comment:删除时间"` + + // 关联关系 + WritingSubmissions []WritingSubmission `json:"writing_submissions,omitempty" gorm:"foreignKey:PromptID"` +} + +// WritingSubmission 写作提交模型 +type WritingSubmission struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:提交ID"` + UserID string `json:"user_id" gorm:"type:varchar(36);not null;index;comment:用户ID"` + PromptID string `json:"prompt_id" gorm:"type:varchar(36);not null;index;comment:题目ID"` + Content string `json:"content" gorm:"type:longtext;not null;comment:写作内容"` + WordCount int `json:"word_count" gorm:"type:int;comment:字数"` + TimeSpent int `json:"time_spent" gorm:"type:int;comment:用时(秒)"` + Score *float64 `json:"score" gorm:"type:decimal(5,2);comment:总分"` + GrammarScore *float64 `json:"grammar_score" gorm:"type:decimal(5,2);comment:语法得分"` + VocabScore *float64 `json:"vocab_score" gorm:"type:decimal(5,2);comment:词汇得分"` + CoherenceScore *float64 `json:"coherence_score" gorm:"type:decimal(5,2);comment:连贯性得分"` + Feedback *string `json:"feedback" gorm:"type:longtext;comment:AI反馈"` + Suggestions *string `json:"suggestions" gorm:"type:json;comment:改进建议(JSON数组)"` + StartedAt time.Time `json:"started_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:开始时间"` + SubmittedAt *time.Time `json:"submitted_at" gorm:"type:timestamp;comment:提交时间"` + GradedAt *time.Time `json:"graded_at" gorm:"type:timestamp;comment:批改时间"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + User User `json:"-" gorm:"foreignKey:UserID"` + Prompt WritingPrompt `json:"-" gorm:"foreignKey:PromptID"` +} + +// SpeakingScenario 口语场景模型 +type SpeakingScenario struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:场景ID"` + Title string `json:"title" gorm:"type:varchar(200);not null;comment:标题"` + Description string `json:"description" gorm:"type:text;not null;comment:场景描述"` + Context *string `json:"context" gorm:"type:text;comment:背景信息"` + Level string `json:"level" gorm:"type:enum('beginner','intermediate','advanced');not null;comment:难度级别"` + Category string `json:"category" gorm:"type:varchar(50);comment:分类"` + Tags *string `json:"tags" gorm:"type:json;comment:标签(JSON数组)"` + Dialogue *string `json:"dialogue" gorm:"type:json;comment:对话模板(JSON数组)"` + KeyPhrases *string `json:"key_phrases" gorm:"type:json;comment:关键短语(JSON数组)"` + IsActive bool `json:"is_active" gorm:"type:boolean;default:true;comment:是否启用"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + DeletedAt gorm.DeletedAt `json:"-" gorm:"index;comment:删除时间"` + + // 关联关系 + SpeakingRecords []SpeakingRecord `json:"speaking_records,omitempty" gorm:"foreignKey:ScenarioID"` +} + +// SpeakingRecord 口语练习记录模型 +type SpeakingRecord struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:记录ID"` + UserID string `json:"user_id" gorm:"type:varchar(36);not null;index;comment:用户ID"` + ScenarioID string `json:"scenario_id" gorm:"type:varchar(36);not null;index;comment:场景ID"` + AudioURL *string `json:"audio_url" gorm:"type:varchar(500);comment:录音URL"` + Transcript *string `json:"transcript" gorm:"type:longtext;comment:语音识别文本"` + Duration int `json:"duration" gorm:"type:int;comment:录音时长(秒)"` + PronunciationScore *float64 `json:"pronunciation_score" gorm:"type:decimal(5,2);comment:发音得分"` + FluencyScore *float64 `json:"fluency_score" gorm:"type:decimal(5,2);comment:流利度得分"` + AccuracyScore *float64 `json:"accuracy_score" gorm:"type:decimal(5,2);comment:准确度得分"` + OverallScore *float64 `json:"overall_score" gorm:"type:decimal(5,2);comment:总分"` + Feedback *string `json:"feedback" gorm:"type:longtext;comment:AI反馈"` + Suggestions *string `json:"suggestions" gorm:"type:json;comment:改进建议(JSON数组)"` + StartedAt time.Time `json:"started_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:开始时间"` + CompletedAt *time.Time `json:"completed_at" gorm:"type:timestamp;comment:完成时间"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + User User `json:"-" gorm:"foreignKey:UserID"` + Scenario SpeakingScenario `json:"-" gorm:"foreignKey:ScenarioID"` +} + +// TableName 指定表名 +func (ListeningMaterial) TableName() string { + return "ai_listening_materials" +} + +func (ListeningRecord) TableName() string { + return "ai_listening_records" +} + +func (ReadingMaterial) TableName() string { + return "ai_reading_materials" +} + +func (ReadingRecord) TableName() string { + return "ai_reading_records" +} + +func (WritingPrompt) TableName() string { + return "ai_writing_prompts" +} + +func (WritingSubmission) TableName() string { + return "ai_writing_submissions" +} + +func (SpeakingScenario) TableName() string { + return "ai_speaking_scenarios" +} + +func (SpeakingRecord) TableName() string { + return "ai_speaking_records" +} \ No newline at end of file diff --git a/serve/internal/models/notification.go b/serve/internal/models/notification.go new file mode 100644 index 0000000..8bc3426 --- /dev/null +++ b/serve/internal/models/notification.go @@ -0,0 +1,44 @@ +package models + +import ( + "time" + + "gorm.io/gorm" +) + +// Notification 通知模型 +type Notification struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:通知ID"` + UserID int64 `json:"user_id" gorm:"type:bigint;not null;index;comment:用户ID"` + Type string `json:"type" gorm:"type:varchar(50);not null;index;comment:通知类型"` + Title string `json:"title" gorm:"type:varchar(255);not null;comment:通知标题"` + Content string `json:"content" gorm:"type:text;not null;comment:通知内容"` + Link *string `json:"link" gorm:"type:varchar(500);comment:跳转链接"` + IsRead bool `json:"is_read" gorm:"type:boolean;default:false;index;comment:是否已读"` + Priority int `json:"priority" gorm:"type:tinyint;default:0;comment:优先级:0-普通,1-重要,2-紧急"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;index;comment:创建时间"` + ReadAt *time.Time `json:"read_at" gorm:"type:timestamp;comment:阅读时间"` + DeletedAt gorm.DeletedAt `json:"-" gorm:"index;comment:删除时间"` + + // 关联关系 + User User `json:"-"` +} + +// TableName 指定表名 +func (Notification) TableName() string { + return "ai_notifications" +} + +// NotificationType 通知类型常量 +const ( + NotificationTypeSystem = "system" // 系统通知 + NotificationTypeLearning = "learning" // 学习提醒 + NotificationTypeAchievement = "achievement" // 成就通知 +) + +// NotificationPriority 通知优先级常量 +const ( + NotificationPriorityNormal = 0 // 普通 + NotificationPriorityImportant = 1 // 重要 + NotificationPriorityUrgent = 2 // 紧急 +) diff --git a/serve/internal/models/study_plan.go b/serve/internal/models/study_plan.go new file mode 100644 index 0000000..912a272 --- /dev/null +++ b/serve/internal/models/study_plan.go @@ -0,0 +1,59 @@ +package models + +import ( + "time" + + "gorm.io/gorm" +) + +// StudyPlan 学习计划模型 +type StudyPlan struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:计划ID"` + UserID int64 `json:"user_id" gorm:"type:bigint;not null;index;comment:用户ID"` + BookID *string `json:"book_id" gorm:"type:varchar(36);index;comment:词汇书ID(可选)"` + PlanName string `json:"plan_name" gorm:"type:varchar(200);not null;comment:计划名称"` + Description *string `json:"description" gorm:"type:text;comment:计划描述"` + DailyGoal int `json:"daily_goal" gorm:"type:int;not null;default:20;comment:每日目标单词数"` + TotalWords int `json:"total_words" gorm:"type:int;default:0;comment:计划总单词数"` + LearnedWords int `json:"learned_words" gorm:"type:int;default:0;comment:已学单词数"` + StartDate time.Time `json:"start_date" gorm:"type:date;not null;comment:开始日期"` + EndDate *time.Time `json:"end_date" gorm:"type:date;comment:结束日期"` + Status string `json:"status" gorm:"type:enum('active','paused','completed','cancelled');default:'active';comment:计划状态"` + RemindTime *string `json:"remind_time" gorm:"type:varchar(10);comment:提醒时间(HH:mm格式)"` + RemindDays *string `json:"remind_days" gorm:"type:varchar(20);comment:提醒日期(1,2,3..7表示周一到周日)"` + IsRemindEnabled bool `json:"is_remind_enabled" gorm:"type:boolean;default:false;comment:是否启用提醒"` + LastStudyDate *time.Time `json:"last_study_date" gorm:"type:date;comment:最后学习日期"` + StreakDays int `json:"streak_days" gorm:"type:int;default:0;comment:连续学习天数"` + CompletedAt *time.Time `json:"completed_at" gorm:"type:timestamp;comment:完成时间"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + DeletedAt gorm.DeletedAt `json:"-" gorm:"index;comment:删除时间"` + + // 关联关系 + User User `json:"-" gorm:"foreignKey:UserID"` + Book *VocabularyBook `json:"book,omitempty" gorm:"-"` +} + +func (StudyPlan) TableName() string { + return "ai_study_plans" +} + +// StudyPlanRecord 学习计划完成记录 +type StudyPlanRecord struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:记录ID"` + PlanID int64 `json:"plan_id" gorm:"type:bigint;not null;index;comment:计划ID"` + UserID int64 `json:"user_id" gorm:"type:bigint;not null;index;comment:用户ID"` + StudyDate time.Time `json:"study_date" gorm:"type:date;not null;index;comment:学习日期"` + WordsStudied int `json:"words_studied" gorm:"type:int;default:0;comment:学习单词数"` + GoalCompleted bool `json:"goal_completed" gorm:"type:boolean;default:false;comment:是否完成目标"` + StudyDuration int `json:"study_duration" gorm:"type:int;default:0;comment:学习时长(分钟)"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + + // 关联关系 + Plan StudyPlan `json:"-" gorm:"foreignKey:PlanID"` + User User `json:"-" gorm:"foreignKey:UserID"` +} + +func (StudyPlanRecord) TableName() string { + return "ai_study_plan_records" +} diff --git a/serve/internal/models/test.go b/serve/internal/models/test.go new file mode 100644 index 0000000..983bd5b --- /dev/null +++ b/serve/internal/models/test.go @@ -0,0 +1,190 @@ +package models + +import ( + "time" +) + +// TestType 测试类型 +type TestType string + +const ( + TestTypeQuick TestType = "quick" // 快速测试 + TestTypeComprehensive TestType = "comprehensive" // 综合测试 + TestTypeDaily TestType = "daily" // 每日测试 + TestTypeCustom TestType = "custom" // 自定义测试 +) + +// TestDifficulty 测试难度 +type TestDifficulty string + +const ( + TestDifficultyBeginner TestDifficulty = "beginner" // 初级 + TestDifficultyIntermediate TestDifficulty = "intermediate" // 中级 + TestDifficultyAdvanced TestDifficulty = "advanced" // 高级 +) + +// TestStatus 测试状态 +type TestStatus string + +const ( + TestStatusPending TestStatus = "pending" // 待开始 + TestStatusInProgress TestStatus = "in_progress" // 进行中 + TestStatusPaused TestStatus = "paused" // 已暂停 + TestStatusCompleted TestStatus = "completed" // 已完成 + TestStatusAbandoned TestStatus = "abandoned" // 已放弃 +) + +// SkillType 技能类型 +type SkillType string + +const ( + SkillTypeVocabulary SkillType = "vocabulary" // 词汇 + SkillTypeGrammar SkillType = "grammar" // 语法 + SkillTypeReading SkillType = "reading" // 阅读 + SkillTypeListening SkillType = "listening" // 听力 + SkillTypeSpeaking SkillType = "speaking" // 口语 + SkillTypeWriting SkillType = "writing" // 写作 +) + +// QuestionType 题目类型 +type QuestionType string + +const ( + QuestionTypeSingleChoice QuestionType = "single_choice" // 单选题 + QuestionTypeMultipleChoice QuestionType = "multiple_choice" // 多选题 + QuestionTypeTrueFalse QuestionType = "true_false" // 判断题 + QuestionTypeFillBlank QuestionType = "fill_blank" // 填空题 + QuestionTypeShortAnswer QuestionType = "short_answer" // 简答题 +) + +// TestTemplate 测试模板 +type TestTemplate struct { + ID string `json:"id" gorm:"primaryKey;type:varchar(36)"` + Title string `json:"title" gorm:"type:varchar(255);not null"` + Description string `json:"description" gorm:"type:text"` + Type TestType `json:"type" gorm:"type:varchar(50);not null"` + Difficulty TestDifficulty `json:"difficulty" gorm:"type:varchar(50)"` + Duration int `json:"duration" gorm:"comment:测试时长(秒)"` + TotalQuestions int `json:"total_questions" gorm:"comment:总题目数"` + PassingScore int `json:"passing_score" gorm:"comment:及格分数"` + MaxScore int `json:"max_score" gorm:"comment:最高分数"` + QuestionConfig string `json:"question_config" gorm:"type:json;comment:题目配置"` + SkillDistribution string `json:"skill_distribution" gorm:"type:json;comment:技能分布"` + IsActive bool `json:"is_active" gorm:"default:true"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` +} + +// TableName 指定表名 +func (TestTemplate) TableName() string { + return "test_templates" +} + +// TestQuestion 测试题目 +type TestQuestion struct { + ID string `json:"id" gorm:"primaryKey;type:varchar(36)"` + TemplateID string `json:"template_id" gorm:"type:varchar(36);index"` + QuestionType QuestionType `json:"question_type" gorm:"type:varchar(50);not null"` + SkillType SkillType `json:"skill_type" gorm:"type:varchar(50);not null"` + Difficulty TestDifficulty `json:"difficulty" gorm:"type:varchar(50)"` + Content string `json:"content" gorm:"type:text;not null;comment:题目内容"` + Options string `json:"options" gorm:"type:json;comment:选项(JSON数组)"` + CorrectAnswer string `json:"correct_answer" gorm:"type:text;comment:正确答案"` + Explanation string `json:"explanation" gorm:"type:text;comment:答案解析"` + Points int `json:"points" gorm:"default:1;comment:分值"` + OrderIndex int `json:"order_index" gorm:"comment:题目顺序"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` +} + +// TableName 指定表名 +func (TestQuestion) TableName() string { + return "test_questions" +} + +// TestSession 测试会话 +type TestSession struct { + ID string `json:"id" gorm:"primaryKey;type:varchar(36)"` + TemplateID string `json:"template_id" gorm:"type:varchar(36);not null;index"` + UserID string `json:"user_id" gorm:"type:varchar(36);not null;index"` + Status TestStatus `json:"status" gorm:"type:varchar(50);not null;default:'pending'"` + StartTime *time.Time `json:"start_time"` + EndTime *time.Time `json:"end_time"` + PausedAt *time.Time `json:"paused_at"` + TimeRemaining int `json:"time_remaining" gorm:"comment:剩余时间(秒)"` + CurrentQuestionIndex int `json:"current_question_index" gorm:"default:0"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` + + // 关联 + Template *TestTemplate `json:"template,omitempty" gorm:"foreignKey:TemplateID"` + Questions []TestQuestion `json:"questions,omitempty" gorm:"many2many:test_session_questions"` + Answers []TestAnswer `json:"answers,omitempty" gorm:"foreignKey:SessionID"` +} + +// TableName 指定表名 +func (TestSession) TableName() string { + return "test_sessions" +} + +// TestAnswer 测试答案 +type TestAnswer struct { + ID string `json:"id" gorm:"primaryKey;type:varchar(36)"` + SessionID string `json:"session_id" gorm:"type:varchar(36);not null;index"` + QuestionID string `json:"question_id" gorm:"type:varchar(36);not null;index"` + Answer string `json:"answer" gorm:"type:text;comment:用户答案"` + IsCorrect *bool `json:"is_correct" gorm:"comment:是否正确"` + Score int `json:"score" gorm:"default:0;comment:得分"` + TimeSpent int `json:"time_spent" gorm:"comment:答题用时(秒)"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` + + // 关联 + Question *TestQuestion `json:"question,omitempty" gorm:"foreignKey:QuestionID"` +} + +// TableName 指定表名 +func (TestAnswer) TableName() string { + return "test_answers" +} + +// TestResult 测试结果 +type TestResult struct { + ID string `json:"id" gorm:"primaryKey;type:varchar(36)"` + SessionID string `json:"session_id" gorm:"type:varchar(36);not null;unique;index"` + UserID string `json:"user_id" gorm:"type:varchar(36);not null;index"` + TemplateID string `json:"template_id" gorm:"type:varchar(36);not null;index"` + TotalScore int `json:"total_score" gorm:"comment:总得分"` + MaxScore int `json:"max_score" gorm:"comment:最高分"` + Percentage float64 `json:"percentage" gorm:"type:decimal(5,2);comment:得分百分比"` + CorrectCount int `json:"correct_count" gorm:"comment:正确题数"` + WrongCount int `json:"wrong_count" gorm:"comment:错误题数"` + SkippedCount int `json:"skipped_count" gorm:"comment:跳过题数"` + TimeSpent int `json:"time_spent" gorm:"comment:总用时(秒)"` + SkillScores string `json:"skill_scores" gorm:"type:json;comment:各技能得分"` + Passed bool `json:"passed" gorm:"comment:是否通过"` + CompletedAt time.Time `json:"completed_at"` + CreatedAt time.Time `json:"created_at"` + UpdatedAt time.Time `json:"updated_at"` + + // 关联 + Session *TestSession `json:"session,omitempty" gorm:"foreignKey:SessionID"` + Template *TestTemplate `json:"template,omitempty" gorm:"foreignKey:TemplateID"` +} + +// TableName 指定表名 +func (TestResult) TableName() string { + return "test_results" +} + +// TestSessionQuestion 测试会话题目关联表 +type TestSessionQuestion struct { + SessionID string `gorm:"primaryKey;type:varchar(36)"` + QuestionID string `gorm:"primaryKey;type:varchar(36)"` + OrderIndex int `gorm:"comment:题目顺序"` +} + +// TableName 指定表名 +func (TestSessionQuestion) TableName() string { + return "test_session_questions" +} diff --git a/serve/internal/models/user.go b/serve/internal/models/user.go new file mode 100644 index 0000000..c6df31f --- /dev/null +++ b/serve/internal/models/user.go @@ -0,0 +1,84 @@ +package models + +import ( + "time" + + "gorm.io/gorm" +) + +// User 用户模型 +type User struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:用户ID"` + Username string `json:"username" gorm:"type:varchar(50);uniqueIndex;not null;comment:用户名"` + Email string `json:"email" gorm:"type:varchar(100);uniqueIndex;not null;comment:邮箱"` + Phone *string `json:"phone" gorm:"type:varchar(20);uniqueIndex;comment:手机号"` + PasswordHash string `json:"-" gorm:"type:varchar(255);not null;comment:密码哈希"` + Nickname *string `json:"nickname" gorm:"type:varchar(100);comment:昵称"` + Avatar *string `json:"avatar" gorm:"type:varchar(500);comment:头像URL"` + Gender *string `json:"gender" gorm:"type:enum('male','female','other');comment:性别"` + BirthDate *time.Time `json:"birth_date" gorm:"type:date;comment:出生日期"` + Bio *string `json:"bio" gorm:"type:text;comment:个人简介"` + Location *string `json:"location" gorm:"type:varchar(100);comment:所在地"` + Timezone string `json:"timezone" gorm:"type:varchar(50);default:'Asia/Shanghai';comment:时区"` + Language string `json:"language" gorm:"type:varchar(10);default:'zh-CN';comment:界面语言"` + EmailVerified bool `json:"email_verified" gorm:"type:boolean;default:false;comment:邮箱是否验证"` + PhoneVerified bool `json:"phone_verified" gorm:"type:boolean;default:false;comment:手机是否验证"` + Status string `json:"status" gorm:"type:enum('active','inactive','suspended','deleted');default:'active';comment:账户状态"` + LastLoginAt *time.Time `json:"last_login_at" gorm:"type:timestamp;comment:最后登录时间"` + LastLoginIP *string `json:"last_login_ip" gorm:"type:varchar(45);comment:最后登录IP"` + LoginCount int `json:"login_count" gorm:"type:int;default:0;comment:登录次数"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + DeletedAt gorm.DeletedAt `json:"-" gorm:"index;comment:删除时间"` + + // 关联关系 + SocialLinks []UserSocialLink `json:"social_links,omitempty"` + Preferences *UserPreference `json:"preferences,omitempty"` + VocabularyProgress []UserVocabularyProgress `json:"vocabulary_progress,omitempty"` +} + +// UserSocialLink 用户社交链接模型 +type UserSocialLink struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:ID"` + UserID int64 `json:"user_id" gorm:"type:bigint;not null;index;comment:用户ID"` + Platform string `json:"platform" gorm:"type:varchar(50);not null;comment:平台名称"` + URL string `json:"url" gorm:"type:varchar(500);not null;comment:链接地址"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + User User `json:"-"` +} + +// UserPreference 用户偏好设置模型 +type UserPreference struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:ID"` + UserID int64 `json:"user_id" gorm:"type:bigint;uniqueIndex;not null;comment:用户ID"` + DailyGoal int `json:"daily_goal" gorm:"type:int;default:50;comment:每日学习目标(分钟)"` + WeeklyGoal int `json:"weekly_goal" gorm:"type:int;default:350;comment:每周学习目标(分钟)"` + ReminderEnabled bool `json:"reminder_enabled" gorm:"type:boolean;default:true;comment:是否启用提醒"` + ReminderTime *string `json:"reminder_time" gorm:"type:time;comment:提醒时间"` + DifficultyLevel string `json:"difficulty_level" gorm:"type:enum('beginner','intermediate','advanced');default:'beginner';comment:难度级别"` + LearningMode string `json:"learning_mode" gorm:"type:enum('casual','intensive','exam_prep');default:'casual';comment:学习模式"` + PreferredTopics *string `json:"preferred_topics" gorm:"type:json;comment:偏好话题(JSON数组)"` + NotificationSettings *string `json:"notification_settings" gorm:"type:json;comment:通知设置(JSON对象)"` + PrivacySettings *string `json:"privacy_settings" gorm:"type:json;comment:隐私设置(JSON对象)"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + User User `json:"-"` +} + +// TableName 指定表名 +func (User) TableName() string { + return "ai_users" +} + +func (UserSocialLink) TableName() string { + return "ai_user_social_links" +} + +func (UserPreference) TableName() string { + return "ai_user_preferences" +} \ No newline at end of file diff --git a/serve/internal/models/user_test.go b/serve/internal/models/user_test.go new file mode 100644 index 0000000..eb164a0 --- /dev/null +++ b/serve/internal/models/user_test.go @@ -0,0 +1,314 @@ +package models + +import ( + "testing" + "time" +) + +// TestUser tests the User model +func TestUser(t *testing.T) { + t.Run("Create User", func(t *testing.T) { + user := &User{ + Username: "testuser", + Email: "test@example.com", + PasswordHash: "hashedpassword", + Status: "active", + Timezone: "Asia/Shanghai", + Language: "zh-CN", + } + + if user.Username != "testuser" { + t.Errorf("Expected username 'testuser', got '%s'", user.Username) + } + + if user.Email != "test@example.com" { + t.Errorf("Expected email 'test@example.com', got '%s'", user.Email) + } + + if user.Status != "active" { + t.Errorf("Expected status 'active', got '%s'", user.Status) + } + }) + + t.Run("User Validation", func(t *testing.T) { + tests := []struct { + name string + user User + expected bool + }{ + { + name: "Valid User", + user: User{ + Username: "validuser", + Email: "valid@example.com", + PasswordHash: "validpassword", + Status: "active", + }, + expected: true, + }, + { + name: "Empty Username", + user: User{ + Username: "", + Email: "valid@example.com", + PasswordHash: "validpassword", + }, + expected: false, + }, + { + name: "Empty Email", + user: User{ + Username: "validuser", + Email: "", + PasswordHash: "validpassword", + }, + expected: false, + }, + { + name: "Empty Password", + user: User{ + Username: "validuser", + Email: "valid@example.com", + PasswordHash: "", + }, + expected: false, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + isValid := validateUser(tt.user) + if isValid != tt.expected { + t.Errorf("Expected %v, got %v", tt.expected, isValid) + } + }) + } + }) + + t.Run("User Timestamps", func(t *testing.T) { + user := &User{ + Username: "testuser", + Email: "test@example.com", + PasswordHash: "hashedpassword", + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + if user.CreatedAt.IsZero() { + t.Error("CreatedAt should not be zero") + } + + if user.UpdatedAt.IsZero() { + t.Error("UpdatedAt should not be zero") + } + }) +} + +// validateUser is a helper function for testing user validation +func validateUser(user User) bool { + if user.Username == "" { + return false + } + if user.Email == "" { + return false + } + if user.PasswordHash == "" { + return false + } + return true +} + +// TestUserPreference tests the UserPreference model +func TestUserPreference(t *testing.T) { + t.Run("Create UserPreference", func(t *testing.T) { + preference := &UserPreference{ + UserID: 1, + DailyGoal: 50, + WeeklyGoal: 350, + ReminderEnabled: true, + DifficultyLevel: "beginner", + LearningMode: "casual", + } + + if preference.UserID != 1 { + t.Errorf("Expected UserID 1, got %d", preference.UserID) + } + + if preference.DailyGoal != 50 { + t.Errorf("Expected DailyGoal 50, got %d", preference.DailyGoal) + } + + if preference.DifficultyLevel != "beginner" { + t.Errorf("Expected DifficultyLevel 'beginner', got '%s'", preference.DifficultyLevel) + } + }) + + t.Run("Preference Validation", func(t *testing.T) { + tests := []struct { + name string + preference UserPreference + expected bool + }{ + { + name: "Valid Preference", + preference: UserPreference{ + UserID: 1, + DailyGoal: 50, + WeeklyGoal: 350, + DifficultyLevel: "beginner", + LearningMode: "casual", + }, + expected: true, + }, + { + name: "Invalid UserID", + preference: UserPreference{ + UserID: 0, + DailyGoal: 50, + DifficultyLevel: "beginner", + }, + expected: false, + }, + { + name: "Negative Daily Goal", + preference: UserPreference{ + UserID: 1, + DailyGoal: -10, + DifficultyLevel: "beginner", + }, + expected: false, + }, + { + name: "Invalid Difficulty Level", + preference: UserPreference{ + UserID: 1, + DailyGoal: 50, + DifficultyLevel: "invalid", + }, + expected: false, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + isValid := validateUserPreference(tt.preference) + if isValid != tt.expected { + t.Errorf("Expected %v, got %v", tt.expected, isValid) + } + }) + } + }) +} + +// validateUserPreference is a helper function for testing user preference validation +func validateUserPreference(preference UserPreference) bool { + if preference.UserID <= 0 { + return false + } + if preference.DailyGoal < 0 || preference.WeeklyGoal < 0 { + return false + } + validDifficultyLevels := []string{"beginner", "intermediate", "advanced"} + validDifficulty := false + for _, level := range validDifficultyLevels { + if preference.DifficultyLevel == level { + validDifficulty = true + break + } + } + if !validDifficulty { + return false + } + return true +} + +// TestUserSocialLink tests the UserSocialLink model +func TestUserSocialLink(t *testing.T) { + t.Run("Create UserSocialLink", func(t *testing.T) { + socialLink := &UserSocialLink{ + UserID: 1, + Platform: "github", + URL: "https://github.com/testuser", + } + + if socialLink.UserID != 1 { + t.Errorf("Expected UserID 1, got %d", socialLink.UserID) + } + + if socialLink.Platform != "github" { + t.Errorf("Expected Platform 'github', got '%s'", socialLink.Platform) + } + + if socialLink.URL != "https://github.com/testuser" { + t.Errorf("Expected URL 'https://github.com/testuser', got '%s'", socialLink.URL) + } + }) + + t.Run("Social Link Validation", func(t *testing.T) { + tests := []struct { + name string + socialLink UserSocialLink + expected bool + }{ + { + name: "Valid Social Link", + socialLink: UserSocialLink{ + UserID: 1, + Platform: "github", + URL: "https://github.com/testuser", + }, + expected: true, + }, + { + name: "Invalid UserID", + socialLink: UserSocialLink{ + UserID: 0, + Platform: "github", + URL: "https://github.com/testuser", + }, + expected: false, + }, + { + name: "Empty Platform", + socialLink: UserSocialLink{ + UserID: 1, + Platform: "", + URL: "https://github.com/testuser", + }, + expected: false, + }, + { + name: "Empty URL", + socialLink: UserSocialLink{ + UserID: 1, + Platform: "github", + URL: "", + }, + expected: false, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + isValid := validateUserSocialLink(tt.socialLink) + if isValid != tt.expected { + t.Errorf("Expected %v, got %v", tt.expected, isValid) + } + }) + } + }) +} + +// validateUserSocialLink is a helper function for testing user social link validation +func validateUserSocialLink(socialLink UserSocialLink) bool { + if socialLink.UserID <= 0 { + return false + } + if socialLink.Platform == "" { + return false + } + if socialLink.URL == "" { + return false + } + return true +} \ No newline at end of file diff --git a/serve/internal/models/vocabulary.go b/serve/internal/models/vocabulary.go new file mode 100644 index 0000000..185f785 --- /dev/null +++ b/serve/internal/models/vocabulary.go @@ -0,0 +1,282 @@ +package models + +import ( + "time" + + "gorm.io/gorm" +) + +// VocabularyCategory 词汇分类模型 +type VocabularyCategory struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:分类ID"` + Name string `json:"name" gorm:"type:varchar(100);not null;comment:分类名称"` + Description *string `json:"description" gorm:"type:text;comment:分类描述"` + Level string `json:"level" gorm:"type:enum('beginner','intermediate','advanced');not null;comment:难度级别"` + Icon *string `json:"icon" gorm:"type:varchar(255);comment:图标URL"` + Color *string `json:"color" gorm:"type:varchar(7);comment:主题色"` + SortOrder int `json:"sort_order" gorm:"type:int;default:0;comment:排序"` + IsActive bool `json:"is_active" gorm:"type:boolean;default:true;comment:是否启用"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + Vocabularies []Vocabulary `json:"vocabularies,omitempty" gorm:"many2many:ai_vocabulary_category_relations;foreignKey:ID;joinForeignKey:CategoryID;References:ID;joinReferences:VocabularyID;"` +} + +// Vocabulary 词汇模型 +type Vocabulary struct { + ID int64 `json:"id" gorm:"column:id;primaryKey;autoIncrement;comment:词汇ID"` + Word string `json:"word" gorm:"column:word;type:varchar(100);uniqueIndex;not null;comment:单词"` + Phonetic *string `json:"phonetic" gorm:"column:phonetic;type:varchar(200);comment:音标"` + AudioURL *string `json:"audio_url" gorm:"column:audio_url;type:varchar(500);comment:音频URL"` + Level string `json:"level" gorm:"column:level;type:enum('beginner','intermediate','advanced');not null;comment:难度级别"` + Frequency int `json:"frequency" gorm:"column:frequency;type:int;default:0;comment:使用频率"` + IsActive bool `json:"is_active" gorm:"column:is_active;type:boolean;default:true;comment:是否启用"` + CreatedAt time.Time `json:"created_at" gorm:"column:created_at;type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"column:updated_at;type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + DeletedAt gorm.DeletedAt `json:"-" gorm:"column:deleted_at;index;comment:删除时间"` + + // 关联关系 + Definitions []VocabularyDefinition `json:"definitions,omitempty" gorm:"foreignKey:VocabularyID"` + Examples []VocabularyExample `json:"examples,omitempty" gorm:"foreignKey:VocabularyID"` + Images []VocabularyImage `json:"images,omitempty" gorm:"foreignKey:VocabularyID"` + Categories []VocabularyCategory `json:"categories,omitempty" gorm:"many2many:ai_vocabulary_category_relations;foreignKey:ID;joinForeignKey:VocabularyID;References:ID;joinReferences:CategoryID;"` + UserProgress []UserVocabularyProgress `json:"user_progress,omitempty" gorm:"foreignKey:VocabularyID"` +} + +// VocabularyDefinition 词汇定义模型 +type VocabularyDefinition struct { + ID int64 `json:"id" gorm:"column:id;primaryKey;autoIncrement;comment:定义ID"` + VocabularyID int64 `json:"vocabulary_id" gorm:"column:vocabulary_id;not null;index;comment:词汇ID"` + PartOfSpeech string `json:"part_of_speech" gorm:"column:part_of_speech;type:varchar(20);not null;comment:词性"` + Definition string `json:"definition" gorm:"column:definition_en;type:text;not null;comment:英文定义"` + Translation string `json:"translation" gorm:"column:definition_cn;type:text;not null;comment:中文翻译"` + SortOrder int `json:"sort_order" gorm:"column:sort_order;type:int;default:0;comment:排序"` + CreatedAt time.Time `json:"created_at" gorm:"column:created_at;type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + + // 关联关系 + Vocabulary Vocabulary `json:"-" gorm:"foreignKey:VocabularyID"` +} + +// VocabularyExample 词汇例句模型 +type VocabularyExample struct { + ID int64 `json:"id" gorm:"column:id;primaryKey;autoIncrement;comment:例句ID"` + VocabularyID int64 `json:"vocabulary_id" gorm:"column:vocabulary_id;not null;index;comment:词汇ID"` + Example string `json:"example" gorm:"column:sentence_en;type:text;not null;comment:英文例句"` + Translation string `json:"translation" gorm:"column:sentence_cn;type:text;not null;comment:中文翻译"` + AudioURL *string `json:"audio_url" gorm:"column:audio_url;type:varchar(500);comment:音频URL"` + SortOrder int `json:"sort_order" gorm:"column:sort_order;type:int;default:0;comment:排序"` + CreatedAt time.Time `json:"created_at" gorm:"column:created_at;type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + + // 关联关系 + Vocabulary Vocabulary `json:"-" gorm:"foreignKey:VocabularyID"` +} + +// VocabularyImage 词汇图片模型 +type VocabularyImage struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:图片ID"` + VocabularyID string `json:"vocabulary_id" gorm:"type:varchar(36);not null;index;comment:词汇ID"` + ImageURL string `json:"image_url" gorm:"type:varchar(500);not null;comment:图片URL"` + AltText *string `json:"alt_text" gorm:"type:varchar(255);comment:替代文本"` + Caption *string `json:"caption" gorm:"type:text;comment:图片说明"` + SortOrder int `json:"sort_order" gorm:"type:int;default:0;comment:排序"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + Vocabulary Vocabulary `json:"-" gorm:"foreignKey:VocabularyID"` +} + +// VocabularyCategoryRelation 词汇分类关系模型 +type VocabularyCategoryRelation struct { + VocabularyID string `json:"vocabulary_id" gorm:"type:varchar(36);primaryKey;comment:词汇ID"` + CategoryID string `json:"category_id" gorm:"type:varchar(36);primaryKey;comment:分类ID"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` +} + +// UserVocabularyProgress 用户词汇学习进度模型 +type UserVocabularyProgress struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:进度ID"` + UserID int64 `json:"user_id" gorm:"type:bigint;not null;index;comment:用户ID"` + VocabularyID string `json:"vocabulary_id" gorm:"type:varchar(36);not null;index;comment:词汇ID"` + MasteryLevel int `json:"mastery_level" gorm:"type:int;default:0;comment:掌握程度(0-100)"` + StudyCount int `json:"study_count" gorm:"type:int;default:0;comment:学习次数"` + CorrectCount int `json:"correct_count" gorm:"type:int;default:0;comment:正确次数"` + IncorrectCount int `json:"incorrect_count" gorm:"type:int;default:0;comment:错误次数"` + LastStudiedAt *time.Time `json:"last_studied_at" gorm:"type:timestamp;comment:最后学习时间"` + NextReviewAt *time.Time `json:"next_review_at" gorm:"type:timestamp;comment:下次复习时间"` + IsMarkedDifficult bool `json:"is_marked_difficult" gorm:"type:boolean;default:false;comment:是否标记为困难"` + IsFavorite bool `json:"is_favorite" gorm:"type:boolean;default:false;comment:是否收藏"` + Notes *string `json:"notes" gorm:"type:text;comment:学习笔记"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + User User `json:"-" gorm:"foreignKey:UserID"` + Vocabulary Vocabulary `json:"-" gorm:"foreignKey:VocabularyID"` +} + +// UserWordProgress 用户单词学习进度模型 +type UserWordProgress struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:进度ID"` + UserID int64 `json:"user_id" gorm:"type:bigint;not null;index:idx_user_vocab;comment:用户ID"` + VocabularyID int64 `json:"vocabulary_id" gorm:"type:bigint;not null;index:idx_user_vocab;comment:单词ID"` + Status string `json:"status" gorm:"type:varchar(20);default:'not_started';comment:学习状态"` + StudyCount int `json:"study_count" gorm:"type:int;default:0;comment:学习次数"` + CorrectCount int `json:"correct_count" gorm:"type:int;default:0;comment:正确次数"` + WrongCount int `json:"wrong_count" gorm:"type:int;default:0;comment:错误次数"` + Proficiency int `json:"proficiency" gorm:"type:int;default:0;comment:熟练度(0-100)"` + IsFavorite bool `json:"is_favorite" gorm:"type:boolean;default:false;comment:是否收藏"` + NextReviewAt *time.Time `json:"next_review_at" gorm:"type:timestamp;comment:下次复习时间"` + ReviewInterval int `json:"review_interval" gorm:"type:int;default:1;comment:复习间隔(天)"` + FirstStudiedAt time.Time `json:"first_studied_at" gorm:"type:timestamp;comment:首次学习时间"` + LastStudiedAt time.Time `json:"last_studied_at" gorm:"type:timestamp;comment:最后学习时间"` + MasteredAt *time.Time `json:"mastered_at" gorm:"type:timestamp;comment:掌握时间"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + User User `json:"-" gorm:"foreignKey:UserID"` + Vocabulary Vocabulary `json:"-" gorm:"foreignKey:VocabularyID"` +} + +// VocabularyTest 词汇测试模型 +type VocabularyTest struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:测试ID"` + UserID int64 `json:"user_id" gorm:"type:bigint;not null;index;comment:用户ID"` + TestType string `json:"test_type" gorm:"type:enum('placement','progress','review');not null;comment:测试类型"` + Level string `json:"level" gorm:"type:enum('beginner','intermediate','advanced');comment:测试级别"` + TotalWords int `json:"total_words" gorm:"type:int;not null;comment:总词汇数"` + CorrectWords int `json:"correct_words" gorm:"type:int;default:0;comment:正确词汇数"` + Score float64 `json:"score" gorm:"type:decimal(5,2);comment:得分"` + Duration int `json:"duration" gorm:"type:int;comment:测试时长(秒)"` + StartedAt time.Time `json:"started_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:开始时间"` + CompletedAt *time.Time `json:"completed_at" gorm:"type:timestamp;comment:完成时间"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系 + User User `json:"-" gorm:"foreignKey:UserID"` +} + +// TableName 指定表名 +func (VocabularyCategory) TableName() string { + return "ai_vocabulary_categories" +} + +func (Vocabulary) TableName() string { + return "ai_vocabulary" +} + +func (VocabularyDefinition) TableName() string { + return "ai_vocabulary_definitions" +} + +func (VocabularyExample) TableName() string { + return "ai_vocabulary_examples" +} + +func (VocabularyImage) TableName() string { + return "ai_vocabulary_images" +} + +func (VocabularyCategoryRelation) TableName() string { + return "ai_vocabulary_category_relations" +} + +func (UserVocabularyProgress) TableName() string { + return "ai_user_vocabulary_progress" +} + +func (VocabularyTest) TableName() string { + return "ai_vocabulary_tests" +} + +// VocabularyBook 词汇书模型 +type VocabularyBook struct { + ID string `json:"id" gorm:"type:varchar(36);primaryKey;comment:词汇书ID"` + Name string `json:"name" gorm:"type:varchar(200);not null;comment:词汇书名称"` + Description *string `json:"description" gorm:"type:text;comment:词汇书描述"` + Category string `json:"category" gorm:"type:varchar(100);not null;comment:分类"` + Level string `json:"level" gorm:"type:enum('beginner','elementary','intermediate','advanced','expert');not null;comment:难度级别"` + TotalWords int `json:"total_words" gorm:"type:int;default:0;comment:总单词数"` + CoverImage *string `json:"cover_image" gorm:"type:varchar(500);comment:封面图片URL"` + Icon *string `json:"icon" gorm:"type:varchar(255);comment:图标"` + Color *string `json:"color" gorm:"type:varchar(7);comment:主题色"` + IsSystem bool `json:"is_system" gorm:"type:boolean;default:true;comment:是否系统词汇书"` + IsActive bool `json:"is_active" gorm:"type:boolean;default:true;comment:是否启用"` + SortOrder int `json:"sort_order" gorm:"type:int;default:0;comment:排序"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` + + // 关联关系（不使用外键约束） + Words []VocabularyBookWord `json:"words,omitempty" gorm:"-"` +} + +// VocabularyBookWord 词汇书单词关联模型 +type VocabularyBookWord struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:关联ID"` + BookID string `json:"book_id" gorm:"type:varchar(36);not null;index;comment:词汇书ID"` + VocabularyID string `json:"vocabulary_id" gorm:"type:varchar(36);not null;index;comment:词汇ID"` + SortOrder int `json:"sort_order" gorm:"type:int;default:0;comment:排序"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + + // 关联关系（不使用外键约束） + Book VocabularyBook `json:"-" gorm:"-"` + Vocabulary *Vocabulary `json:"word,omitempty" gorm:"-"` +} + +func (VocabularyBook) TableName() string { + return "ai_vocabulary_books" +} + +func (VocabularyBookWord) TableName() string { + return "ai_vocabulary_book_words" +} + +func (UserWordProgress) TableName() string { + return "ai_user_word_progress" +} + +// LearningSession 学习会话模型 +type LearningSession struct { + ID int64 `json:"id" gorm:"type:bigint;primaryKey;autoIncrement;comment:会话ID"` + UserID int64 `json:"user_id" gorm:"type:bigint;not null;index;comment:用户ID"` + BookID string `json:"book_id" gorm:"type:varchar(36);not null;index;comment:词汇书ID"` + DailyGoal int `json:"daily_goal" gorm:"type:int;default:20;comment:每日学习目标"` + NewWordsCount int `json:"new_words_count" gorm:"type:int;default:0;comment:新学单词数"` + ReviewCount int `json:"review_count" gorm:"type:int;default:0;comment:复习单词数"` + MasteredCount int `json:"mastered_count" gorm:"type:int;default:0;comment:掌握单词数"` + StartedAt time.Time `json:"started_at" gorm:"type:timestamp;comment:开始时间"` + CompletedAt *time.Time `json:"completed_at" gorm:"type:timestamp;comment:完成时间"` + CreatedAt time.Time `json:"created_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP;comment:创建时间"` + UpdatedAt time.Time `json:"updated_at" gorm:"type:timestamp;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;comment:更新时间"` +} + +func (LearningSession) TableName() string { + return "ai_learning_sessions" +} + +// UserVocabularyBookProgress 用户词汇书学习进度 +type UserVocabularyBookProgress struct { + ID int64 `gorm:"primaryKey;autoIncrement" json:"id"` + UserID int64 `gorm:"not null;index:idx_user_book" json:"user_id"` + BookID string `gorm:"type:varchar(36);not null;index:idx_user_book" json:"book_id"` + LearnedWords int `gorm:"default:0" json:"learned_words"` + MasteredWords int `gorm:"default:0" json:"mastered_words"` + ProgressPercentage float64 `gorm:"type:decimal(5,2);default:0.00" json:"progress_percentage"` + StreakDays int `gorm:"default:0" json:"streak_days"` + TotalStudyDays int `gorm:"default:0" json:"total_study_days"` + AverageDailyWords float64 `gorm:"type:decimal(5,2);default:0.00" json:"average_daily_words"` + EstimatedCompletionDate *time.Time `json:"estimated_completion_date"` + IsCompleted bool `gorm:"default:false" json:"is_completed"` + CompletedAt *time.Time `json:"completed_at"` + StartedAt time.Time `gorm:"not null" json:"started_at"` + LastStudiedAt time.Time `json:"last_studied_at"` + CreatedAt time.Time `gorm:"autoCreateTime" json:"created_at"` + UpdatedAt time.Time `gorm:"autoUpdateTime" json:"updated_at"` +} + +func (UserVocabularyBookProgress) TableName() string { + return "user_vocabulary_book_progress" +} \ No newline at end of file diff --git a/serve/internal/models/vocabulary_test.go b/serve/internal/models/vocabulary_test.go new file mode 100644 index 0000000..cdfa1e5 --- /dev/null +++ b/serve/internal/models/vocabulary_test.go @@ -0,0 +1,482 @@ +package models + +import ( + "testing" + "time" +) + +// TestVocabulary tests the Vocabulary model +func TestVocabulary(t *testing.T) { + t.Run("Create Vocabulary", func(t *testing.T) { + vocab := &Vocabulary{ + ID: "vocab-123", + Word: "hello", + Level: "beginner", + Frequency: 100, + IsActive: true, + } + + if vocab.Word != "hello" { + t.Errorf("Expected word 'hello', got '%s'", vocab.Word) + } + + if vocab.Level != "beginner" { + t.Errorf("Expected level 'beginner', got '%s'", vocab.Level) + } + + if vocab.Frequency != 100 { + t.Errorf("Expected frequency 100, got %d", vocab.Frequency) + } + }) + + t.Run("Vocabulary Validation", func(t *testing.T) { + tests := []struct { + name string + vocab Vocabulary + expected bool + }{ + { + name: "Valid Vocabulary", + vocab: Vocabulary{ + ID: "vocab-123", + Word: "test", + Level: "beginner", + Frequency: 50, + }, + expected: true, + }, + { + name: "Empty Word", + vocab: Vocabulary{ + ID: "vocab-123", + Word: "", + Level: "beginner", + }, + expected: false, + }, + { + name: "Invalid Level", + vocab: Vocabulary{ + ID: "vocab-123", + Word: "test", + Level: "invalid", + }, + expected: false, + }, + { + name: "Negative Frequency", + vocab: Vocabulary{ + ID: "vocab-123", + Word: "test", + Level: "beginner", + Frequency: -1, + }, + expected: false, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + isValid := validateVocabulary(tt.vocab) + if isValid != tt.expected { + t.Errorf("Expected %v, got %v", tt.expected, isValid) + } + }) + } + }) +} + +// validateVocabulary is a helper function for testing vocabulary validation +func validateVocabulary(vocab Vocabulary) bool { + if vocab.Word == "" { + return false + } + validLevels := []string{"beginner", "intermediate", "advanced"} + validLevel := false + for _, level := range validLevels { + if vocab.Level == level { + validLevel = true + break + } + } + if !validLevel { + return false + } + if vocab.Frequency < 0 { + return false + } + return true +} + +// TestVocabularyCategory tests the VocabularyCategory model +func TestVocabularyCategory(t *testing.T) { + t.Run("Create VocabularyCategory", func(t *testing.T) { + category := &VocabularyCategory{ + ID: "cat-123", + Name: "Animals", + Level: "beginner", + SortOrder: 1, + IsActive: true, + } + + if category.Name != "Animals" { + t.Errorf("Expected name 'Animals', got '%s'", category.Name) + } + + if category.Level != "beginner" { + t.Errorf("Expected level 'beginner', got '%s'", category.Level) + } + + if category.SortOrder != 1 { + t.Errorf("Expected sort order 1, got %d", category.SortOrder) + } + }) + + t.Run("Category Validation", func(t *testing.T) { + tests := []struct { + name string + category VocabularyCategory + expected bool + }{ + { + name: "Valid Category", + category: VocabularyCategory{ + ID: "cat-123", + Name: "Animals", + Level: "beginner", + SortOrder: 1, + }, + expected: true, + }, + { + name: "Empty Name", + category: VocabularyCategory{ + ID: "cat-123", + Name: "", + Level: "beginner", + }, + expected: false, + }, + { + name: "Invalid Level", + category: VocabularyCategory{ + ID: "cat-123", + Name: "Animals", + Level: "invalid", + }, + expected: false, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + isValid := validateVocabularyCategory(tt.category) + if isValid != tt.expected { + t.Errorf("Expected %v, got %v", tt.expected, isValid) + } + }) + } + }) +} + +// validateVocabularyCategory is a helper function for testing vocabulary category validation +func validateVocabularyCategory(category VocabularyCategory) bool { + if category.Name == "" { + return false + } + validLevels := []string{"beginner", "intermediate", "advanced"} + validLevel := false + for _, level := range validLevels { + if category.Level == level { + validLevel = true + break + } + } + return validLevel +} + +// TestVocabularyDefinition tests the VocabularyDefinition model +func TestVocabularyDefinition(t *testing.T) { + t.Run("Create VocabularyDefinition", func(t *testing.T) { + definition := &VocabularyDefinition{ + ID: "def-123", + VocabularyID: "vocab-123", + PartOfSpeech: "noun", + Definition: "A greeting or expression of goodwill", + SortOrder: 1, + } + + if definition.PartOfSpeech != "noun" { + t.Errorf("Expected part of speech 'noun', got '%s'", definition.PartOfSpeech) + } + + if definition.Definition != "A greeting or expression of goodwill" { + t.Errorf("Expected definition 'A greeting or expression of goodwill', got '%s'", definition.Definition) + } + }) + + t.Run("Definition Validation", func(t *testing.T) { + tests := []struct { + name string + definition VocabularyDefinition + expected bool + }{ + { + name: "Valid Definition", + definition: VocabularyDefinition{ + ID: "def-123", + VocabularyID: "vocab-123", + PartOfSpeech: "noun", + Definition: "A greeting", + }, + expected: true, + }, + { + name: "Empty VocabularyID", + definition: VocabularyDefinition{ + ID: "def-123", + VocabularyID: "", + PartOfSpeech: "noun", + Definition: "A greeting", + }, + expected: false, + }, + { + name: "Empty Definition", + definition: VocabularyDefinition{ + ID: "def-123", + VocabularyID: "vocab-123", + PartOfSpeech: "noun", + Definition: "", + }, + expected: false, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + isValid := validateVocabularyDefinition(tt.definition) + if isValid != tt.expected { + t.Errorf("Expected %v, got %v", tt.expected, isValid) + } + }) + } + }) +} + +// validateVocabularyDefinition is a helper function for testing vocabulary definition validation +func validateVocabularyDefinition(definition VocabularyDefinition) bool { + if definition.VocabularyID == "" { + return false + } + if definition.Definition == "" { + return false + } + return true +} + +// TestUserVocabularyProgress tests the UserVocabularyProgress model +func TestUserVocabularyProgress(t *testing.T) { + t.Run("Create UserVocabularyProgress", func(t *testing.T) { + now := time.Now() + progress := &UserVocabularyProgress{ + UserID: 1, + VocabularyID: "vocab-123", + MasteryLevel: 75, + StudyCount: 10, + CorrectCount: 8, + IncorrectCount: 2, + LastStudiedAt: &now, + IsMarkedDifficult: false, + IsFavorite: true, + } + + if progress.UserID != 1 { + t.Errorf("Expected UserID 1, got %d", progress.UserID) + } + + if progress.MasteryLevel != 75 { + t.Errorf("Expected MasteryLevel 75, got %d", progress.MasteryLevel) + } + + if progress.StudyCount != 10 { + t.Errorf("Expected StudyCount 10, got %d", progress.StudyCount) + } + }) + + t.Run("Progress Validation", func(t *testing.T) { + tests := []struct { + name string + progress UserVocabularyProgress + expected bool + }{ + { + name: "Valid Progress", + progress: UserVocabularyProgress{ + UserID: 1, + VocabularyID: "vocab-123", + MasteryLevel: 75, + StudyCount: 10, + }, + expected: true, + }, + { + name: "Invalid UserID", + progress: UserVocabularyProgress{ + UserID: 0, + VocabularyID: "vocab-123", + MasteryLevel: 75, + }, + expected: false, + }, + { + name: "Invalid MasteryLevel", + progress: UserVocabularyProgress{ + UserID: 1, + VocabularyID: "vocab-123", + MasteryLevel: 150, // Over 100 + }, + expected: false, + }, + { + name: "Empty VocabularyID", + progress: UserVocabularyProgress{ + UserID: 1, + VocabularyID: "", + MasteryLevel: 75, + }, + expected: false, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + isValid := validateUserVocabularyProgress(tt.progress) + if isValid != tt.expected { + t.Errorf("Expected %v, got %v", tt.expected, isValid) + } + }) + } + }) +} + +// validateUserVocabularyProgress is a helper function for testing user vocabulary progress validation +func validateUserVocabularyProgress(progress UserVocabularyProgress) bool { + if progress.UserID <= 0 { + return false + } + if progress.VocabularyID == "" { + return false + } + if progress.MasteryLevel < 0 || progress.MasteryLevel > 100 { + return false + } + return true +} + +// TestVocabularyTest tests the VocabularyTest model +func TestVocabularyTest(t *testing.T) { + t.Run("Create VocabularyTest", func(t *testing.T) { + test := &VocabularyTest{ + UserID: 1, + TestType: "placement", + Level: "beginner", + TotalWords: 20, + CorrectWords: 15, + Score: 75.0, + Duration: 300, // 5 minutes + StartedAt: time.Now(), + } + + if test.UserID != 1 { + t.Errorf("Expected UserID 1, got %d", test.UserID) + } + + if test.TestType != "placement" { + t.Errorf("Expected TestType 'placement', got '%s'", test.TestType) + } + + if test.Score != 75.0 { + t.Errorf("Expected Score 75.0, got %f", test.Score) + } + }) + + t.Run("Test Validation", func(t *testing.T) { + tests := []struct { + name string + test VocabularyTest + expected bool + }{ + { + name: "Valid Test", + test: VocabularyTest{ + UserID: 1, + TestType: "placement", + Level: "beginner", + TotalWords: 20, + CorrectWords: 15, + }, + expected: true, + }, + { + name: "Invalid UserID", + test: VocabularyTest{ + UserID: 0, + TestType: "placement", + TotalWords: 20, + }, + expected: false, + }, + { + name: "Invalid TestType", + test: VocabularyTest{ + UserID: 1, + TestType: "invalid", + TotalWords: 20, + }, + expected: false, + }, + { + name: "Correct Words Greater Than Total", + test: VocabularyTest{ + UserID: 1, + TestType: "placement", + TotalWords: 20, + CorrectWords: 25, + }, + expected: false, + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + isValid := validateVocabularyTest(tt.test) + if isValid != tt.expected { + t.Errorf("Expected %v, got %v", tt.expected, isValid) + } + }) + } + }) +} + +// validateVocabularyTest is a helper function for testing vocabulary test validation +func validateVocabularyTest(test VocabularyTest) bool { + if test.UserID <= 0 { + return false + } + validTestTypes := []string{"placement", "progress", "review"} + validTestType := false + for _, testType := range validTestTypes { + if test.TestType == testType { + validTestType = true + break + } + } + if !validTestType { + return false + } + if test.CorrectWords > test.TotalWords { + return false + } + return true +} \ No newline at end of file diff --git a/serve/internal/service/ai_service.go b/serve/internal/service/ai_service.go new file mode 100644 index 0000000..a883233 --- /dev/null +++ b/serve/internal/service/ai_service.go @@ -0,0 +1,309 @@ +package service + +import ( + "bytes" + "context" + "encoding/json" + "fmt" + "io" + "net/http" + "os" + "strings" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/model" +) + +// AIService AI服务接口 +type AIService interface { + // 写作批改 + CorrectWriting(ctx context.Context, content string, taskType string) (*model.WritingCorrection, error) + // 口语评估 + EvaluateSpeaking(ctx context.Context, audioText string, prompt string) (*model.SpeakingEvaluation, error) + // 智能推荐 + GetRecommendations(ctx context.Context, userLevel string, learningHistory []string) (*model.AIRecommendation, error) + // 生成练习题 + GenerateExercise(ctx context.Context, content string, exerciseType string) (*model.Exercise, error) +} + +type aiService struct { + apiKey string + baseURL string + client *http.Client +} + +// NewAIService 创建AI服务实例 +func NewAIService() AIService { + apiKey := os.Getenv("OPENAI_API_KEY") + baseURL := os.Getenv("OPENAI_BASE_URL") + if baseURL == "" { + baseURL = "https://api.openai.com/v1" + } + + return &aiService{ + apiKey: apiKey, + baseURL: baseURL, + client: &http.Client{ + Timeout: 30 * time.Second, + }, + } +} + +// OpenAI API请求结构 +type openAIRequest struct { + Model string `json:"model"` + Messages []message `json:"messages"` + MaxTokens int `json:"max_tokens"` + Temperature float64 `json:"temperature"` +} + +type message struct { + Role string `json:"role"` + Content string `json:"content"` +} + +type openAIResponse struct { + Choices []struct { + Message message `json:"message"` + } `json:"choices"` + Error *struct { + Message string `json:"message"` + Type string `json:"type"` + } `json:"error,omitempty"` +} + +// callOpenAI 调用OpenAI API +func (s *aiService) callOpenAI(ctx context.Context, prompt string) (string, error) { + if s.apiKey == "" { + return "", fmt.Errorf("OpenAI API key not configured") + } + + reqBody := openAIRequest{ + Model: "gpt-3.5-turbo", + Messages: []message{ + { + Role: "user", + Content: prompt, + }, + }, + MaxTokens: 1000, + Temperature: 0.7, + } + + jsonData, err := json.Marshal(reqBody) + if err != nil { + return "", fmt.Errorf("failed to marshal request: %w", err) + } + + req, err := http.NewRequestWithContext(ctx, "POST", s.baseURL+"/chat/completions", bytes.NewBuffer(jsonData)) + if err != nil { + return "", fmt.Errorf("failed to create request: %w", err) + } + + req.Header.Set("Content-Type", "application/json") + req.Header.Set("Authorization", "Bearer "+s.apiKey) + + resp, err := s.client.Do(req) + if err != nil { + return "", fmt.Errorf("failed to send request: %w", err) + } + defer resp.Body.Close() + + body, err := io.ReadAll(resp.Body) + if err != nil { + return "", fmt.Errorf("failed to read response: %w", err) + } + + var openAIResp openAIResponse + if err := json.Unmarshal(body, &openAIResp); err != nil { + return "", fmt.Errorf("failed to unmarshal response: %w", err) + } + + if openAIResp.Error != nil { + return "", fmt.Errorf("OpenAI API error: %s", openAIResp.Error.Message) + } + + if len(openAIResp.Choices) == 0 { + return "", fmt.Errorf("no response from OpenAI") + } + + return openAIResp.Choices[0].Message.Content, nil +} + +// CorrectWriting 写作批改 +func (s *aiService) CorrectWriting(ctx context.Context, content string, taskType string) (*model.WritingCorrection, error) { + prompt := fmt.Sprintf(`请对以下英语写作进行批改，任务类型：%s + +写作内容： +%s + +请按照以下JSON格式返回批改结果： +{ + "overall_score": 85, + "grammar_score": 80, + "vocabulary_score": 90, + "structure_score": 85, + "content_score": 88, + "corrections": [ + { + "original": "错误的句子", + "corrected": "修正后的句子", + "explanation": "修改说明", + "error_type": "grammar" + } + ], + "suggestions": [ + "建议1", + "建议2" + ], + "strengths": [ + "优点1", + "优点2" + ], + "weaknesses": [ + "需要改进的地方1", + "需要改进的地方2" + ] +}`, taskType, content) + + response, err := s.callOpenAI(ctx, prompt) + if err != nil { + return nil, err + } + + // 解析JSON响应 + var correction model.WritingCorrection + if err := json.Unmarshal([]byte(response), &correction); err != nil { + // 如果JSON解析失败，返回基本的批改结果 + return &model.WritingCorrection{ + OverallScore: 75, + Suggestions: []string{"AI批改服务暂时不可用，请稍后重试"}, + }, nil + } + + return &correction, nil +} + +// EvaluateSpeaking 口语评估 +func (s *aiService) EvaluateSpeaking(ctx context.Context, audioText string, prompt string) (*model.SpeakingEvaluation, error) { + evalPrompt := fmt.Sprintf(`请对以下英语口语进行评估，题目：%s + +口语内容： +%s + +请按照以下JSON格式返回评估结果： +{ + "overall_score": 85, + "pronunciation_score": 80, + "fluency_score": 90, + "grammar_score": 85, + "vocabulary_score": 88, + "feedback": "整体评价", + "strengths": [ + "优点1", + "优点2" + ], + "improvements": [ + "需要改进的地方1", + "需要改进的地方2" + ] +}`, prompt, audioText) + + response, err := s.callOpenAI(ctx, evalPrompt) + if err != nil { + return nil, err + } + + // 解析JSON响应 + var evaluation model.SpeakingEvaluation + if err := json.Unmarshal([]byte(response), &evaluation); err != nil { + // 如果JSON解析失败，返回基本的评估结果 + return &model.SpeakingEvaluation{ + OverallScore: 75, + Feedback: "AI评估服务暂时不可用，请稍后重试", + }, nil + } + + return &evaluation, nil +} + +// GetRecommendations 智能推荐 +func (s *aiService) GetRecommendations(ctx context.Context, userLevel string, learningHistory []string) (*model.AIRecommendation, error) { + historyStr := strings.Join(learningHistory, ", ") + prompt := fmt.Sprintf(`基于用户的英语水平（%s）和学习历史（%s），请提供个性化的学习推荐。 + +请按照以下JSON格式返回推荐结果： +{ + "recommended_topics": [ + "推荐主题1", + "推荐主题2" + ], + "difficulty_level": "intermediate", + "study_plan": [ + "学习计划步骤1", + "学习计划步骤2" + ], + "focus_areas": [ + "重点关注领域1", + "重点关注领域2" + ] +}`, userLevel, historyStr) + + response, err := s.callOpenAI(ctx, prompt) + if err != nil { + return nil, err + } + + // 解析JSON响应 + var recommendation model.AIRecommendation + if err := json.Unmarshal([]byte(response), &recommendation); err != nil { + // 如果JSON解析失败，返回基本的推荐结果 + return &model.AIRecommendation{ + RecommendedTopics: []string{"基础语法练习", "日常对话练习"}, + DifficultyLevel: "beginner", + StudyPlan: []string{"每天练习30分钟", "重点关注基础词汇"}, + }, nil + } + + return &recommendation, nil +} + +// GenerateExercise 生成练习题 +func (s *aiService) GenerateExercise(ctx context.Context, content string, exerciseType string) (*model.Exercise, error) { + prompt := fmt.Sprintf(`基于以下内容生成%s类型的练习题： + +内容： +%s + +请按照以下JSON格式返回练习题： +{ + "title": "练习题标题", + "instructions": "练习说明", + "questions": [ + { + "question": "问题1", + "options": ["选项A", "选项B", "选项C", "选项D"], + "correct_answer": "正确答案", + "explanation": "解释" + } + ] +}`, exerciseType, content) + + response, err := s.callOpenAI(ctx, prompt) + if err != nil { + return nil, err + } + + // 解析JSON响应 + var exercise model.Exercise + if err := json.Unmarshal([]byte(response), &exercise); err != nil { + // 如果JSON解析失败，返回基本的练习题 + return &model.Exercise{ + Title: "基础练习", + Instructions: "AI练习生成服务暂时不可用，请稍后重试", + Questions: []model.Question{}, + }, nil + } + + return &exercise, nil +} \ No newline at end of file diff --git a/serve/internal/service/upload_service.go b/serve/internal/service/upload_service.go new file mode 100644 index 0000000..c1eade2 --- /dev/null +++ b/serve/internal/service/upload_service.go @@ -0,0 +1,226 @@ +package service + +import ( + "fmt" + "io" + "mime/multipart" + "os" + "path/filepath" + "strings" + "time" + + "github.com/google/uuid" +) + +// UploadService 文件上传服务接口 +type UploadService interface { + // 上传音频文件 + UploadAudio(file *multipart.FileHeader) (*UploadResult, error) + // 上传图片文件 + UploadImage(file *multipart.FileHeader) (*UploadResult, error) + // 删除文件 + DeleteFile(filePath string) error + // 获取文件URL + GetFileURL(filePath string) string +} + +type uploadService struct { + uploadDir string + baseURL string +} + +// UploadResult 上传结果 +type UploadResult struct { + FileName string `json:"file_name"` + FilePath string `json:"file_path"` + FileURL string `json:"file_url"` + FileSize int64 `json:"file_size"` + ContentType string `json:"content_type"` +} + +// NewUploadService 创建文件上传服务实例 +func NewUploadService(uploadDir, baseURL string) UploadService { + // 确保上传目录存在 + os.MkdirAll(uploadDir, 0755) + os.MkdirAll(filepath.Join(uploadDir, "audio"), 0755) + os.MkdirAll(filepath.Join(uploadDir, "images"), 0755) + + return &uploadService{ + uploadDir: uploadDir, + baseURL: baseURL, + } +} + +// 允许的文件类型 +var ( + allowedAudioTypes = map[string]bool{ + "audio/mpeg": true, // mp3 + "audio/wav": true, // wav + "audio/mp4": true, // m4a + "audio/webm": true, // webm + "audio/ogg": true, // ogg + } + + allowedImageTypes = map[string]bool{ + "image/jpeg": true, // jpg, jpeg + "image/png": true, // png + "image/gif": true, // gif + "image/webp": true, // webp + } + + // 文件大小限制（字节） + maxAudioSize = 50 * 1024 * 1024 // 50MB + maxImageSize = 10 * 1024 * 1024 // 10MB +) + +// UploadAudio 上传音频文件 +func (s *uploadService) UploadAudio(file *multipart.FileHeader) (*UploadResult, error) { + // 检查文件大小 + if file.Size > int64(maxAudioSize) { + return nil, fmt.Errorf("audio file too large, max size is %d MB", maxAudioSize/(1024*1024)) + } + + // 检查文件类型 + contentType := file.Header.Get("Content-Type") + if !allowedAudioTypes[contentType] { + return nil, fmt.Errorf("unsupported audio format: %s", contentType) + } + + // 生成唯一文件名 + ext := filepath.Ext(file.Filename) + fileName := fmt.Sprintf("%s_%d%s", uuid.New().String(), time.Now().Unix(), ext) + relativePath := filepath.Join("audio", fileName) + fullPath := filepath.Join(s.uploadDir, relativePath) + + // 保存文件 + if err := s.saveFile(file, fullPath); err != nil { + return nil, fmt.Errorf("failed to save audio file: %w", err) + } + + return &UploadResult{ + FileName: fileName, + FilePath: relativePath, + FileURL: s.GetFileURL(relativePath), + FileSize: file.Size, + ContentType: contentType, + }, nil +} + +// UploadImage 上传图片文件 +func (s *uploadService) UploadImage(file *multipart.FileHeader) (*UploadResult, error) { + // 检查文件大小 + if file.Size > int64(maxImageSize) { + return nil, fmt.Errorf("image file too large, max size is %d MB", maxImageSize/(1024*1024)) + } + + // 检查文件类型 + contentType := file.Header.Get("Content-Type") + if !allowedImageTypes[contentType] { + return nil, fmt.Errorf("unsupported image format: %s", contentType) + } + + // 生成唯一文件名 + ext := filepath.Ext(file.Filename) + fileName := fmt.Sprintf("%s_%d%s", uuid.New().String(), time.Now().Unix(), ext) + relativePath := filepath.Join("images", fileName) + fullPath := filepath.Join(s.uploadDir, relativePath) + + // 保存文件 + if err := s.saveFile(file, fullPath); err != nil { + return nil, fmt.Errorf("failed to save image file: %w", err) + } + + return &UploadResult{ + FileName: fileName, + FilePath: relativePath, + FileURL: s.GetFileURL(relativePath), + FileSize: file.Size, + ContentType: contentType, + }, nil +} + +// saveFile 保存文件到磁盘 +func (s *uploadService) saveFile(fileHeader *multipart.FileHeader, destPath string) error { + // 确保目录存在 + dir := filepath.Dir(destPath) + if err := os.MkdirAll(dir, 0755); err != nil { + return fmt.Errorf("failed to create directory: %w", err) + } + + // 打开上传的文件 + src, err := fileHeader.Open() + if err != nil { + return fmt.Errorf("failed to open uploaded file: %w", err) + } + defer src.Close() + + // 创建目标文件 + dst, err := os.Create(destPath) + if err != nil { + return fmt.Errorf("failed to create destination file: %w", err) + } + defer dst.Close() + + // 复制文件内容 + _, err = io.Copy(dst, src) + if err != nil { + return fmt.Errorf("failed to copy file content: %w", err) + } + + return nil +} + +// DeleteFile 删除文件 +func (s *uploadService) DeleteFile(filePath string) error { + // 安全检查：确保文件路径在上传目录内 + if !strings.HasPrefix(filePath, s.uploadDir) { + fullPath := filepath.Join(s.uploadDir, filePath) + filePath = fullPath + } + + // 检查文件是否存在 + if _, err := os.Stat(filePath); os.IsNotExist(err) { + return fmt.Errorf("file does not exist: %s", filePath) + } + + // 删除文件 + if err := os.Remove(filePath); err != nil { + return fmt.Errorf("failed to delete file: %w", err) + } + + return nil +} + +// GetFileURL 获取文件URL +func (s *uploadService) GetFileURL(filePath string) string { + // 清理路径分隔符 + cleanPath := strings.ReplaceAll(filePath, "\\", "/") + return fmt.Sprintf("%s/uploads/%s", s.baseURL, cleanPath) +} + +// ValidateFileType 验证文件类型 +func ValidateFileType(filename string, allowedTypes map[string]bool) bool { + ext := strings.ToLower(filepath.Ext(filename)) + switch ext { + case ".mp3": + return allowedTypes["audio/mpeg"] + case ".wav": + return allowedTypes["audio/wav"] + case ".m4a": + return allowedTypes["audio/mp4"] + case ".webm": + return allowedTypes["audio/webm"] + case ".ogg": + return allowedTypes["audio/ogg"] + case ".jpg", ".jpeg": + return allowedTypes["image/jpeg"] + case ".png": + return allowedTypes["image/png"] + case ".gif": + return allowedTypes["image/gif"] + case ".webp": + return allowedTypes["image/webp"] + default: + return false + } +} \ No newline at end of file diff --git a/serve/internal/service/user_service.go b/serve/internal/service/user_service.go new file mode 100644 index 0000000..d7f9290 --- /dev/null +++ b/serve/internal/service/user_service.go @@ -0,0 +1,80 @@ +package service + +import ( + "errors" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/model" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/database" +) + +type UserService struct { + userRepo *database.UserRepository +} + +func NewUserService(userRepo *database.UserRepository) *UserService { + return &UserService{userRepo: userRepo} +} + +// 用户注册 +func (s *UserService) Register(username, email, password string) (string, error) { + // 检查用户是否已存在 + if _, err := s.userRepo.GetByEmail(email); err == nil { + return "", errors.New("用户已存在") + } + + // 创建新用户 + user := &model.User{ + Username: username, + Email: email, + Password: password, // 实际应用中需要加密 + } + + userID, err := s.userRepo.Create(user) + if err != nil { + return "", err + } + + return userID, nil +} + +// 用户登录 +func (s *UserService) Login(email, password string) (string, string, error) { + user, err := s.userRepo.GetByEmail(email) + if err != nil { + return "", "", errors.New("用户不存在") + } + + // 实际应用中需要验证密码 + if user.Password != password { + return "", "", errors.New("密码错误") + } + + // 生成 token (实际应用中应使用 JWT 等) + token := "fake-token-" + user.ID + + return token, user.ID, nil +} + +// 获取用户信息 +func (s *UserService) GetProfile(userID string) (*model.User, error) { + user, err := s.userRepo.GetByID(userID) + if err != nil { + return nil, errors.New("用户不存在") + } + + return user, nil +} + +// 更新用户信息 +func (s *UserService) UpdateProfile(userID, username, avatar string) error { + user, err := s.userRepo.GetByID(userID) + if err != nil { + return errors.New("用户不存在") + } + + user.Username = username + if avatar != "" { + user.Avatar = avatar + } + + return s.userRepo.Update(user) +} \ No newline at end of file diff --git a/serve/internal/services/learning_session_service.go b/serve/internal/services/learning_session_service.go new file mode 100644 index 0000000..c7002b7 --- /dev/null +++ b/serve/internal/services/learning_session_service.go @@ -0,0 +1,510 @@ +package services + +import ( + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "gorm.io/gorm" +) + +// LearningSessionService 学习会话服务 +type LearningSessionService struct { + db *gorm.DB +} + +func NewLearningSessionService(db *gorm.DB) *LearningSessionService { + return &LearningSessionService{db: db} +} + +// StartLearningSession 开始学习会话 +func (s *LearningSessionService) StartLearningSession(userID int64, bookID string, dailyGoal int) (*models.LearningSession, error) { + now := time.Now() + today := time.Date(now.Year(), now.Month(), now.Day(), 0, 0, 0, 0, now.Location()) + + // 检查今天是否已有学习会话 + var existingSession models.LearningSession + err := s.db.Where("user_id = ? AND book_id = ? AND DATE(created_at) = ?", + userID, bookID, today.Format("2006-01-02")).First(&existingSession).Error + + if err == nil { + // 已存在会话，返回现有会话 + return &existingSession, nil + } + + if err != gorm.ErrRecordNotFound { + return nil, err + } + + // 创建新的学习会话 + session := &models.LearningSession{ + UserID: userID, + BookID: bookID, + DailyGoal: dailyGoal, + NewWordsCount: 0, + ReviewCount: 0, + MasteredCount: 0, + StartedAt: now, + } + + if err := s.db.Create(session).Error; err != nil { + return nil, err + } + + return session, nil +} + +// GetTodayLearningTasks 获取今日学习任务（新词+复习词） +// 学习逻辑：每天学习的单词 = 用户选择的新词数 + 当日所有需要复习的单词 +func (s *LearningSessionService) GetTodayLearningTasks(userID int64, bookID string, newWordsLimit int) (map[string]interface{}, error) { + now := time.Now() + + // 1. 获取所有需要复习的单词（到期的，不限数量） + var reviewWords []models.UserWordProgress + err := s.db.Raw(` + SELECT uwp.* + FROM ai_user_word_progress uwp + INNER JOIN ai_vocabulary_book_words vbw ON CAST(vbw.vocabulary_id AS UNSIGNED) = uwp.vocabulary_id + WHERE uwp.user_id = ? + AND vbw.book_id = ? + AND uwp.status IN ('learning', 'reviewing') + AND (uwp.next_review_at IS NULL OR uwp.next_review_at <= ?) + ORDER BY uwp.next_review_at ASC + `, userID, bookID, now).Scan(&reviewWords).Error + + if err != nil { + return nil, err + } + + // 2. 获取新单词（从未学习的） + var newWords []int64 + err = s.db.Raw(` + SELECT CAST(vbw.vocabulary_id AS UNSIGNED) as id + FROM ai_vocabulary_book_words vbw + LEFT JOIN ai_user_word_progress uwp ON uwp.vocabulary_id = CAST(vbw.vocabulary_id AS UNSIGNED) AND uwp.user_id = ? + WHERE vbw.book_id = ? + AND uwp.id IS NULL + ORDER BY vbw.sort_order ASC + LIMIT ? + `, userID, bookID, newWordsLimit).Scan(&newWords).Error + + if err != nil { + return nil, err + } + + // 3. 获取已掌握的单词统计 + var masteredCount int64 + s.db.Model(&models.UserWordProgress{}). + Joins("INNER JOIN ai_vocabulary_book_words vbw ON CAST(vbw.vocabulary_id AS UNSIGNED) = ai_user_word_progress.vocabulary_id"). + Where("ai_user_word_progress.user_id = ? AND vbw.book_id = ? AND ai_user_word_progress.status = 'mastered'", + userID, bookID). + Count(&masteredCount) + + // 4. 获取词汇书总词数 + var totalWords int64 + s.db.Model(&models.VocabularyBookWord{}).Where("book_id = ?", bookID).Count(&totalWords) + + return map[string]interface{}{ + "newWords": newWords, + "reviewWords": reviewWords, + "masteredCount": masteredCount, + "totalWords": totalWords, + "progress": float64(masteredCount) / float64(totalWords) * 100, + }, nil +} + +// RecordWordStudy 记录单词学习结果 +func (s *LearningSessionService) RecordWordStudy(userID int64, wordID int64, difficulty string) (*models.UserWordProgress, error) { + now := time.Now() + + var progress models.UserWordProgress + err := s.db.Where("user_id = ? AND vocabulary_id = ?", userID, wordID).First(&progress).Error + + isNew := false + if err == gorm.ErrRecordNotFound { + isNew = true + // 创建新记录 + progress = models.UserWordProgress{ + UserID: userID, + VocabularyID: wordID, + Status: "learning", + StudyCount: 0, + CorrectCount: 0, + WrongCount: 0, + Proficiency: 0, + ReviewInterval: 1, + FirstStudiedAt: now, + LastStudiedAt: now, + } + } else if err != nil { + return nil, err + } + + // 更新学习统计 + progress.StudyCount++ + progress.LastStudiedAt = now + + // 根据难度更新进度和计算下次复习时间 + nextInterval := s.calculateNextInterval(progress.ReviewInterval, difficulty, progress.StudyCount) + + switch difficulty { + case "forgot": + // 完全忘记：重置 + progress.WrongCount++ + progress.Proficiency = max(0, progress.Proficiency-30) + progress.ReviewInterval = 1 + progress.Status = "learning" + progress.NextReviewAt = &[]time.Time{now.Add(24 * time.Hour)}[0] + + case "hard": + // 困难：小幅增加间隔 + progress.WrongCount++ + progress.Proficiency = max(0, progress.Proficiency-10) + progress.ReviewInterval = max(1, nextInterval/2) + nextReview := now.Add(time.Duration(progress.ReviewInterval) * 24 * time.Hour) + progress.NextReviewAt = &nextReview + + case "good": + // 一般：正常增加 + progress.CorrectCount++ + progress.Proficiency = min(100, progress.Proficiency+15) + progress.ReviewInterval = nextInterval + nextReview := now.Add(time.Duration(progress.ReviewInterval) * 24 * time.Hour) + progress.NextReviewAt = &nextReview + + // 更新状态 + if progress.StudyCount >= 3 && progress.Proficiency >= 60 { + progress.Status = "reviewing" + } + + case "easy": + // 容易：大幅增加间隔 + progress.CorrectCount++ + progress.Proficiency = min(100, progress.Proficiency+25) + progress.ReviewInterval = int(float64(nextInterval) * 1.5) + nextReview := now.Add(time.Duration(progress.ReviewInterval) * 24 * time.Hour) + progress.NextReviewAt = &nextReview + + // 更新状态 + if progress.StudyCount >= 2 && progress.Proficiency >= 70 { + progress.Status = "reviewing" + } + + case "perfect": + // 完美：最大间隔 + progress.CorrectCount++ + progress.Proficiency = 100 + progress.ReviewInterval = nextInterval * 2 + nextReview := now.Add(time.Duration(progress.ReviewInterval) * 24 * time.Hour) + progress.NextReviewAt = &nextReview + + // 达到掌握标准 + if progress.StudyCount >= 5 && progress.Proficiency >= 90 { + progress.Status = "mastered" + progress.MasteredAt = &now + } else { + progress.Status = "reviewing" + } + } + + // 保存或更新 + if isNew { + if err := s.db.Create(&progress).Error; err != nil { + return nil, err + } + } else { + if err := s.db.Save(&progress).Error; err != nil { + return nil, err + } + } + + // 更新今日学习会话的计数器 + s.updateTodaySessionStats(userID) + + return &progress, nil +} + +// updateTodaySessionStats 更新今日学习会话的统计数据 +func (s *LearningSessionService) updateTodaySessionStats(userID int64) { + now := time.Now() + today := time.Date(now.Year(), now.Month(), now.Day(), 0, 0, 0, 0, now.Location()) + + // 查找今日会话 + var session models.LearningSession + err := s.db.Where("user_id = ? AND DATE(created_at) = ?", userID, today.Format("2006-01-02")).First(&session).Error + if err != nil { + return // 没有会话就不更新 + } + + // 统计今日学习的单词 + var stats struct { + NewWords int64 + ReviewWords int64 + MasteredWords int64 + } + + // 今日新学单词（首次学习时间是今天） + s.db.Model(&models.UserWordProgress{}). + Where("user_id = ? AND DATE(first_studied_at) = ?", userID, today.Format("2006-01-02")). + Count(&stats.NewWords) + + // 今日复习单词（首次学习不是今天，但最后学习是今天） + s.db.Model(&models.UserWordProgress{}). + Where("user_id = ? AND DATE(first_studied_at) != ? AND DATE(last_studied_at) = ?", + userID, today.Format("2006-01-02"), today.Format("2006-01-02")). + Count(&stats.ReviewWords) + + // 今日掌握单词（掌握时间是今天） + s.db.Model(&models.UserWordProgress{}). + Where("user_id = ? AND DATE(mastered_at) = ?", userID, today.Format("2006-01-02")). + Count(&stats.MasteredWords) + + // 更新会话 + session.NewWordsCount = int(stats.NewWords) + session.ReviewCount = int(stats.ReviewWords) + session.MasteredCount = int(stats.MasteredWords) + + s.db.Save(&session) + + // 同时更新词汇书级别的进度 + s.updateBookProgress(userID, session.BookID) +} + +// updateBookProgress 更新词汇书级别的学习进度 +func (s *LearningSessionService) updateBookProgress(userID int64, bookID string) { + // 统计该词汇书的总体进度 + var progress struct { + TotalLearned int64 + TotalMastered int64 + } + + // 统计已学习的单词数（该词汇书中的所有已学习单词） + s.db.Raw(` + SELECT COUNT(DISTINCT uwp.vocabulary_id) as total_learned, + SUM(CASE WHEN uwp.status = 'mastered' THEN 1 ELSE 0 END) as total_mastered + FROM ai_user_word_progress uwp + INNER JOIN ai_vocabulary_book_words vbw ON CAST(vbw.vocabulary_id AS UNSIGNED) = uwp.vocabulary_id + WHERE uwp.user_id = ? AND vbw.book_id = ? + `, userID, bookID).Scan(&progress) + + // 获取词汇书总单词数 + var totalWords int64 + s.db.Model(&models.VocabularyBookWord{}).Where("book_id = ?", bookID).Count(&totalWords) + + // 计算进度百分比 + progressPercentage := 0.0 + if totalWords > 0 { + progressPercentage = float64(progress.TotalLearned) / float64(totalWords) * 100 + } + + // 更新或创建词汇书进度记录 + now := time.Now() + var bookProgress models.UserVocabularyBookProgress + err := s.db.Where("user_id = ? AND book_id = ?", userID, bookID).First(&bookProgress).Error + + if err == gorm.ErrRecordNotFound { + // 创建新记录 + bookProgress = models.UserVocabularyBookProgress{ + UserID: userID, + BookID: bookID, + LearnedWords: int(progress.TotalLearned), + MasteredWords: int(progress.TotalMastered), + ProgressPercentage: progressPercentage, + StartedAt: now, + LastStudiedAt: now, + } + s.db.Create(&bookProgress) + } else if err == nil { + // 更新现有记录 + bookProgress.LearnedWords = int(progress.TotalLearned) + bookProgress.MasteredWords = int(progress.TotalMastered) + bookProgress.ProgressPercentage = progressPercentage + bookProgress.LastStudiedAt = now + s.db.Save(&bookProgress) + } +} + +// calculateNextInterval 计算下次复习间隔（天数） +func (s *LearningSessionService) calculateNextInterval(currentInterval int, difficulty string, studyCount int) int { + // 基于SuperMemo SM-2算法的简化版本 + baseIntervals := []int{1, 3, 7, 14, 30, 60, 120, 240} + + if studyCount <= len(baseIntervals) { + return baseIntervals[min(studyCount-1, len(baseIntervals)-1)] + } + + // 超过基础序列后，根据难度调整 + switch difficulty { + case "forgot": + return 1 + case "hard": + return max(1, int(float64(currentInterval)*0.8)) + case "good": + return int(float64(currentInterval) * 1.5) + case "easy": + return int(float64(currentInterval) * 2.5) + case "perfect": + return currentInterval * 3 + default: + return currentInterval + } +} + +// UpdateSessionProgress 更新学习会话进度 +func (s *LearningSessionService) UpdateSessionProgress(sessionID int64, newWords, reviewWords, masteredWords int) error { + return s.db.Model(&models.LearningSession{}). + Where("id = ?", sessionID). + Updates(map[string]interface{}{ + "new_words_count": newWords, + "review_count": reviewWords, + "mastered_count": masteredWords, + "completed_at": time.Now(), + }).Error +} + +// GetLearningStatistics 获取学习统计 +func (s *LearningSessionService) GetLearningStatistics(userID int64, bookID string) (map[string]interface{}, error) { + // 今日学习统计 + now := time.Now() + today := time.Date(now.Year(), now.Month(), now.Day(), 0, 0, 0, 0, now.Location()) + + var todaySession models.LearningSession + s.db.Where("user_id = ? AND book_id = ? AND DATE(created_at) = ?", + userID, bookID, today.Format("2006-01-02")).First(&todaySession) + + // 总体统计 + var stats struct { + TotalLearned int64 + TotalMastered int64 + AvgProficiency float64 + } + + s.db.Model(&models.UserWordProgress{}). + Select("COUNT(*) as total_learned, SUM(CASE WHEN status = 'mastered' THEN 1 ELSE 0 END) as total_mastered, AVG(proficiency) as avg_proficiency"). + Joins("INNER JOIN ai_vocabulary_book_words vbw ON CAST(vbw.vocabulary_id AS UNSIGNED) = ai_user_word_progress.vocabulary_id"). + Where("ai_user_word_progress.user_id = ? AND vbw.book_id = ?", userID, bookID). + Scan(&stats) + + // 连续学习天数 + var streakDays int + s.db.Raw(` + SELECT COUNT(DISTINCT DATE(created_at)) + FROM ai_learning_sessions + WHERE user_id = ? AND book_id = ? + AND created_at >= DATE_SUB(CURDATE(), INTERVAL 30 DAY) + `, userID, bookID).Scan(&streakDays) + + return map[string]interface{}{ + "todayNewWords": todaySession.NewWordsCount, + "todayReview": todaySession.ReviewCount, + "todayMastered": todaySession.MasteredCount, + "totalLearned": stats.TotalLearned, + "totalMastered": stats.TotalMastered, + "avgProficiency": stats.AvgProficiency, + "streakDays": streakDays, + }, nil +} + +// GetTodayReviewWords 获取今日需要复习的所有单词（跨所有词汇书） +func (s *LearningSessionService) GetTodayReviewWords(userID int64) ([]map[string]interface{}, error) { + now := time.Now() + + // 获取所有到期需要复习的单词 + var reviewWords []models.UserWordProgress + err := s.db.Raw(` + SELECT uwp.* + FROM ai_user_word_progress uwp + WHERE uwp.user_id = ? + AND uwp.status IN ('learning', 'reviewing') + AND (uwp.next_review_at IS NULL OR uwp.next_review_at <= ?) + ORDER BY uwp.next_review_at ASC + LIMIT 100 + `, userID, now).Scan(&reviewWords).Error + + if err != nil { + return nil, err + } + + // 获取单词详情 + result := make([]map[string]interface{}, 0) + for _, progress := range reviewWords { + result = append(result, map[string]interface{}{ + "vocabulary_id": progress.VocabularyID, + "status": progress.Status, + "proficiency": progress.Proficiency, + "study_count": progress.StudyCount, + "next_review_at": progress.NextReviewAt, + "last_studied_at": progress.LastStudiedAt, + }) + } + + return result, nil +} + +// GetTodayOverallStatistics 获取今日总体学习统计（所有词汇书） +func (s *LearningSessionService) GetTodayOverallStatistics(userID int64) (map[string]interface{}, error) { + now := time.Now() + today := time.Date(now.Year(), now.Month(), now.Day(), 0, 0, 0, 0, now.Location()) + + // 今日学习的单词总数 + var todayStats struct { + NewWords int64 + ReviewWords int64 + TotalStudied int64 + } + + // 统计今日新学习的单词 + s.db.Model(&models.UserWordProgress{}). + Where("user_id = ? AND DATE(first_studied_at) = ?", userID, today.Format("2006-01-02")). + Count(&todayStats.NewWords) + + // 统计今日复习的单词（今天学习但不是第一次） + s.db.Model(&models.UserWordProgress{}). + Where("user_id = ? AND DATE(first_studied_at) != ? AND DATE(last_studied_at) = ?", + userID, today.Format("2006-01-02"), today.Format("2006-01-02")). + Count(&todayStats.ReviewWords) + + todayStats.TotalStudied = todayStats.NewWords + todayStats.ReviewWords + + // 总体统计 + var totalStats struct { + TotalLearned int64 + TotalMastered int64 + } + + s.db.Model(&models.UserWordProgress{}). + Select("COUNT(*) as total_learned, SUM(CASE WHEN status = 'mastered' THEN 1 ELSE 0 END) as total_mastered"). + Where("user_id = ?", userID). + Scan(&totalStats) + + // 连续学习天数（最近30天内有学习记录的天数） + var streakDays int64 + s.db.Raw(` + SELECT COUNT(DISTINCT DATE(last_studied_at)) + FROM ai_user_word_progress + WHERE user_id = ? + AND last_studied_at >= DATE_SUB(CURDATE(), INTERVAL 30 DAY) + `, userID).Scan(&streakDays) + + return map[string]interface{}{ + "todayNewWords": todayStats.NewWords, + "todayReviewWords": todayStats.ReviewWords, + "todayTotalStudied": todayStats.TotalStudied, + "totalLearned": totalStats.TotalLearned, + "totalMastered": totalStats.TotalMastered, + "streakDays": streakDays, + }, nil +} + +func min(a, b int) int { + if a < b { + return a + } + return b +} + +func max(a, b int) int { + if a > b { + return a + } + return b +} diff --git a/serve/internal/services/listening_service.go b/serve/internal/services/listening_service.go new file mode 100644 index 0000000..e5b85e8 --- /dev/null +++ b/serve/internal/services/listening_service.go @@ -0,0 +1,347 @@ +package services + +import ( + "database/sql" + "errors" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/google/uuid" + "gorm.io/gorm" +) + +// ListeningService 听力训练服务 +type ListeningService struct { + db *gorm.DB +} + +// NewListeningService 创建听力训练服务实例 +func NewListeningService(db *gorm.DB) *ListeningService { + return &ListeningService{db: db} +} + +// GetListeningMaterials 获取听力材料列表 +func (s *ListeningService) GetListeningMaterials(level, category string, page, pageSize int) ([]models.ListeningMaterial, int64, error) { + var materials []models.ListeningMaterial + var total int64 + + query := s.db.Model(&models.ListeningMaterial{}).Where("is_active = ?", true) + + if level != "" { + query = query.Where("level = ?", level) + } + if category != "" { + query = query.Where("category = ?", category) + } + + // 获取总数 + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询 + offset := (page - 1) * pageSize + if err := query.Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&materials).Error; err != nil { + return nil, 0, err + } + + return materials, total, nil +} + +// GetListeningMaterial 获取单个听力材料 +func (s *ListeningService) GetListeningMaterial(id string) (*models.ListeningMaterial, error) { + var material models.ListeningMaterial + if err := s.db.Where("id = ? AND is_active = ?", id, true).First(&material).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, errors.New("听力材料不存在") + } + return nil, err + } + return &material, nil +} + +// CreateListeningMaterial 创建听力材料 +func (s *ListeningService) CreateListeningMaterial(material *models.ListeningMaterial) error { + material.ID = uuid.New().String() + material.CreatedAt = time.Now() + material.UpdatedAt = time.Now() + material.IsActive = true + + return s.db.Create(material).Error +} + +// UpdateListeningMaterial 更新听力材料 +func (s *ListeningService) UpdateListeningMaterial(id string, updates map[string]interface{}) error { + updates["updated_at"] = time.Now() + result := s.db.Model(&models.ListeningMaterial{}).Where("id = ?", id).Updates(updates) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("听力材料不存在") + } + return nil +} + +// DeleteListeningMaterial 删除听力材料（软删除） +func (s *ListeningService) DeleteListeningMaterial(id string) error { + result := s.db.Model(&models.ListeningMaterial{}).Where("id = ?", id).Update("is_active", false) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("听力材料不存在") + } + return nil +} + +// SearchListeningMaterials 搜索听力材料 +func (s *ListeningService) SearchListeningMaterials(keyword, level, category string, page, pageSize int) ([]models.ListeningMaterial, int64, error) { + var materials []models.ListeningMaterial + var total int64 + + query := s.db.Model(&models.ListeningMaterial{}).Where("is_active = ?", true) + + if keyword != "" { + query = query.Where("title LIKE ? OR description LIKE ?", "%"+keyword+"%", "%"+keyword+"%") + } + if level != "" { + query = query.Where("level = ?", level) + } + if category != "" { + query = query.Where("category = ?", category) + } + + // 获取总数 + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询 + offset := (page - 1) * pageSize + if err := query.Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&materials).Error; err != nil { + return nil, 0, err + } + + return materials, total, nil +} + +// CreateListeningRecord 创建听力练习记录 +func (s *ListeningService) CreateListeningRecord(record *models.ListeningRecord) error { + record.ID = uuid.New().String() + record.StartedAt = time.Now() + record.CreatedAt = time.Now() + record.UpdatedAt = time.Now() + + return s.db.Create(record).Error +} + +// UpdateListeningRecord 更新听力练习记录 +func (s *ListeningService) UpdateListeningRecord(id string, updates map[string]interface{}) error { + updates["updated_at"] = time.Now() + if _, exists := updates["completed_at"]; exists { + now := time.Now() + updates["completed_at"] = &now + } + + result := s.db.Model(&models.ListeningRecord{}).Where("id = ?", id).Updates(updates) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("听力练习记录不存在") + } + return nil +} + +// GetUserListeningRecords 获取用户听力练习记录 +func (s *ListeningService) GetUserListeningRecords(userID string, page, pageSize int) ([]models.ListeningRecord, int64, error) { + var records []models.ListeningRecord + var total int64 + + query := s.db.Model(&models.ListeningRecord{}).Where("user_id = ?", userID) + + // 获取总数 + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询，包含关联的材料信息 + offset := (page - 1) * pageSize + if err := query.Preload("Material").Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&records).Error; err != nil { + return nil, 0, err + } + + return records, total, nil +} + +// GetListeningRecord 获取单个听力练习记录 +func (s *ListeningService) GetListeningRecord(id string) (*models.ListeningRecord, error) { + var record models.ListeningRecord + if err := s.db.Preload("Material").Where("id = ?", id).First(&record).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, errors.New("听力练习记录不存在") + } + return nil, err + } + return &record, nil +} + +// GetUserListeningStats 获取用户听力学习统计 +func (s *ListeningService) GetUserListeningStats(userID string) (map[string]interface{}, error) { + stats := make(map[string]interface{}) + + // 总练习次数 + var totalRecords int64 + if err := s.db.Model(&models.ListeningRecord{}).Where("user_id = ?", userID).Count(&totalRecords).Error; err != nil { + return nil, err + } + stats["total_records"] = totalRecords + + // 已完成练习次数 + var completedRecords int64 + if err := s.db.Model(&models.ListeningRecord{}).Where("user_id = ? AND completed_at IS NOT NULL", userID).Count(&completedRecords).Error; err != nil { + return nil, err + } + stats["completed_records"] = completedRecords + + // 平均得分（NULL 安全） + var avgScore sql.NullFloat64 + if err := s.db.Model(&models.ListeningRecord{}). + Where("user_id = ? AND score IS NOT NULL", userID). + Select("AVG(score)"). + Scan(&avgScore).Error; err != nil { + return nil, err + } + if avgScore.Valid { + stats["average_score"] = avgScore.Float64 + } else { + stats["average_score"] = 0.0 + } + + // 平均准确率（NULL 安全） + var avgAccuracy sql.NullFloat64 + if err := s.db.Model(&models.ListeningRecord{}). + Where("user_id = ? AND accuracy IS NOT NULL", userID). + Select("AVG(accuracy)"). + Scan(&avgAccuracy).Error; err != nil { + return nil, err + } + if avgAccuracy.Valid { + stats["average_accuracy"] = avgAccuracy.Float64 + } else { + stats["average_accuracy"] = 0.0 + } + + // 总学习时间（分钟，NULL 安全） + var totalTimeSpent sql.NullInt64 + if err := s.db.Model(&models.ListeningRecord{}). + Where("user_id = ?", userID). + Select("SUM(time_spent)"). + Scan(&totalTimeSpent).Error; err != nil { + return nil, err + } + if totalTimeSpent.Valid { + stats["total_time_spent"] = totalTimeSpent.Int64 / 60 + } else { + stats["total_time_spent"] = 0 + } + + // 连续学习天数 + continuousDays, err := s.calculateContinuousLearningDays(userID) + if err != nil { + return nil, err + } + stats["continuous_days"] = continuousDays + + // 按难度级别统计 + levelStats := make(map[string]int64) + rows, err := s.db.Raw(` + SELECT lm.level, COUNT(*) as count + FROM ai_listening_records lr + JOIN ai_listening_materials lm ON lr.material_id = lm.id + WHERE lr.user_id = ? AND lr.completed_at IS NOT NULL + GROUP BY lm.level + `, userID).Rows() + if err != nil { + return nil, err + } + defer rows.Close() + + for rows.Next() { + var level string + var count int64 + if err := rows.Scan(&level, &count); err != nil { + return nil, err + } + levelStats[level] = count + } + stats["level_stats"] = levelStats + + return stats, nil +} + +// calculateContinuousLearningDays 计算连续学习天数 +func (s *ListeningService) calculateContinuousLearningDays(userID string) (int, error) { + // 获取最近的学习记录日期 + rows, err := s.db.Raw(` + SELECT DISTINCT DATE(created_at) as learning_date + FROM ai_listening_records + WHERE user_id = ? AND completed_at IS NOT NULL + ORDER BY learning_date DESC + LIMIT 30 + `, userID).Rows() + if err != nil { + return 0, err + } + defer rows.Close() + + var dates []time.Time + for rows.Next() { + var date time.Time + if err := rows.Scan(&date); err != nil { + return 0, err + } + dates = append(dates, date) + } + + if len(dates) == 0 { + return 0, nil + } + + // 计算连续天数 + continuousDays := 1 + today := time.Now().Truncate(24 * time.Hour) + lastDate := dates[0].Truncate(24 * time.Hour) + + // 如果最后一次学习不是今天或昨天，连续天数为0 + if lastDate.Before(today.AddDate(0, 0, -1)) { + return 0, nil + } + + for i := 1; i < len(dates); i++ { + currentDate := dates[i].Truncate(24 * time.Hour) + expectedDate := lastDate.AddDate(0, 0, -1) + + if currentDate.Equal(expectedDate) { + continuousDays++ + lastDate = currentDate + } else { + break + } + } + + return continuousDays, nil +} + +// GetListeningProgress 获取用户在特定材料上的学习进度 +func (s *ListeningService) GetListeningProgress(userID, materialID string) (*models.ListeningRecord, error) { + var record models.ListeningRecord + if err := s.db.Where("user_id = ? AND material_id = ?", userID, materialID).Order("created_at DESC").First(&record).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, nil // 没有学习记录 + } + return nil, err + } + return &record, nil +} \ No newline at end of file diff --git a/serve/internal/services/notification_service.go b/serve/internal/services/notification_service.go new file mode 100644 index 0000000..ad549d8 --- /dev/null +++ b/serve/internal/services/notification_service.go @@ -0,0 +1,163 @@ +package services + +import ( + "fmt" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "gorm.io/gorm" +) + +// NotificationService 通知服务 +type NotificationService struct { + db *gorm.DB +} + +// NewNotificationService 创建通知服务实例 +func NewNotificationService(db *gorm.DB) *NotificationService { + return &NotificationService{db: db} +} + +// GetUserNotifications 获取用户通知列表 +func (s *NotificationService) GetUserNotifications(userID int64, page, limit int, onlyUnread bool) ([]models.Notification, int64, error) { + var notifications []models.Notification + var total int64 + + query := s.db.Model(&models.Notification{}).Where("user_id = ?", userID) + + // 只查询未读通知 + if onlyUnread { + query = query.Where("is_read = ?", false) + } + + // 获取总数 + if err := query.Count(&total).Error; err != nil { + return nil, 0, fmt.Errorf("统计通知数量失败: %w", err) + } + + // 分页查询 + offset := (page - 1) * limit + if err := query.Order("priority DESC, created_at DESC"). + Offset(offset). + Limit(limit). + Find(¬ifications).Error; err != nil { + return nil, 0, fmt.Errorf("查询通知列表失败: %w", err) + } + + return notifications, total, nil +} + +// GetUnreadCount 获取未读通知数量 +func (s *NotificationService) GetUnreadCount(userID int64) (int64, error) { + var count int64 + if err := s.db.Model(&models.Notification{}). + Where("user_id = ? AND is_read = ?", userID, false). + Count(&count).Error; err != nil { + return 0, fmt.Errorf("统计未读通知失败: %w", err) + } + return count, nil +} + +// MarkAsRead 标记通知为已读 +func (s *NotificationService) MarkAsRead(userID, notificationID int64) error { + now := time.Now() + result := s.db.Model(&models.Notification{}). + Where("id = ? AND user_id = ?", notificationID, userID). + Updates(map[string]interface{}{ + "is_read": true, + "read_at": now, + }) + + if result.Error != nil { + return fmt.Errorf("标记通知已读失败: %w", result.Error) + } + + if result.RowsAffected == 0 { + return fmt.Errorf("通知不存在或无权限") + } + + return nil +} + +// MarkAllAsRead 标记所有通知为已读 +func (s *NotificationService) MarkAllAsRead(userID int64) error { + now := time.Now() + result := s.db.Model(&models.Notification{}). + Where("user_id = ? AND is_read = ?", userID, false). + Updates(map[string]interface{}{ + "is_read": true, + "read_at": now, + }) + + if result.Error != nil { + return fmt.Errorf("标记所有通知已读失败: %w", result.Error) + } + + return nil +} + +// DeleteNotification 删除通知 +func (s *NotificationService) DeleteNotification(userID, notificationID int64) error { + result := s.db.Where("id = ? AND user_id = ?", notificationID, userID). + Delete(&models.Notification{}) + + if result.Error != nil { + return fmt.Errorf("删除通知失败: %w", result.Error) + } + + if result.RowsAffected == 0 { + return fmt.Errorf("通知不存在或无权限") + } + + return nil +} + +// CreateNotification 创建通知（内部使用） +func (s *NotificationService) CreateNotification(notification *models.Notification) error { + if err := s.db.Create(notification).Error; err != nil { + return fmt.Errorf("创建通知失败: %w", err) + } + return nil +} + +// SendSystemNotification 发送系统通知 +func (s *NotificationService) SendSystemNotification(userID int64, title, content string, link *string, priority int) error { + notification := &models.Notification{ + UserID: userID, + Type: models.NotificationTypeSystem, + Title: title, + Content: content, + Link: link, + Priority: priority, + IsRead: false, + } + return s.CreateNotification(notification) +} + +// SendLearningReminder 发送学习提醒 +func (s *NotificationService) SendLearningReminder(userID int64, title, content string, link *string) error { + notification := &models.Notification{ + UserID: userID, + Type: models.NotificationTypeLearning, + Title: title, + Content: content, + Link: link, + Priority: models.NotificationPriorityNormal, + IsRead: false, + } + return s.CreateNotification(notification) +} + +// SendAchievementNotification 发送成就通知 +func (s *NotificationService) SendAchievementNotification(userID int64, title, content string, link *string) error { + notification := &models.Notification{ + UserID: userID, + Type: models.NotificationTypeAchievement, + Title: title, + Content: content, + Link: link, + Priority: models.NotificationPriorityImportant, + IsRead: false, + } + return s.CreateNotification(notification) +} diff --git a/serve/internal/services/reading_service.go b/serve/internal/services/reading_service.go new file mode 100644 index 0000000..99690f5 --- /dev/null +++ b/serve/internal/services/reading_service.go @@ -0,0 +1,432 @@ +package services + +import ( + "database/sql" + "errors" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/google/uuid" + "gorm.io/gorm" +) + +// ReadingService 阅读理解服务 +type ReadingService struct { + db *gorm.DB +} + +// NewReadingService 创建阅读理解服务实例 +func NewReadingService(db *gorm.DB) *ReadingService { + return &ReadingService{db: db} +} + +// ===== 阅读材料管理 ===== + +// GetReadingMaterials 获取阅读材料列表 +func (s *ReadingService) GetReadingMaterials(level, category string, page, pageSize int) ([]models.ReadingMaterial, int64, error) { + var materials []models.ReadingMaterial + var total int64 + + query := s.db.Model(&models.ReadingMaterial{}).Where("is_active = ?", true) + + // 按难度级别筛选 + if level != "" { + query = query.Where("level = ?", level) + } + + // 按分类筛选 + if category != "" { + query = query.Where("category = ?", category) + } + + // 获取总数 + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询 + offset := (page - 1) * pageSize + if err := query.Order("created_at DESC").Offset(offset).Limit(pageSize).Find(&materials).Error; err != nil { + return nil, 0, err + } + + return materials, total, nil +} + +// GetReadingMaterial 获取单个阅读材料 +func (s *ReadingService) GetReadingMaterial(id string) (*models.ReadingMaterial, error) { + var material models.ReadingMaterial + if err := s.db.Where("id = ? AND is_active = ?", id, true).First(&material).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, errors.New("阅读材料不存在") + } + return nil, err + } + return &material, nil +} + +// CreateReadingMaterial 创建阅读材料 +func (s *ReadingService) CreateReadingMaterial(material *models.ReadingMaterial) error { + material.ID = uuid.New().String() + material.CreatedAt = time.Now() + material.UpdatedAt = time.Now() + material.IsActive = true + + return s.db.Create(material).Error +} + +// UpdateReadingMaterial 更新阅读材料 +func (s *ReadingService) UpdateReadingMaterial(id string, updates map[string]interface{}) error { + updates["updated_at"] = time.Now() + result := s.db.Model(&models.ReadingMaterial{}).Where("id = ?", id).Updates(updates) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("阅读材料不存在") + } + return nil +} + +// DeleteReadingMaterial 删除阅读材料（软删除） +func (s *ReadingService) DeleteReadingMaterial(id string) error { + result := s.db.Model(&models.ReadingMaterial{}).Where("id = ?", id).Update("is_active", false) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("阅读材料不存在") + } + return nil +} + +// SearchReadingMaterials 搜索阅读材料 +func (s *ReadingService) SearchReadingMaterials(keyword string, level, category string, page, pageSize int) ([]models.ReadingMaterial, int64, error) { + var materials []models.ReadingMaterial + var total int64 + + query := s.db.Model(&models.ReadingMaterial{}).Where("is_active = ?", true) + + // 关键词搜索 + if keyword != "" { + query = query.Where("title LIKE ? OR content LIKE ? OR summary LIKE ?", + "%"+keyword+"%", "%"+keyword+"%", "%"+keyword+"%") + } + + // 按难度级别筛选 + if level != "" { + query = query.Where("level = ?", level) + } + + // 按分类筛选 + if category != "" { + query = query.Where("category = ?", category) + } + + // 获取总数 + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询 + offset := (page - 1) * pageSize + if err := query.Order("created_at DESC").Offset(offset).Limit(pageSize).Find(&materials).Error; err != nil { + return nil, 0, err + } + + return materials, total, nil +} + +// ===== 阅读记录管理 ===== + +// CreateReadingRecord 创建阅读记录 +func (s *ReadingService) CreateReadingRecord(record *models.ReadingRecord) error { + record.ID = uuid.New().String() + record.StartedAt = time.Now() + record.CreatedAt = time.Now() + record.UpdatedAt = time.Now() + + return s.db.Create(record).Error +} + +// UpdateReadingRecord 更新阅读记录 +func (s *ReadingService) UpdateReadingRecord(id string, updates map[string]interface{}) error { + updates["updated_at"] = time.Now() + result := s.db.Model(&models.ReadingRecord{}).Where("id = ?", id).Updates(updates) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("阅读记录不存在") + } + return nil +} + +// GetUserReadingRecords 获取用户阅读记录 +func (s *ReadingService) GetUserReadingRecords(userID string, page, pageSize int) ([]models.ReadingRecord, int64, error) { + var records []models.ReadingRecord + var total int64 + + query := s.db.Model(&models.ReadingRecord{}).Where("user_id = ?", userID) + + // 获取总数 + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询，预加载材料信息 + offset := (page - 1) * pageSize + if err := query.Preload("Material").Order("created_at DESC").Offset(offset).Limit(pageSize).Find(&records).Error; err != nil { + return nil, 0, err + } + + return records, total, nil +} + +// GetReadingRecord 获取单个阅读记录 +func (s *ReadingService) GetReadingRecord(id string) (*models.ReadingRecord, error) { + var record models.ReadingRecord + if err := s.db.Preload("Material").Where("id = ?", id).First(&record).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, errors.New("阅读记录不存在") + } + return nil, err + } + return &record, nil +} + +// GetReadingProgress 获取用户对特定材料的阅读进度 +func (s *ReadingService) GetReadingProgress(userID, materialID string) (*models.ReadingRecord, error) { + var record models.ReadingRecord + if err := s.db.Where("user_id = ? AND material_id = ?", userID, materialID).First(&record).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, nil // 没有阅读记录 + } + return nil, err + } + return &record, nil +} + +// ===== 阅读统计 ===== + +// ReadingStats 阅读统计结构 +type ReadingStats struct { + TotalMaterials int64 `json:"total_materials"` // 总阅读材料数 + CompletedMaterials int64 `json:"completed_materials"` // 已完成材料数 + TotalReadingTime int64 `json:"total_reading_time"` // 总阅读时间(秒) + AverageScore float64 `json:"average_score"` // 平均理解得分 + AverageSpeed float64 `json:"average_speed"` // 平均阅读速度(词/分钟) + ContinuousDays int `json:"continuous_days"` // 连续阅读天数 + LevelStats []LevelStat `json:"level_stats"` // 各难度级别统计 +} + +// LevelStat 难度级别统计 +type LevelStat struct { + Level string `json:"level"` + CompletedCount int64 `json:"completed_count"` + AverageScore float64 `json:"average_score"` + AverageSpeed float64 `json:"average_speed"` +} + +// GetUserReadingStats 获取用户阅读统计 +func (s *ReadingService) GetUserReadingStats(userID string) (*ReadingStats, error) { + stats := &ReadingStats{} + + // 获取总阅读材料数 + if err := s.db.Model(&models.ReadingMaterial{}).Where("is_active = ?", true).Count(&stats.TotalMaterials).Error; err != nil { + return nil, err + } + + // 获取已完成材料数 + if err := s.db.Model(&models.ReadingRecord{}).Where("user_id = ? AND completed_at IS NOT NULL", userID).Count(&stats.CompletedMaterials).Error; err != nil { + return nil, err + } + + // 获取总阅读时间 + var totalTime sql.NullInt64 + if err := s.db.Model(&models.ReadingRecord{}).Where("user_id = ?", userID).Select("SUM(reading_time)").Scan(&totalTime).Error; err != nil { + return nil, err + } + if totalTime.Valid { + stats.TotalReadingTime = totalTime.Int64 + } + + // 获取平均理解得分 + var avgScore sql.NullFloat64 + if err := s.db.Model(&models.ReadingRecord{}).Where("user_id = ? AND comprehension_score IS NOT NULL", userID).Select("AVG(comprehension_score)").Scan(&avgScore).Error; err != nil { + return nil, err + } + if avgScore.Valid { + stats.AverageScore = avgScore.Float64 + } + + // 获取平均阅读速度 + var avgSpeed sql.NullFloat64 + if err := s.db.Model(&models.ReadingRecord{}).Where("user_id = ? AND reading_speed IS NOT NULL", userID).Select("AVG(reading_speed)").Scan(&avgSpeed).Error; err != nil { + return nil, err + } + if avgSpeed.Valid { + stats.AverageSpeed = avgSpeed.Float64 + } + + // 计算连续阅读天数 + continuousDays, err := s.calculateContinuousReadingDays(userID) + if err != nil { + return nil, err + } + stats.ContinuousDays = continuousDays + + // 获取各难度级别统计 + levelStats, err := s.getLevelStats(userID) + if err != nil { + return nil, err + } + stats.LevelStats = levelStats + + return stats, nil +} + +// calculateContinuousReadingDays 计算连续阅读天数 +func (s *ReadingService) calculateContinuousReadingDays(userID string) (int, error) { + // 获取最近的阅读记录日期 + var dates []time.Time + if err := s.db.Model(&models.ReadingRecord{}).Where("user_id = ?", userID).Select("DATE(created_at) as date").Group("DATE(created_at)").Order("date DESC").Limit(365).Scan(&dates).Error; err != nil { + return 0, err + } + + if len(dates) == 0 { + return 0, nil + } + + // 计算连续天数 + continuousDays := 1 + today := time.Now().Truncate(24 * time.Hour) + lastDate := dates[0].Truncate(24 * time.Hour) + + // 如果最后一次阅读不是今天或昨天，连续天数为0 + if lastDate.Before(today.AddDate(0, 0, -1)) { + return 0, nil + } + + for i := 1; i < len(dates); i++ { + currentDate := dates[i].Truncate(24 * time.Hour) + expectedDate := lastDate.AddDate(0, 0, -1) + + if currentDate.Equal(expectedDate) { + continuousDays++ + lastDate = currentDate + } else { + break + } + } + + return continuousDays, nil +} + +// getLevelStats 获取各难度级别统计 +func (s *ReadingService) getLevelStats(userID string) ([]LevelStat, error) { + var levelStats []LevelStat + + query := ` + SELECT + m.level, + COUNT(r.id) as completed_count, + AVG(r.comprehension_score) as average_score, + AVG(r.reading_speed) as average_speed + FROM ai_reading_records r + JOIN ai_reading_materials m ON r.material_id = m.id + WHERE r.user_id = ? AND r.completed_at IS NOT NULL + GROUP BY m.level + ` + + if err := s.db.Raw(query, userID).Scan(&levelStats).Error; err != nil { + return nil, err + } + + return levelStats, nil +} + +// GetRecommendedMaterials 获取推荐阅读材料 +func (s *ReadingService) GetRecommendedMaterials(userID string, limit int) ([]models.ReadingMaterial, error) { + // 获取用户最近的阅读记录，分析偏好 + var userLevel string + var userCategory string + + // 获取用户最常阅读的难度级别 + if err := s.db.Raw(` + SELECT m.level + FROM ai_reading_records r + JOIN ai_reading_materials m ON r.material_id = m.id + WHERE r.user_id = ? + GROUP BY m.level + ORDER BY COUNT(*) DESC + LIMIT 1 + `, userID).Scan(&userLevel).Error; err != nil { + userLevel = "intermediate" // 默认中级 + } + + // 获取用户最常阅读的分类 + if err := s.db.Raw(` + SELECT m.category + FROM ai_reading_records r + JOIN ai_reading_materials m ON r.material_id = m.id + WHERE r.user_id = ? + GROUP BY m.category + ORDER BY COUNT(*) DESC + LIMIT 1 + `, userID).Scan(&userCategory).Error; err != nil { + userCategory = "" // 不限制分类 + } + + // 获取用户未读过的材料 + var materials []models.ReadingMaterial + query := s.db.Model(&models.ReadingMaterial{}).Where(` + is_active = ? AND id NOT IN ( + SELECT material_id FROM ai_reading_records WHERE user_id = ? + ) + `, true, userID) + + // 优先推荐相同难度级别的材料 + if userLevel != "" { + query = query.Where("level = ?", userLevel) + } + + // 如果有偏好分类，优先推荐 + if userCategory != "" { + query = query.Where("category = ?", userCategory) + } + + if err := query.Order("created_at DESC").Limit(limit).Find(&materials).Error; err != nil { + return nil, err + } + + // 如果推荐材料不足，补充其他材料 + if len(materials) < limit { + var additionalMaterials []models.ReadingMaterial + remaining := limit - len(materials) + + // 获取已推荐材料的ID列表 + excludeIDs := make([]string, len(materials)) + for i, m := range materials { + excludeIDs[i] = m.ID + } + + additionalQuery := s.db.Model(&models.ReadingMaterial{}).Where(` + is_active = ? AND id NOT IN ( + SELECT material_id FROM ai_reading_records WHERE user_id = ? + ) + `, true, userID) + + if len(excludeIDs) > 0 { + additionalQuery = additionalQuery.Where("id NOT IN ?", excludeIDs) + } + + if err := additionalQuery.Order("created_at DESC").Limit(remaining).Find(&additionalMaterials).Error; err != nil { + return materials, nil // 返回已有的推荐 + } + + materials = append(materials, additionalMaterials...) + } + + return materials, nil +} \ No newline at end of file diff --git a/serve/internal/services/speaking_service.go b/serve/internal/services/speaking_service.go new file mode 100644 index 0000000..e383834 --- /dev/null +++ b/serve/internal/services/speaking_service.go @@ -0,0 +1,436 @@ +package services + +import ( + "errors" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "gorm.io/gorm" +) + +// SpeakingService 口语练习服务 +type SpeakingService struct { + db *gorm.DB +} + +// NewSpeakingService 创建口语练习服务实例 +func NewSpeakingService(db *gorm.DB) *SpeakingService { + return &SpeakingService{ + db: db, + } +} + +// ==================== 口语场景管理 ==================== + +// GetSpeakingScenarios 获取口语场景列表 +func (s *SpeakingService) GetSpeakingScenarios(level, category string, page, pageSize int) ([]models.SpeakingScenario, int64, error) { + var scenarios []models.SpeakingScenario + var total int64 + + query := s.db.Model(&models.SpeakingScenario{}).Where("is_active = ?", true) + + // 添加过滤条件 + if level != "" { + query = query.Where("level = ?", level) + } + if category != "" { + query = query.Where("category = ?", category) + } + + // 获取总数 + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询 + offset := (page - 1) * pageSize + if err := query.Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&scenarios).Error; err != nil { + return nil, 0, err + } + + return scenarios, total, nil +} + +// GetSpeakingScenario 根据ID获取口语场景 +func (s *SpeakingService) GetSpeakingScenario(id string) (*models.SpeakingScenario, error) { + var scenario models.SpeakingScenario + if err := s.db.Where("id = ? AND is_active = ?", id, true).First(&scenario).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, errors.New("口语场景不存在") + } + return nil, err + } + return &scenario, nil +} + +// CreateSpeakingScenario 创建口语场景 +func (s *SpeakingService) CreateSpeakingScenario(scenario *models.SpeakingScenario) error { + scenario.CreatedAt = time.Now() + scenario.UpdatedAt = time.Now() + return s.db.Create(scenario).Error +} + +// UpdateSpeakingScenario 更新口语场景 +func (s *SpeakingService) UpdateSpeakingScenario(id string, updateData *models.SpeakingScenario) error { + updateData.UpdatedAt = time.Now() + result := s.db.Model(&models.SpeakingScenario{}).Where("id = ? AND is_active = ?", id, true).Updates(updateData) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("口语场景不存在") + } + return nil +} + +// DeleteSpeakingScenario 删除口语场景（软删除） +func (s *SpeakingService) DeleteSpeakingScenario(id string) error { + result := s.db.Model(&models.SpeakingScenario{}).Where("id = ?", id).Update("is_active", false) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("口语场景不存在") + } + return nil +} + +// SearchSpeakingScenarios 搜索口语场景 +func (s *SpeakingService) SearchSpeakingScenarios(keyword string, level, category string, page, pageSize int) ([]models.SpeakingScenario, int64, error) { + var scenarios []models.SpeakingScenario + var total int64 + + query := s.db.Model(&models.SpeakingScenario{}).Where("is_active = ?", true) + + // 关键词搜索 + if keyword != "" { + query = query.Where("title LIKE ? OR description LIKE ?", "%"+keyword+"%", "%"+keyword+"%") + } + + // 添加过滤条件 + if level != "" { + query = query.Where("level = ?", level) + } + if category != "" { + query = query.Where("category = ?", category) + } + + // 获取总数 + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询 + offset := (page - 1) * pageSize + if err := query.Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&scenarios).Error; err != nil { + return nil, 0, err + } + + return scenarios, total, nil +} + +// GetRecommendedScenarios 获取推荐的口语场景 +func (s *SpeakingService) GetRecommendedScenarios(userID string, limit int) ([]models.SpeakingScenario, error) { + var scenarios []models.SpeakingScenario + + // 简单的推荐逻辑：基于用户水平和最近练习情况 + // 这里可以根据实际需求实现更复杂的推荐算法 + query := ` + SELECT + s.*, + CASE WHEN ar.cnt IS NULL OR ar.cnt = 0 THEN 0 ELSE 1 END AS has_record + FROM ai_speaking_scenarios s + LEFT JOIN ( + SELECT scenario_id, COUNT(*) AS cnt + FROM ai_speaking_records + WHERE user_id = ? + GROUP BY scenario_id + ) ar ON ar.scenario_id = s.id + WHERE s.is_active = true + ORDER BY has_record ASC, s.created_at DESC + LIMIT ? + ` + + if err := s.db.Raw(query, userID, limit).Scan(&scenarios).Error; err != nil { + return nil, err + } + + return scenarios, nil +} + +// ==================== 口语练习记录管理 ==================== + +// CreateSpeakingRecord 创建口语练习记录 +func (s *SpeakingService) CreateSpeakingRecord(record *models.SpeakingRecord) error { + record.CreatedAt = time.Now() + record.UpdatedAt = time.Now() + return s.db.Create(record).Error +} + +// UpdateSpeakingRecord 更新口语练习记录 +func (s *SpeakingService) UpdateSpeakingRecord(id string, updateData *models.SpeakingRecord) error { + updateData.UpdatedAt = time.Now() + result := s.db.Model(&models.SpeakingRecord{}).Where("id = ?", id).Updates(updateData) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("口语练习记录不存在") + } + return nil +} + +// GetSpeakingRecord 根据ID获取口语练习记录 +func (s *SpeakingService) GetSpeakingRecord(id string) (*models.SpeakingRecord, error) { + var record models.SpeakingRecord + if err := s.db.Preload("SpeakingScenario").Where("id = ?", id).First(&record).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, errors.New("口语练习记录不存在") + } + return nil, err + } + return &record, nil +} + +// GetUserSpeakingRecords 获取用户的口语练习记录 +func (s *SpeakingService) GetUserSpeakingRecords(userID string, page, pageSize int) ([]models.SpeakingRecord, int64, error) { + var records []models.SpeakingRecord + var total int64 + + query := s.db.Model(&models.SpeakingRecord{}).Where("user_id = ?", userID) + + // 获取总数 + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询 + offset := (page - 1) * pageSize + if err := query.Preload("SpeakingScenario").Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&records).Error; err != nil { + return nil, 0, err + } + + return records, total, nil +} + +// SubmitSpeaking 提交口语练习 +func (s *SpeakingService) SubmitSpeaking(recordID string, audioURL, transcript string) error { + updateData := map[string]interface{}{ + "audio_url": audioURL, + "transcript": transcript, + "completed_at": time.Now(), + "updated_at": time.Now(), + } + + result := s.db.Model(&models.SpeakingRecord{}).Where("id = ?", recordID).Updates(updateData) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("口语练习记录不存在") + } + return nil +} + +// GradeSpeaking 评分口语练习 +func (s *SpeakingService) GradeSpeaking(recordID string, pronunciationScore, fluencyScore, accuracyScore, overallScore float64, feedback, suggestions string) error { + updateData := map[string]interface{}{ + "pronunciation_score": pronunciationScore, + "fluency_score": fluencyScore, + "accuracy_score": accuracyScore, + "overall_score": overallScore, + "feedback": feedback, + "suggestions": suggestions, + "graded_at": time.Now(), + "updated_at": time.Now(), + } + + result := s.db.Model(&models.SpeakingRecord{}).Where("id = ?", recordID).Updates(updateData) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("口语练习记录不存在") + } + return nil +} + +// ==================== 口语学习统计 ==================== + +// GetUserSpeakingStats 获取用户口语学习统计 +func (s *SpeakingService) GetUserSpeakingStats(userID string) (map[string]interface{}, error) { + stats := make(map[string]interface{}) + + // 总练习次数 + var totalRecords int64 + if err := s.db.Model(&models.SpeakingRecord{}).Where("user_id = ?", userID).Count(&totalRecords).Error; err != nil { + return nil, err + } + stats["total_records"] = totalRecords + + // 已完成练习次数 + var completedRecords int64 + if err := s.db.Model(&models.SpeakingRecord{}).Where("user_id = ? AND completed_at IS NOT NULL", userID).Count(&completedRecords).Error; err != nil { + return nil, err + } + stats["completed_records"] = completedRecords + + // 已评分练习次数 + var gradedRecords int64 + if err := s.db.Model(&models.SpeakingRecord{}).Where("user_id = ? AND overall_score IS NOT NULL", userID).Count(&gradedRecords).Error; err != nil { + return nil, err + } + stats["graded_records"] = gradedRecords + + // 平均分数 + var avgScores struct { + Pronunciation float64 `json:"pronunciation"` + Fluency float64 `json:"fluency"` + Accuracy float64 `json:"accuracy"` + Overall float64 `json:"overall"` + } + if err := s.db.Model(&models.SpeakingRecord{}).Where("user_id = ? AND overall_score IS NOT NULL", userID).Select( + "AVG(pronunciation_score) as pronunciation, AVG(fluency_score) as fluency, AVG(accuracy_score) as accuracy, AVG(overall_score) as overall", + ).Scan(&avgScores).Error; err != nil { + return nil, err + } + stats["average_scores"] = avgScores + + // 总练习时长 + var totalDuration int64 + if err := s.db.Model(&models.SpeakingRecord{}).Where("user_id = ? AND duration IS NOT NULL", userID).Select("COALESCE(SUM(duration), 0)").Scan(&totalDuration).Error; err != nil { + return nil, err + } + stats["total_duration"] = totalDuration + + // 平均练习时长 + var avgDuration float64 + if completedRecords > 0 { + avgDuration = float64(totalDuration) / float64(completedRecords) + } + stats["average_duration"] = avgDuration + + // 连续练习天数 + continuousDays, err := s.calculateContinuousSpeakingDays(userID) + if err != nil { + return nil, err + } + stats["continuous_days"] = continuousDays + + // 按难度级别统计 + levelStats, err := s.getSpeakingStatsByLevel(userID) + if err != nil { + return nil, err + } + stats["stats_by_level"] = levelStats + + return stats, nil +} + +// calculateContinuousSpeakingDays 计算连续练习天数 +func (s *SpeakingService) calculateContinuousSpeakingDays(userID string) (int, error) { + var dates []time.Time + if err := s.db.Model(&models.SpeakingRecord{}).Where("user_id = ? AND completed_at IS NOT NULL", userID).Select("DATE(created_at) as date").Group("DATE(created_at)").Order("date DESC").Pluck("date", &dates).Error; err != nil { + return 0, err + } + + if len(dates) == 0 { + return 0, nil + } + + continuousDays := 1 + for i := 1; i < len(dates); i++ { + diff := dates[i-1].Sub(dates[i]).Hours() / 24 + if diff == 1 { + continuousDays++ + } else { + break + } + } + + return continuousDays, nil +} + +// getSpeakingStatsByLevel 获取按难度级别的统计 +func (s *SpeakingService) getSpeakingStatsByLevel(userID string) (map[string]interface{}, error) { + var results []struct { + Level string `json:"level"` + Count int64 `json:"count"` + Score float64 `json:"avg_score"` + } + + query := ` + SELECT + ss.level, + COUNT(sr.id) as count, + AVG(sr.overall_score) as avg_score + FROM ai_speaking_records sr + JOIN ai_speaking_scenarios ss ON sr.scenario_id = ss.id + WHERE sr.user_id = ? AND sr.overall_score IS NOT NULL + GROUP BY ss.level + ` + + if err := s.db.Raw(query, userID).Scan(&results).Error; err != nil { + return nil, err + } + + stats := make(map[string]interface{}) + for _, result := range results { + stats[result.Level] = map[string]interface{}{ + "count": result.Count, + "avg_score": result.Score, + } + } + + return stats, nil +} + +// GetSpeakingProgress 获取口语学习进度 +func (s *SpeakingService) GetSpeakingProgress(userID, scenarioID string) (map[string]interface{}, error) { + progress := make(map[string]interface{}) + + // 该场景的练习记录 + var records []models.SpeakingRecord + if err := s.db.Where("user_id = ? AND scenario_id = ?", userID, scenarioID).Order("created_at ASC").Find(&records).Error; err != nil { + return nil, err + } + + progress["total_attempts"] = len(records) + + if len(records) == 0 { + progress["completed"] = false + progress["best_score"] = 0 + progress["latest_score"] = 0 + progress["improvement"] = 0 + return progress, nil + } + + // 最佳分数 + var bestScore float64 + for _, record := range records { + if record.OverallScore != nil && *record.OverallScore > bestScore { + bestScore = *record.OverallScore + } + } + progress["best_score"] = bestScore + + // 最新分数 + latestRecord := records[len(records)-1] + latestScore := 0.0 + if latestRecord.OverallScore != nil { + latestScore = *latestRecord.OverallScore + } + progress["latest_score"] = latestScore + + // 是否完成（有评分记录） + progress["completed"] = latestRecord.OverallScore != nil + + // 进步情况（最新分数与第一次分数的差值） + improvement := 0.0 + if len(records) > 1 && records[0].OverallScore != nil && latestRecord.OverallScore != nil { + improvement = *latestRecord.OverallScore - *records[0].OverallScore + } + progress["improvement"] = improvement + + return progress, nil +} \ No newline at end of file diff --git a/serve/internal/services/study_plan_service.go b/serve/internal/services/study_plan_service.go new file mode 100644 index 0000000..52a9307 --- /dev/null +++ b/serve/internal/services/study_plan_service.go @@ -0,0 +1,317 @@ +package services + +import ( + "errors" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "gorm.io/gorm" +) + +// StudyPlanService 学习计划服务 +type StudyPlanService struct { + db *gorm.DB +} + +func NewStudyPlanService(db *gorm.DB) *StudyPlanService { + return &StudyPlanService{db: db} +} + +// CreateStudyPlan 创建学习计划 +func (s *StudyPlanService) CreateStudyPlan(userID int64, planName string, description *string, dailyGoal int, + bookID *string, startDate time.Time, endDate *time.Time, remindTime *string, remindDays *string) (*models.StudyPlan, error) { + + // 验证参数 + if dailyGoal < 1 || dailyGoal > 200 { + return nil, errors.New("每日目标必须在1-200之间") + } + + // 如果指定了词汇书，获取总单词数 + totalWords := 0 + if bookID != nil && *bookID != "" { + var count int64 + s.db.Model(&models.VocabularyBookWord{}).Where("book_id = ?", *bookID).Count(&count) + totalWords = int(count) + } + + plan := &models.StudyPlan{ + UserID: userID, + BookID: bookID, + PlanName: planName, + Description: description, + DailyGoal: dailyGoal, + TotalWords: totalWords, + LearnedWords: 0, + StartDate: startDate, + EndDate: endDate, + Status: "active", + RemindTime: remindTime, + RemindDays: remindDays, + IsRemindEnabled: remindTime != nil && remindDays != nil, + StreakDays: 0, + } + + if err := s.db.Create(plan).Error; err != nil { + return nil, err + } + + return plan, nil +} + +// GetUserStudyPlans 获取用户的学习计划列表 +func (s *StudyPlanService) GetUserStudyPlans(userID int64, status string) ([]models.StudyPlan, error) { + var plans []models.StudyPlan + query := s.db.Where("user_id = ?", userID) + + if status != "" && status != "all" { + query = query.Where("status = ?", status) + } + + err := query.Order("created_at DESC").Find(&plans).Error + return plans, err +} + +// GetStudyPlanByID 获取学习计划详情 +func (s *StudyPlanService) GetStudyPlanByID(planID, userID int64) (*models.StudyPlan, error) { + var plan models.StudyPlan + err := s.db.Where("id = ? AND user_id = ?", planID, userID).First(&plan).Error + if err != nil { + return nil, err + } + return &plan, nil +} + +// UpdateStudyPlan 更新学习计划 +func (s *StudyPlanService) UpdateStudyPlan(planID, userID int64, updates map[string]interface{}) (*models.StudyPlan, error) { + var plan models.StudyPlan + if err := s.db.Where("id = ? AND user_id = ?", planID, userID).First(&plan).Error; err != nil { + return nil, err + } + + // 验证dailyGoal + if dailyGoal, ok := updates["daily_goal"].(int); ok { + if dailyGoal < 1 || dailyGoal > 200 { + return nil, errors.New("每日目标必须在1-200之间") + } + } + + if err := s.db.Model(&plan).Updates(updates).Error; err != nil { + return nil, err + } + + return &plan, nil +} + +// DeleteStudyPlan 删除学习计划（软删除） +func (s *StudyPlanService) DeleteStudyPlan(planID, userID int64) error { + result := s.db.Where("id = ? AND user_id = ?", planID, userID).Delete(&models.StudyPlan{}) + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("计划不存在或无权删除") + } + return nil +} + +// UpdatePlanStatus 更新计划状态 +func (s *StudyPlanService) UpdatePlanStatus(planID, userID int64, status string) error { + validStatuses := map[string]bool{ + "active": true, + "paused": true, + "completed": true, + "cancelled": true, + } + + if !validStatuses[status] { + return errors.New("无效的状态") + } + + updates := map[string]interface{}{ + "status": status, + } + + if status == "completed" { + now := time.Now() + updates["completed_at"] = now + } + + result := s.db.Model(&models.StudyPlan{}). + Where("id = ? AND user_id = ?", planID, userID). + Updates(updates) + + if result.Error != nil { + return result.Error + } + if result.RowsAffected == 0 { + return errors.New("计划不存在或无权修改") + } + + return nil +} + +// RecordStudyProgress 记录学习进度 +func (s *StudyPlanService) RecordStudyProgress(planID, userID int64, wordsStudied, studyDuration int) error { + var plan models.StudyPlan + if err := s.db.Where("id = ? AND user_id = ?", planID, userID).First(&plan).Error; err != nil { + return err + } + + today := time.Now().Truncate(24 * time.Hour) + + // 检查今天是否已有记录 + var record models.StudyPlanRecord + err := s.db.Where("plan_id = ? AND user_id = ? AND study_date = ?", planID, userID, today).First(&record).Error + + if err == gorm.ErrRecordNotFound { + // 创建新记录 + record = models.StudyPlanRecord{ + PlanID: planID, + UserID: userID, + StudyDate: today, + WordsStudied: wordsStudied, + GoalCompleted: wordsStudied >= plan.DailyGoal, + StudyDuration: studyDuration, + } + if err := s.db.Create(&record).Error; err != nil { + return err + } + } else if err == nil { + // 更新现有记录 + record.WordsStudied += wordsStudied + record.StudyDuration += studyDuration + record.GoalCompleted = record.WordsStudied >= plan.DailyGoal + if err := s.db.Save(&record).Error; err != nil { + return err + } + } else { + return err + } + + // 更新计划的已学单词数 + plan.LearnedWords += wordsStudied + + // 更新连续学习天数 + if plan.LastStudyDate != nil { + lastDate := plan.LastStudyDate.Truncate(24 * time.Hour) + yesterday := today.AddDate(0, 0, -1) + + if lastDate.Equal(yesterday) { + plan.StreakDays++ + } else if !lastDate.Equal(today) { + plan.StreakDays = 1 + } + } else { + plan.StreakDays = 1 + } + + plan.LastStudyDate = &today + + // 检查是否完成计划 + if plan.TotalWords > 0 && plan.LearnedWords >= plan.TotalWords { + plan.Status = "completed" + now := time.Now() + plan.CompletedAt = &now + } + + return s.db.Save(&plan).Error +} + +// GetStudyPlanStatistics 获取学习计划统计 +func (s *StudyPlanService) GetStudyPlanStatistics(planID, userID int64) (map[string]interface{}, error) { + var plan models.StudyPlan + if err := s.db.Where("id = ? AND user_id = ?", planID, userID).First(&plan).Error; err != nil { + return nil, err + } + + // 统计总学习天数 + var totalStudyDays int64 + s.db.Model(&models.StudyPlanRecord{}). + Where("plan_id = ? AND user_id = ?", planID, userID). + Count(&totalStudyDays) + + // 统计完成目标的天数 + var completedDays int64 + s.db.Model(&models.StudyPlanRecord{}). + Where("plan_id = ? AND user_id = ? AND goal_completed = ?", planID, userID, true). + Count(&completedDays) + + // 计算平均每日学习单词数 + var avgWords float64 + s.db.Model(&models.StudyPlanRecord{}). + Select("AVG(words_studied) as avg_words"). + Where("plan_id = ? AND user_id = ?", planID, userID). + Scan(&avgWords) + + // 计算完成率 + completionRate := 0.0 + if plan.TotalWords > 0 { + completionRate = float64(plan.LearnedWords) / float64(plan.TotalWords) * 100 + } + + // 获取最近7天的学习记录 + var recentRecords []models.StudyPlanRecord + s.db.Where("plan_id = ? AND user_id = ?", planID, userID). + Order("study_date DESC"). + Limit(7). + Find(&recentRecords) + + return map[string]interface{}{ + "plan": plan, + "total_study_days": totalStudyDays, + "completed_days": completedDays, + "avg_words": avgWords, + "completion_rate": completionRate, + "recent_records": recentRecords, + "streak_days": plan.StreakDays, + }, nil +} + +// GetTodayStudyPlans 获取今日需要执行的学习计划 +func (s *StudyPlanService) GetTodayStudyPlans(userID int64) ([]map[string]interface{}, error) { + var plans []models.StudyPlan + today := time.Now().Truncate(24 * time.Hour) + weekday := int(time.Now().Weekday()) + if weekday == 0 { + weekday = 7 // 将周日从0改为7 + } + + // 查找活跃的计划 + err := s.db.Where("user_id = ? AND status = ? AND start_date <= ?", userID, "active", today). + Find(&plans).Error + + if err != nil { + return nil, err + } + + result := make([]map[string]interface{}, 0) + + for _, plan := range plans { + // 检查今天是否已完成 + var record models.StudyPlanRecord + err := s.db.Where("plan_id = ? AND user_id = ? AND study_date = ?", plan.ID, userID, today). + First(&record).Error + + todayCompleted := err == nil && record.GoalCompleted + todayProgress := 0 + if err == nil { + todayProgress = record.WordsStudied + } + + // 检查是否需要提醒 + needRemind := false + if plan.IsRemindEnabled && plan.RemindDays != nil { + // 简单检查：这里可以根据RemindDays判断今天是否需要提醒 + needRemind = true + } + + result = append(result, map[string]interface{}{ + "plan": plan, + "today_completed": todayCompleted, + "today_progress": todayProgress, + "need_remind": needRemind, + }) + } + + return result, nil +} diff --git a/serve/internal/services/test_service.go b/serve/internal/services/test_service.go new file mode 100644 index 0000000..a16788c --- /dev/null +++ b/serve/internal/services/test_service.go @@ -0,0 +1,497 @@ +package services + +import ( + "encoding/json" + "errors" + "fmt" + "time" + + "github.com/google/uuid" + "gorm.io/gorm" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" +) + +// TestService 测试服务 +type TestService struct { + db *gorm.DB +} + +// NewTestService 创建测试服务实例 +func NewTestService(db *gorm.DB) *TestService { + return &TestService{db: db} +} + +// GetTestTemplates 获取测试模板列表 +func (s *TestService) GetTestTemplates(testType *models.TestType, difficulty *models.TestDifficulty, page, pageSize int) ([]models.TestTemplate, int64, error) { + var templates []models.TestTemplate + var total int64 + + query := s.db.Model(&models.TestTemplate{}).Where("is_active = ?", true) + + if testType != nil { + query = query.Where("type = ?", *testType) + } + if difficulty != nil { + query = query.Where("difficulty = ?", *difficulty) + } + + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + offset := (page - 1) * pageSize + if err := query.Order("created_at DESC").Offset(offset).Limit(pageSize).Find(&templates).Error; err != nil { + return nil, 0, err + } + + return templates, total, nil +} + +// GetTestTemplateByID 根据ID获取测试模板 +func (s *TestService) GetTestTemplateByID(id string) (*models.TestTemplate, error) { + var template models.TestTemplate + if err := s.db.Where("id = ? AND is_active = ?", id, true).First(&template).Error; err != nil { + return nil, err + } + return &template, nil +} + +// CreateTestSession 创建测试会话 +func (s *TestService) CreateTestSession(templateID, userID string) (*models.TestSession, error) { + // 获取模板 + template, err := s.GetTestTemplateByID(templateID) + if err != nil { + return nil, fmt.Errorf("模板不存在: %w", err) + } + + // 获取模板对应的题目 + var questions []models.TestQuestion + if err := s.db.Where("template_id = ?", templateID).Order("order_index ASC").Find(&questions).Error; err != nil { + return nil, err + } + + if len(questions) == 0 { + return nil, errors.New("模板没有配置题目") + } + + // 创建会话 + session := &models.TestSession{ + ID: uuid.New().String(), + TemplateID: templateID, + UserID: userID, + Status: models.TestStatusPending, + TimeRemaining: template.Duration, + CurrentQuestionIndex: 0, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + // 开启事务 + tx := s.db.Begin() + defer func() { + if r := recover(); r != nil { + tx.Rollback() + } + }() + + // 保存会话 + if err := tx.Create(session).Error; err != nil { + tx.Rollback() + return nil, err + } + + // 关联题目 + for i, question := range questions { + sessionQuestion := models.TestSessionQuestion{ + SessionID: session.ID, + QuestionID: question.ID, + OrderIndex: i, + } + if err := tx.Create(&sessionQuestion).Error; err != nil { + tx.Rollback() + return nil, err + } + } + + if err := tx.Commit().Error; err != nil { + return nil, err + } + + // 加载关联数据 + session.Template = template + session.Questions = questions + + return session, nil +} + +// GetTestSession 获取测试会话 +func (s *TestService) GetTestSession(sessionID string) (*models.TestSession, error) { + var session models.TestSession + if err := s.db.Preload("Template").Preload("Answers.Question").First(&session, "id = ?", sessionID).Error; err != nil { + return nil, err + } + + // 加载题目 + var questions []models.TestQuestion + if err := s.db.Raw(` + SELECT q.* FROM test_questions q + INNER JOIN test_session_questions sq ON q.id = sq.question_id + WHERE sq.session_id = ? + ORDER BY sq.order_index ASC + `, sessionID).Scan(&questions).Error; err != nil { + return nil, err + } + session.Questions = questions + + return &session, nil +} + +// StartTest 开始测试 +func (s *TestService) StartTest(sessionID string) (*models.TestSession, error) { + session, err := s.GetTestSession(sessionID) + if err != nil { + return nil, err + } + + if session.Status != models.TestStatusPending && session.Status != models.TestStatusPaused { + return nil, errors.New("测试状态不允许开始") + } + + now := time.Now() + session.Status = models.TestStatusInProgress + session.StartTime = &now + session.UpdatedAt = now + + if err := s.db.Save(session).Error; err != nil { + return nil, err + } + + return session, nil +} + +// SubmitAnswer 提交答案 +func (s *TestService) SubmitAnswer(sessionID, questionID, answer string) (*models.TestSession, error) { + session, err := s.GetTestSession(sessionID) + if err != nil { + return nil, err + } + + if session.Status != models.TestStatusInProgress { + return nil, errors.New("测试未在进行中") + } + + // 查找题目 + var question models.TestQuestion + if err := s.db.First(&question, "id = ?", questionID).Error; err != nil { + return nil, err + } + + // 检查是否已经回答过 + var existingAnswer models.TestAnswer + err = s.db.Where("session_id = ? AND question_id = ?", sessionID, questionID).First(&existingAnswer).Error + if err == nil { + // 更新已有答案 + existingAnswer.Answer = answer + existingAnswer.UpdatedAt = time.Now() + + // 判断答案是否正确 + isCorrect := s.checkAnswer(question, answer) + existingAnswer.IsCorrect = &isCorrect + if isCorrect { + existingAnswer.Score = question.Points + } else { + existingAnswer.Score = 0 + } + + if err := s.db.Save(&existingAnswer).Error; err != nil { + return nil, err + } + } else { + // 创建新答案 + isCorrect := s.checkAnswer(question, answer) + score := 0 + if isCorrect { + score = question.Points + } + + testAnswer := &models.TestAnswer{ + ID: uuid.New().String(), + SessionID: sessionID, + QuestionID: questionID, + Answer: answer, + IsCorrect: &isCorrect, + Score: score, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + if err := s.db.Create(testAnswer).Error; err != nil { + return nil, err + } + } + + // 重新加载会话 + return s.GetTestSession(sessionID) +} + +// checkAnswer 检查答案是否正确 +func (s *TestService) checkAnswer(question models.TestQuestion, answer string) bool { + switch question.QuestionType { + case models.QuestionTypeSingleChoice, models.QuestionTypeTrueFalse: + return answer == question.CorrectAnswer + case models.QuestionTypeMultipleChoice: + // 多选题需要比较JSON数组 + var userAnswers, correctAnswers []string + json.Unmarshal([]byte(answer), &userAnswers) + json.Unmarshal([]byte(question.CorrectAnswer), &correctAnswers) + + if len(userAnswers) != len(correctAnswers) { + return false + } + + answerMap := make(map[string]bool) + for _, a := range correctAnswers { + answerMap[a] = true + } + + for _, a := range userAnswers { + if !answerMap[a] { + return false + } + } + return true + case models.QuestionTypeFillBlank, models.QuestionTypeShortAnswer: + // 简单的字符串比较，实际应用中可能需要更复杂的匹配逻辑 + return answer == question.CorrectAnswer + default: + return false + } +} + +// PauseTest 暂停测试 +func (s *TestService) PauseTest(sessionID string) (*models.TestSession, error) { + session, err := s.GetTestSession(sessionID) + if err != nil { + return nil, err + } + + if session.Status != models.TestStatusInProgress { + return nil, errors.New("测试未在进行中") + } + + now := time.Now() + session.Status = models.TestStatusPaused + session.PausedAt = &now + session.UpdatedAt = now + + if err := s.db.Save(session).Error; err != nil { + return nil, err + } + + return session, nil +} + +// ResumeTest 恢复测试 +func (s *TestService) ResumeTest(sessionID string) (*models.TestSession, error) { + session, err := s.GetTestSession(sessionID) + if err != nil { + return nil, err + } + + if session.Status != models.TestStatusPaused { + return nil, errors.New("测试未暂停") + } + + now := time.Now() + session.Status = models.TestStatusInProgress + session.PausedAt = nil + session.UpdatedAt = now + + if err := s.db.Save(session).Error; err != nil { + return nil, err + } + + return session, nil +} + +// CompleteTest 完成测试 +func (s *TestService) CompleteTest(sessionID string) (*models.TestResult, error) { + session, err := s.GetTestSession(sessionID) + if err != nil { + return nil, err + } + + if session.Status != models.TestStatusInProgress { + return nil, errors.New("测试未在进行中") + } + + now := time.Now() + session.Status = models.TestStatusCompleted + session.EndTime = &now + session.UpdatedAt = now + + // 计算结果 + var answers []models.TestAnswer + if err := s.db.Preload("Question").Where("session_id = ?", sessionID).Find(&answers).Error; err != nil { + return nil, err + } + + totalScore := 0 + maxScore := 0 + correctCount := 0 + wrongCount := 0 + skippedCount := len(session.Questions) - len(answers) + timeSpent := 0 + + skillScores := make(map[models.SkillType]int) + skillMaxScores := make(map[models.SkillType]int) + + for _, answer := range answers { + if answer.Question != nil { + maxScore += answer.Question.Points + skillMaxScores[answer.Question.SkillType] += answer.Question.Points + + if answer.IsCorrect != nil && *answer.IsCorrect { + totalScore += answer.Score + correctCount++ + skillScores[answer.Question.SkillType] += answer.Score + } else { + wrongCount++ + } + + timeSpent += answer.TimeSpent + } + } + + percentage := 0.0 + if maxScore > 0 { + percentage = float64(totalScore) / float64(maxScore) * 100 + } + + // 构建技能得分JSON + skillScoresJSON, _ := json.Marshal(skillScores) + + // 创建测试结果 + result := &models.TestResult{ + ID: uuid.New().String(), + SessionID: sessionID, + UserID: session.UserID, + TemplateID: session.TemplateID, + TotalScore: totalScore, + MaxScore: maxScore, + Percentage: percentage, + CorrectCount: correctCount, + WrongCount: wrongCount, + SkippedCount: skippedCount, + TimeSpent: timeSpent, + SkillScores: string(skillScoresJSON), + Passed: totalScore >= session.Template.PassingScore, + CompletedAt: now, + CreatedAt: now, + UpdatedAt: now, + } + + // 开启事务 + tx := s.db.Begin() + defer func() { + if r := recover(); r != nil { + tx.Rollback() + } + }() + + // 保存会话状态 + if err := tx.Save(session).Error; err != nil { + tx.Rollback() + return nil, err + } + + // 保存结果 + if err := tx.Create(result).Error; err != nil { + tx.Rollback() + return nil, err + } + + if err := tx.Commit().Error; err != nil { + return nil, err + } + + // 加载关联数据 + result.Session = session + result.Template = session.Template + + return result, nil +} + +// GetUserTestHistory 获取用户测试历史 +func (s *TestService) GetUserTestHistory(userID string, page, pageSize int) ([]models.TestResult, int64, error) { + var results []models.TestResult + var total int64 + + query := s.db.Model(&models.TestResult{}).Where("user_id = ?", userID) + + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + offset := (page - 1) * pageSize + if err := query.Preload("Template").Order("completed_at DESC").Offset(offset).Limit(pageSize).Find(&results).Error; err != nil { + return nil, 0, err + } + + return results, total, nil +} + +// GetTestResultByID 获取测试结果详情 +func (s *TestService) GetTestResultByID(resultID string) (*models.TestResult, error) { + var result models.TestResult + if err := s.db.Preload("Template").Preload("Session.Answers.Question").First(&result, "id = ?", resultID).Error; err != nil { + return nil, err + } + return &result, nil +} + +// GetUserTestStats 获取用户测试统计 +func (s *TestService) GetUserTestStats(userID string) (map[string]interface{}, error) { + var stats struct { + TotalTests int64 + CompletedTests int64 + AverageScore float64 + PassRate float64 + } + + // 总测试数 + s.db.Model(&models.TestSession{}).Where("user_id = ?", userID).Count(&stats.TotalTests) + + // 完成的测试数 + s.db.Model(&models.TestSession{}).Where("user_id = ? AND status = ?", userID, models.TestStatusCompleted).Count(&stats.CompletedTests) + + // 平均分和通过率 + var results []models.TestResult + s.db.Where("user_id = ?", userID).Find(&results) + + if len(results) > 0 { + totalPercentage := 0.0 + passedCount := 0 + for _, result := range results { + totalPercentage += result.Percentage + if result.Passed { + passedCount++ + } + } + stats.AverageScore = totalPercentage / float64(len(results)) + stats.PassRate = float64(passedCount) / float64(len(results)) * 100 + } + + return map[string]interface{}{ + "total_tests": stats.TotalTests, + "completed_tests": stats.CompletedTests, + "average_score": stats.AverageScore, + "pass_rate": stats.PassRate, + }, nil +} + +// DeleteTestResult 删除测试结果 +func (s *TestService) DeleteTestResult(resultID string) error { + return s.db.Delete(&models.TestResult{}, "id = ?", resultID).Error +} diff --git a/serve/internal/services/user_service.go b/serve/internal/services/user_service.go new file mode 100644 index 0000000..07c4bd2 --- /dev/null +++ b/serve/internal/services/user_service.go @@ -0,0 +1,349 @@ +package services + +import ( + "errors" + "fmt" + "time" + + "gorm.io/gorm" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" +) + +// UserService 用户服务 +type UserService struct { + db *gorm.DB +} + +// NewUserService 创建用户服务实例 +func NewUserService(db *gorm.DB) *UserService { + return &UserService{db: db} +} + +// CreateUser 创建用户 +func (s *UserService) CreateUser(username, email, password string) (*models.User, error) { + // 检查用户名是否已存在 + var existingUser models.User + if err := s.db.Where("username = ? OR email = ?", username, email).First(&existingUser).Error; err == nil { + if existingUser.Username == username { + return nil, common.ErrUsernameExists + } + if existingUser.Email == email { + return nil, common.ErrEmailExists + } + } else if !errors.Is(err, gorm.ErrRecordNotFound) { + return nil, err + } + + // 生成密码哈希 + passwordHash, err := utils.HashPassword(password) + if err != nil { + return nil, err + } + + // 创建用户 + user := &models.User{ + Username: username, + Email: email, + PasswordHash: passwordHash, + Status: "active", + Timezone: "Asia/Shanghai", + Language: "zh-CN", + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + if err := s.db.Create(user).Error; err != nil { + return nil, err + } + + // 创建用户偏好设置 + preference := &models.UserPreference{ + UserID: user.ID, + DailyGoal: 50, + WeeklyGoal: 350, + ReminderEnabled: true, + DifficultyLevel: "beginner", + LearningMode: "casual", + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + if err := s.db.Create(preference).Error; err != nil { + // 如果创建偏好设置失败，记录日志但不影响用户创建 + // 可以在这里添加日志记录 + } + + return user, nil +} + +// GetUserByID 根据ID获取用户 +func (s *UserService) GetUserByID(userID int64) (*models.User, error) { + var user models.User + if err := s.db.Preload("Preferences").Preload("SocialLinks").Where("id = ?", userID).First(&user).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, common.ErrUserNotFound + } + return nil, err + } + return &user, nil +} + +// GetUserByEmail 根据邮箱获取用户 +func (s *UserService) GetUserByEmail(email string) (*models.User, error) { + var user models.User + if err := s.db.Where("email = ?", email).First(&user).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, common.ErrUserNotFound + } + return nil, err + } + return &user, nil +} + +// GetUserByUsername 根据用户名获取用户 +func (s *UserService) GetUserByUsername(username string) (*models.User, error) { + var user models.User + if err := s.db.Where("username = ?", username).First(&user).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, common.ErrUserNotFound + } + return nil, err + } + return &user, nil +} + +// UpdateUser 更新用户信息 +func (s *UserService) UpdateUser(userID int64, updates map[string]interface{}) (*models.User, error) { + // 检查用户是否存在 + var user models.User + if err := s.db.Where("id = ?", userID).First(&user).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, common.ErrUserNotFound + } + return nil, err + } + + // 如果更新邮箱，检查邮箱是否已被其他用户使用 + if email, ok := updates["email"]; ok { + var existingUser models.User + if err := s.db.Where("email = ? AND id != ?", email, userID).First(&existingUser).Error; err == nil { + return nil, common.ErrEmailExists + } else if !errors.Is(err, gorm.ErrRecordNotFound) { + return nil, err + } + } + + // 如果更新用户名，检查用户名是否已被其他用户使用 + if username, ok := updates["username"]; ok { + var existingUser models.User + if err := s.db.Where("username = ? AND id != ?", username, userID).First(&existingUser).Error; err == nil { + return nil, common.ErrUsernameExists + } else if !errors.Is(err, gorm.ErrRecordNotFound) { + return nil, err + } + } + + // 更新时间戳 + updates["updated_at"] = time.Now() + + // 执行更新 + if err := s.db.Model(&user).Updates(updates).Error; err != nil { + return nil, err + } + + // 重新获取更新后的用户信息 + return s.GetUserByID(userID) +} + +// UpdatePassword 更新用户密码 +func (s *UserService) UpdatePassword(userID int64, oldPassword, newPassword string) error { + // 获取用户 + var user models.User + if err := s.db.Where("id = ?", userID).First(&user).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return common.ErrUserNotFound + } + return err + } + + // 验证旧密码 + if !utils.CheckPasswordHash(oldPassword, user.PasswordHash) { + return common.ErrInvalidPassword + } + + // 生成新密码哈希 + newPasswordHash, err := utils.HashPassword(newPassword) + if err != nil { + return err + } + + // 更新密码 + return s.db.Model(&user).Updates(map[string]interface{}{ + "password_hash": newPasswordHash, + "updated_at": time.Now(), + }).Error +} + +// UpdateLoginInfo 更新登录信息 +func (s *UserService) UpdateLoginInfo(userID int64, loginIP string) error { + now := time.Now() + return s.db.Model(&models.User{}).Where("id = ?", userID).Updates(map[string]interface{}{ + "last_login_at": &now, + "last_login_ip": loginIP, + "login_count": gorm.Expr("login_count + 1"), + "updated_at": now, + }).Error +} + +// VerifyPassword 验证密码 +func (s *UserService) VerifyPassword(userID int64, password string) error { + var user models.User + if err := s.db.Where("id = ?", userID).First(&user).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return common.ErrUserNotFound + } + return err + } + + if !utils.CheckPasswordHash(password, user.PasswordHash) { + return common.ErrInvalidPassword + } + + return nil +} + +// DeleteUser 删除用户 +func (s *UserService) DeleteUser(userID int64) error { + // 检查用户是否存在 + var user models.User + if err := s.db.Where("id = ?", userID).First(&user).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return common.ErrUserNotFound + } + return err + } + + // 软删除用户 + return s.db.Delete(&user).Error +} + +// GetUserPreferences 获取用户偏好设置 +func (s *UserService) GetUserPreferences(userID int64) (*models.UserPreference, error) { + var preference models.UserPreference + if err := s.db.Where("user_id = ?", userID).First(&preference).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, common.ErrUserNotFound + } + return nil, err + } + return &preference, nil +} + +// UpdateUserPreferences 更新用户偏好设置 +func (s *UserService) UpdateUserPreferences(userID int64, updates map[string]interface{}) (*models.UserPreference, error) { + // 检查偏好设置是否存在 + var preference models.UserPreference + if err := s.db.Where("user_id = ?", userID).First(&preference).Error; err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, common.ErrUserNotFound + } + return nil, err + } + + // 更新时间戳 + updates["updated_at"] = time.Now() + + // 执行更新 + if err := s.db.Model(&preference).Updates(updates).Error; err != nil { + return nil, err + } + + // 重新获取更新后的偏好设置 + return s.GetUserPreferences(userID) +} + +// GetUserLearningProgress 获取用户学习进度 +func (s *UserService) GetUserLearningProgress(userID string, page, limit int) ([]map[string]interface{}, int64, error) { + // 初始化为空切片而不是nil，避免JSON序列化为null + progressList := []map[string]interface{}{} + var total int64 + + // 查询用户在各个词汇书的学习进度 + query := ` + SELECT + vb.id, + vb.name as title, + vb.description as category, + vb.level, + COUNT(DISTINCT vbw.vocabulary_id) as total_words, + COUNT(DISTINCT CASE WHEN uwp.status IN ('learning', 'reviewing', 'mastered') THEN uwp.vocabulary_id END) as learned_words, + MAX(uwp.last_studied_at) as last_study_date + FROM ai_vocabulary_books vb + LEFT JOIN ai_vocabulary_book_words vbw ON vbw.book_id = vb.id + LEFT JOIN ai_user_word_progress uwp ON CAST(uwp.vocabulary_id AS UNSIGNED) = CAST(vbw.vocabulary_id AS UNSIGNED) AND uwp.user_id = ? + WHERE vb.is_system = 1 + GROUP BY vb.id, vb.name, vb.description, vb.level + HAVING total_words > 0 + ORDER BY last_study_date DESC + ` + + // 获取总数 + countQuery := ` + SELECT COUNT(*) FROM ( + SELECT vb.id + FROM ai_vocabulary_books vb + LEFT JOIN ai_vocabulary_book_words vbw ON vbw.book_id = vb.id + WHERE vb.is_system = 1 + GROUP BY vb.id + HAVING COUNT(DISTINCT vbw.vocabulary_id) > 0 + ) as subquery + ` + if err := s.db.Raw(countQuery).Scan(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询 + offset := (page - 1) * limit + rows, err := s.db.Raw(query+" LIMIT ? OFFSET ?", userID, limit, offset).Rows() + if err != nil { + return nil, 0, err + } + defer rows.Close() + + for rows.Next() { + var ( + id int64 + title string + category string + level string + totalWords int + learnedWords int + lastStudyDate *time.Time + ) + + if err := rows.Scan(&id, &title, &category, &level, &totalWords, &learnedWords, &lastStudyDate); err != nil { + continue + } + + progress := float64(0) + if totalWords > 0 { + progress = float64(learnedWords) / float64(totalWords) + } + + progressList = append(progressList, map[string]interface{}{ + "id": fmt.Sprintf("%d", id), + "title": title, + "category": category, + "level": level, + "total_words": totalWords, + "learned_words": learnedWords, + "progress": progress, + "last_study_date": lastStudyDate, + }) + } + + return progressList, total, nil +} \ No newline at end of file diff --git a/serve/internal/services/vocabulary_service.go b/serve/internal/services/vocabulary_service.go new file mode 100644 index 0000000..c3fc238 --- /dev/null +++ b/serve/internal/services/vocabulary_service.go @@ -0,0 +1,1317 @@ +package services + +import ( + "fmt" + "log" + "strconv" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/common" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/interfaces" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" + "gorm.io/gorm" +) + +type VocabularyService struct { + db *gorm.DB +} + +func NewVocabularyService(db *gorm.DB) *VocabularyService { + return &VocabularyService{db: db} +} + +// 显式实现 VocabularyServiceInterface 接口 +var _ interfaces.VocabularyServiceInterface = (*VocabularyService)(nil) + +// GetCategories 获取词汇分类列表 +func (s *VocabularyService) GetCategories(page, pageSize int, level string) (*common.PaginationData, error) { + var categories []*models.VocabularyCategory + var total int64 + + query := s.db.Model(&models.VocabularyCategory{}) + if level != "" { + query = query.Where("level = ?", level) + } + + if err := query.Count(&total).Error; err != nil { + return nil, err + } + + offset := utils.CalculateOffset(page, pageSize) + if err := query.Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&categories).Error; err != nil { + return nil, err + } + + totalPages := utils.CalculateTotalPages(int(total), pageSize) + + return &common.PaginationData{ + Items: categories, + Pagination: &common.Pagination{ + Page: page, + PageSize: pageSize, + Total: int(total), + TotalPages: totalPages, + }, + }, nil +} + +// CreateCategory 创建词汇分类 +func (s *VocabularyService) CreateCategory(name, description, level string) (*models.VocabularyCategory, error) { + // 检查分类名称是否已存在 + var existingCategory models.VocabularyCategory + if err := s.db.Where("name = ?", name).First(&existingCategory).Error; err == nil { + return nil, common.NewBusinessError(common.ErrCodeUserExists, "分类名称已存在") + } else if err != gorm.ErrRecordNotFound { + return nil, err + } + + category := &models.VocabularyCategory{ + ID: utils.GenerateUUID(), + Name: name, + Description: &description, + Level: level, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + if err := s.db.Create(category).Error; err != nil { + return nil, err + } + + return category, nil +} + +// UpdateCategory 更新词汇分类 +func (s *VocabularyService) UpdateCategory(categoryID string, updates map[string]interface{}) (*models.VocabularyCategory, error) { + var category models.VocabularyCategory + if err := s.db.Where("id = ?", categoryID).First(&category).Error; err != nil { + if err == gorm.ErrRecordNotFound { + return nil, common.NewBusinessError(common.ErrCodeCategoryNotFound, "分类不存在") + } + return nil, err + } + + // 如果更新名称，检查是否重复 + if name, ok := updates["name"]; ok { + var existingCategory models.VocabularyCategory + if err := s.db.Where("name = ? AND id != ?", name, categoryID).First(&existingCategory).Error; err == nil { + return nil, common.NewBusinessError(common.ErrCodeUserExists, "分类名称已存在") + } else if err != gorm.ErrRecordNotFound { + return nil, err + } + } + + updates["updated_at"] = time.Now() + if err := s.db.Model(&category).Updates(updates).Error; err != nil { + return nil, err + } + + return &category, nil +} + +// DeleteCategory 删除词汇分类 +func (s *VocabularyService) DeleteCategory(categoryID string) error { + // 检查分类是否存在 + var category models.VocabularyCategory + if err := s.db.Where("id = ?", categoryID).First(&category).Error; err != nil { + if err == gorm.ErrRecordNotFound { + return common.NewBusinessError(common.ErrCodeCategoryNotFound, "分类不存在") + } + return err + } + + // 检查是否有词汇使用该分类 + var count int64 + if err := s.db.Model(&models.Vocabulary{}).Where("category_id = ?", categoryID).Count(&count).Error; err != nil { + return err + } + if count > 0 { + return common.NewBusinessError(common.ErrCodeBadRequest, "该分类下还有词汇，无法删除") + } + + if err := s.db.Delete(&category).Error; err != nil { + return err + } + + return nil +} + +// GetVocabulariesByCategory 根据分类获取词汇列表 +func (s *VocabularyService) GetVocabulariesByCategory(categoryID string, page, pageSize int, level string) (*common.PaginationData, error) { + offset := utils.CalculateOffset(page, pageSize) + + query := s.db.Where("category_id = ?", categoryID) + if level != "" { + query = query.Where("level = ?", level) + } + + // 获取总数 + var total int64 + if err := query.Model(&models.Vocabulary{}).Count(&total).Error; err != nil { + return nil, err + } + + // 获取词汇列表 + var vocabularies []models.Vocabulary + if err := query.Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&vocabularies).Error; err != nil { + return nil, err + } + + totalPages := utils.CalculateTotalPages(int(total), pageSize) + + return &common.PaginationData{ + Items: vocabularies, + Pagination: &common.Pagination{ + Page: page, + PageSize: pageSize, + Total: int(total), + TotalPages: totalPages, + }, + }, nil +} + +// GetVocabularyByID 根据ID获取词汇详情 +func (s *VocabularyService) GetVocabularyByID(vocabularyID string) (*models.Vocabulary, error) { + var vocabulary models.Vocabulary + if err := s.db.Where("id = ?", vocabularyID).First(&vocabulary).Error; err != nil { + if err == gorm.ErrRecordNotFound { + return nil, common.NewBusinessError(common.ErrCodeVocabularyNotFound, "词汇不存在") + } + return nil, err + } + return &vocabulary, nil +} + +// CreateVocabulary 创建词汇 +func (s *VocabularyService) CreateVocabulary(word, phonetic, level string, frequency int, categoryID string, definitions, examples, images []string) (*models.Vocabulary, error) { + // 检查词汇是否已存在 + var existingVocabulary models.Vocabulary + if err := s.db.Where("word = ?", word).First(&existingVocabulary).Error; err == nil { + return nil, common.NewBusinessError(common.ErrCodeWordExists, "词汇已存在") + } else if err != gorm.ErrRecordNotFound { + return nil, err + } + + // 检查分类是否存在 + var category models.VocabularyCategory + if err := s.db.Where("id = ?", categoryID).First(&category).Error; err != nil { + if err == gorm.ErrRecordNotFound { + return nil, common.NewBusinessError(common.ErrCodeCategoryNotFound, "分类不存在") + } + return nil, err + } + + // 创建词汇 + vocabulary := &models.Vocabulary{ + Word: word, + Level: level, + Frequency: frequency, + IsActive: true, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + // 设置音标（可选） + if phonetic != "" { + vocabulary.Phonetic = &phonetic + } + + // 开始事务 + tx := s.db.Begin() + defer func() { + if r := recover(); r != nil { + tx.Rollback() + } + }() + + // 创建词汇记录 + if err := tx.Create(vocabulary).Error; err != nil { + tx.Rollback() + return nil, err + } + + // 关联分类 + if err := tx.Model(vocabulary).Association("Categories").Append(&category); err != nil { + tx.Rollback() + return nil, err + } + + // 创建定义 + for i, def := range definitions { + definition := &models.VocabularyDefinition{ + VocabularyID: vocabulary.ID, + PartOfSpeech: "noun", // 默认词性 + Definition: def, + Translation: def, // 暂时用定义作为翻译 + SortOrder: i, + CreatedAt: time.Now(), + } + if err := tx.Create(definition).Error; err != nil { + tx.Rollback() + return nil, err + } + } + + // 创建例句 + for i, ex := range examples { + example := &models.VocabularyExample{ + VocabularyID: vocabulary.ID, + Example: ex, + Translation: ex, // 暂时用例句作为翻译 + SortOrder: i, + CreatedAt: time.Now(), + } + if err := tx.Create(example).Error; err != nil { + tx.Rollback() + return nil, err + } + } + + // 创建图片（暂时跳过，因为VocabularyImage结构需要更新） + _ = images // 避免未使用警告 + /* + for i, img := range images { + image := &models.VocabularyImage{ + VocabularyID: vocabulary.ID, + ImageURL: img, + SortOrder: i, + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + if err := tx.Create(image).Error; err != nil { + tx.Rollback() + return nil, err + } + } + */ + + // 提交事务 + if err := tx.Commit().Error; err != nil { + return nil, err + } + + return vocabulary, nil +} + +// UpdateVocabulary 更新词汇 +func (s *VocabularyService) UpdateVocabulary(id string, vocabulary *models.Vocabulary) error { + return s.db.Model(&models.Vocabulary{}).Where("id = ?", id).Updates(vocabulary).Error +} + +// DeleteVocabulary 删除词汇 +func (s *VocabularyService) DeleteVocabulary(id string) error { + return s.db.Delete(&models.Vocabulary{}, id).Error +} + +// GetUserVocabularyProgress 获取用户词汇学习进度 +func (s *VocabularyService) GetUserVocabularyProgress(userID int64, vocabularyID string) (*models.UserVocabularyProgress, error) { + var progress models.UserVocabularyProgress + if err := s.db.Where("user_id = ? AND vocabulary_id = ?", userID, vocabularyID).First(&progress).Error; err != nil { + if err == gorm.ErrRecordNotFound { + return nil, common.NewBusinessError(common.ErrCodeProgressNotFound, "学习进度不存在") + } + return nil, err + } + return &progress, nil +} + +// UpdateUserVocabularyProgress 更新用户词汇学习进度 +func (s *VocabularyService) UpdateUserVocabularyProgress(userID int64, vocabularyID string, updates map[string]interface{}) (*models.UserVocabularyProgress, error) { + // 查找或创建进度记录 + var progress models.UserVocabularyProgress + err := s.db.Where("user_id = ? AND vocabulary_id = ?", userID, vocabularyID).First(&progress).Error + + if err == gorm.ErrRecordNotFound { + // 创建新的进度记录 + now := time.Now() + progress = models.UserVocabularyProgress{ + ID: 0, // 让数据库自动生成 + UserID: userID, + VocabularyID: vocabularyID, + StudyCount: 1, + LastStudiedAt: &now, + CreatedAt: now, + UpdatedAt: now, + } + + // 应用更新 + if masteryLevel, ok := updates["mastery_level"].(int); ok { + progress.MasteryLevel = masteryLevel + } + + if err := s.db.Create(&progress).Error; err != nil { + return nil, err + } + return &progress, nil + } else if err != nil { + return nil, err + } + + // 更新现有进度记录 + now := time.Now() + updateData := map[string]interface{}{ + "study_count": progress.StudyCount + 1, + "last_studied_at": &now, + "updated_at": now, + } + + // 合并传入的更新数据 + for key, value := range updates { + updateData[key] = value + } + + if err := s.db.Model(&progress).Updates(updateData).Error; err != nil { + return nil, err + } + + // 重新查询更新后的记录 + if err := s.db.Where("user_id = ? AND vocabulary_id = ?", userID, vocabularyID).First(&progress).Error; err != nil { + return nil, err + } + + return &progress, nil +} + +// GetUserVocabularyStats 获取用户词汇学习统计 +func (s *VocabularyService) GetUserVocabularyStats(userID int64) (map[string]interface{}, error) { + stats := make(map[string]interface{}) + + // 总学习词汇数 + var totalStudied int64 + if err := s.db.Table("ai_user_word_progress").Where("user_id = ?", userID).Count(&totalStudied).Error; err != nil { + return nil, err + } + stats["total_studied"] = totalStudied + + // 掌握程度统计（基于proficiency字段：0-100） + var masteryStats []struct { + Level string `json:"level"` + Count int64 `json:"count"` + } + if err := s.db.Table("ai_user_word_progress"). + Select("CASE WHEN proficiency >= 80 THEN 'mastered' WHEN proficiency >= 60 THEN 'familiar' WHEN proficiency >= 40 THEN 'learning' ELSE 'new' END as level, COUNT(*) as count"). + Where("user_id = ?", userID). + Group("level"). + Scan(&masteryStats).Error; err != nil { + return nil, err + } + stats["mastery_stats"] = masteryStats + + // 学习准确率 + var accuracyResult struct { + TotalCorrect int64 `json:"total_correct"` + TotalWrong int64 `json:"total_wrong"` + } + if err := s.db.Table("ai_user_word_progress"). + Select("COALESCE(SUM(correct_count), 0) as total_correct, COALESCE(SUM(wrong_count), 0) as total_wrong"). + Where("user_id = ?", userID). + Scan(&accuracyResult).Error; err != nil { + return nil, err + } + + totalAttempts := accuracyResult.TotalCorrect + accuracyResult.TotalWrong + if totalAttempts > 0 { + stats["accuracy_rate"] = float64(accuracyResult.TotalCorrect) / float64(totalAttempts) * 100 + } else { + stats["accuracy_rate"] = 0.0 + } + + // 最近学习的词汇 + var recentVocabularies []models.Vocabulary + if err := s.db.Table("ai_vocabulary v"). + Joins("JOIN ai_user_word_progress uwp ON v.id = uwp.vocabulary_id"). + Where("uwp.user_id = ?", userID). + Order("uwp.last_studied_at DESC"). + Limit(5). + Find(&recentVocabularies).Error; err != nil { + return nil, err + } + stats["recent_vocabularies"] = recentVocabularies + + return stats, nil +} + +// GetTodayStudyWords 获取今日学习单词（包含完整的释义和例句） +func (s *VocabularyService) GetTodayStudyWords(userID int64, limit int) ([]map[string]interface{}, error) { + var words []map[string]interface{} + + // 查询最近学习的单词（按最后学习时间排序，获取最近学习的词） + query := ` + SELECT + v.id, + v.word, + COALESCE(v.phonetic, '') as phonetic, + COALESCE(v.phonetic_us, '') as phonetic_us, + COALESCE(v.phonetic_uk, '') as phonetic_uk, + COALESCE(v.audio_url, '') as audio_url, + COALESCE(v.audio_us_url, '') as audio_us_url, + COALESCE(v.audio_uk_url, '') as audio_uk_url, + COALESCE(v.level, '') as level, + v.difficulty_level, + v.frequency, + uwp.proficiency as mastery_level, + uwp.study_count as review_count, + uwp.next_review_at + FROM ai_vocabulary v + INNER JOIN ai_user_word_progress uwp ON v.id = uwp.vocabulary_id + WHERE uwp.user_id = ? + AND v.is_active = 1 + ORDER BY uwp.last_studied_at DESC + LIMIT ? + ` + + rows, err := s.db.Raw(query, userID, limit).Rows() + if err != nil { + return nil, err + } + defer rows.Close() + + var vocabularyIDs []int64 + tempWords := make(map[int64]map[string]interface{}) + + for rows.Next() { + var ( + id, reviewCount, difficultyLevel, frequency int64 + word, phonetic, phoneticUs, phoneticUk, audioUrl, audioUsUrl, audioUkUrl, level string + masteryLevel int + nextReviewAt *time.Time + ) + + if err := rows.Scan(&id, &word, &phonetic, &phoneticUs, &phoneticUk, &audioUrl, &audioUsUrl, &audioUkUrl, &level, &difficultyLevel, &frequency, &masteryLevel, &reviewCount, &nextReviewAt); err != nil { + continue + } + + vocabularyIDs = append(vocabularyIDs, id) + tempWords[id] = map[string]interface{}{ + "id": fmt.Sprintf("%d", id), + "word": word, + "phonetic": phonetic, + "phonetic_us": phoneticUs, + "phonetic_uk": phoneticUk, + "audio_url": audioUrl, + "audio_us_url": audioUsUrl, + "audio_uk_url": audioUkUrl, + "difficulty": s.mapDifficultyLevel(int(difficultyLevel)), + "frequency": int(frequency), + "mastery_level": masteryLevel, + "review_count": reviewCount, + "next_review_at": nextReviewAt, + "definitions": []map[string]interface{}{}, + "examples": []map[string]interface{}{}, + "created_at": time.Now(), + "updated_at": time.Now(), + } + } + + // 批量获取释义 + if len(vocabularyIDs) > 0 { + s.loadDefinitionsForWords(vocabularyIDs, tempWords) + s.loadExamplesForWords(vocabularyIDs, tempWords) + } + + // 按原始顺序返回 + for _, id := range vocabularyIDs { + words = append(words, tempWords[id]) + } + + // 如果没有需要复习的，返回一些新单词 + if len(words) == 0 { + newWordsQuery := ` + SELECT + v.id, + v.word, + COALESCE(v.phonetic, '') as phonetic, + COALESCE(v.phonetic_us, '') as phonetic_us, + COALESCE(v.phonetic_uk, '') as phonetic_uk, + COALESCE(v.audio_url, '') as audio_url, + COALESCE(v.audio_us_url, '') as audio_us_url, + COALESCE(v.audio_uk_url, '') as audio_uk_url, + COALESCE(v.level, '') as level, + v.difficulty_level, + v.frequency + FROM ai_vocabulary v + WHERE v.is_active = 1 + AND NOT EXISTS ( + SELECT 1 FROM ai_user_word_progress uvp + WHERE uvp.vocabulary_id = v.id AND uvp.user_id = ? + ) + ORDER BY v.frequency DESC, RAND() + LIMIT ? + ` + + rows, err := s.db.Raw(newWordsQuery, userID, limit).Rows() + if err != nil { + return nil, err + } + defer rows.Close() + + var newVocabularyIDs []int64 + newTempWords := make(map[int64]map[string]interface{}) + + for rows.Next() { + var ( + id, difficultyLevel, frequency int64 + word, phonetic, phoneticUs, phoneticUk, audioUrl, audioUsUrl, audioUkUrl, level string + ) + + if err := rows.Scan(&id, &word, &phonetic, &phoneticUs, &phoneticUk, &audioUrl, &audioUsUrl, &audioUkUrl, &level, &difficultyLevel, &frequency); err != nil { + fmt.Printf("err:%+v", err) + continue + } + + newVocabularyIDs = append(newVocabularyIDs, id) + newTempWords[id] = map[string]interface{}{ + "id": fmt.Sprintf("%d", id), + "word": word, + "phonetic": phonetic, + "phonetic_us": phoneticUs, + "phonetic_uk": phoneticUk, + "audio_url": audioUrl, + "audio_us_url": audioUsUrl, + "audio_uk_url": audioUkUrl, + "difficulty": s.mapDifficultyLevel(int(difficultyLevel)), + "frequency": int(frequency), + "mastery_level": 0, + "review_count": 0, + "definitions": []map[string]interface{}{}, + "examples": []map[string]interface{}{}, + "created_at": time.Now(), + "updated_at": time.Now(), + } + } + + // 批量获取释义和例句 + if len(newVocabularyIDs) > 0 { + s.loadDefinitionsForWords(newVocabularyIDs, newTempWords) + s.loadExamplesForWords(newVocabularyIDs, newTempWords) + } + + // 按原始顺序返回 + for _, id := range newVocabularyIDs { + words = append(words, newTempWords[id]) + } + } + + return words, nil +} + +// GetStudyStatistics 获取学习统计 +func (s *VocabularyService) GetStudyStatistics(userID int64, date string) (map[string]interface{}, error) { + stats := make(map[string]interface{}) + + // 如果指定日期没有数据，使用最近一次学习的日期 + var actualDate string + dateCheckQuery := ` + SELECT DATE_FORMAT(DATE(last_studied_at), '%Y-%m-%d') as study_date + FROM ai_user_word_progress + WHERE user_id = ? AND DATE(last_studied_at) <= ? + ORDER BY last_studied_at DESC + LIMIT 1 + ` + if err := s.db.Raw(dateCheckQuery, userID, date).Scan(&actualDate).Error; err != nil { + // 如果没有任何学习记录，使用传入的日期 + actualDate = date + } + + // 今日学习单词数（去重） + var wordsStudied int64 + todayQuery := ` + SELECT COUNT(DISTINCT vocabulary_id) + FROM ai_user_word_progress + WHERE user_id = ? AND DATE(last_studied_at) = ? + ` + if err := s.db.Raw(todayQuery, userID, actualDate).Scan(&wordsStudied).Error; err != nil { + return nil, err + } + + // 今日新学单词数（第一次学习） + var newWordsLearned int64 + newWordsQuery := ` + SELECT COUNT(*) + FROM ai_user_word_progress + WHERE user_id = ? + AND DATE(first_studied_at) = ? + ` + if err := s.db.Raw(newWordsQuery, userID, actualDate).Scan(&newWordsLearned).Error; err != nil { + return nil, err + } + + // 今日复习单词数 + var wordsReviewed int64 + reviewQuery := ` + SELECT COUNT(*) + FROM ai_user_word_progress + WHERE user_id = ? + AND DATE(last_studied_at) = ? + AND study_count > 1 + ` + if err := s.db.Raw(reviewQuery, userID, actualDate).Scan(&wordsReviewed).Error; err != nil { + return nil, err + } + + // 今日掌握单词数 + var wordsMastered int64 + masteredQuery := ` + SELECT COUNT(*) + FROM ai_user_word_progress + WHERE user_id = ? + AND DATE(mastered_at) = ? + AND status = 'mastered' + ` + if err := s.db.Raw(masteredQuery, userID, actualDate).Scan(&wordsMastered).Error; err != nil { + return nil, err + } + + // 今日正确和错误次数 + var correctAnswers, wrongAnswers int64 + answersQuery := ` + SELECT + COALESCE(SUM(correct_count), 0) as correct, + COALESCE(SUM(wrong_count), 0) as wrong + FROM ai_user_word_progress + WHERE user_id = ? + AND DATE(last_studied_at) = ? + ` + row := s.db.Raw(answersQuery, userID, actualDate).Row() + if err := row.Scan(&correctAnswers, &wrongAnswers); err != nil { + return nil, err + } + + // 计算准确率 + totalAnswers := correctAnswers + wrongAnswers + averageAccuracy := 0.0 + if totalAnswers > 0 { + averageAccuracy = float64(correctAnswers) / float64(totalAnswers) + } + + // 构建返回数据（匹配前端StudyStatistics模型） + stats["id"] = fmt.Sprintf("stats_%d_%s", userID, actualDate) + stats["user_id"] = fmt.Sprintf("%d", userID) + stats["date"] = actualDate + stats["session_count"] = 1 + stats["words_studied"] = wordsStudied + stats["new_words_learned"] = newWordsLearned + stats["words_reviewed"] = wordsReviewed + stats["words_mastered"] = wordsMastered + stats["total_study_time_seconds"] = int(wordsStudied) * 30 // 估算学习时间 + stats["correct_answers"] = correctAnswers + stats["wrong_answers"] = wrongAnswers + stats["average_accuracy"] = averageAccuracy + stats["experience_gained"] = int(wordsStudied) * 5 + stats["points_gained"] = int(wordsStudied) * 2 + stats["streak_days"] = 1 + + return stats, nil +} + +// GetStudyStatisticsHistory 获取学习统计历史 +func (s *VocabularyService) GetStudyStatisticsHistory(userID int64, startDate, endDate string) ([]map[string]interface{}, error) { + var history []map[string]interface{} + + log.Printf("[DEBUG] GetStudyStatisticsHistory: userID=%d, startDate=%s, endDate=%s", userID, startDate, endDate) + + // 按日期分组统计学习数据 + query := ` + SELECT + DATE(last_studied_at) as date, + COUNT(DISTINCT vocabulary_id) as words_studied, + SUM(CASE WHEN DATE(first_studied_at) = DATE(last_studied_at) THEN 1 ELSE 0 END) as new_words_learned, + SUM(CASE WHEN study_count > 1 THEN 1 ELSE 0 END) as words_reviewed, + SUM(CASE WHEN status = 'mastered' AND DATE(mastered_at) = DATE(last_studied_at) THEN 1 ELSE 0 END) as words_mastered, + SUM(correct_count) as correct_answers, + SUM(wrong_count) as wrong_answers + FROM ai_user_word_progress + WHERE user_id = ? + AND DATE(last_studied_at) BETWEEN ? AND ? + GROUP BY DATE(last_studied_at) + ORDER BY DATE(last_studied_at) ASC + ` + + rows, err := s.db.Raw(query, userID, startDate, endDate).Rows() + if err != nil { + log.Printf("[ERROR] GetStudyStatisticsHistory query failed: %v", err) + return nil, err + } + defer rows.Close() + + for rows.Next() { + var ( + date time.Time + wordsStudied, newWordsLearned, wordsReviewed, wordsMastered int64 + correctAnswers, wrongAnswers int64 + ) + + if err := rows.Scan(&date, &wordsStudied, &newWordsLearned, &wordsReviewed, &wordsMastered, &correctAnswers, &wrongAnswers); err != nil { + log.Printf("[ERROR] GetStudyStatisticsHistory scan failed: %v", err) + continue + } + + // 格式化日期为 YYYY-MM-DD 字符串 + dateStr := date.Format("2006-01-02") + + // 计算准确率 + totalAnswers := correctAnswers + wrongAnswers + averageAccuracy := 0.0 + if totalAnswers > 0 { + averageAccuracy = float64(correctAnswers) / float64(totalAnswers) + } + + // 构建返回数据（匹配前端StudyStatistics模型） + history = append(history, map[string]interface{}{ + "id": fmt.Sprintf("stats_%d_%s", userID, dateStr), + "user_id": fmt.Sprintf("%d", userID), + "date": dateStr, + "session_count": 1, + "words_studied": wordsStudied, + "new_words_learned": newWordsLearned, + "words_reviewed": wordsReviewed, + "words_mastered": wordsMastered, + "total_study_time_seconds": int(wordsStudied) * 30, + "correct_answers": correctAnswers, + "wrong_answers": wrongAnswers, + "average_accuracy": averageAccuracy, + "experience_gained": int(wordsStudied) * 5, + "points_gained": int(wordsStudied) * 2, + "streak_days": 1, + }) + } + + return history, nil +} + +// GetVocabularyTest 获取词汇测试 +func (s *VocabularyService) GetVocabularyTest(testID string) (*models.VocabularyTest, error) { + var test models.VocabularyTest + if err := s.db.Where("id = ?", testID).First(&test).Error; err != nil { + if err == gorm.ErrRecordNotFound { + return nil, common.NewBusinessError(common.ErrCodeTestNotFound, "测试不存在") + } + return nil, err + } + return &test, nil +} + +// CreateVocabularyTest 创建词汇测试 +func (s *VocabularyService) CreateVocabularyTest(userID int64, testType, level string, totalWords int) (*models.VocabularyTest, error) { + test := &models.VocabularyTest{ + ID: 0, // 让数据库自动生成 + UserID: userID, + TestType: testType, + Level: level, + TotalWords: totalWords, + StartedAt: time.Now(), + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + if err := s.db.Create(test).Error; err != nil { + return nil, err + } + + return test, nil +} + +// UpdateVocabularyTestResult 更新词汇测试结果 +func (s *VocabularyService) UpdateVocabularyTestResult(testID string, correctWords int, score float64, duration int) error { + now := time.Now() + updates := map[string]interface{}{ + "correct_words": correctWords, + "score": score, + "duration": duration, + "completed_at": &now, + "updated_at": now, + } + + result := s.db.Model(&models.VocabularyTest{}).Where("id = ?", testID).Updates(updates) + if result.Error != nil { + return result.Error + } + + if result.RowsAffected == 0 { + return common.NewBusinessError(common.ErrCodeTestNotFound, "测试不存在") + } + + return nil +} + +// SearchVocabularies 搜索词汇 +func (s *VocabularyService) SearchVocabularies(keyword string, level string, page, pageSize int) (*common.PaginationData, error) { + offset := utils.CalculateOffset(page, pageSize) + + query := s.db.Model(&models.Vocabulary{}) + + // 关键词搜索 + if keyword != "" { + query = query.Where("word LIKE ? OR phonetic LIKE ?", "%"+keyword+"%", "%"+keyword+"%") + } + + // 级别过滤 + if level != "" { + query = query.Where("level = ?", level) + } + + // 只查询启用的词汇 + query = query.Where("is_active = ?", true) + + // 获取总数 + var total int64 + if err := query.Count(&total).Error; err != nil { + return nil, err + } + + // 获取词汇列表 + var vocabularies []models.Vocabulary + if err := query.Preload("Definitions").Preload("Examples").Preload("Images").Preload("Categories"). + Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&vocabularies).Error; err != nil { + return nil, err + } + + totalPages := utils.CalculateTotalPages(int(total), pageSize) + + return &common.PaginationData{ + Items: vocabularies, + Pagination: &common.Pagination{ + Page: page, + PageSize: pageSize, + Total: int(total), + TotalPages: totalPages, + }, + }, nil +} + +// GetDailyStats 获取每日学习统计 +func (s *VocabularyService) GetDailyStats(userID string) (map[string]interface{}, error) { + var stats struct { + WordsLearned int `json:"wordsLearned"` + StudyTimeMinutes int `json:"studyTimeMinutes"` + } + + // 查询今日学习单词数量（今天有复习记录的单词） + if err := s.db.Raw(` + SELECT COUNT(DISTINCT vocabulary_id) AS wordsLearned + FROM ai_user_vocabulary_progress + WHERE user_id = ? AND DATE(last_reviewed_at) = CURDATE() + `, userID).Scan(&stats.WordsLearned).Error; err != nil { + return nil, err + } + + // 查询今日学习时间（根据复习次数估算，每次复习约2分钟） + var reviewCount int + if err := s.db.Raw(` + SELECT COALESCE(SUM(review_count), 0) AS review_count + FROM ai_user_vocabulary_progress + WHERE user_id = ? AND DATE(last_reviewed_at) = CURDATE() + `, userID).Scan(&reviewCount).Error; err != nil { + return nil, err + } + stats.StudyTimeMinutes = reviewCount * 2 // 估算学习时间 + + return map[string]interface{}{ + "wordsLearned": stats.WordsLearned, + "studyTimeMinutes": stats.StudyTimeMinutes, + }, nil +} + +// GetUserLearningProgress 获取用户学习进度 +func (s *VocabularyService) GetUserLearningProgress(userID string, page, limit int) ([]map[string]interface{}, int64, error) { + var progressList []map[string]interface{} + var total int64 + + // 查询用户在各个分类的学习进度 + query := ` + SELECT + vc.id, + vc.name as title, + vc.category, + vc.level, + COUNT(DISTINCT v.id) as total_words, + COUNT(DISTINCT CASE WHEN uvp.mastery_level >= 3 THEN uvp.vocabulary_id END) as learned_words, + MAX(uvp.last_review_date) as last_study_date + FROM vocabulary_categories vc + LEFT JOIN vocabulary v ON v.category_id = vc.id + LEFT JOIN user_vocabulary_progress uvp ON uvp.vocabulary_id = v.id AND uvp.user_id = ? + GROUP BY vc.id, vc.name, vc.category, vc.level + HAVING total_words > 0 + ORDER BY last_study_date DESC NULLS LAST + ` + + // 获取总数 + countQuery := ` + SELECT COUNT(*) FROM ( + SELECT vc.id + FROM vocabulary_categories vc + LEFT JOIN vocabulary v ON v.category_id = vc.id + GROUP BY vc.id + HAVING COUNT(DISTINCT v.id) > 0 + ) as subquery + ` + if err := s.db.Raw(countQuery).Scan(&total).Error; err != nil { + return nil, 0, err + } + + // 分页查询 + offset := (page - 1) * limit + rows, err := s.db.Raw(query+" LIMIT ? OFFSET ?", userID, limit, offset).Rows() + if err != nil { + return nil, 0, err + } + defer rows.Close() + + for rows.Next() { + var ( + id string + title string + category string + level string + totalWords int + learnedWords int + lastStudyDate *time.Time + ) + + if err := rows.Scan(&id, &title, &category, &level, &totalWords, &learnedWords, &lastStudyDate); err != nil { + continue + } + + progress := float64(0) + if totalWords > 0 { + progress = float64(learnedWords) / float64(totalWords) * 100 + } + + item := map[string]interface{}{ + "id": id, + "title": title, + "category": category, + "level": level, + "total_words": totalWords, + "learned_words": learnedWords, + "progress": progress, + "last_study_date": lastStudyDate, + } + + progressList = append(progressList, item) + } + + return progressList, total, nil +} + +// loadDefinitionsForWords 批量加载单词的释义 +func (s *VocabularyService) loadDefinitionsForWords(vocabularyIDs []int64, words map[int64]map[string]interface{}) { + var definitions []struct { + VocabularyID int64 `gorm:"column:vocabulary_id"` + PartOfSpeech string `gorm:"column:part_of_speech"` + DefinitionEn string `gorm:"column:definition_en"` + DefinitionCn string `gorm:"column:definition_cn"` + } + + if err := s.db.Table("ai_vocabulary_definitions"). + Where("vocabulary_id IN ?", vocabularyIDs). + Order("vocabulary_id, sort_order"). + Find(&definitions).Error; err != nil { + return + } + + for _, def := range definitions { + if word, ok := words[def.VocabularyID]; ok { + defs := word["definitions"].([]map[string]interface{}) + defs = append(defs, map[string]interface{}{ + "type": def.PartOfSpeech, + "definition": def.DefinitionEn, + "translation": def.DefinitionCn, + }) + word["definitions"] = defs + } + } +} + +// loadExamplesForWords 批量加载单词的例句 +func (s *VocabularyService) loadExamplesForWords(vocabularyIDs []int64, words map[int64]map[string]interface{}) { + var examples []struct { + VocabularyID int64 `gorm:"column:vocabulary_id"` + SentenceEn string `gorm:"column:sentence_en"` + SentenceCn string `gorm:"column:sentence_cn"` + } + + if err := s.db.Table("ai_vocabulary_examples"). + Where("vocabulary_id IN ?", vocabularyIDs). + Order("vocabulary_id, sort_order"). + Limit(len(vocabularyIDs) * 3). // 每个单词最多3个例句 + Find(&examples).Error; err != nil { + return + } + + for _, ex := range examples { + if word, ok := words[ex.VocabularyID]; ok { + exs := word["examples"].([]map[string]interface{}) + exs = append(exs, map[string]interface{}{ + "sentence": ex.SentenceEn, + "translation": ex.SentenceCn, + }) + word["examples"] = exs + } + } +} + +// mapDifficultyLevel 映射难度等级 +func (s *VocabularyService) mapDifficultyLevel(level int) string { + switch level { + case 1: + return "beginner" + case 2: + return "elementary" + case 3: + return "intermediate" + case 4: + return "advanced" + case 5: + return "expert" + default: + return "intermediate" + } +} + +// GetSystemVocabularyBooks 获取系统词汇书列表 +func (s *VocabularyService) GetSystemVocabularyBooks(page, limit int, category string) ([]models.VocabularyBook, int64, error) { + var books []models.VocabularyBook + var total int64 + + query := s.db.Model(&models.VocabularyBook{}).Where("is_system = ? AND is_active = ?", true, true) + + // 如果指定了分类，添加分类过滤 + if category != "" { + query = query.Where("category = ?", category) + } + + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + offset := (page - 1) * limit + if err := query.Offset(offset).Limit(limit).Order("sort_order ASC, created_at DESC").Find(&books).Error; err != nil { + return nil, 0, err + } + + return books, total, nil +} + +// GetVocabularyBookCategories 获取词汇书分类列表 +func (s *VocabularyService) GetVocabularyBookCategories() ([]map[string]interface{}, error) { + var results []struct { + Category string + Count int64 + } + + // 查询所有分类及其词汇书数量 + if err := s.db.Model(&models.VocabularyBook{}). + Select("category, COUNT(*) as count"). + Where("is_system = ? AND is_active = ?", true, true). + Group("category"). + Order("MIN(sort_order)"). + Find(&results).Error; err != nil { + return nil, err + } + + // 转换为返回格式 + categories := make([]map[string]interface{}, 0, len(results)) + for _, result := range results { + categories = append(categories, map[string]interface{}{ + "name": result.Category, + "count": result.Count, + }) + } + + return categories, nil +} + +// GetVocabularyBookProgress 获取词汇书学习进度 +func (s *VocabularyService) GetVocabularyBookProgress(userID int64, bookID string) (*models.UserVocabularyBookProgress, error) { + var progress models.UserVocabularyBookProgress + + // 查询进度表 + err := s.db.Where("user_id = ? AND book_id = ?", userID, bookID). + First(&progress).Error + + if err != nil { + return nil, err + } + + return &progress, nil +} + +// GetVocabularyBookWords 获取词汇书单词列表 +func (s *VocabularyService) GetVocabularyBookWords(bookID string, page, limit int) ([]models.VocabularyBookWord, int64, error) { + var bookWords []models.VocabularyBookWord + var total int64 + + query := s.db.Model(&models.VocabularyBookWord{}).Where("book_id = ?", bookID) + + if err := query.Count(&total).Error; err != nil { + return nil, 0, err + } + + offset := (page - 1) * limit + if err := query.Offset(offset). + Limit(limit). + Order("sort_order ASC, id ASC"). + Find(&bookWords).Error; err != nil { + return nil, 0, err + } + + // 手动加载词汇数据 + for i := range bookWords { + var vocab models.Vocabulary + + // 将vocabulary_id从string转换为int64（因为数据库表类型不一致） + // ai_vocabulary_book_words.vocabulary_id 是 varchar + // ai_vocabulary.id 是 bigint + vocabularyIDInt64, err := strconv.ParseInt(bookWords[i].VocabularyID, 10, 64) + if err != nil { + // 如果转换失败，跳过这个单词 + continue + } + + if err := s.db.Where("id = ?", vocabularyIDInt64).First(&vocab).Error; err != nil { + continue + } + + // 加载释义 + s.db.Where("vocabulary_id = ?", vocab.ID).Find(&vocab.Definitions) + + // 加载例句 + s.db.Where("vocabulary_id = ?", vocab.ID).Find(&vocab.Examples) + + bookWords[i].Vocabulary = &vocab + } + + return bookWords, total, nil +} + +// GetUserWordProgress 获取用户单词学习进度 +func (s *VocabularyService) GetUserWordProgress(userID int64, wordID int64) (map[string]interface{}, error) { + // 查询用户单词进度记录 + var progress models.UserWordProgress + err := s.db.Where("user_id = ? AND vocabulary_id = ?", userID, wordID).First(&progress).Error + + if err == gorm.ErrRecordNotFound { + // 如果没有记录，返回默认进度 + now := time.Now() + return map[string]interface{}{ + "id": "0", + "userId": fmt.Sprint(userID), + "wordId": fmt.Sprint(wordID), + "status": "not_started", + "studyCount": 0, + "correctCount": 0, + "wrongCount": 0, + "proficiency": 0, + "nextReviewAt": nil, + "reviewInterval": 1, + "firstStudiedAt": now, + "lastStudiedAt": now, + "masteredAt": nil, + }, nil + } + + if err != nil { + return nil, err + } + + // 返回进度数据 + return map[string]interface{}{ + "id": fmt.Sprint(progress.ID), + "userId": fmt.Sprint(progress.UserID), + "wordId": fmt.Sprint(progress.VocabularyID), + "status": progress.Status, + "studyCount": progress.StudyCount, + "correctCount": progress.CorrectCount, + "wrongCount": progress.WrongCount, + "proficiency": progress.Proficiency, + "nextReviewAt": progress.NextReviewAt, + "reviewInterval": progress.ReviewInterval, + "firstStudiedAt": progress.FirstStudiedAt, + "lastStudiedAt": progress.LastStudiedAt, + "masteredAt": progress.MasteredAt, + }, nil +} + +// UpdateUserWordProgress 更新用户单词学习进度 +func (s *VocabularyService) UpdateUserWordProgress(userID int64, wordID int64, status string, isCorrect *bool) (map[string]interface{}, error) { + var progress models.UserWordProgress + err := s.db.Where("user_id = ? AND vocabulary_id = ?", userID, wordID).First(&progress).Error + + now := time.Now() + + if err == gorm.ErrRecordNotFound { + // 创建新记录 + progress = models.UserWordProgress{ + UserID: userID, + VocabularyID: wordID, + Status: status, + StudyCount: 1, + CorrectCount: 0, + WrongCount: 0, + Proficiency: 0, + ReviewInterval: 1, + FirstStudiedAt: now, + LastStudiedAt: now, + } + + if isCorrect != nil && *isCorrect { + progress.CorrectCount = 1 + progress.Proficiency = 20 + } else if isCorrect != nil { + progress.WrongCount = 1 + } + + if err := s.db.Create(&progress).Error; err != nil { + return nil, err + } + } else if err != nil { + return nil, err + } else { + // 更新现有记录 + progress.Status = status + progress.StudyCount++ + progress.LastStudiedAt = now + + if isCorrect != nil && *isCorrect { + progress.CorrectCount++ + // 根据正确率更新熟练度 + accuracy := float64(progress.CorrectCount) / float64(progress.StudyCount) + progress.Proficiency = int(accuracy * 100) + + // 如果熟练度达到80%，标记为已掌握 + if progress.Proficiency >= 80 && progress.Status != "mastered" { + progress.Status = "mastered" + progress.MasteredAt = &now + } + } else if isCorrect != nil { + progress.WrongCount++ + // 降低熟练度 + if progress.Proficiency > 10 { + progress.Proficiency -= 10 + } + } + + if err := s.db.Save(&progress).Error; err != nil { + return nil, err + } + } + + // 返回更新后的进度 + return map[string]interface{}{ + "id": fmt.Sprint(progress.ID), + "userId": fmt.Sprint(progress.UserID), + "wordId": fmt.Sprint(progress.VocabularyID), + "status": progress.Status, + "studyCount": progress.StudyCount, + "correctCount": progress.CorrectCount, + "wrongCount": progress.WrongCount, + "proficiency": progress.Proficiency, + "nextReviewAt": progress.NextReviewAt, + "reviewInterval": progress.ReviewInterval, + "firstStudiedAt": progress.FirstStudiedAt, + "lastStudiedAt": progress.LastStudiedAt, + "masteredAt": progress.MasteredAt, + }, nil +} diff --git a/serve/internal/services/word_book_service.go b/serve/internal/services/word_book_service.go new file mode 100644 index 0000000..de8b83d --- /dev/null +++ b/serve/internal/services/word_book_service.go @@ -0,0 +1,237 @@ +package services + +import ( + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "gorm.io/gorm" +) + +// WordBookService 生词本服务 +type WordBookService struct { + db *gorm.DB +} + +func NewWordBookService(db *gorm.DB) *WordBookService { + return &WordBookService{db: db} +} + +// ToggleFavorite 切换单词收藏状态 +func (s *WordBookService) ToggleFavorite(userID, wordID int64) (bool, error) { + var progress models.UserWordProgress + err := s.db.Where("user_id = ? AND vocabulary_id = ?", userID, wordID).First(&progress).Error + + if err == gorm.ErrRecordNotFound { + // 如果没有进度记录，创建一个并设置为收藏 + now := time.Now() + progress = models.UserWordProgress{ + UserID: userID, + VocabularyID: wordID, + Status: "not_started", + StudyCount: 0, + CorrectCount: 0, + WrongCount: 0, + Proficiency: 0, + ReviewInterval: 1, + FirstStudiedAt: now, + LastStudiedAt: now, + } + + // 通过GORM钩子设置IsFavorite（因为是bool类型的零值问题） + if err := s.db.Create(&progress).Error; err != nil { + return false, err + } + + // 更新IsFavorite为true + if err := s.db.Model(&progress).Update("is_favorite", true).Error; err != nil { + return false, err + } + + return true, nil + } else if err != nil { + return false, err + } + + // 切换收藏状态 + newStatus := !progress.IsFavorite + if err := s.db.Model(&progress).Update("is_favorite", newStatus).Error; err != nil { + return false, err + } + + return newStatus, nil +} + +// GetFavoriteWords 获取生词本列表（带分页） +func (s *WordBookService) GetFavoriteWords(userID int64, page, pageSize int, sortBy, order string) ([]map[string]interface{}, int64, error) { + var total int64 + + // 统计总数 + s.db.Model(&models.UserWordProgress{}). + Where("user_id = ? AND is_favorite = ?", userID, true). + Count(&total) + + if total == 0 { + return []map[string]interface{}{}, 0, nil + } + + // 构建排序字段 + orderClause := "uwp.created_at DESC" + switch sortBy { + case "proficiency": + orderClause = "uwp.proficiency " + order + case "word": + orderClause = "v.word " + order + case "created_at": + orderClause = "uwp.created_at " + order + } + + // 查询收藏的单词及其详情 + var results []map[string]interface{} + offset := (page - 1) * pageSize + + err := s.db.Raw(` + SELECT + v.id, + v.word, + v.phonetic, + v.audio_url, + v.level, + uwp.proficiency, + uwp.study_count, + uwp.status, + uwp.next_review_at, + uwp.created_at as favorited_at, + GROUP_CONCAT(DISTINCT vd.definition_cn SEPARATOR '; ') as definitions, + GROUP_CONCAT(DISTINCT vd.part_of_speech SEPARATOR ', ') as parts_of_speech + FROM ai_user_word_progress uwp + INNER JOIN ai_vocabulary v ON v.id = uwp.vocabulary_id + LEFT JOIN ai_vocabulary_definitions vd ON vd.vocabulary_id = v.id + WHERE uwp.user_id = ? AND uwp.is_favorite = true + GROUP BY v.id, v.word, v.phonetic, v.audio_url, v.level, + uwp.proficiency, uwp.study_count, uwp.status, uwp.next_review_at, uwp.created_at + ORDER BY `+orderClause+` + LIMIT ? OFFSET ? + `, userID, pageSize, offset).Scan(&results).Error + + if err != nil { + return nil, 0, err + } + + return results, total, nil +} + +// GetFavoriteWordsByBook 获取指定词汇书的生词本 +func (s *WordBookService) GetFavoriteWordsByBook(userID int64, bookID string) ([]map[string]interface{}, error) { + var results []map[string]interface{} + + err := s.db.Raw(` + SELECT + v.id, + v.word, + v.phonetic, + v.audio_url, + v.level, + uwp.proficiency, + uwp.study_count, + uwp.status, + GROUP_CONCAT(DISTINCT vd.definition_cn SEPARATOR '; ') as definitions, + GROUP_CONCAT(DISTINCT vd.part_of_speech SEPARATOR ', ') as parts_of_speech + FROM ai_user_word_progress uwp + INNER JOIN ai_vocabulary v ON v.id = uwp.vocabulary_id + INNER JOIN ai_vocabulary_book_words vbw ON CAST(vbw.vocabulary_id AS UNSIGNED) = v.id + LEFT JOIN ai_vocabulary_definitions vd ON vd.vocabulary_id = v.id + WHERE uwp.user_id = ? AND uwp.is_favorite = true AND vbw.book_id = ? + GROUP BY v.id, v.word, v.phonetic, v.audio_url, v.level, + uwp.proficiency, uwp.study_count, uwp.status + ORDER BY uwp.created_at DESC + `, userID, bookID).Scan(&results).Error + + if err != nil { + return nil, err + } + + return results, nil +} + +// GetFavoriteStats 获取生词本统计信息 +func (s *WordBookService) GetFavoriteStats(userID int64) (map[string]interface{}, error) { + var stats struct { + TotalWords int64 + MasteredWords int64 + ReviewingWords int64 + LearningWords int64 + AvgProficiency float64 + NeedReviewToday int64 + } + + // 统计总数和各状态数量 + s.db.Raw(` + SELECT + COUNT(*) as total_words, + SUM(CASE WHEN status = 'mastered' THEN 1 ELSE 0 END) as mastered_words, + SUM(CASE WHEN status = 'reviewing' THEN 1 ELSE 0 END) as reviewing_words, + SUM(CASE WHEN status = 'learning' THEN 1 ELSE 0 END) as learning_words, + AVG(proficiency) as avg_proficiency, + SUM(CASE WHEN next_review_at IS NOT NULL AND next_review_at <= NOW() THEN 1 ELSE 0 END) as need_review_today + FROM ai_user_word_progress + WHERE user_id = ? AND is_favorite = true + `, userID).Scan(&stats) + + return map[string]interface{}{ + "total_words": stats.TotalWords, + "mastered_words": stats.MasteredWords, + "reviewing_words": stats.ReviewingWords, + "learning_words": stats.LearningWords, + "avg_proficiency": stats.AvgProficiency, + "need_review_today": stats.NeedReviewToday, + }, nil +} + +// BatchAddToFavorite 批量添加到生词本 +func (s *WordBookService) BatchAddToFavorite(userID int64, wordIDs []int64) (int, error) { + count := 0 + now := time.Now() + + for _, wordID := range wordIDs { + var progress models.UserWordProgress + err := s.db.Where("user_id = ? AND vocabulary_id = ?", userID, wordID).First(&progress).Error + + if err == gorm.ErrRecordNotFound { + // 创建新记录 + progress = models.UserWordProgress{ + UserID: userID, + VocabularyID: wordID, + Status: "not_started", + StudyCount: 0, + CorrectCount: 0, + WrongCount: 0, + Proficiency: 0, + ReviewInterval: 1, + FirstStudiedAt: now, + LastStudiedAt: now, + } + if err := s.db.Create(&progress).Error; err != nil { + continue + } + if err := s.db.Model(&progress).Update("is_favorite", true).Error; err != nil { + continue + } + count++ + } else if err == nil && !progress.IsFavorite { + // 更新现有记录 + if err := s.db.Model(&progress).Update("is_favorite", true).Error; err != nil { + continue + } + count++ + } + } + + return count, nil +} + +// RemoveFromFavorite 从生词本移除 +func (s *WordBookService) RemoveFromFavorite(userID, wordID int64) error { + return s.db.Model(&models.UserWordProgress{}). + Where("user_id = ? AND vocabulary_id = ?", userID, wordID). + Update("is_favorite", false).Error +} diff --git a/serve/internal/services/writing_service.go b/serve/internal/services/writing_service.go new file mode 100644 index 0000000..7c94c50 --- /dev/null +++ b/serve/internal/services/writing_service.go @@ -0,0 +1,337 @@ +package services + +import ( + "database/sql" + "fmt" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "gorm.io/gorm" +) + +// WritingService 写作练习服务 +type WritingService struct { + db *gorm.DB +} + +// NewWritingService 创建写作练习服务实例 +func NewWritingService(db *gorm.DB) *WritingService { + return &WritingService{ + db: db, + } +} + +// ===== 写作题目管理 ===== + +// GetWritingPrompts 获取写作题目列表 +func (s *WritingService) GetWritingPrompts(difficulty string, category string, limit, offset int) ([]*models.WritingPrompt, error) { + var prompts []*models.WritingPrompt + query := s.db.Where("is_active = ?", true) + + if difficulty != "" { + query = query.Where("level = ?", difficulty) + } + if category != "" { + query = query.Where("category = ?", category) + } + + err := query.Order("created_at DESC").Limit(limit).Offset(offset).Find(&prompts).Error + return prompts, err +} + +// GetWritingPrompt 获取单个写作题目 +func (s *WritingService) GetWritingPrompt(id string) (*models.WritingPrompt, error) { + var prompt models.WritingPrompt + err := s.db.Where("id = ? AND is_active = ?", id, true).First(&prompt).Error + if err != nil { + return nil, err + } + return &prompt, nil +} + +// CreateWritingPrompt 创建写作题目 +func (s *WritingService) CreateWritingPrompt(prompt *models.WritingPrompt) error { + return s.db.Create(prompt).Error +} + +// UpdateWritingPrompt 更新写作题目 +func (s *WritingService) UpdateWritingPrompt(id string, prompt *models.WritingPrompt) error { + return s.db.Where("id = ?", id).Updates(prompt).Error +} + +// DeleteWritingPrompt 删除写作题目（软删除） +func (s *WritingService) DeleteWritingPrompt(id string) error { + return s.db.Model(&models.WritingPrompt{}).Where("id = ?", id).Update("is_active", false).Error +} + +// SearchWritingPrompts 搜索写作题目 +func (s *WritingService) SearchWritingPrompts(keyword string, difficulty string, category string, limit, offset int) ([]*models.WritingPrompt, error) { + var prompts []*models.WritingPrompt + query := s.db.Where("is_active = ?", true) + + if keyword != "" { + query = query.Where("title LIKE ? OR description LIKE ?", "%"+keyword+"%", "%"+keyword+"%") + } + if difficulty != "" { + query = query.Where("level = ?", difficulty) + } + if category != "" { + query = query.Where("category = ?", category) + } + + err := query.Order("created_at DESC").Limit(limit).Offset(offset).Find(&prompts).Error + return prompts, err +} + +// GetRecommendedPrompts 获取推荐写作题目 +func (s *WritingService) GetRecommendedPrompts(userID string, limit int) ([]*models.WritingPrompt, error) { + // 基于用户历史表现推荐合适难度的题目 + var prompts []*models.WritingPrompt + + // 获取用户最近的写作记录，分析难度偏好 + var avgScore sql.NullFloat64 + s.db.Model(&models.WritingSubmission{}). + Where("user_id = ? AND score IS NOT NULL", userID). + Select("AVG(score)").Scan(&avgScore) + + // 根据平均分推荐合适难度 + var difficulty string + if !avgScore.Valid || avgScore.Float64 < 60 { + difficulty = "beginner" + } else if avgScore.Float64 < 80 { + difficulty = "intermediate" + } else { + difficulty = "advanced" + } + + err := s.db.Where("level = ? AND is_active = ?", difficulty, true). + Order("RAND()").Limit(limit).Find(&prompts).Error + return prompts, err +} + +// ===== 写作提交管理 ===== + +// CreateWritingSubmission 创建写作提交 +func (s *WritingService) CreateWritingSubmission(submission *models.WritingSubmission) error { + return s.db.Create(submission).Error +} + +// UpdateWritingSubmission 更新写作提交 +func (s *WritingService) UpdateWritingSubmission(id string, submission *models.WritingSubmission) error { + return s.db.Where("id = ?", id).Updates(submission).Error +} + +// GetWritingSubmission 获取写作提交详情 +func (s *WritingService) GetWritingSubmission(id string) (*models.WritingSubmission, error) { + var submission models.WritingSubmission + err := s.db.Preload("Prompt").Where("id = ?", id).First(&submission).Error + if err != nil { + return nil, err + } + return &submission, nil +} + +// GetUserWritingSubmissions 获取用户写作提交列表 +func (s *WritingService) GetUserWritingSubmissions(userID string, limit, offset int) ([]*models.WritingSubmission, error) { + var submissions []*models.WritingSubmission + err := s.db.Preload("Prompt").Where("user_id = ?", userID). + Order("created_at DESC").Limit(limit).Offset(offset).Find(&submissions).Error + return submissions, err +} + +// SubmitWriting 提交写作作业 +func (s *WritingService) SubmitWriting(submissionID string, content string, timeSpent int) error { + now := time.Now() + updates := map[string]interface{}{ + "content": content, + "word_count": len(content), // 简单字数统计，实际可能需要更复杂的逻辑 + "time_spent": timeSpent, + "submitted_at": &now, + } + + return s.db.Model(&models.WritingSubmission{}).Where("id = ?", submissionID).Updates(updates).Error +} + +// GradeWriting AI批改写作 +func (s *WritingService) GradeWriting(submissionID string, score, grammarScore, vocabScore, coherenceScore float64, feedback, suggestions string) error { + now := time.Now() + updates := map[string]interface{}{ + "score": score, + "grammar_score": grammarScore, + "vocab_score": vocabScore, + "coherence_score": coherenceScore, + "feedback": feedback, + "suggestions": suggestions, + "graded_at": &now, + } + + return s.db.Model(&models.WritingSubmission{}).Where("id = ?", submissionID).Updates(updates).Error +} + +// ===== 写作统计分析 ===== + +// GetUserWritingStats 获取用户写作统计 +func (s *WritingService) GetUserWritingStats(userID string) (map[string]interface{}, error) { + stats := make(map[string]interface{}) + + // 总提交数 + var totalSubmissions int64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ?", userID).Count(&totalSubmissions) + stats["total_submissions"] = totalSubmissions + + // 已完成提交数 + var completedSubmissions int64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ? AND submitted_at IS NOT NULL", userID).Count(&completedSubmissions) + stats["completed_submissions"] = completedSubmissions + + // 已批改提交数 + var gradedSubmissions int64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ? AND graded_at IS NOT NULL", userID).Count(&gradedSubmissions) + stats["graded_submissions"] = gradedSubmissions + + // 平均分数 + var avgScore sql.NullFloat64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ? AND score IS NOT NULL", userID).Select("AVG(score)").Scan(&avgScore) + if avgScore.Valid { + stats["average_score"] = fmt.Sprintf("%.2f", avgScore.Float64) + } else { + stats["average_score"] = "0.00" + } + + // 平均语法分数 + var avgGrammarScore sql.NullFloat64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ? AND grammar_score IS NOT NULL", userID).Select("AVG(grammar_score)").Scan(&avgGrammarScore) + if avgGrammarScore.Valid { + stats["average_grammar_score"] = fmt.Sprintf("%.2f", avgGrammarScore.Float64) + } else { + stats["average_grammar_score"] = "0.00" + } + + // 平均词汇分数 + var avgVocabScore sql.NullFloat64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ? AND vocab_score IS NOT NULL", userID).Select("AVG(vocab_score)").Scan(&avgVocabScore) + if avgVocabScore.Valid { + stats["average_vocab_score"] = fmt.Sprintf("%.2f", avgVocabScore.Float64) + } else { + stats["average_vocab_score"] = "0.00" + } + + // 平均连贯性分数 + var avgCoherenceScore sql.NullFloat64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ? AND coherence_score IS NOT NULL", userID).Select("AVG(coherence_score)").Scan(&avgCoherenceScore) + if avgCoherenceScore.Valid { + stats["average_coherence_score"] = fmt.Sprintf("%.2f", avgCoherenceScore.Float64) + } else { + stats["average_coherence_score"] = "0.00" + } + + // 总写作时间 + var totalTimeSpent sql.NullInt64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ? AND time_spent IS NOT NULL", userID).Select("SUM(time_spent)").Scan(&totalTimeSpent) + if totalTimeSpent.Valid { + stats["total_time_spent"] = totalTimeSpent.Int64 + } else { + stats["total_time_spent"] = 0 + } + + // 平均写作时间 + var avgTimeSpent sql.NullFloat64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ? AND time_spent IS NOT NULL", userID).Select("AVG(time_spent)").Scan(&avgTimeSpent) + if avgTimeSpent.Valid { + stats["average_time_spent"] = fmt.Sprintf("%.2f", avgTimeSpent.Float64) + } else { + stats["average_time_spent"] = "0.00" + } + + // 总字数 + var totalWordCount sql.NullInt64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ? AND word_count IS NOT NULL", userID).Select("SUM(word_count)").Scan(&totalWordCount) + if totalWordCount.Valid { + stats["total_word_count"] = totalWordCount.Int64 + } else { + stats["total_word_count"] = 0 + } + + // 平均字数 + var avgWordCount sql.NullFloat64 + s.db.Model(&models.WritingSubmission{}).Where("user_id = ? AND word_count IS NOT NULL", userID).Select("AVG(word_count)").Scan(&avgWordCount) + if avgWordCount.Valid { + stats["average_word_count"] = fmt.Sprintf("%.2f", avgWordCount.Float64) + } else { + stats["average_word_count"] = "0.00" + } + + // 连续写作天数 + continuousDays := s.calculateContinuousWritingDays(userID) + stats["continuous_writing_days"] = continuousDays + + // 按难度统计 + difficultyStats := s.getWritingStatsByDifficulty(userID) + stats["difficulty_stats"] = difficultyStats + + return stats, nil +} + +// calculateContinuousWritingDays 计算连续写作天数 +func (s *WritingService) calculateContinuousWritingDays(userID string) int { + var dates []time.Time + s.db.Model(&models.WritingSubmission{}). + Where("user_id = ? AND submitted_at IS NOT NULL", userID). + Select("DATE(submitted_at) as date"). + Group("DATE(submitted_at)"). + Order("date DESC"). + Pluck("date", &dates) + + if len(dates) == 0 { + return 0 + } + + continuousDays := 1 + for i := 1; i < len(dates); i++ { + diff := dates[i-1].Sub(dates[i]).Hours() / 24 + if diff == 1 { + continuousDays++ + } else { + break + } + } + + return continuousDays +} + +// getWritingStatsByDifficulty 按难度获取写作统计 +func (s *WritingService) getWritingStatsByDifficulty(userID string) map[string]interface{} { + type DifficultyStats struct { + Difficulty string `json:"difficulty"` + Count int64 `json:"count"` + AvgScore float64 `json:"avg_score"` + } + + var stats []DifficultyStats + s.db.Model(&models.WritingSubmission{}). + Select("p.level as difficulty, COUNT(*) as count, COALESCE(AVG(writing_submissions.score), 0) as avg_score"). + Joins("JOIN writing_prompts p ON writing_submissions.prompt_id = p.id"). + Where("writing_submissions.user_id = ? AND writing_submissions.submitted_at IS NOT NULL", userID). + Group("p.level"). + Scan(&stats) + + result := make(map[string]interface{}) + for _, stat := range stats { + result[stat.Difficulty] = map[string]interface{}{ + "count": stat.Count, + "avg_score": fmt.Sprintf("%.2f", stat.AvgScore), + } + } + + return result +} + +// GetWritingProgress 获取写作进度 +func (s *WritingService) GetWritingProgress(userID string, promptID string) (*models.WritingSubmission, error) { + var submission models.WritingSubmission + err := s.db.Where("user_id = ? AND prompt_id = ?", userID, promptID).First(&submission).Error + if err != nil { + return nil, err + } + return &submission, nil +} \ No newline at end of file diff --git a/serve/internal/utils/utils.go b/serve/internal/utils/utils.go new file mode 100644 index 0000000..b998a6c --- /dev/null +++ b/serve/internal/utils/utils.go @@ -0,0 +1,223 @@ +package utils + +import ( + "crypto/rand" + "encoding/hex" + "fmt" + "regexp" + "strconv" + "strings" + "time" + + "github.com/gin-gonic/gin" + "github.com/google/uuid" + "golang.org/x/crypto/bcrypt" +) + +// HashPassword 对密码进行哈希加密 +func HashPassword(password string) (string, error) { + bytes, err := bcrypt.GenerateFromPassword([]byte(password), bcrypt.DefaultCost) + return string(bytes), err +} + +// CheckPasswordHash 验证密码哈希 +func CheckPasswordHash(password, hash string) bool { + err := bcrypt.CompareHashAndPassword([]byte(hash), []byte(password)) + return err == nil +} + +// GenerateUUID 生成UUID +func GenerateUUID() string { + return uuid.New().String() +} + +// GenerateRandomString 生成指定长度的随机字符串 +func GenerateRandomString(length int) (string, error) { + bytes := make([]byte, length/2) + if _, err := rand.Read(bytes); err != nil { + return "", err + } + return hex.EncodeToString(bytes), nil +} + +// IsValidEmail 验证邮箱格式 +func IsValidEmail(email string) bool { + pattern := `^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$` + regex := regexp.MustCompile(pattern) + return regex.MatchString(email) +} + +// IsValidPhone 验证手机号格式（中国大陆） +func IsValidPhone(phone string) bool { + pattern := `^1[3-9]\d{9}$` + regex := regexp.MustCompile(pattern) + return regex.MatchString(phone) +} + +// IsStrongPassword 验证密码强度 +func IsStrongPassword(password string) bool { + if len(password) < 8 { + return false + } + + // 至少包含一个数字 + hasNumber := regexp.MustCompile(`[0-9]`).MatchString(password) + // 至少包含一个小写字母 + hasLower := regexp.MustCompile(`[a-z]`).MatchString(password) + // 至少包含一个大写字母 + hasUpper := regexp.MustCompile(`[A-Z]`).MatchString(password) + // 至少包含一个特殊字符 + hasSpecial := regexp.MustCompile(`[!@#$%^&*()_+\-=\[\]{};':"\\|,.<>\/?]`).MatchString(password) + + return hasNumber && hasLower && hasUpper && hasSpecial +} + +// GetPaginationParams 从请求中获取分页参数 +func GetPaginationParams(c *gin.Context) (page, pageSize int) { + pageStr := c.DefaultQuery("page", "1") + pageSizeStr := c.DefaultQuery("page_size", "20") + + page, err := strconv.Atoi(pageStr) + if err != nil || page < 1 { + page = 1 + } + + pageSize, err = strconv.Atoi(pageSizeStr) + if err != nil || pageSize < 1 || pageSize > 100 { + pageSize = 20 + } + + return page, pageSize +} + +// CalculateOffset 计算数据库查询偏移量 +func CalculateOffset(page, pageSize int) int { + return (page - 1) * pageSize +} + +// CalculateTotalPages 计算总页数 +func CalculateTotalPages(total, pageSize int) int { + if total == 0 { + return 0 + } + return (total + pageSize - 1) / pageSize +} + +// StringToInt 字符串转整数，带默认值 +func StringToInt(str string, defaultValue int) int { + if str == "" { + return defaultValue + } + value, err := strconv.Atoi(str) + if err != nil { + return defaultValue + } + return value +} + +// StringToBool 字符串转布尔值，带默认值 +func StringToBool(str string, defaultValue bool) bool { + if str == "" { + return defaultValue + } + value, err := strconv.ParseBool(str) + if err != nil { + return defaultValue + } + return value +} + +// TrimSpaces 去除字符串前后空格 +func TrimSpaces(str string) string { + return strings.TrimSpace(str) +} + +// FormatTime 格式化时间 +func FormatTime(t time.Time) string { + return t.Format("2006-01-02 15:04:05") +} + +// ParseTime 解析时间字符串 +func ParseTime(timeStr string) (time.Time, error) { + return time.Parse("2006-01-02 15:04:05", timeStr) +} + +// GetUserIDFromContext 从上下文中获取用户ID +func GetUserIDFromContext(c *gin.Context) (int64, bool) { + userID, exists := c.Get("user_id") + if !exists { + return 0, false + } + if id, ok := userID.(int64); ok { + return id, true + } + return 0, false +} + +// SetUserIDToContext 设置用户ID到上下文 +func SetUserIDToContext(c *gin.Context, userID int64) { + c.Set("user_id", userID) +} + +// Int64ToString 将int64转换为string +func Int64ToString(i int64) string { + return strconv.FormatInt(i, 10) +} + +// StringToInt64 将string转换为int64 +func StringToInt64(str string) (int64, error) { + return strconv.ParseInt(str, 10, 64) +} + +// Contains 检查切片是否包含指定元素 +func Contains(slice []string, item string) bool { + for _, s := range slice { + if s == item { + return true + } + } + return false +} + +// RemoveDuplicates 去除字符串切片中的重复元素 +func RemoveDuplicates(slice []string) []string { + keys := make(map[string]bool) + result := []string{} + + for _, item := range slice { + if !keys[item] { + keys[item] = true + result = append(result, item) + } + } + + return result +} + +// GenerateFileName 生成文件名 +func GenerateFileName(originalName string) string { + ext := "" + if dotIndex := strings.LastIndex(originalName, "."); dotIndex != -1 { + ext = originalName[dotIndex:] + } + return fmt.Sprintf("%d_%s%s", time.Now().Unix(), GenerateUUID()[:8], ext) +} + +// GetClientIP 获取客户端IP地址 +func GetClientIP(c *gin.Context) string { + // 尝试从X-Forwarded-For头获取 + if ip := c.GetHeader("X-Forwarded-For"); ip != "" { + if index := strings.Index(ip, ","); index != -1 { + return strings.TrimSpace(ip[:index]) + } + return strings.TrimSpace(ip) + } + + // 尝试从X-Real-IP头获取 + if ip := c.GetHeader("X-Real-IP"); ip != "" { + return strings.TrimSpace(ip) + } + + // 使用RemoteAddr + return c.ClientIP() +} \ No newline at end of file diff --git a/serve/main.go b/serve/main.go new file mode 100644 index 0000000..ddc5a88 --- /dev/null +++ b/serve/main.go @@ -0,0 +1,83 @@ +// main.go +package main + +import ( + "fmt" + "log" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/api" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/config" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/database" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/logger" +) + +func main() { + // 加载配置 + config.LoadConfig() + if config.GlobalConfig == nil { + log.Fatal("Failed to load configuration") + } + + // 初始化日志系统 + loggerConfig := logger.LogConfig{ + Level: config.GlobalConfig.Log.Level, + Format: config.GlobalConfig.Log.Format, + Output: config.GlobalConfig.Log.Output, + FilePath: config.GlobalConfig.Log.FilePath, + MaxSize: config.GlobalConfig.Log.MaxSize, + MaxBackups: config.GlobalConfig.Log.MaxBackups, + MaxAge: config.GlobalConfig.Log.MaxAge, + Compress: config.GlobalConfig.Log.Compress, + } + logger.InitLogger(loggerConfig) + + // 初始化数据库 + database.InitDatabase() + defer database.CloseDatabase() + + // 检查是否为生产环境 + isProduction := config.GlobalConfig.App.Environment == "production" + + // 生产环境下跳过数据库迁移和初始化操作 + if !isProduction { + // 执行合并后的SQL以创建视图/触发器/扩展表（若尚未存在） + if err := database.ApplyMergedSchemaIfNeeded(database.GetDB()); err != nil { + log.Printf("Warning: Failed to apply merged schema: %v", err) + } + + // 运行数据库迁移 + if err := database.AutoMigrate(database.GetDB()); err != nil { + log.Fatalf("Failed to migrate database: %v", err) + } + + // 创建索引 + if err := database.CreateIndexes(database.GetDB()); err != nil { + log.Printf("Warning: Failed to create indexes: %v", err) + } + + // 初始化种子数据 + if err := database.SeedData(database.GetDB()); err != nil { + log.Printf("Warning: Failed to seed data: %v", err) + } + } else { + log.Println("Production environment detected, skipping database migration and initialization") + } + + // 记录启动信息 + logger.WithFields(map[string]interface{}{ + "app_name": config.GlobalConfig.App.Name, + "app_version": config.GlobalConfig.App.Version, + "environment": config.GlobalConfig.App.Environment, + "port": config.GlobalConfig.Server.Port, + }).Info("Starting AI English Learning Server") + + // 从 api 包获取配置好的路由引擎 + router := api.SetupRouter() + + // 启动服务 + port := fmt.Sprintf(":%s", config.GlobalConfig.Server.Port) + logger.Infof("Server is running on port %s", config.GlobalConfig.Server.Port) + if err := router.Run(port); err != nil { + logger.Fatalf("Failed to start server: %v", err) + } +} diff --git a/serve/migrations/add_is_favorite_to_user_word_progress.sql b/serve/migrations/add_is_favorite_to_user_word_progress.sql new file mode 100644 index 0000000..ab1ff8d --- /dev/null +++ b/serve/migrations/add_is_favorite_to_user_word_progress.sql @@ -0,0 +1,6 @@ +-- 添加is_favorite字段到用户单词学习进度表 +ALTER TABLE ai_user_word_progress +ADD COLUMN is_favorite BOOLEAN DEFAULT FALSE COMMENT '是否收藏' AFTER proficiency; + +-- 创建索引以提高查询收藏单词的性能 +CREATE INDEX idx_is_favorite ON ai_user_word_progress(user_id, is_favorite); diff --git a/serve/migrations/add_vocabulary_extended_fields.sql b/serve/migrations/add_vocabulary_extended_fields.sql new file mode 100644 index 0000000..ae42ce5 --- /dev/null +++ b/serve/migrations/add_vocabulary_extended_fields.sql @@ -0,0 +1,25 @@ +-- 添加词汇扩展字段 +-- 为ai_vocabulary表添加同义词、反义词、派生词等字段 + +USE ai_english_learning; + +-- 添加扩展字段到词汇表 +ALTER TABLE ai_vocabulary +ADD COLUMN IF NOT EXISTS synonyms JSON COMMENT '同义词列表 ["happy", "joyful"]', +ADD COLUMN IF NOT EXISTS antonyms JSON COMMENT '反义词列表 ["sad", "unhappy"]', +ADD COLUMN IF NOT EXISTS derivatives JSON COMMENT '派生词列表 [{"word": "happiness", "meaning": "幸福"}]', +ADD COLUMN IF NOT EXISTS collocations JSON COMMENT '词组搭配 [{"phrase": "look forward to", "meaning": "期待"}]', +ADD COLUMN IF NOT EXISTS word_root TEXT COMMENT '词根信息'; + +-- 添加索引 +ALTER TABLE ai_vocabulary +ADD INDEX idx_phonetic_us (phonetic_us(50)), +ADD INDEX idx_phonetic_uk (phonetic_uk(50)); + +-- 更新现有数据的默认值 +UPDATE ai_vocabulary +SET + synonyms = JSON_ARRAY() WHERE synonyms IS NULL, + antonyms = JSON_ARRAY() WHERE antonyms IS NULL, + derivatives = JSON_ARRAY() WHERE derivatives IS NULL, + collocations = JSON_ARRAY() WHERE collocations IS NULL; diff --git a/serve/migrations/create_learning_sessions.sql b/serve/migrations/create_learning_sessions.sql new file mode 100644 index 0000000..ebb58bc --- /dev/null +++ b/serve/migrations/create_learning_sessions.sql @@ -0,0 +1,17 @@ +-- 创建学习会话表 +CREATE TABLE IF NOT EXISTS ai_learning_sessions ( + id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '会话ID', + user_id BIGINT NOT NULL COMMENT '用户ID', + book_id VARCHAR(36) NOT NULL COMMENT '词汇书ID', + daily_goal INT DEFAULT 20 COMMENT '每日学习目标', + new_words_count INT DEFAULT 0 COMMENT '新学单词数', + review_count INT DEFAULT 0 COMMENT '复习单词数', + mastered_count INT DEFAULT 0 COMMENT '掌握单词数', + started_at TIMESTAMP NOT NULL COMMENT '开始时间', + completed_at TIMESTAMP NULL COMMENT '完成时间', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + + INDEX idx_user_book (user_id, book_id), + INDEX idx_created_at (created_at) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='学习会话表'; diff --git a/serve/migrations/create_notifications.sql b/serve/migrations/create_notifications.sql new file mode 100644 index 0000000..bba6e87 --- /dev/null +++ b/serve/migrations/create_notifications.sql @@ -0,0 +1,19 @@ +-- 创建通知表 +CREATE TABLE IF NOT EXISTS `ai_notifications` ( + `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '通知ID', + `user_id` BIGINT UNSIGNED NOT NULL COMMENT '用户ID', + `type` VARCHAR(50) NOT NULL COMMENT '通知类型: system(系统通知), learning(学习提醒), achievement(成就通知)', + `title` VARCHAR(255) NOT NULL COMMENT '通知标题', + `content` TEXT NOT NULL COMMENT '通知内容', + `link` VARCHAR(500) DEFAULT NULL COMMENT '跳转链接', + `is_read` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否已读: 0-未读, 1-已读', + `priority` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '优先级: 0-普通, 1-重要, 2-紧急', + `created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + `read_at` TIMESTAMP NULL DEFAULT NULL COMMENT '阅读时间', + `deleted_at` TIMESTAMP NULL DEFAULT NULL COMMENT '删除时间', + PRIMARY KEY (`id`), + KEY `idx_user_id` (`user_id`), + KEY `idx_is_read` (`is_read`), + KEY `idx_created_at` (`created_at`), + KEY `idx_type` (`type`) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='通知表'; diff --git a/serve/migrations/create_test_tables.sql b/serve/migrations/create_test_tables.sql new file mode 100644 index 0000000..d04a6af --- /dev/null +++ b/serve/migrations/create_test_tables.sql @@ -0,0 +1,121 @@ +-- 创建测试相关表 +-- Create test-related tables + +-- 测试模板表 +CREATE TABLE IF NOT EXISTS test_templates ( + id VARCHAR(36) PRIMARY KEY, + title VARCHAR(255) NOT NULL COMMENT '模板标题', + description TEXT COMMENT '模板描述', + type VARCHAR(50) NOT NULL COMMENT '测试类型: quick, comprehensive, daily, custom', + difficulty VARCHAR(50) COMMENT '难度: beginner, intermediate, advanced', + duration INT COMMENT '测试时长(秒)', + total_questions INT COMMENT '总题目数', + passing_score INT COMMENT '及格分数', + max_score INT COMMENT '最高分数', + question_config JSON COMMENT '题目配置', + skill_distribution JSON COMMENT '技能分布', + is_active BOOLEAN DEFAULT TRUE COMMENT '是否启用', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + INDEX idx_type (type), + INDEX idx_difficulty (difficulty), + INDEX idx_is_active (is_active) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='测试模板表'; + +-- 测试题目表 +CREATE TABLE IF NOT EXISTS test_questions ( + id VARCHAR(36) PRIMARY KEY, + template_id VARCHAR(36) NOT NULL COMMENT '模板ID', + question_type VARCHAR(50) NOT NULL COMMENT '题目类型: single_choice, multiple_choice, true_false, fill_blank, short_answer', + skill_type VARCHAR(50) NOT NULL COMMENT '技能类型: vocabulary, grammar, reading, listening, speaking, writing', + difficulty VARCHAR(50) COMMENT '难度', + content TEXT NOT NULL COMMENT '题目内容', + options JSON COMMENT '选项(JSON数组)', + correct_answer TEXT COMMENT '正确答案', + explanation TEXT COMMENT '答案解析', + points INT DEFAULT 1 COMMENT '分值', + order_index INT COMMENT '题目顺序', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + INDEX idx_template_id (template_id), + INDEX idx_question_type (question_type), + INDEX idx_skill_type (skill_type), + INDEX idx_difficulty (difficulty), + FOREIGN KEY (template_id) REFERENCES test_templates(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='测试题目表'; + +-- 测试会话表 +CREATE TABLE IF NOT EXISTS test_sessions ( + id VARCHAR(36) PRIMARY KEY, + template_id VARCHAR(36) NOT NULL COMMENT '模板ID', + user_id VARCHAR(36) NOT NULL COMMENT '用户ID', + status VARCHAR(50) NOT NULL DEFAULT 'pending' COMMENT '状态: pending, in_progress, paused, completed, abandoned', + start_time TIMESTAMP NULL COMMENT '开始时间', + end_time TIMESTAMP NULL COMMENT '结束时间', + paused_at TIMESTAMP NULL COMMENT '暂停时间', + time_remaining INT COMMENT '剩余时间(秒)', + current_question_index INT DEFAULT 0 COMMENT '当前题目索引', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + INDEX idx_template_id (template_id), + INDEX idx_user_id (user_id), + INDEX idx_status (status), + INDEX idx_created_at (created_at), + FOREIGN KEY (template_id) REFERENCES test_templates(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='测试会话表'; + +-- 测试会话题目关联表 +CREATE TABLE IF NOT EXISTS test_session_questions ( + session_id VARCHAR(36) NOT NULL COMMENT '会话ID', + question_id VARCHAR(36) NOT NULL COMMENT '题目ID', + order_index INT COMMENT '题目顺序', + PRIMARY KEY (session_id, question_id), + INDEX idx_session_id (session_id), + INDEX idx_question_id (question_id), + FOREIGN KEY (session_id) REFERENCES test_sessions(id) ON DELETE CASCADE, + FOREIGN KEY (question_id) REFERENCES test_questions(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='测试会话题目关联表'; + +-- 测试答案表 +CREATE TABLE IF NOT EXISTS test_answers ( + id VARCHAR(36) PRIMARY KEY, + session_id VARCHAR(36) NOT NULL COMMENT '会话ID', + question_id VARCHAR(36) NOT NULL COMMENT '题目ID', + answer TEXT COMMENT '用户答案', + is_correct BOOLEAN COMMENT '是否正确', + score INT DEFAULT 0 COMMENT '得分', + time_spent INT COMMENT '答题用时(秒)', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + INDEX idx_session_id (session_id), + INDEX idx_question_id (question_id), + UNIQUE KEY uk_session_question (session_id, question_id), + FOREIGN KEY (session_id) REFERENCES test_sessions(id) ON DELETE CASCADE, + FOREIGN KEY (question_id) REFERENCES test_questions(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='测试答案表'; + +-- 测试结果表 +CREATE TABLE IF NOT EXISTS test_results ( + id VARCHAR(36) PRIMARY KEY, + session_id VARCHAR(36) NOT NULL UNIQUE COMMENT '会话ID', + user_id VARCHAR(36) NOT NULL COMMENT '用户ID', + template_id VARCHAR(36) NOT NULL COMMENT '模板ID', + total_score INT COMMENT '总得分', + max_score INT COMMENT '最高分', + percentage DECIMAL(5,2) COMMENT '得分百分比', + correct_count INT COMMENT '正确题数', + wrong_count INT COMMENT '错误题数', + skipped_count INT COMMENT '跳过题数', + time_spent INT COMMENT '总用时(秒)', + skill_scores JSON COMMENT '各技能得分', + passed BOOLEAN COMMENT '是否通过', + completed_at TIMESTAMP NOT NULL COMMENT '完成时间', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + INDEX idx_session_id (session_id), + INDEX idx_user_id (user_id), + INDEX idx_template_id (template_id), + INDEX idx_completed_at (completed_at), + FOREIGN KEY (session_id) REFERENCES test_sessions(id) ON DELETE CASCADE, + FOREIGN KEY (template_id) REFERENCES test_templates(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='测试结果表'; diff --git a/serve/migrations/create_user_vocabulary_book_progress.sql b/serve/migrations/create_user_vocabulary_book_progress.sql new file mode 100644 index 0000000..9d93cf4 --- /dev/null +++ b/serve/migrations/create_user_vocabulary_book_progress.sql @@ -0,0 +1,23 @@ +-- 创建用户词汇书学习进度表 +CREATE TABLE IF NOT EXISTS user_vocabulary_book_progress ( + id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '进度ID', + user_id BIGINT NOT NULL COMMENT '用户ID', + book_id VARCHAR(36) NOT NULL COMMENT '词汇书ID', + learned_words INT DEFAULT 0 COMMENT '已学习单词数', + mastered_words INT DEFAULT 0 COMMENT '已掌握单词数', + progress_percentage DECIMAL(5,2) DEFAULT 0.00 COMMENT '学习进度百分比', + streak_days INT DEFAULT 0 COMMENT '连续学习天数', + total_study_days INT DEFAULT 0 COMMENT '总学习天数', + average_daily_words DECIMAL(5,2) DEFAULT 0.00 COMMENT '平均每日学习单词数', + estimated_completion_date TIMESTAMP NULL COMMENT '预计完成时间', + is_completed BOOLEAN DEFAULT FALSE COMMENT '是否已完成', + completed_at TIMESTAMP NULL COMMENT '完成时间', + started_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '开始学习时间', + last_studied_at TIMESTAMP NULL COMMENT '最后学习时间', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + + UNIQUE INDEX idx_user_book (user_id, book_id), + INDEX idx_user_id (user_id), + INDEX idx_book_id (book_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户词汇书学习进度表'; diff --git a/serve/migrations/create_user_word_progress.sql b/serve/migrations/create_user_word_progress.sql new file mode 100644 index 0000000..dc5bf20 --- /dev/null +++ b/serve/migrations/create_user_word_progress.sql @@ -0,0 +1,22 @@ +-- 创建用户单词学习进度表 +CREATE TABLE IF NOT EXISTS ai_user_word_progress ( + id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '进度ID', + user_id BIGINT NOT NULL COMMENT '用户ID', + vocabulary_id BIGINT NOT NULL COMMENT '单词ID', + status VARCHAR(20) DEFAULT 'not_started' COMMENT '学习状态', + study_count INT DEFAULT 0 COMMENT '学习次数', + correct_count INT DEFAULT 0 COMMENT '正确次数', + wrong_count INT DEFAULT 0 COMMENT '错误次数', + proficiency INT DEFAULT 0 COMMENT '熟练度(0-100)', + next_review_at TIMESTAMP NULL COMMENT '下次复习时间', + review_interval INT DEFAULT 1 COMMENT '复习间隔(天)', + first_studied_at TIMESTAMP NOT NULL COMMENT '首次学习时间', + last_studied_at TIMESTAMP NOT NULL COMMENT '最后学习时间', + mastered_at TIMESTAMP NULL COMMENT '掌握时间', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + + UNIQUE INDEX idx_user_vocab (user_id, vocabulary_id), + INDEX idx_next_review (next_review_at), + INDEX idx_status (status) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户单词学习进度表'; diff --git a/serve/migrations/create_vocabulary_books.sql b/serve/migrations/create_vocabulary_books.sql new file mode 100644 index 0000000..cfaa7cd --- /dev/null +++ b/serve/migrations/create_vocabulary_books.sql @@ -0,0 +1,45 @@ +-- 创建词汇书表 +CREATE TABLE IF NOT EXISTS `ai_vocabulary_books` ( + `id` VARCHAR(36) NOT NULL COMMENT '词汇书ID', + `name` VARCHAR(200) NOT NULL COMMENT '词汇书名称', + `description` TEXT COMMENT '词汇书描述', + `category` VARCHAR(100) NOT NULL COMMENT '分类', + `level` ENUM('beginner','elementary','intermediate','advanced','expert') NOT NULL COMMENT '难度级别', + `total_words` INT DEFAULT 0 COMMENT '总单词数', + `cover_image` VARCHAR(500) COMMENT '封面图片URL', + `icon` VARCHAR(255) COMMENT '图标', + `color` VARCHAR(7) COMMENT '主题色', + `is_system` BOOLEAN DEFAULT TRUE COMMENT '是否系统词汇书', + `is_active` BOOLEAN DEFAULT TRUE COMMENT '是否启用', + `sort_order` INT DEFAULT 0 COMMENT '排序', + `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', + PRIMARY KEY (`id`), + KEY `idx_category` (`category`), + KEY `idx_level` (`level`), + KEY `idx_is_system` (`is_system`, `is_active`) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='词汇书表'; + +-- 创建词汇书单词关联表 +CREATE TABLE IF NOT EXISTS `ai_vocabulary_book_words` ( + `id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '关联ID', + `book_id` VARCHAR(36) NOT NULL COMMENT '词汇书ID', + `vocabulary_id` VARCHAR(36) NOT NULL COMMENT '词汇ID', + `sort_order` INT DEFAULT 0 COMMENT '排序', + `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', + PRIMARY KEY (`id`), + UNIQUE KEY `uk_book_vocabulary` (`book_id`, `vocabulary_id`), + KEY `idx_book_id` (`book_id`), + KEY `idx_vocabulary_id` (`vocabulary_id`) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='词汇书单词关联表'; + +-- 插入系统词汇书数据 +INSERT INTO `ai_vocabulary_books` (`id`, `name`, `description`, `category`, `level`, `total_words`, `icon`, `color`, `is_system`, `is_active`, `sort_order`) VALUES +('cet4_core_2500', '大学英语四级核心词汇', '涵盖CET-4考试核心词汇2500个', 'CET-4核心词汇', 'intermediate', 2500, '📚', '#4CAF50', TRUE, TRUE, 1), +('cet6_core_3000', '大学英语六级核心词汇', '涵盖CET-6考试核心词汇3000个', 'CET-6核心词汇', 'advanced', 3000, '📖', '#2196F3', TRUE, TRUE, 2), +('toefl_high_3500', '托福高频词汇', '托福考试高频词汇3500个', 'TOEFL高频词汇', 'advanced', 3500, '🎓', '#FF9800', TRUE, TRUE, 3), +('ielts_high_3500', '雅思高频词汇', '雅思考试高频词汇3500个', 'IELTS高频词汇', 'advanced', 3500, '🌟', '#9C27B0', TRUE, TRUE, 4), +('primary_core_1000', '小学英语核心词汇', '小学阶段必备核心词汇1000个', '小学核心词汇', 'beginner', 1000, '🎈', '#E91E63', TRUE, TRUE, 5), +('junior_core_1500', '初中英语核心词汇', '初中阶段必备核心词汇1500个', '初中核心词汇', 'elementary', 1500, '📝', '#00BCD4', TRUE, TRUE, 6), +('senior_core_3500', '高中英语核心词汇', '高中阶段必备核心词汇3500个', '高中核心词汇', 'intermediate', 3500, '📕', '#FF5722', TRUE, TRUE, 7), +('business_core_1000', '商务英语核心词汇', '商务场景常用核心词汇1000个', '商务英语', 'intermediate', 1000, '💼', '#607D8B', TRUE, TRUE, 8); diff --git a/serve/migrations/fix_all_vocabulary_books_sort_order.sql b/serve/migrations/fix_all_vocabulary_books_sort_order.sql new file mode 100644 index 0000000..d6688a9 --- /dev/null +++ b/serve/migrations/fix_all_vocabulary_books_sort_order.sql @@ -0,0 +1,44 @@ +-- Fix all vocabulary books sort order + +-- Learning Stage (1-39): Elementary to Advanced +UPDATE `ai_vocabulary_books` SET `sort_order` = 1 WHERE `id` = 'primary_core_1000'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 2 WHERE `id` = 'junior_high_1500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 3 WHERE `id` = 'junior_core_1500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 4 WHERE `id` = 'senior_high_3500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 5 WHERE `id` = 'senior_core_3500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 6 WHERE `id` = 'college_textbook'; + +-- Domestic Tests (40-59) +UPDATE `ai_vocabulary_books` SET `sort_order` = 40 WHERE `id` = 'cet4_core_2500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 41 WHERE `id` = 'cet6_core_3000'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 42 WHERE `id` = 'postgraduate_vocabulary'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 43 WHERE `id` = 'tem4_vocabulary'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 44 WHERE `id` = 'tem8_vocabulary'; + +-- International Tests (60-79) +UPDATE `ai_vocabulary_books` SET `sort_order` = 60 WHERE `id` = 'toefl_high_3500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 61 WHERE `id` = 'ielts_high_3500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 62 WHERE `id` = 'ielts_general'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 63 WHERE `id` = 'toeic_vocabulary'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 64 WHERE `id` = 'gre_vocabulary'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 65 WHERE `id` = 'gmat_vocabulary'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 66 WHERE `id` = 'sat_vocabulary'; + +-- Professional & Business (80-99) +UPDATE `ai_vocabulary_books` SET `sort_order` = 80 WHERE `id` = 'business_core_1000'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 81 WHERE `id` = 'bec_preliminary'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 82 WHERE `id` = 'bec_vantage'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 83 WHERE `id` = 'bec_higher'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 84 WHERE `id` = 'mba_finance'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 85 WHERE `id` = 'medical_english'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 86 WHERE `id` = 'legal_english'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 87 WHERE `id` = 'it_engineering'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 88 WHERE `id` = 'academic_english'; + +-- Functional (100-119) +UPDATE `ai_vocabulary_books` SET `sort_order` = 100 WHERE `id` = 'word_roots_affixes'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 101 WHERE `id` = 'synonyms_antonyms'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 102 WHERE `id` = 'daily_spoken_collocations'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 103 WHERE `id` = 'academic_spoken_collocations'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 104 WHERE `id` = 'academic_writing_collocations'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 105 WHERE `id` = 'daily_life_english'; diff --git a/serve/migrations/update_vocabulary_books_sort_order.sql b/serve/migrations/update_vocabulary_books_sort_order.sql new file mode 100644 index 0000000..699a3e4 --- /dev/null +++ b/serve/migrations/update_vocabulary_books_sort_order.sql @@ -0,0 +1,10 @@ +-- Update vocabulary books sort order by learning stage and difficulty level + +UPDATE `ai_vocabulary_books` SET `sort_order` = 10 WHERE `id` = 'primary_core_1000'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 20 WHERE `id` = 'junior_core_1500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 30 WHERE `id` = 'senior_core_3500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 40 WHERE `id` = 'cet4_core_2500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 50 WHERE `id` = 'cet6_core_3000'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 60 WHERE `id` = 'toefl_high_3500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 70 WHERE `id` = 'ielts_high_3500'; +UPDATE `ai_vocabulary_books` SET `sort_order` = 80 WHERE `id` = 'business_core_1000'; diff --git a/serve/run_migration.bat b/serve/run_migration.bat new file mode 100644 index 0000000..ef0abc7 --- /dev/null +++ b/serve/run_migration.bat @@ -0,0 +1,19 @@ +@echo off +REM 执行数据库迁移脚本 - 添加is_favorite字段 +echo 正在执行数据库迁移... +echo. + +REM 使用Docker容器中的MySQL执行 +docker exec -i ai_english_learning-mysql-1 mysql -uroot -proot ai_english_learning < migrations\add_is_favorite_to_user_word_progress.sql + +if %ERRORLEVEL% EQU 0 ( + echo. + echo ✅ 迁移成功完成！ + echo is_favorite字段已添加到ai_user_word_progress表 +) else ( + echo. + echo ❌ 迁移失败，请检查错误信息 + echo 提示：确保Docker容器正在运行 +) + +pause diff --git a/serve/scripts/create_test_users.go b/serve/scripts/create_test_users.go new file mode 100644 index 0000000..ca018c1 --- /dev/null +++ b/serve/scripts/create_test_users.go @@ -0,0 +1,105 @@ +package main + +import ( + "fmt" + "log" + "time" + + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/config" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/database" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/models" + "github.com/Nanqipro/YunQue-Tech-Projects/ai_english_learning/serve/internal/utils" +) + +func main() { + // 加载配置 + config.LoadConfig() + if config.GlobalConfig == nil { + log.Fatal("Failed to load configuration") + } + + // 初始化数据库 + database.InitDatabase() + defer database.CloseDatabase() + + db := database.GetDB() + + // 测试用户数据 + testUsers := []struct { + Username string + Email string + Password string + Nickname string + }{ + { + Username: "testuser", + Email: "test@example.com", + Password: "Test@123", + Nickname: "测试用户", + }, + { + Username: "student1", + Email: "student1@example.com", + Password: "Student@123", + Nickname: "学生一号", + }, + { + Username: "student2", + Email: "student2@example.com", + Password: "Student@123", + Nickname: "学生二号", + }, + { + Username: "teacher", + Email: "teacher@example.com", + Password: "Teacher@123", + Nickname: "教师账号", + }, + } + + fmt.Println("开始创建测试用户...") + + for _, userData := range testUsers { + // 检查用户是否已存在 + var existingUser models.User + result := db.Where("username = ? OR email = ?", userData.Username, userData.Email).First(&existingUser) + + if result.Error == nil { + fmt.Printf("用户 %s 已存在，跳过创建\n", userData.Username) + continue + } + + // 加密密码 + hashedPassword, err := utils.HashPassword(userData.Password) + if err != nil { + log.Printf("Failed to hash password for %s: %v", userData.Username, err) + continue + } + + // 创建用户 + user := models.User{ + Username: userData.Username, + Email: userData.Email, + PasswordHash: hashedPassword, + Nickname: &userData.Nickname, + Status: "active", + CreatedAt: time.Now(), + UpdatedAt: time.Now(), + } + + if err := db.Create(&user).Error; err != nil { + log.Printf("Failed to create user %s: %v", userData.Username, err) + continue + } + + fmt.Printf("✓ 成功创建用户: %s (邮箱: %s, 密码: %s)\n", + userData.Username, userData.Email, userData.Password) + } + + fmt.Println("\n测试用户创建完成！") + fmt.Println("\n可用的测试账号：") + fmt.Println("1. 用户名: testuser 邮箱: test@example.com 密码: Test@123") + fmt.Println("2. 用户名: student1 邮箱: student1@example.com 密码: Student@123") + fmt.Println("3. 用户名: student2 邮箱: student2@example.com 密码: Student@123") + fmt.Println("4. 用户名: teacher 邮箱: teacher@example.com 密码: Teacher@123") +} diff --git a/serve/scripts/test_log_format.bat b/serve/scripts/test_log_format.bat new file mode 100644 index 0000000..776704e --- /dev/null +++ b/serve/scripts/test_log_format.bat @@ -0,0 +1,39 @@ +@echo off +echo. +echo Testing Backend Log Format +echo ================================ +echo. + +set BASE_URL=http://localhost:8080 + +echo [1/5] Testing Health Check (GET 200) +curl -s "%BASE_URL%/health" >nul 2>&1 +timeout /t 1 /nobreak >nul + +echo [2/5] Testing Login (POST 200) +curl -s -X POST "%BASE_URL%/api/v1/auth/login" -H "Content-Type: application/json" -d "{\"account\":\"test@example.com\",\"password\":\"Test@123\"}" >nul 2>&1 +timeout /t 1 /nobreak >nul + +echo [3/5] Testing 404 Error (GET 404) +curl -s "%BASE_URL%/api/v1/not-found" >nul 2>&1 +timeout /t 1 /nobreak >nul + +echo [4/5] Testing OPTIONS Preflight (OPTIONS 204) +curl -s -X OPTIONS "%BASE_URL%/api/v1/user/profile" -H "Origin: http://localhost:3001" >nul 2>&1 +timeout /t 1 /nobreak >nul + +echo [5/5] Testing Unauthorized (GET 401) +curl -s "%BASE_URL%/api/v1/user/profile" >nul 2>&1 +timeout /t 1 /nobreak >nul + +echo. +echo Test Complete! +echo. +echo View logs: +echo type logs\app.log +echo. +echo View last 20 lines: +echo powershell "Get-Content logs\app.log -Tail 20" +echo. + +pause diff --git a/serve/scripts/test_log_format.sh b/serve/scripts/test_log_format.sh new file mode 100644 index 0000000..8cc005b --- /dev/null +++ b/serve/scripts/test_log_format.sh @@ -0,0 +1,41 @@ +#!/bin/bash + +# 测试日志格式脚本 +# 用于演示新的emoji日志格式 + +echo "🧪 测试后端日志格式" +echo "================================" +echo "" + +BASE_URL="http://localhost:8080" + +echo "1️⃣ 测试健康检查 (GET 200)" +curl -s "$BASE_URL/health" > /dev/null +sleep 1 + +echo "2️⃣ 测试登录 (POST 200)" +curl -s -X POST "$BASE_URL/api/v1/auth/login" \ + -H "Content-Type: application/json" \ + -d '{"account":"test@example.com","password":"Test@123"}' > /dev/null +sleep 1 + +echo "3️⃣ 测试404错误 (GET 404)" +curl -s "$BASE_URL/api/v1/not-found" > /dev/null +sleep 1 + +echo "4️⃣ 测试OPTIONS预检 (OPTIONS 204)" +curl -s -X OPTIONS "$BASE_URL/api/v1/user/profile" \ + -H "Origin: http://localhost:3001" > /dev/null +sleep 1 + +echo "5️⃣ 测试未授权 (GET 401)" +curl -s "$BASE_URL/api/v1/user/profile" > /dev/null +sleep 1 + +echo "" +echo "✅ 测试完成！" +echo "📋 查看日志：" +echo " tail -20 logs/app.log" +echo "" +echo "🎨 格式化查看（需要安装jq）：" +echo " tail -20 logs/app.log | jq '.'" diff --git a/serve/scripts/test_new_log.ps1 b/serve/scripts/test_new_log.ps1 new file mode 100644 index 0000000..9279d93 --- /dev/null +++ b/serve/scripts/test_new_log.ps1 @@ -0,0 +1,44 @@ +# 测试新的日志格式 + +Write-Host "`n=== Testing New Log Format ===`n" -ForegroundColor Cyan + +$baseUrl = "http://localhost:8080" + +# 1. 测试健康检查 +Write-Host "[1/4] Testing Health Check..." -ForegroundColor Yellow +Invoke-WebRequest -Uri "$baseUrl/health" -UseBasicParsing | Out-Null +Start-Sleep -Seconds 1 + +# 2. 测试登录 +Write-Host "[2/4] Testing Login..." -ForegroundColor Yellow +$loginBody = @{ + account = "test@example.com" + password = "Test@123" +} | ConvertTo-Json + +Invoke-WebRequest -Uri "$baseUrl/api/v1/auth/login" ` + -Method POST ` + -Body $loginBody ` + -ContentType "application/json" ` + -UseBasicParsing | Out-Null +Start-Sleep -Seconds 1 + +# 3. 测试404 +Write-Host "[3/4] Testing 404 Error..." -ForegroundColor Yellow +try { + Invoke-WebRequest -Uri "$baseUrl/api/v1/not-found" -UseBasicParsing | Out-Null +} catch { + # 忽略404错误 +} +Start-Sleep -Seconds 1 + +# 4. 测试未授权 +Write-Host "[4/4] Testing Unauthorized..." -ForegroundColor Yellow +try { + Invoke-WebRequest -Uri "$baseUrl/api/v1/user/profile" -UseBasicParsing | Out-Null +} catch { + # 忽略401错误 +} + +Write-Host "`n=== Test Complete! ===`n" -ForegroundColor Green +Write-Host "Check the server console for beautiful logs!" -ForegroundColor Cyan diff --git a/start.txt b/start.txt new file mode 100644 index 0000000..a8b3967 --- /dev/null +++ b/start.txt @@ -0,0 +1,6 @@ +cd /home/work/ai_dianshang/ +unzip ai_dianshang.zip && \ +fuser -k 8060/tcp || true && \ +nohup go run cmd/main.go > ai_dianshang.log 2>&1 & + +tail -f /home/work/ai_dianshang/ai_dianshang.log