Todo Cursor

🚀 待辦事項應用

待辦事項應用是一個全面的應用程序，涵蓋 React Native 移動端應用與 Node.js/Express 後端 API。本項目藉助 Cursor 和 Box MCP 服務器構建，全程未手動編寫代碼。

在 Cursor 中，我們搜索了 Box 裡的產品需求文檔（PRD）和編碼標準，隨後讓 Cursor 依據 PRD 描述構建應用程序，並確保遵循編碼標準。若想查看使用的文檔，可查閱 /sample-docs 目錄。

為避免繞過 PRD 或指南來簡化構建過程，我們採用了以下公開示例：

• Damian Filiatrault 在 ScalablePath 上提供的 PRD
• 從 Google 的 Github 下載的編碼標準

🚀 快速開始

項目結構

• /mobile-app - React Native 移動端應用（使用 Expo）
• /api - Node.js/Express 後端 API（使用 TypeScript）

設置說明

先決條件

• 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

✨ 主要特性

• 用戶認證（註冊、登錄）
• 任務清單創建和管理
• 任務創建，包含名稱、描述、截止日期和優先級
• 標記任務為完成
• 刪除任務和清單
• 多平臺支持（iOS 和 Android）

🔧 技術細節

移動端應用

• React Native（使用 Expo）
• TypeScript
• Redux Toolkit 用於狀態管理
• Expo Router 用於導航
• React Native 安全區域上下文，用於處理安全區域

後端 API

• Node.js（使用 Express）
• TypeScript
• MongoDB（使用 Mongoose）
• JWT 認證
• Express Validator 用於請求驗證

📚 詳細文檔

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/tasks - 獲取全部任務
• POST /api/tasks - 創建新任務
• GET /api/tasks/:taskId - 獲取特定任務
• PUT /api/tasks/:taskId - 更新任務
• DELETE /api/tasks/:taskId - 刪除任務

🤝 貢獻指南

要為該項目做出貢獻，請按照以下步驟操作：

1. 克隆此倉庫到本地。
2. 創建一個新的功能分支：git checkout -b feature/your-feature-name
3. 提交你的更改：git commit -m '添加了新功能'
4. 推送到遠程分支：git push origin feature/your-feature-name
5. 創建拉取請求。

📄 許可證

此項目受到 MIT License 的保護。