ScenicSpot 景点主数据

概述

ScenicSpot 表示西湖景点主数据，用于管理景点的基础信息、展示内容、地理位置、打卡奖励以及 NFC 标签绑定关系。

业务含义

西湖景点主数据。

字段定义

字段名	类型	必填	默认值	字段说明	状态值枚举
spotId	string	是	-	景点 ID	-
spotName	string	是	-	景点名称	-
area	string	是	-	所属片区	-
tagline	string	是	-	一句话亮点	-
intro	text	是	-	景点介绍	-
tips	text	否	null	游玩贴士	-
durationMin	int	否	0	建议游玩时长	-
heroImage	string	是	-	主图	-
gallery	json	否	[]	图册	-
latitude	decimal	否	null	纬度	-
longitude	decimal	否	null	经度	-
checkinPoints	int	是	0	首次打卡奖励积分	-
nfcTagIds	json	否	[]	绑定的标签 ID 列表	-
status	enum	是	active	景点状态	active, inactive

字段说明补充

• spotId：景点唯一标识。
• spotName：用于前台展示的景点名称。
• area：景点所属片区，用于区域归类与筛选。
• tagline：景点亮点摘要，适合列表页或卡片式展示。
• intro：景点详细介绍正文。
• tips：可选的游玩建议、注意事项。
• durationMin：建议游玩时长，单位为分钟。
• heroImage：景点主视觉图片。
• gallery：景点图册，存储多张图片信息的 JSON 数组。
• latitude / longitude：景点地理坐标，用于地图展示与定位。
• checkinPoints：用户首次打卡该景点可获得的积分。
• nfcTagIds：与该景点绑定的 NFC 标签 ID 列表。
• status：景点启用状态。

状态枚举

值	含义
active	启用
inactive	停用

建模要点

• gallery、nfcTagIds 为 JSON 类型，默认空数组 []。
• 地理坐标字段可为空，说明系统允许景点暂不配置地图定位信息。
• checkinPoints 为必填字段，默认值为 0，表示可显式配置无奖励积分。
• status 默认值为 active，新增景点默认处于启用状态。