feat: initial release

.dockerignore

@@ -0,0 +1,6 @@
+node_modules
+.next
+build
+.env
+Dockerfile
+README.md

Dockerfile

@@ -0,0 +1,9 @@
+FROM node:18-alpine
+WORKDIR /app
+ENV NEXT_TELEMETRY_DISABLED=1
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+EXPOSE 3000
+CMD ["npm", "start"]

MOBILE_ARCHITECTURE.md

@@ -0,0 +1,226 @@
+# Lingo - 离线移动端 App 架构文档
+
+## 📱 项目概述
+
+本项目已成功从纯 Web 应用改造为**支持离线运行的移动端应用**，使用 Capacitor + SQLite 技术栈。
+
+### 核心架构
+
+```
+┌─────────────────────────────────────┐
+│         Next.js 14 App              │
+│  (React Server + Client Components) │
+└──────────────┬──────────────────────┘
+               │
+               │ Capacitor Bridge
+               ▼
+┌─────────────────────────────────────┐
+│      Capacitor Native Layer         │
+│  ┌─────────────┐ ┌───────────────┐  │
+│  │ SQLite DB   │ │ Native APIs   │  │
+│  │ (Local)     │ │ (Network,     │  │
+│  │             │ │  Storage,     │  │
+│  │             │ │  etc.)        │  │
+│  └─────────────┘ └───────────────┘  │
+└─────────────────────────────────────┘
+```
+
+## 🗂️ 新增文件结构
+
+```
+nextjs-duolingo-clone/
+├── capacitor.config.ts          # Capacitor 配置文件
+├── db/
+│   ├── offline-db.ts            # SQLite 数据库核心服务
+│   └── offline-queries.ts       # 离线数据查询操作
+├── hooks/
+│   └── use-sync-engine.ts       # 数据同步引擎 Hook
+├── lib/
+│   └── mobile-app.ts            # 移动端工具函数
+├── providers/
+│   ├── database-provider.tsx    # 数据库初始化 Provider
+│   └── offline-provider.tsx     # 离线状态管理 Provider
+├── scripts/
+│   └── seed-offline.ts          # 离线数据库种子脚本
+└── components/
+    └── network-status.tsx       # 网络状态提示组件
+```
+
+## 🚀 快速开始
+
+### 1. 环境要求
+
+- Node.js >= 18
+- npm >= 9
+- **Android 开发**: Android Studio + SDK
+- **iOS 开发**: Xcode (macOS only)
+
+### 2. 安装依赖
+
+```bash
+npm install
+```
+
+### 3. 添加移动平台
+
+```bash
+# 添加 Android 平台
+npx cap add android
+
+# 添加 iOS 平台 (macOS)
+npx cap add ios
+```
+
+### 4. 开发与构建
+
+```bash
+# Web 开发模式 (保留原有 Server 功能)
+npm run dev
+
+# 构建并同步到移动端
+npm run cap:sync
+
+# 打开 Android Studio
+npm run cap:android
+
+# 打开 Xcode
+npm run cap:ios
+
+# 直接运行到设备
+npm run cap:run:android
+npm run cap:run:ios
+```
+
+## 📦 核心依赖
+
+| 包名 | 用途 |
+|------|------|
+| `@capacitor/core` | Capacitor 核心 |
+| `@capacitor-community/sqlite` | SQLite 数据库 |
+| `@capacitor/network` | 网络状态检测 |
+| `@capacitor/splash-screen` | 启动画面 |
+| `@capacitor/preferences` | 本地偏好设置 |
+| `@capacitor/app` | 应用生命周期 |
+| `@capacitor/haptics` | 触觉反馈 |
+| `@capacitor/keyboard` | 键盘管理 |
+
+## 💾 离线数据架构
+
+### SQLite 数据表
+
+| 表名 | 说明 |
+|------|------|
+| `courses` | 语言课程 |
+| `units` | 学习单元 |
+| `lessons` | 课程章节 |
+| `challenges` | 练习题 |
+| `challenge_options` | 题目选项 |
+| `challenge_progress` | 答题进度 |
+| `user_progress` | 用户进度 |
+| `user_subscription` | 订阅信息 |
+| `sync_queue` | 同步队列 (离线时暂存，联网后同步) |
+
+### 数据同步机制
+
+1. **离线状态**: 所有数据变更写入本地 SQLite 和 `sync_queue`
+2. **联网检测**: 自动检测网络状态变化
+3. **增量同步**: 将 `sync_queue` 中的待同步数据发送到服务器
+4. **冲突处理**: 基于时间戳和服务端优先级解决冲突
+
+## 🔧 使用示例
+
+### 1. 在组件中使用离线数据库
+
+```tsx
+import { dbService } from '@/db/offline-db';
+import { offlineQueries } from '@/db/offline-queries';
+
+export async function getMyProgress(userId: string) {
+  return await offlineQueries.getUserProgress(userId);
+}
+
+export async function saveChallengeProgress(userId: string, challengeId: number) {
+  await offlineQueries.upsertChallengeProgress(userId, challengeId, true);
+}
+```
+
+### 2. 使用同步引擎 Hook
+
+```tsx
+import { useSyncEngine } from '@/hooks/use-sync-engine';
+
+function MyComponent() {
+  const { isOnline, isSyncing, forceSync } = useSyncEngine();
+
+  return (
+    <div>
+      <p>Network: {isOnline ? 'Online' : 'Offline'}</p>
+      <button onClick={forceSync} disabled={isSyncing || !isOnline}>
+        {isSyncing ? 'Syncing...' : 'Sync Now'}
+      </button>
+    </div>
+  );
+}
+```
+
+### 3. 使用离线 Provider
+
+```tsx
+import { DatabaseProvider } from '@/providers/database-provider';
+import { OfflineProvider } from '@/providers/offline-provider';
+import { NetworkStatus } from '@/components/network-status';
+
+function App() {
+  return (
+    <DatabaseProvider>
+      <OfflineProvider>
+        <NetworkStatus />
+        <YourAppContent />
+      </OfflineProvider>
+    </DatabaseProvider>
+  );
+}
+```
+
+## 🌐 部署选项
+
+### 选项 A: 纯离线模式 (推荐)
+
+- 完全离线运行
+- 首次安装时包含种子数据
+- 适合无服务器部署
+
+### 选项 B: 混合模式
+
+- 优先使用本地数据
+- 联网时同步到云端
+- 支持多设备数据同步
+
+## 📊 性能优化建议
+
+1. **数据库索引**: 已为高频查询字段创建索引
+2. **连接池**: SQLite 自动管理连接
+3. **批量操作**: 使用事务减少 I/O 次数
+4. **缓存策略**: 配合 React Query 实现智能缓存
+5. **图片优化**: 使用 Capacitor 文件系统缓存
+
+## ⚠️ 注意事项
+
+1. **Android 构建**: 需要安装 Android Studio 和 SDK
+2. **iOS 构建**: 需要 macOS 和 Xcode
+3. **SQLite 插件**: 在模拟器上可能需要额外配置
+4. **首次启动**: 数据库初始化可能需要几秒
+
+## 🔮 未来扩展
+
+- [ ] 端到端加密同步
+- [ ] 多用户支持
+- [ ] 课程包下载/导入
+- [ ] 语音识别离线支持
+- [ ] 学习数据分析和导出
+
+## 📞 技术支持
+
+如有问题，请查看:
+- [Capacitor 文档](https://capacitorjs.com/docs)
+- [SQLite 插件文档](https://github.com/capacitor-community/sqlite)