官网内容管理-后端接口开发

This commit is contained in:
eafonyang
2026-07-30 17:33:08 +08:00
parent b1c88fc5e6
commit e71d18b331
34 changed files with 4246 additions and 0 deletions
+56
View File
@@ -172,6 +172,7 @@ Admin 可对导航栏中的每个入口进行以下配置:
| 特性列表 | 子表单 | 布局 5(Feature Grid)专用:图标 + 标题 + 描述 |
| 步骤列表 | 子表单 | 布局 8Scroll Narrative)专用:步骤标题 + 描述 + 配图 |
| 视频地址 | 素材选择 | 布局 7Video Showcase)专用 |
| 参数分组列表 | 子表单 | 布局 10(Spec Table)专用:分组标题 + 参数项列表(详见 4.3 节) |
> 不同布局模式下,仅显示该布局所需的配置字段,无关字段自动隐藏。
@@ -290,6 +291,61 @@ Admin 可对导航栏中的每个入口进行以下配置:
- 未配置任何 Section 的产品,详情页仅显示 Page Hero(标题为产品名)+ 产品简介
- 建议为每个产品至少配置 3-5 个 Section 区块
### 4.3 产品参数规格(Spec Table 布局)
参数规格作为一种 **Section 布局类型**(布局 10),在产品详情页中与其他 Section 一起拖拽排序、显示/隐藏。
**前端展示效果:**
- 每个分组以卡片形式展示,左侧为分组标题(如“基本规格”“输入 / 输出”)
- 卡片内以「标签: 值」列表形式排列参数项,细线分隔
- 每个分组默认显示前 N 项,超出部分收起,显示“查看全部参数 ∨”按钮展开
- 展开后按钮变为“收起参数 ∧”
**后台配置结构:**
每个产品可独立配置多个参数分组,每个分组包含多个参数项:
| 层级 | 配置项 | 类型 | 必填 | 说明 |
|------|--------|------|------|------|
| 分组 | 分组标题(中/英) | 文本 | 是 | 如“基本规格”“输入 / 输出”“XLR 输出音频特性” |
| 分组 | 排列顺序 | 数字排序 | 否 | 分组在产品页中的显示顺序 |
| 分组 | 默认显示数量 | 数字 | 否 | 收起状态下默认显示前 N 项,默认 5 |
| 参数项 | 参数名称(中/英) | 文本 | 是 | 如“信噪比”“尺寸”“重量” |
| 参数项 | 参数值(中/英) | 文本 | 是 | 如“≥129.5dB”“236mm × 236.8mm × 64mm” |
| 参数项 | 排列顺序 | 数字排序 | 否 | 参数在分组内的显示顺序 |
**配置示例:**
```
产品:Luxsin X8
├── 分组 1:基本规格(默认显示 5 项)
│ ├── 型号: Luxsin X8
│ ├── 尺寸: 236mm (长) × 236.8mm (宽) × 64mm (高)
│ ├── 重量: 2750g
│ ├── 电源输入: AC 100120V/220240V50/60Hz
│ └── 屏幕: 4英寸 LCD (480×960) 触摸屏
├── 分组 2:输入 / 输出(默认显示 5 项)
│ ├── USB-A 输入: 用于本地固件升级
│ ├── USB-B 输入: 最高支持 PCM 768kHz/32bitDSD512(Native)
│ ├── USB-C 输入: 最高支持 PCM 768kHz/32bitDSD512(Native)
│ ├── IIS 输入: 最高支持 PCM 768kHz/32bitDSD512(Native)
│ └── 同轴输入: 最高支持 PCM 192kHz/24bit
└── 分组 3:XLR 输出音频特性(默认显示 5 项)
├── 信噪比: ≥129.5dB
├── 总谐波失真: <−121.8dB @不加权
├── 声道分离度: ≥133dB (1kHz@200kΩ)
├── 底噪: 1.1uVrms
└── 线路输出电平: 4.2Vrms (1kHz@200kΩ)
```
**Admin 端操作:**
- 在产品详情页 Section 配置中,添加布局类型为「参数规格」的区块
- 区块内可添加多个分组,每个分组内可添加多个参数项
- 分组和参数项均支持拖拽排序
- 若参数项≤默认显示数量,前端不显示“查看全部参数”按钮
---
## 5. 新闻管理