Todo App

Todo 应用

一款功能全面的待办事项应用，包含 React Native 移动应用和 Node.js/Express 后端 API。此 文件使用 Cursor 和 Box MCP server 构建。未手动编写任何代码。

在 Cursor 中，我们搜索了 Box 中的产品需求文档（PRD）和编码规范，并要求 Cursor 构建 PRD 中描述的应用，同时确保遵循编码规范。如需查看我们在 Box 中使用的文档， 请访问 /sample-docs 目录。

为了避免通过修改 PRD 或指南来简化构建过程，我使用了以下 公开示例：

• Damian Filiatrault 在 ScalablePath 提供的 PRD。
• 从 Google Github 下载的编码规范

项目结构

• /mobile-app - 使用 Expo 的 React Native 移动应用
• /api - 使用 TypeScript 的 Node.js/Express 后端 API

功能

• 用户身份验证（注册、登录）
• 创建和管理任务列表
• 创建任务，包含名称、描述、截止日期和优先级
• 将任务标记为已完成
• 删除任务和列表
• 跨平台（iOS 和 Android）

技术栈

移动应用

• 使用 Expo 的 React Native
• TypeScript
• 使用 Redux Toolkit 管理状态
• 使用 Expo Router 进行导航
• 使用 React Native Safe Area Context 处理安全区域

后端 API

• 使用 Express 的 Node.js
• TypeScript
• 使用 Mongoose 的 MongoDB
• JWT 身份验证
• 使用 Express Validator 验证请求

设置说明

前置条件

• Node.js 18+
• MongoDB
• Expo CLI（npm install -g expo-cli）
• iOS 模拟器（用于 iOS 开发）
• Android Studio 和模拟器（用于 Android 开发）

移动应用设置

# Navigate to the mobile app directory
cd mobile-app

# Install dependencies
npm install

# Start the development server
npm start

# Run on iOS
npm run ios

# Run on Android
npm run android

API 设置

# Navigate to the API directory
cd api

# Install dependencies
npm install

# Create a .env file with the following variables
# PORT=3000
# MONGODB_URI=mongodb://localhost:27017/todo-app
# JWT_SECRET=your-secret-key

# Start the development server
npm run dev

# Build the project
npm run build

# Start the production server
npm start

环境变量

移动应用

在 mobile-app 目录中创建 .env 文件，内容如下：

EXPO_PUBLIC_API_URL=http://localhost:3000/api

API

在 api 目录中创建 .env 文件，内容如下：

PORT=3000
MONGODB_URI=mongodb://localhost:27017/todo-app
JWT_SECRET=your-secret-key

API 端点

身份验证

• POST /api/auth/register - 注册新用户
• POST /api/auth/login - 用户登录

列表

• GET /api/lists - 获取当前用户的所有列表
• POST /api/lists - 创建新列表
• GET /api/lists/:listId - 获取指定列表
• PUT /api/lists/:listId - 更新列表
• DELETE /api/lists/:listId - 删除列表

任务

• GET /api/lists/:listId/tasks - 获取列表中的所有任务
• POST /api/lists/:listId/tasks - 创建新任务
• GET /api/lists/:listId/tasks/:taskId - 获取指定任务
• PUT /api/lists/:listId/tasks/:taskId - 更新任务
• DELETE /api/lists/:listId/tasks/:taskId - 删除任务

参与贡献

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 License 授权。