# Todo

**Repository Path**: shaostatictiger/todo

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-20
- **Last Updated**: 2026-01-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 四象限 Todo (Four Quadrant Todo)

基于 Eisenhower Matrix 的跨平台任务管理应用，支持 iOS、Android 和 Web 三端同步。

## 🌟 特性

### 核心功能
- ✅ **四象限任务管理** - 基于 Eisenhower Matrix 的任务分类
- 📱 **跨平台支持** - React Native (iOS/Android) + Web
- 🔄 **实时同步** - 多设备数据同步，支持离线使用
- 🎯 **智能提醒** - 任务截止日期提醒和重复任务
- 📊 **数据统计** - 任务完成情况和效率分析
- 👥 **多用户支持** - 完整的用户认证系统

### 技术特色
- 🚀 **现代化技术栈** - React Native + FastAPI + MySQL
- 🛡️ **企业级安全** - JWT 认证 + 密码加密
- 📦 **模块化架构** - 清晰的代码结构和组件复用
- 🎨 **精美UI设计** - 遵循 iOS 18 设计规范
- ⚡ **高性能** - 优化的数据库查询和缓存策略

## 🏗️ 项目结构

```
todo/
├── backend/                 # FastAPI 后端
│   ├── core/               # 核心配置和常量
│   ├── middleware/         # 中间件 (认证/日志/错误处理)
│   ├── routers/            # API 路由模块
│   ├── utils/              # 工具函数
│   ├── models.py           # 数据库模型
│   ├── schemas.py          # Pydantic 模型
│   ├── main.py             # 主应用入口
│   └── requirements.txt    # Python 依赖
├── screens/                # React Native 页面组件
│   ├── LoginScreen.tsx     # 登录页面
│   ├── HomeScreen.tsx      # 主页
│   ├── CalendarScreen.tsx  # 日历页面
│   └── ...
├── components/             # 可复用组件
├── hooks/                  # 自定义 React Hooks
├── services/               # API 服务层
├── constants/              # 常量和配置
├── utils/                  # 工具函数
└── types/                  # TypeScript 类型定义
```

## 🚀 快速开始

### 环境要求
- Node.js 18+
- Python 3.8+
- MySQL 8.0+
- iOS/Android 开发环境 (可选)

### 后端部署

1. **安装依赖**
   ```bash
   cd backend
   pip install -r requirements.txt
   ```

2. **配置环境变量**
   ```bash
   cp .env.example .env
   # 编辑 .env 文件配置数据库和JWT密钥
   ```

3. **启动服务**
   ```bash
   uvicorn main:app --reload --host 0.0.0.0 --port 8000
   ```

4. **一键部署到服务器**
   ```bash
   ./deploy.sh
   ```

### 前端开发

1. **安装依赖**
   ```bash
   npm install
   ```

2. **启动开发服务器**
   ```bash
   npm start
   ```

3. **运行平台**
   ```bash
   # iOS
   npm run ios

   # Android
   npm run android

   # Web
   npm run web
   ```

## 📖 四象限方法论

### Eisenhower Matrix
- **Q1 (重要且紧急)** - 🔴 立即处理
- **Q2 (重要不紧急)** - 🔵 计划执行
- **Q3 (紧急不重要)** - 🟡 委派处理
- **Q4 (不紧急不重要)** - 🟢 可删除

### 任务分类
- 💼 Work (工作)
- 📚 Study (学习)
- 🏃 Life (生活)
- ❤️ Health (健康)
- 💰 Finance (财务)
- 👥 Social (社交)
- 👤 Personal (个人)
- 📝 Other (其他)

## 🔌 API 文档

后端服务启动后，访问 `/docs` 查看完整的 API 文档：

```
http://localhost:8000/docs
```

### 主要API端点
- `POST /api/v1/auth/login` - 用户登录
- `POST /api/v1/auth/register` - 用户注册
- `GET /api/v1/tasks` - 获取任务列表
- `POST /api/v1/tasks` - 创建任务
- `POST /api/v1/sync` - 数据同步

## 🎨 设计系统

### 颜色规范
```typescript
// 四象限颜色
quadrant1: '#FF6B6B', // 重要紧急 - 红色
quadrant2: '#4ECDC4', // 重要不紧急 - 青色
quadrant3: '#FFE66D', // 紧急不重要 - 黄色
quadrant4: '#95E1D3', // 不紧急不重要 - 绿色

// iOS 系统颜色
iosPrimary: '#007AFF',
iosSuccess: '#34C759',
iosWarning: '#FF9500',
iosDanger: '#FF3B30'
```

### 布局规范
```typescript
// 间距
spacing: {
  xs: 4,
  sm: 8,
  md: 16,
  lg: 24,
  xl: 32,
  xxl: 48
}

// 圆角
borderRadius: {
  small: 8,
  medium: 12,
  large: 16,
  xl: 24
}
```

## 🔧 开发指南

### 代码规范
- 使用 TypeScript 严格模式
- ESLint + Prettier 代码格式化
- 遵循 React Native 最佳实践
- 详细的代码注释和文档

### 提交规范
```
feat:    添加新功能
fix:     修复bug
docs:    文档更新
style:   代码格式调整
refactor:代码重构
test:    测试相关
chore:   构建过程或辅助工具变动
```

### 分支策略
- `main` - 生产环境分支
- `develop` - 开发分支
- `feature/*` - 功能分支
- `fix/*` - bug修复分支

## 📦 部署

### 服务器要求
- Ubuntu 20.04+ / CentOS 7+
- 2GB+ RAM
- 10GB+ 存储空间

### 自动化部署

1. **服务器初始化**
   ```bash
   ./backend/install-server.sh
   ```

2. **一键部署**
   ```bash
   ./deploy-all.sh
   ```

3. **服务管理**
   ```bash
   # 查看状态
   systemctl status todo-backend
   systemctl status todo-frontend

   # 重启服务
   systemctl restart todo-backend
   systemctl restart todo-frontend

   # 查看日志
   journalctl -u todo-backend -f
   journalctl -u todo-frontend -f
   ```

## 🚦 状态监控

### 健康检查
```bash
curl http://localhost:8000/health
```

响应示例:
```json
{
  "status": "healthy",
  "database": "connected",
  "timestamp": "2026-01-17T10:00:00.000Z"
}
```

### 性能监控
- 请求处理时间监控
- 数据库查询性能
- 内存使用情况
- 错误率统计

## 🤝 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'feat: Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🆘 故障排除

### 常见问题

1. **iOS 构建失败**
   ```bash
   cd ios && pod install
   ```

2. **Android 构建失败**
   ```bash
   ./gradlew clean
   ```

3. **数据库连接失败**
   ```bash
   # 检查 MySQL 服务状态
   systemctl status mysql
   ```

### 获取帮助
- 📧 邮箱: your-email@example.com
- 💬 讨论区: GitHub Discussions
- 🐛 问题报告: GitHub Issues

## 📊 项目状态

| 模块 | 状态 | 进度 |
|------|------|------|
| 后端API | ✅ 完成 | 100% |
| 移动端UI | ✅ 完成 | 100% |
| Web端 | 🚧 开发中 | 80% |
| 数据同步 | ✅ 完成 | 100% |
| 测试覆盖 | 🚧 进行中 | 60% |
| 文档完善 | ✅ 完成 | 100% |

---

**最后更新**: 2026-01-17
**版本**: v1.0.0
**状态**: ✅ 生产就绪

---

<div align="center">

**用心打造每一行代码，让任务管理变得更简单** ✨

</div>