[WIP] Add missing Flutter project configuration files

[Copilot]

Flutter App Platform Setup Plan

• 1. Update pubspec.yaml SDK constraints to >=3.1.0 <4.0.0
• 2. Delete pubspec.lock (will be regenerated)
• 3. Create web/ directory with index.html, manifest.json, favicon.png
• 4. Create test/ directory with widget_test.dart
• 5. Create Story model (story_model.dart)
• 6. Create Character model (character_model.dart)
• 7. Add Story/Character API endpoints to constants.dart
• 8. Add Story/Character API methods to api_service.dart
• 9. Create stories_screen.dart
• 10. Create story_detail_screen.dart
• 11. Create generate_story_screen.dart
• 12. Create characters_screen.dart
• 13. Create add_character_screen.dart
• 14. Create story_card.dart widget
• 15. Update home_screen.dart to add Stories tab (5 tabs total)
• 16. Update .gitignore
• 17. Update README.md with setup instructions
• 18. Run code review
• 19. Run security check

Original prompt

背景

flutter_app/ 目录下现有 Dart 源代码（lib/ 下的 services、screens、widgets、models、utils），但缺少 Flutter 项目运行所需的关键平台文件和配置，导致无法 flutter run。

现有代码结构分析

当前存在的文件：

• flutter_app/pubspec.yaml - 依赖配置
• flutter_app/analysis_options.yaml - lint 配置
• flutter_app/pubspec.lock - 锁定依赖
• flutter_app/.gitignore
• flutter_app/README.md
• flutter_app/lib/main.dart - 入口
• flutter_app/lib/services/ - api_service.dart, auth_service.dart, storage_service.dart
• flutter_app/lib/screens/ - login_screen.dart, home_screen.dart, notes_list_screen.dart, note_detail_screen.dart, add_note_screen.dart, rag_search_screen.dart, review_screen.dart, profile_screen.dart
• flutter_app/lib/widgets/ - note_card.dart, rag_result_card.dart, review_item_card.dart
• flutter_app/lib/utils/ - constants.dart, validators.dart, helpers.dart
• flutter_app/lib/models/ - note_model.dart, review_record_model.dart, rag_response_model.dart
• flutter_app/lib/config/ - app_constants.dart

当前 pubspec.yaml 的依赖：

name: myenglishnote
description: A comprehensive English learning note-taking app with RAG search and SRS review system.
publish_to: 'none'
version: 1.0.0+1
environment:
  sdk: '>=3.0.0 <4.0.0'
dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.6
  flutter_staggered_animations: ^1.1.1
  cached_network_image: ^3.3.1
  lottie: ^3.1.0
  uuid: ^4.0.0
  http: ^1.1.0
  dio: ^5.4.0
  provider: ^6.1.1
  flutter_riverpod: ^2.4.9
  shared_preferences: ^2.2.2
  flutter_secure_storage: ^9.0.0
  json_annotation: ^4.8.1
  intl: ^0.18.1
  email_validator: ^2.1.17
  logger: ^2.0.2+1
  permission_handler: ^11.1.0
dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^3.0.1
  build_runner: ^2.4.7
  json_serializable: ^6.7.1

后端 API 端点 (Spring Boot RuoYi):

• 登录: POST /loginmobile
• 注册: POST /register
• 笔记管理: POST /api/note/add, GET /api/note/list, GET /api/note/{id}, PUT /api/note/{id}, DELETE /api/note/{id}, GET /api/note/count
• RAG 搜索: POST /api/rag/search, POST /api/rag/answer, POST /api/rag/chat
• 复习管理: GET /api/review/next, POST /api/review/record, GET /api/review/stats
• 故事管理: POST /api/story/generate, GET /api/story/list, GET /api/story/{id}, PUT /api/story/{id}, DELETE /api/story/{id} 等
• 角色管理: POST /api/character/add, GET /api/character/list, GET /api/character/{id} 等
• 统一搜索: GET /api/search/all, GET /api/search/notes, GET /api/search/stories

后端认证方式：JWT Bearer Token

需要做的事情

1. 创建缺失的 Flutter 平台目录和文件

当前 flutter_app/ 缺少以下关键目录/文件，导致无法运行：

• android/ - Android 平台代码和配置 (包含 app/build.gradle, app/src/main/AndroidManifest.xml, app/src/main/kotlin/...MainActivity.kt, build.gradle, gradle.properties, settings.gradle, local.properties 模板, gradle/wrapper/ 等)
• ios/ - iOS 平台代码 (包含 Runner/, Runner.xcodeproj/, Runner.xcworkspace/, Podfile 等)
• web/ - Web 平台 (包含 index.html, manifest.json, favicon.png 等)
• test/ - 测试目录 (包含 widget_test.dart)
• linux/, macos/, windows/ - 桌面平台（可选，但至少添加 web）

注意: 对于 android、ios、linux、macos、windows 等平台目录，由于它们包含大量自动生成的二进制和配置文件，不要尝试手动创建。只需创建 web/ 目录和 test/ 目录即可。用户将在本地运行 flutter create . 来生成这些平台文件。

2. 更新 pubspec.yaml

更新 flutter_app/pubspec.yaml，使 SDK 约束适配最新的 Flutter SDK：

• 将 SDK 约束改为 sdk: '>=3.1.0 <4.0.0'
• 删除 pubspec.lock（需要重新生成）
• 确保所有依赖版本兼容

3. 补全缺失的 Model 文件

在 flutter_app/lib/models/ 目录下，确认以下 model 文件存在并正确实现：

• note_model.dart - 笔记数据模型（需要有 id, userId, content, tags, embedding, embeddingModel, createdAt, updatedAt 字段）
• review_record_model.dart - 复习记录模型（需要有 noteId, repetitions, intervalDays, easinessFactor, nextReviewDate 字段）
• rag_response_model.dart - RAG 响应模型（需要有 success, question, answer, relatedNotes, processingTime 字段）

如果这些文件不存在（code search 无法找到它们的内容），则需要创建。

4. 添加 Story/Character 相关代码

后端已经实现了 Story 和 Character 功能，但 Flutter 前端缺少相关页面。需要添加：

Models:

• flutter_app/lib/models/story_model.dart - 包含 id, title, content, characterId, characterName, difficulty, wordCount, includeVocabularyList, vocabularyList, status, userId, createdAt, updatedAt
• flutter_app/lib/models/character_model.dart - 包含 id, name, nameEn, description, personality, background, role, avatarUrl, userId, createdAt, updatedAt

Services - 在 api_service.dart 中添加：

• Story CRUD API 调用方法（generate, list, get, update, delete, batch delete）
• Character CRUD API 调用方法（add, list, get, update, delete）

Constants - 在 constants.dart 中添加：

• Story 和 Character 相关的 API endpoint 常量

Screens:

• flutter_app/lib/screens/stories_screen.dart - 故事列表页面
• flutter_app/lib/screens/story_detail_screen.dart - 故事详情页面
• flutter_app/lib/screens/generate_story_screen.dart - 生成故事页面（包含选择角色、难度、词汇等选项）
• flutter_app/lib/screens/characters_screen.dart - 角色列表页面
• flutter_app/lib/screens/add_character_screen.dart - 添加角色页面

Widgets:

• flutter_app/lib/widgets/story_card.dart - 故事卡片

HomeScreen 更新 - 在底部导航栏中添加 Stories tab（现有 4 ...

This pull request was created from Copilot chat.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.