Polish project documentation and runtime config

This commit is contained in:
2026-06-09 10:22:59 +08:00
parent 5f061295d8
commit 0594fc9f8c
43 changed files with 1001 additions and 97 deletions

58
docs/PROJECT_OVERVIEW.md Normal file
View File

@@ -0,0 +1,58 @@
# 系统介绍
旅行知识图谱管理系统是 `new2` 版本的城市与旅行领域知识图谱平台面向景区、旅行社、文旅运营和智能客服场景。系统把采集资料、百科文本、POI 空间数据、线路产品、酒店/餐饮/车辆等资源沉淀为可审核、可发布、可查询的图谱资产。
## 目标用户
- 文旅运营人员:查看图谱覆盖、数据质量、缺口和发布状态。
- 数据标注与审核人员:处理实体字段、证据来源、冲突合并和专家签核。
- 产品和线路人员:维护固定线路、景点组合、报价说明和资源约束。
- 智能客服研发人员:基于图谱接口构建线路问答、周边资源推荐和报价查询。
- 工程维护人员:通过 Docker、快照和脚本复现系统与数据。
## 核心能力
| 能力 | 说明 |
| --- | --- |
| 数据源与批次管理 | 管理来源、采集批次、原始记录和质量摘要 |
| 实体审核 | 查看候选实体、字段决策、证据链、审查历史和合并 |
| 图谱广场 | 汇总图谱规模、使用情况、健康告警和用户查询 |
| Schema 管理 | 管理 ontology schema、DSL、版本和发布记录 |
| 证据质量 | 聚合 POI 证据、资源质量和字段可信度 |
| 发布与回滚 | 创建发布任务、查看 diff、回滚图谱版本 |
| 城市空间图谱 | 使用高德 POI 与空间网格支持周边检索 |
| 旅行客服 Agent | 支持线路清单、线路匹配、线路报价、酒店资源、车辆和附近资源查询 |
| 权限与组织 | 内置角色、能力矩阵、用户和区域责任管理 |
## 典型业务流程
```mermaid
flowchart LR
A["采集/导入资料"] --> B["抽取候选实体"]
B --> C["字段证据与质量检查"]
C --> D["人工审核/冲突合并"]
D --> E["发布到 FalkorDB 图谱"]
E --> F["图谱查询/客服问答/运营分析"]
```
## 随仓库发布的内容
- 后端源码:`app/`
- 前端源码:`admin-web/`
- Docker 运行环境:`Dockerfile``docker-compose.yml``docker/`
- 图谱数据快照:`snapshots/postgres/``snapshots/falkordb/`
- 图谱 schema 与样例资料:`schema搭建/`
- 采集、构建、发布和快照脚本:`scripts/`
- 项目文档:`README.md``docs/`
## 默认演示数据
快照以 `new2` 本地系统为来源,包含贵阳/贵州旅行场景相关数据:
- PostgreSQL schema`kg_admin_new2`
- FalkorDB 主要图:`guiyang_new2`
- FalkorDB 空间图:`guiyang_spatial_v1`
- 空间 POI`80609`
- 候选实体:约 `37457`
这些数据随仓库一起发布,下载后通过 Docker 初始化脚本自动恢复。