Appearance
周边图鉴 Atlas
概述
周边图鉴（Atlas）用于描述带芯片周边对应的图鉴主数据，是项目中用于管理图鉴信息、关联商品及芯片标签的核心数据结构。
业务含义
带芯片周边对应的图鉴主数据。
数据结构
| 字段名 | 类型 | 必填 | 默认值 | 字段说明 | 状态值枚举 |
|---|---|---|---|---|---|
| atlasId | string | 是 | - | 图鉴 ID | - |
| goodsId | string | 否 | null | 关联商品 ID | - |
| atlasName | string | 是 | - | 图鉴名称 | - |
| atlasIcon | string | 是 | - | 图鉴图标 | - |
| intro | text | 否 | null | 图鉴说明 | - |
| nfcTagIds | json | 否 | [] | 图鉴芯片标签列表 | - |
| rewardPoints | int | 是 | 0 | 解锁奖励积分 | - |
| status | enum | 是 | active | 状态 | active, inactive |
字段说明
atlasId
- 类型：
string - 必填：是
- 含义：图鉴唯一标识。
goodsId
- 类型：
string - 必填：否
- 默认值：
null - 含义：关联的商品 ID。
atlasName
- 类型：
string - 必填：是
- 含义：图鉴名称。
atlasIcon
- 类型：
string - 必填：是
- 含义：图鉴图标资源地址或标识。
intro
- 类型：
text - 必填：否
- 默认值：
null - 含义：图鉴说明文本。
nfcTagIds
- 类型：
json - 必填：否
- 默认值：
[] - 含义：与该图鉴关联的芯片标签列表。
rewardPoints
- 类型：
int - 必填：是
- 默认值：
0 - 含义：用户解锁该图鉴后可获得的奖励积分。
status
- 类型：
enum - 必填：是
- 默认值：
active - 含义：图鉴状态。
- 枚举值：
active：启用inactive：停用
建模要点
atlasId应作为图鉴主键使用。goodsId用于建立图鉴与商品的关联关系。nfcTagIds适合存储多个 NFC 芯片标签标识。rewardPoints用于图鉴解锁后的积分激励逻辑。status用于控制图鉴是否生效。