# storage-learn

**Repository Path**: hellophpxinkai/storage-learn

## Basic Information

- **Project Name**: storage-learn
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-13
- **Last Updated**: 2025-12-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 英语故事学习应用 (Story Learn English)

这是一个互动式英语学习应用，通过有趣的故事情节和互动练习帮助用户提高英语水平。


## 产品介绍

### 产品概述
这款应用是一个基于故事的英语学习平台，用户可以通过阅读互动故事、回答问题和完成练习来学习英语。应用采用游戏化的方式，让学习过程更加有趣和吸引人。

### 主要功能
- **故事书架**：用户可以浏览所有可用的故事，查看封面和简介
- **章节阅读**：每个故事分为多个章节，用户可以按顺序解锁和阅读
- **互动对话**：故事以对话形式呈现，配有角色、背景和音效
- **多种练习类型**：
  - 听力练习：听音频回答问题
  - 填空练习：完成句子中的空缺
  - 多选题：从选项中选择正确答案
- **即时反馈**：回答问题后获得即时反馈和解释
- **进度追踪**：记录用户完成的章节和整体学习进度
- **成就系统**：完成特定目标获得成就奖励
- **角色关系**：与故事中的角色建立关系，影响故事发展

## 技术文档

### 技术栈
- **前端框架**：Next.js 13+ (App Router)
- **UI库**：React 18
- **样式**：TailwindCSS
- **动画**：Framer Motion
- **包管理**：pnpm

### 项目结构
```
/app                    - Next.js 应用目录
  /page.tsx             - 主页(书架页面)
  /(routes)             - 路由目录
    /(story)            - 故事相关路由
      /story/[storyId]  - 故事详情页
        /chapter/[chapterId] - 章节阅读页
/components             - React组件
  /ui                   - UI组件
    /dialog-box.tsx     - 对话框组件
    /question-box.tsx   - 问题框组件
    /listening-question.tsx - 听力问题组件
    /fill-blank-question.tsx - 填空问题组件
    /feedback-dialog.tsx - 反馈对话框
    /completion-dialog.tsx - 完成对话框
/lib                    - 工具库
  /types                - 类型定义
    /story.ts           - 故事相关类型
  /services             - 服务
    /story.ts           - 故事服务
    /storage.ts         - 存储服务
  /data                 - 数据
```

### 数据结构
- **Story**: 故事对象，包含标题、描述、封面图片和章节
- **Chapter**: 章节对象，包含标题、描述和对话内容
- **Dialog**: 对话对象，包含说话者、内容、类型和背景
- **Character**: 角色对象，包含名称、图片和位置
- **GameState**: 游戏状态，包含已完成章节、角色关系和成就

## 开发指南

### 安装依赖
```bash
pnpm install
```

### 启动开发服务器
```bash
pnpm dev
```

### 构建生产版本
```bash
pnpm build
```

### 启动生产服务器
```bash
pnpm start
```

## 贡献指南
欢迎贡献新的故事内容、练习题目或功能改进。请遵循以下步骤：
1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 创建 Pull Request

## 许可证
[MIT](https://choosealicense.com/licenses/mit/)