Todo 应用

一个全面的待办事项应用程序，包含一个 React Native 移动应用和一个 Node.js/Express 后端 API。此文件是使用 Cursor 和 Box MCP 服务器构建的。没有手动编写任何代码。

在 Cursor 中，我们搜索了 Box 中的产品需求文档 (PRD) 和编码标准，并要求 Cursor 构建 PRD 中描述的应用程序，并确保遵循编码标准。要查看我们在 Box 中使用的文档，请查看 /sample-docs 目录。

为了防止通过作弊 PRD 或指南来简化构建，我使用了以下公开可用的示例：

• 来自 ScalablePath 的 Damian Filiatrault 的 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 开发）

移动应用设置

# 导航到移动应用目录
cd mobile-app

# 安装依赖
npm install

# 启动开发服务器
npm start

# 在 iOS 上运行
npm run ios

# 在 Android 上运行
npm run android

API 设置

# 导航到 API 目录
cd api

# 安装依赖
npm install

# 创建一个包含以下变量的 .env 文件
# PORT=3000
# MONGODB_URI=mongodb://localhost:27017/todo-app
# JWT_SECRET=your-secret-key

# 启动开发服务器
npm run dev

# 构建项目
npm run build

# 启动生产服务器
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 许可证获得许可。