xuelong/bxh
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial travel knowledge graph release

Browse Source
This commit is contained in:
3452078359-xuexue
2026-06-09 09:56:26 +08:00
commit 5f061295d8
402 changed files with 103877 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

254
schema搭建/travel_fixed_route_item/travel_fixed_route_item_schema.v1.dsl.md Normal file
View File

@@ -0,0 +1,254 @@
```text
namespace travel_fixed_route_item
version 1
entity AdministrativeRegion // 行政区层级，支持省/市/县/镇，资源和景区按行政区过滤。
property region_id: Text
property name: Text
property level: Text
property province: Text
property city: Text
property county: Text
property town: Text
property parent_id: Text
property geo_polygon: Text
property source: Text
entity ScenicAttraction // 路线可到达的主景区/景点锚点，例如黄果树旅游景区、荔波小七孔景区、西江千户苗寨景区。
property attraction_id: Text
property name: Text
property type: Text
property rating: Text
property province: Text
property city: Text
property county: Text
property lat: Text
property lng: Text
property aliases: Text
property image_urls: Text
property description: Text
property source: Text
entity SubAttraction // 主景区内的子景点/子活动，例如黄果树旅游景区下的天星桥、陡坡塘瀑布。
property sub_attraction_id: Text
property name: Text
property type: Text
property parent_attraction_name: Text
property lat: Text
property lng: Text
property aliases: Text
property notes: Text
property source: Text
entity TourProduct // 已有固定路线产品。路线、天数和 POI 顺序不可修改。
property product_id: Text
property route_line_id: Text
property route_line_no: Text
property route_line_name: Text
property route_display_name: Text
property name: Text
property duration_days: Text
property duration_nights: Text
property theme: Text
property product_family: Text
property base_price: Text
property base_price_status: Text
property base_price_min_adult: Text
property base_price_max_adult: Text
property base_price_child_min: Text
property single_room_diff_min: Text
property base_price_text: Text
property price_options: Text
property price_option_count: Text
property mandatory_fee_text: Text
property ticket_refund_policy: Text
property quote_formula: Text
property pricing_notes: Text
property pricing_source_files: Text
property price_match_confidence: Text
property default_vehicle_type: Text
property quote_price_source: Text
property simulated_price_used: Text
property simulated_price_text: Text
property small_group_supported: Text
property small_group_support_status: Text
property group_service_mode: Text
property small_group_unsupported_reason: Text
property supplier_data_required: Text
property default_hotel_grade: Text
property route_immutable: Text
property route_stop_sequence: Text
property route_day_summary: Text
property route_extraction_status: Text
property route_extraction_issues: Text
property source_filename: Text
property source_text_chars: Text
property policy_notes: Text
property source_files: Text
entity ProductDay // 产品中的某一天行程。
property day_id: Text
property route_line_id: Text
property route_line_name: Text
property day_no: Text
property name: Text
property route_path: Text
property meal_text: Text
property accommodation_text: Text
property route_stop_sequence: Text
property sub_attraction_sequence: Text
property source_file: Text
entity RouteStop // 每日停靠点/POI，像公交站一样有全程顺序和当日顺序。
property stop_id: Text
property route_line_id: Text
property route_line_name: Text
property name: Text
property order_no: Text
property day_no: Text
property day_stop_order: Text
property global_stop_order: Text
property station_like_name: Text
property stop_type: Text
property city_or_area: Text
property route_sequence_label: Text
property route_display_text: Text
property sub_attraction_sequence: Text
property meal_text: Text
property accommodation_text: Text
property previous_stop_name: Text
property next_stop_name: Text
property source_file: Text
entity TravelItem // 统一资源实体，酒店、餐厅、车辆、门票、小交通、保险、景区活动、购物、视频讲解等都进入这个类型。资源本身不带 INCLUDED/OPTIONAL/MANDATORY 状态。
property item_id: Text
property name: Text
property type: Text
property subtype: Text
property description: Text
property price: Text
property price_text: Text
property adult_price: Text
property child_price: Text
property currency: Text
property unit: Text
property capacity: Text
property seat_count: Text
property safe_passenger_capacity: Text
property business_passenger_capacity: Text
property recommended_passenger_min: Text
property recommended_passenger_max: Text
property luggage_capacity: Text
property vehicle_group: Text
property vehicle_grade: Text
property vehicle_count_formula: Text
property service_rights: Text
property supplier_price_status: Text
property pricing_pending_reason: Text
property rating: Text
property region_name: Text
property scenic_name: Text
property address: Text
property lat: Text
property lng: Text
property features: Text
property signature_dishes: Text
property image_resource_id: Text
property image_match_level: Text
property image_url_count: Text
property image_urls: Text
property primary_image_url: Text
property applicable_product_text: Text
property room_type_count: Text
property rate_plan_count: Text
property supplier_rate_pending: Text
property has_simulated_room_prices: Text
property source_file: Text
property data_quality: Text
entity HotelRoomType // 酒店下属房型/用房口径。酒店本体只存酒店信息，房型价格放到独立节点，避免把淡旺季价揉进酒店名称。
property room_id: Text
property hotel_name: Text
property room_name: Text
property room_category: Text
property bed_type: Text
property occupancy: Text
property simulated_room_name: Text
property raw_price_text: Text
property applicable_product_text: Text
property source_file: Text
property source_row: Text
property data_quality: Text
entity HotelPriceEvent // 酒店房型在挂牌价、淡季、旺季、周末加价等不同价格事件下的价格记录。
property rate_id: Text
property hotel_name: Text
property room_id: Text
property room_name: Text
property season: Text
property event_type: Text
property price: Text
property price_min: Text
property price_max: Text
property weekend_surcharge: Text
property currency: Text
property unit: Text
property price_text: Text
property price_status: Text
property simulated_price: Text
property source_field: Text
property applicable_product_text: Text
property notes: Text
property source_file: Text
property source_row: Text
property data_quality: Text
entity ItineraryResourceBinding // 路线节点与资源的绑定槽位。状态、额外费用、是否客户可选都在这里，而不是写到 TravelItem 上。
property binding_id: Text
property name: Text
property binding_type: Text
property status: Text
property route_stop_id: Text
property travel_item_id: Text
property default_text: Text
property extra_expense: Text
property price_formula: Text
property quantity_formula: Text
property pricing_scope: Text
property charge_policy: Text
property evidence_level: Text
property requires_manual_review: Text
property customer_visible: Text
property selection_mode: Text
property notes: Text
property source_file: Text
entity CustomerSelection // 客户在某个资源槽位下的选择记录，用于后续报价累计；当前图谱只定义 Schema，不预置真实客户数据。
property selection_id: Text
property user_id: Text
property customer_profile: Text
property selected_at: Text
property selected_item_id: Text
property price: Text
property quantity: Text
property notes: Text
relation REGION_PARENT_OF: AdministrativeRegion -> AdministrativeRegion // 上级行政区包含下级行政区
relation ATTRACTION_BELONGS_TO_REGION: ScenicAttraction -> AdministrativeRegion // 景区/景点位于行政区
relation SUB_ATTRACTION_BELONGS_TO_ATTRACTION: SubAttraction -> ScenicAttraction // 子景点属于主景区
relation SUB_ATTRACTION_LOCATED_IN_REGION: SubAttraction -> AdministrativeRegion // 子景点位于行政区
relation PRODUCT_HAS_DAY: TourProduct -> ProductDay // 产品包含每日行程
relation DAY_HAS_STOP: ProductDay -> RouteStop // 每日行程按顺序包含停靠点
relation ROUTE_STOP_NEXT: RouteStop -> RouteStop // 固定路线相邻停靠点先后关系
relation STOP_VISITS_ATTRACTION: RouteStop -> ScenicAttraction // 停靠点访问主景区/景点
relation STOP_VISITS_SUB_ATTRACTION: RouteStop -> SubAttraction // 停靠点访问景区内子景点
relation STOP_LOCATED_IN_REGION: RouteStop -> AdministrativeRegion // 停靠点所在行政区
relation STOP_HAS_TRAVEL_ITEM: RouteStop -> ItineraryResourceBinding // 停靠点拥有资源绑定槽位
relation BINDING_BINDS_ITEM: ItineraryResourceBinding -> TravelItem // 绑定槽位可使用/指向 TravelItem
relation ITEM_LOCATED_IN_REGION: TravelItem -> AdministrativeRegion // 资源位于行政区
relation ITEM_SERVES_ATTRACTION: TravelItem -> ScenicAttraction // 资源可服务某景区/景点
relation HOTEL_HAS_ROOM_TYPE: TravelItem -> HotelRoomType // 酒店拥有房型/用房口径
relation ROOM_TYPE_HAS_PRICE_EVENT: HotelRoomType -> HotelPriceEvent // 房型拥有淡季/旺季/挂牌价等价格事件
relation CUSTOMER_SELECTED_BINDING: CustomerSelection -> ItineraryResourceBinding // 客户选择了某个资源槽位
relation SELECTION_SELECTED_ITEM: CustomerSelection -> TravelItem // 客户最终选择的资源项
```

