docs/knowledge-review-rule
Co-Authored-By: Claude Code <noreply@anthropic.com>
那拉提文旅智能问答:前后端基础壳子
基础工程骨架:Vue 3 + TypeScript + Vite 前端;FastAPI + Pydantic + SQLAlchemy 后端;PostgreSQL + pgvector 数据库配置。
启动数据库
需要 Docker Desktop,在项目根目录运行:
docker compose up -d db
开发数据库默认仅绑定 127.0.0.1:5432。请在正式使用前修改默认密码。
启动后端(Windows PowerShell)
cd backend
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env
uvicorn app.main:app --reload
API 文档:http://127.0.0.1:8000/docs
启动前端(另开终端)
cd frontend
npm install
npm run dev
Vite 通常使用 http://localhost:5173。
已有接口
- GET
/api/health - POST
/api/chat:占位接口,尚未接入检索和 LLM - GET
/api/knowledge - POST
/api/knowledge
前端包括问答、知识库管理、来源与更新、实验评估四个页面。实验评估页面没有虚构数据;所有页面明确标记当前功能状态。
注意:当前没有实现 Embedding、RAG、网络搜索、后台更新任务、用户认证或生产级数据库迁移。下一步建议先验证前后端联通,再按模块实现。.env 不要提交到 Git。
团队协作文档
目标 Gitea 仓库:https://gitea.kronecker.cc/saint/border-red-post-nalati。
Languages
Python
77.8%
Vue
14.7%
TypeScript
5.9%
JavaScript
1.5%