plf
b02d3378fc
Full-stack application for document-to-knowledge-graph pipeline: - Backend: FastAPI + LangGraph ReAct agent + DeepSeek + MinerU parsing - Frontend: React 19 + Vite + D3.js + shadcn/ui - Pipeline: MinerU parsing → LangExtract entity extraction → KG building Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
32 lines
829 B
Markdown
32 lines
829 B
Markdown
# GraphRAG Studio — Project Conventions
|
||
|
||
## 1. 目录结构
|
||
|
||
- **前端代码** 统一放在 `frontend/` 目录下
|
||
- **后端代码** 统一放在 `backend/` 目录下
|
||
|
||
```
|
||
GraphRAGAgent/
|
||
├── frontend/ # 所有前端代码（HTML/CSS/JS）
|
||
├── backend/ # 所有后端代码（FastAPI 服务）
|
||
└── docs/ # 规范文档
|
||
```
|
||
|
||
## 2. 环境变量与敏感配置
|
||
|
||
- 所有外部配置（API Key、Base URL、Token 等）统一在 `backend/.env` 中管理
|
||
- `.env` 文件**禁止提交到 Git**，必须在 `.gitignore` 中忽略
|
||
- 提供 `backend/.env.example` 作为配置模板（不含真实值）
|
||
|
||
## 3. 后端虚拟环境
|
||
|
||
- 后端服务必须使用 `uv` 创建独立虚拟环境：
|
||
|
||
```bash
|
||
cd backend
|
||
uv venv
|
||
uv pip install -r requirements.txt
|
||
```
|
||
|
||
- 虚拟环境目录 `.venv/` 不提交到 Git
|