6.5 KiB
旅行知识图谱管理系统
面向贵州、贵阳旅行场景的知识图谱管理系统。项目包含 FastAPI 后端、React 管理后台、PostgreSQL 管理库、FalkorDB 图数据库、图谱 schema、采集/抽取脚本和可恢复的数据快照。用户 clone 仓库后可以直接用 Docker 启动完整系统，并恢复随仓库发布的图谱数据。
项目亮点
- 完整后台：数据源、批次、实体审核、证据质量、图谱广场、发布回滚、权限、任务和通知模块。
- 双数据库架构：PostgreSQL 保存后台业务数据与审核流程，FalkorDB 保存可查询图谱。
- 可复现数据：仓库内置 PostgreSQL 与 FalkorDB 快照，下载后可恢复图谱数据。
- Docker 一键启动：
docker compose up -d --build同时启动 API、管理后台、PostgreSQL 和 FalkorDB。 - 旅行客服场景：内置固定线路、周边资源、酒店报价、车辆、行程推荐和图谱问答相关接口。
- 可扩展 Agent：保留高德、网页、小红书、抖音、事件抽取、多源对齐、审计等 Agent 代码。
系统架构
flowchart LR
U["运营/标注/客服用户"] --> W["React 管理后台 /admin"]
W --> A["FastAPI 后端 /v1/admin"]
A --> P[("PostgreSQL\nkg_admin_new2")]
A --> F[("FalkorDB\nguiyang_new2\nguiyang_spatial_v1")]
A --> S["Schema 与采集脚本"]
A --> L["OpenAI 兼容 LLM\n可选"]
A --> M["高德地图 API\n可选"]
更详细的模块说明见 docs/ARCHITECTURE.md。
快速启动
需要先安装并启动 Docker Desktop。
git clone https://github.com/3452078359-xuexue/travel-knowledge-graph.git
cd travel-knowledge-graph
docker compose up -d --build
启动完成后打开：
http://localhost:8102/admin
演示账号：
用户名：admin@example.com
密码：change-me
常用服务端口：
| 服务 | 默认地址 |
|---|---|
| 管理后台/API | http://localhost:8102 |
| 管理后台页面 | http://localhost:8102/admin |
| API 文档 | http://localhost:8102/docs |
| PostgreSQL | localhost:5433 |
| FalkorDB Redis 协议 | localhost:6380 |
| FalkorDB Browser | http://localhost:3002 |
数据快照
仓库包含可恢复快照：
| 数据库 | 快照文件 | 默认库/图 |
|---|---|---|
| PostgreSQL | snapshots/postgres/kg_admin_new2.dump |
database kg_admin, schema kg_admin_new2 |
| FalkorDB | snapshots/falkordb/dump.rdb |
graph guiyang_new2, guiyang_spatial_v1 |
当前快照包含约 80609 条空间 POI、37457 条候选实体，以及 FalkorDB 中的贵阳与旅行社相关图谱。详细结构见 docs/reports/new2_current_kg_schema_snapshot.md 和 docs/DATA_SNAPSHOTS.md。
PostgreSQL 初始化脚本只会在 Docker 数据卷首次创建时执行。如果要丢弃本地修改并从仓库快照重新恢复：
docker compose down -v
docker compose up -d --build
验证命令
检查 API：
curl http://localhost:8102/v1/admin/health
检查 PostgreSQL：
docker compose exec postgres psql -U admin -d kg_admin \
-c "SELECT COUNT(*) FROM kg_admin_new2.amap_spatial_pois;"
检查 FalkorDB 图列表：
docker compose exec falkordb redis-cli -p 6379 GRAPH.LIST
项目结构
.
├── app/ # FastAPI 后端、API 路由、Agent、图谱核心逻辑
├── admin-web/ # React + Vite 管理后台源码
├── docker/ # Docker 初始化脚本
├── docs/ # 项目说明、架构、部署、数据和报告文档
├── schema搭建/ # 图谱 schema、百科样例数据和 DSL 资料
├── scripts/ # 采集、构建、发布和快照导出脚本
├── snapshots/ # 可恢复数据库快照
├── Dockerfile # 后端镜像与前端静态资源构建
├── docker-compose.yml # 一键启动完整系统
├── .env.example # 本地配置模板
└── requirements.txt # Python 后端依赖
不会上传 .env、node_modules/、运行日志、浏览器缓存、本地 Docker 数据卷和临时文件。仓库保留系统源码、Docker 配置、schema、脚本、必要报告和数据库快照。
文档导航
| 文档 | 内容 |
|---|---|
| docs/PROJECT_OVERVIEW.md | 系统定位、业务能力和功能地图 |
| docs/ARCHITECTURE.md | 容器、后端、前端和数据架构 |
| docs/DEPLOYMENT.md | Docker 部署、端口、环境变量和常见问题 |
| docs/DATA_SNAPSHOTS.md | 数据快照、恢复、重导出和校验 |
| docs/API_REFERENCE.md | API 分组、常用接口和调用示例 |
| docs/MAINTENANCE.md | 维护流程、发布检查和仓库边界 |
| CONTRIBUTING.md | 开发参与和提交规范 |
| SECURITY.md | 演示账号、密钥和生产安全建议 |
| CHANGELOG.md | 版本记录 |
本地开发
后端开发：
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python -m uvicorn app.main:app --host 0.0.0.0 --port 8102 --reload
前端开发：
cd admin-web
npm install
npm run dev
前端构建产物会输出到 app/static/admin/，Docker 镜像构建时会自动完成这一步。
更新快照
如果本机已有 zn-kg-new2-postgres 和 zn-kg-new2-falkordb 容器，并且想把最新数据重新导出到仓库：
bash scripts/export_snapshots.sh
然后提交 snapshots/ 中更新后的 dump 文件即可。快照文件接近 GitHub 单文件建议上限，更新前请先确认文件大小不超过 GitHub 的 100 MB 单文件限制。
生产使用提醒
默认账号、数据库密码和 AUTH_SECRET 仅用于演示。正式部署前请修改 .env 或 compose 环境变量，并为 LLM、高德等外部服务单独配置密钥。更多建议见 SECURITY.md。