# 代码仓库任务

## 1) 将前端迁移至 Vite + React（复杂）
- 在 `week5/frontend/` 中搭建 Vite + React 应用（也可放在类似 `week5/frontend/ui/` 的子目录中）。
- 使用由 FastAPI 提供服务的构建产物替换当前静态资源：
  - 构建到 `week5/frontend/dist/`。
  - 更新 FastAPI 的静态目录挂载，使其提供 `dist` 中的内容，并让根路径（`/`）返回 `dist` 中的 `index.html`。
- 在 React 中接入现有端点：
  - 笔记的列表、创建、删除和编辑。
  - 待办事项的列表、创建和完成。
- 更新 `Makefile`，加入 `web-install`、`web-dev`、`web-build` 目标，并确保 `make run` 自动构建 Web 产物（或在文档中说明该工作流）。
- 为至少两个组件添加组件/单元测试（React Testing Library），并在 `backend/tests` 中添加 API 兼容性集成测试。

## 2) 支持分页和排序的笔记搜索（中等）
- 实现 `GET /notes/search?q=...&page=1&page_size=10&sort=created_desc|title_asc`。
- 对标题/内容使用不区分大小写的匹配。
- 返回包含 `items`、`total`、`page`、`page_size` 的响应数据。
- 使用 SQLAlchemy 组合查询，实现筛选、排序和分页。
- 更新 React 界面，加入搜索输入框、结果数量以及上一页/下一页分页控件。
- 在 `backend/tests/test_notes.py` 中添加针对查询边界情况和分页的测试。

## 3) 完整的笔记 CRUD 与乐观式界面更新（中等）
- 添加 `PUT /notes/{id}` 和 `DELETE /notes/{id}`。
- 在前端进行乐观式状态更新，并在发生错误时执行回滚。
- 在 `schemas.py` 中验证请求数据（最小长度，以及适当的最大长度）。
- 添加成功场景和验证错误场景的测试。

## 4) 待办事项：筛选与批量完成（中等）
- 添加 `GET /action-items?completed=true|false`，按完成状态进行筛选。
- 添加 `POST /action-items/bulk-complete`，接收 ID 列表并在一个事务中将对应事项标记为已完成。
- 更新前端，加入筛选开关和批量操作界面。
- 添加测试，覆盖筛选、批量操作行为，以及出错时的事务回滚。

## 5) 具有多对多关系的标签功能（复杂）
- 添加 `Tag` 模型和连接表 `note_tags`（`Note` 与 `Tag` 之间为多对多关系）。
- 端点：
  - `GET /tags`、`POST /tags`、`DELETE /tags/{id}`
  - 使用 `POST /notes/{id}/tags` 关联标签，使用 `DELETE /notes/{id}/tags/{tag_id}` 解除关联
- 更新提取功能（参见下一个任务），根据 `#hashtags` 自动创建并关联标签。
- 更新界面，以标签块形式显示标签，并支持按标签筛选笔记。
- 添加针对模型关系和端点行为的测试。

## 6) 改进提取逻辑和端点（中等）
- 扩展 `backend/app/services/extract.py`，使其能够解析：
  - `#hashtags` → 标签
  - `- [ ] task text` → 待办事项
- 添加 `POST /notes/{id}/extract`：
  - 返回结构化提取结果；当 `apply=true` 时，还可选择持久化新标签/待办事项。
- 添加针对提取解析和 `apply=true` 持久化路径的测试。

## 7) 健壮的错误处理和响应封装（简单至中等）
- 使用 Pydantic 模型添加验证（最小长度约束、非空字符串）。
- 添加全局异常处理器，返回统一的 JSON 封装：
  - `{ "ok": false, "error": { "code": "NOT_FOUND", "message": "..." } }`
  - 成功响应：`{ "ok": true, "data": ... }`
- 更新测试，断言成功和错误场景下的响应封装结构。

## 8) 为所有集合的列表端点添加分页（简单）
- 为 `GET /notes` 和 `GET /action-items` 添加 `page` 和 `page_size`。
- 分别返回 `items` 和 `total`。
- 更新前端，为列表加入分页；添加边界测试（最后一页为空、页面大小过大）。

## 9) 查询性能与索引（简单至中等）
- 在有益的位置添加 SQLite 索引（例如 `notes.title`、标签连接表）。
- 通过植入较大数据集的测试验证查询计划有所改进，并确保没有性能回退。

## 10) 改进测试覆盖率（简单）
- 添加测试以覆盖：
  - 每个端点的 400/404 场景
  - 批量操作的并发/事务行为
  - 搜索、分页和乐观式更新的前端集成测试（可以使用模拟或轻量级方案）

## 11) 可部署至 Vercel（中等至复杂）
- 使用 Vite + React 的前端：
  - 添加包含 `build` 和 `preview` 脚本的 `package.json`，并配置 Vite 将输出写入 `frontend/dist`（或 `frontend/ui/dist`）。
  - 添加 `vercel.json`，将项目根目录设置为 `week5/frontend`，并将 `outputDirectory` 设置为 `dist`。
  - 在构建时注入 `VITE_API_BASE_URL`，使其指向 API。
- Vercel 上的 API（方案 A：无服务器 FastAPI）：
  - 创建 `week5/api/index.py`，从 `backend/app/main.py` 导入 FastAPI 的 `app`。
  - 确保 Vercel 能够获取 Python 依赖项（为函数使用 `pyproject.toml` 或 `requirements.txt`）。
  - 配置 CORS，允许 Vercel 前端源站访问。
  - 更新 `vercel.json`，将 `/api/*` 路由到 Python 函数，并为其他路由提供 React 应用。
- 部署在其他位置的 API（方案 B）：
  - 将后端部署到 Fly.io 或 Render 等服务。
  - 配置 Vercel 前端，使其通过 `VITE_API_BASE_URL` 调用外部 API，并设置任何必要的重写/代理。
- 在 `README.md` 中添加简短的部署指南，其中包括环境变量、构建命令和回滚方法。