372
schema搭建/travel_fixed_route_item/travel_fixed_route_item_schema.v1.json Normal file
View File

@@ -0,0 +1,372 @@
{
"namespace": "travel_fixed_route_item",
"version": "1",
"display_name": "旅行社固定线路资源图谱 Schema",
"purpose": "面向旅行社客服的已有固定路线产品查询、固定站点展示、资源槽位可选项和费用累计。路线不可改；住宿、餐饮、车辆、门票、小交通、二消、活动等统一抽象为 TravelItem，状态只写在 ItineraryResourceBinding。",
"entity_types": {
"AdministrativeRegion": {
"definition": "行政区层级，支持省/市/县/镇，资源和景区按行政区过滤。",
"fields": [
"region_id",
"name",
"level",
"province",
"city",
"county",
"town",
"parent_id",
"geo_polygon",
"source"
]
},
"ScenicAttraction": {
"definition": "路线可到达的主景区/景点锚点，例如黄果树旅游景区、荔波小七孔景区、西江千户苗寨景区。",
"fields": [
"attraction_id",
"name",
"type",
"rating",
"province",
"city",
"county",
"lat",
"lng",
"aliases",
"image_urls",
"description",
"source"
]
},
"SubAttraction": {
"definition": "主景区内的子景点/子活动，例如黄果树旅游景区下的天星桥、陡坡塘瀑布。",
"fields": [
"sub_attraction_id",
"name",
"type",
"parent_attraction_name",
"lat",
"lng",
"aliases",
"notes",
"source"
]
},
"TourProduct": {
"definition": "已有固定路线产品。路线、天数和 POI 顺序不可修改。",
"fields": [
"product_id",
"route_line_id",
"route_line_no",
"route_line_name",
"route_display_name",
"name",
"duration_days",
"duration_nights",
"theme",
"product_family",
"base_price",
"base_price_status",
"base_price_min_adult",
"base_price_max_adult",
"base_price_child_min",
"single_room_diff_min",
"base_price_text",
"price_options",
"price_option_count",
"mandatory_fee_text",
"ticket_refund_policy",
"quote_formula",
"pricing_notes",
"pricing_source_files",
"price_match_confidence",
"default_vehicle_type",
"quote_price_source",
"simulated_price_used",
"simulated_price_text",
"small_group_supported",
"small_group_support_status",
"group_service_mode",
"small_group_unsupported_reason",
"supplier_data_required",
"default_hotel_grade",
"route_immutable",
"route_stop_sequence",
"route_day_summary",
"route_extraction_status",
"route_extraction_issues",
"source_filename",
"source_text_chars",
"policy_notes",
"source_files"
]
},
"ProductDay": {
"definition": "产品中的某一天行程。",
"fields": [
"day_id",
"route_line_id",
"route_line_name",
"day_no",
"name",
"route_path",
"meal_text",
"accommodation_text",
"route_stop_sequence",
"sub_attraction_sequence",
"source_file"
]
},
"RouteStop": {
"definition": "每日停靠点/POI，像公交站一样有全程顺序和当日顺序。",
"fields": [
"stop_id",
"route_line_id",
"route_line_name",
"name",
"order_no",
"day_no",
"day_stop_order",
"global_stop_order",
"station_like_name",
"stop_type",
"city_or_area",
"route_sequence_label",
"route_display_text",
"sub_attraction_sequence",
"meal_text",
"accommodation_text",
"previous_stop_name",
"next_stop_name",
"source_file"
]
},
"TravelItem": {
"definition": "统一资源实体，酒店、餐厅、车辆、门票、小交通、保险、景区活动、购物、视频讲解等都进入这个类型。资源本身不带 INCLUDED/OPTIONAL/MANDATORY 状态。",
"fields": [
"item_id",
"name",
"type",
"subtype",
"description",
"price",
"price_text",
"adult_price",
"child_price",
"currency",
"unit",
"capacity",
"seat_count",
"safe_passenger_capacity",
"business_passenger_capacity",
"recommended_passenger_min",
"recommended_passenger_max",
"luggage_capacity",
"vehicle_group",
"vehicle_grade",
"vehicle_count_formula",
"service_rights",
"supplier_price_status",
"pricing_pending_reason",
"rating",
"region_name",
"scenic_name",
"address",
"lat",
"lng",
"features",
"signature_dishes",
"image_resource_id",
"image_match_level",
"image_url_count",
"image_urls",
"primary_image_url",
"applicable_product_text",
"room_type_count",
"rate_plan_count",
"supplier_rate_pending",
"has_simulated_room_prices",
"source_file",
"data_quality"
]
},
"HotelRoomType": {
"definition": "酒店下属房型/用房口径。酒店本体只存酒店信息，房型价格放到独立节点，避免把淡旺季价揉进酒店名称。",
"fields": [
"room_id",
"hotel_name",
"room_name",
"room_category",
"bed_type",
"occupancy",
"simulated_room_name",
"raw_price_text",
"applicable_product_text",
"source_file",
"source_row",
"data_quality"
]
},
"HotelPriceEvent": {
"definition": "酒店房型在挂牌价、淡季、旺季、周末加价等不同价格事件下的价格记录。",
"fields": [
"rate_id",
"hotel_name",
"room_id",
"room_name",
"season",
"event_type",
"price",
"price_min",
"price_max",
"weekend_surcharge",
"currency",
"unit",
"price_text",
"price_status",
"simulated_price",
"source_field",
"applicable_product_text",
"notes",
"source_file",
"source_row",
"data_quality"
]
},
"ItineraryResourceBinding": {
"definition": "路线节点与资源的绑定槽位。状态、额外费用、是否客户可选都在这里，而不是写到 TravelItem 上。",
"fields": [
"binding_id",
"name",
"binding_type",
"status",
"route_stop_id",
"travel_item_id",
"default_text",
"extra_expense",
"price_formula",
"quantity_formula",
"pricing_scope",
"charge_policy",
"evidence_level",
"requires_manual_review",
"customer_visible",
"selection_mode",
"notes",
"source_file"
]
},
"CustomerSelection": {
"definition": "客户在某个资源槽位下的选择记录，用于后续报价累计；当前图谱只定义 Schema，不预置真实客户数据。",
"fields": [
"selection_id",
"user_id",
"customer_profile",
"selected_at",
"selected_item_id",
"price",
"quantity",
"notes"
]
}
},
"relation_types": {
"REGION_PARENT_OF": [
"AdministrativeRegion",
"AdministrativeRegion",
"上级行政区包含下级行政区"
],
"ATTRACTION_BELONGS_TO_REGION": [
"ScenicAttraction",
"AdministrativeRegion",
"景区/景点位于行政区"
],
"SUB_ATTRACTION_BELONGS_TO_ATTRACTION": [
"SubAttraction",
"ScenicAttraction",
"子景点属于主景区"
],
"SUB_ATTRACTION_LOCATED_IN_REGION": [
"SubAttraction",
"AdministrativeRegion",
"子景点位于行政区"
],
"PRODUCT_HAS_DAY": [
"TourProduct",
"ProductDay",
"产品包含每日行程"
],
"DAY_HAS_STOP": [
"ProductDay",
"RouteStop",
"每日行程按顺序包含停靠点"
],
"ROUTE_STOP_NEXT": [
"RouteStop",
"RouteStop",
"固定路线相邻停靠点先后关系"
],
"STOP_VISITS_ATTRACTION": [
"RouteStop",
"ScenicAttraction",
"停靠点访问主景区/景点"
],
"STOP_VISITS_SUB_ATTRACTION": [
"RouteStop",
"SubAttraction",
"停靠点访问景区内子景点"
],
"STOP_LOCATED_IN_REGION": [
"RouteStop",
"AdministrativeRegion",
"停靠点所在行政区"
],
"STOP_HAS_TRAVEL_ITEM": [
"RouteStop",
"ItineraryResourceBinding",
"停靠点拥有资源绑定槽位"
],
"BINDING_BINDS_ITEM": [
"ItineraryResourceBinding",
"TravelItem",
"绑定槽位可使用/指向 TravelItem"
],
"ITEM_LOCATED_IN_REGION": [
"TravelItem",
"AdministrativeRegion",
"资源位于行政区"
],
"ITEM_SERVES_ATTRACTION": [
"TravelItem",
"ScenicAttraction",
"资源可服务某景区/景点"
],
"HOTEL_HAS_ROOM_TYPE": [
"TravelItem",
"HotelRoomType",
"酒店拥有房型/用房口径"
],
"ROOM_TYPE_HAS_PRICE_EVENT": [
"HotelRoomType",
"HotelPriceEvent",
"房型拥有淡季/旺季/挂牌价等价格事件"
],
"CUSTOMER_SELECTED_BINDING": [
"CustomerSelection",
"ItineraryResourceBinding",
"客户选择了某个资源槽位"
],
"SELECTION_SELECTED_ITEM": [
"CustomerSelection",
"TravelItem",
"客户最终选择的资源项"
]
},
"business_constraints": [
"TourProduct -> ProductDay -> RouteStop 是固定路线骨架，不允许客服随意改顺序。",
"TravelItem 是纯资源，不记录 INCLUDED/OPTIONAL/MANDATORY。",
"ItineraryResourceBinding.status 只能是 INCLUDED、OPTIONAL、MANDATORY。",
"报价口径：TourProduct.base_price + CustomerSelection.price 或 ItineraryResourceBinding.extra_expense 累计。",
"酒店/餐饮/门票/活动按行政区和景区过滤；车辆按人数、座位数、建议游客容量和产品默认车型过滤，不按附近地理关系过滤。",
"车辆价格当前允许预生成口径，但必须保留 supplier_price_status=pending_supplier_quote，等待供应商按车型、天数、公里数、司机食宿和团期补准。"
]
}