旅行知识图谱管理系统

这是 new2 版旅行/城市知识图谱系统，包含 FastAPI 后端、React 管理后台、PostgreSQL 管理库和 FalkorDB 图数据库。仓库已附带数据库快照，用户下载后可以用 Docker 直接恢复图谱数据。

数据快照

• PostgreSQL：snapshots/postgres/kg_admin_new2.dump
• FalkorDB：snapshots/falkordb/dump.rdb
• 默认管理库 schema：kg_admin_new2
• 默认 FalkorDB 图谱：guiyang_new2
• 空间图谱：guiyang_spatial_v1

当前快照包含约 80609 条空间 POI、37457 条候选实体，以及 FalkorDB 中的贵阳与旅行社相关图谱。详细结构见 docs/reports/new2_current_kg_schema_snapshot.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：8102
• PostgreSQL：5433
• FalkorDB Redis 协议：6380
• FalkorDB Browser：3002

重新恢复快照

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

本地开发

后端依赖：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
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 文件即可。