NoteWeave

课程笔记协作系统。项目目标见 docs/需求文档.md，架构设计见 docs/架构文档.md，开发约定见 docs/项目规范文档.md。

后端开发

当前后端位于 backend/，使用 FastAPI + SQLite 实现首版 MVP API，依赖由 uv 管理。

本环境中的 uv 安装在项目内工具环境：

./.tools/uv/bin/uv --version

创建/安装后端环境：

cd /root/project/NoteWeave/backend
env UV_CACHE_DIR=/root/project/NoteWeave/.uv-cache ../.tools/uv/bin/uv venv
env UV_CACHE_DIR=/root/project/NoteWeave/.uv-cache ../.tools/uv/bin/uv pip install -e ".[dev]"

运行测试：

cd /root/project/NoteWeave/backend
env UV_CACHE_DIR=/root/project/NoteWeave/.uv-cache ../.tools/uv/bin/uv run --no-sync pytest

启动服务：

cd /root/project/NoteWeave/backend
env UV_CACHE_DIR=/root/project/NoteWeave/.uv-cache ../.tools/uv/bin/uv run --no-sync uvicorn noteweave.api.app:app --reload --port 8000

健康检查：

curl http://127.0.0.1:8000/health

前端工作台与展示页

当前前端位于 frontend/，使用 Vue 3 + Vite + TypeScript。旧的无构建链前端已整体保留到 frontend-old/。

• #landing：产品介绍页（功能模块/价值主张）
• #workspace：课程知识协作工作台

安装依赖：

cd /root/project/NoteWeave/frontend
npm install

开发预览：

cd /root/project/NoteWeave/frontend
npm run dev

构建验证：

cd /root/project/NoteWeave/frontend
npm run typecheck
npm run build

默认访问：

http://127.0.0.1:5173

工作台可直接打开：

http://127.0.0.1:5173/#workspace