# 官网 CMS 侧边栏菜单设计

> **版本**: v1.0  
> **关联文档**: [proposal.md](../www/proposal.md)  
> **目标**: 定义 Dashboard 侧边栏中「官网管理」模块的菜单结构、路由规划及页面职责

---

## 1. 现有菜单结构

| order | 菜单 | 路由 | 说明 |
|-------|------|------|------|
| 1 | 首页 | `/home` | Dashboard 数据看板 |
| 2 | 耳机 | `/headphone` | 品牌管理 / 型号管理 |
| 3 | OTA 升级 | `/upgrade` | OTA / 目标设备 / 黑名单 |
| 4 | 分享码 | `/share-code` | 分享码日志 |
| 5 | 系统 | `/system` | 用户管理（隐藏，仅超管） |
| 6 | 工具箱 | `/toolbox` | Luxsin Controller |

---

## 2. 新增「官网管理」菜单

在现有菜单之后新增一个顶级分组 **「官网管理」**，包含以下子菜单：

```
官网管理 (www)
├── 全局配置 (global)
│   ├── 站点信息 (basic)
│   ├── 页脚配置 (footer)
│   ├── 社交链接 (social)
│   └── SEO 默认值 (seo)
├── 导航管理 (nav)
│   ├── 导航入口 (items)
│   └── 导航外观 (appearance)
├── 页面管理 (page)
│   ├── 首页区块 (home)
│   ├── 产品列表页 (product-list)
│   ├── 新闻列表页 (news-list)
│   ├── 关于我们 (about)
│   └── 技术支持 (support)
├── 产品管理 (product)
│   ├── 产品系列 (series)
│   └── 产品列表 (list)
├── 新闻管理 (news)
│   └── 新闻文章 (articles)
├── 素材库 (media)
├── 翻译管理 (i18n)
├── 联系表单 (contact)
│   ├── 表单配置 (settings)
│   └── 提交记录 (submissions)
└── 页面 SEO (page-seo)
```

---

## 3. 路由与菜单详细定义

### 3.1 路由命名规范

- 顶级分组: `www`
- 子菜单: `www_{module}` 格式，用 `_` 分隔层级
- 路由路径: `/www/{module}` 或 `/www/{module}/{sub}`
- i18n Key: `route.www_{name}`

### 3.2 完整路由表

| route name | path | icon | order | keepAlive | 说明 |
|---|---|---|---|---|---|
| **www** | `/www` | `mdi:globe-model` | 7 | — | 顶级分组 |
| www_global | `/www/global` | `mdi:application-cog-outline` | 1 | — | 全局配置（分组） |
| www_global_basic | `/www/global/basic` | `mdi:information-outline` | 1 | ✓ | 站点标题 / Favicon / Logo |
| www_global_footer | `/www/global/footer` | `mdi:page-layout-footer` | 2 | ✓ | 公司名称 / 地址 / 备案信息 |
| www_global_social | `/www/global/social` | `mdi:share-variant-outline` | 3 | ✓ | 微信 / 微博 / B站 / YouTube 等 |
| www_global_seo | `/www/global/seo` | `mdi:magnify` | 4 | ✓ | 全站默认 Meta / OG 图片 |
| www_nav | `/www/nav` | `mdi:menu` | 2 | — | 导航管理（分组） |
| www_nav_items | `/www/nav/items` | `mdi:format-list-bulleted` | 1 | ✓ | 入口增删排序 / 显示形式 |
| www_nav_appearance | `/www/nav/appearance` | `mdi:palette-outline` | 2 | ✓ | 首页/非首页导航风格 |
| www_page | `/www/page` | `mdi:file-document-outline` | 3 | — | 页面管理（分组） |
| www_page_home | `/www/page/home` | `mdi:home-outline` | 1 | ✓ | 首页 Section 区块配置 |
| www_page_product-list | `/www/page/product-list` | `mdi:format-list-bulleted-square` | 2 | ✓ | 产品列表 Page Hero / 列数 |
| www_page_news-list | `/www/page/news-list` | `mdi:newspaper-variant-outline` | 3 | ✓ | 新闻列表 Page Hero / 分页 |
| www_page_about | `/www/page/about` | `mdi:account-group-outline` | 4 | ✓ | 关于我们文本/图片/CTA |
| www_page_support | `/www/page/support` | `mdi:lifebuoy` | 5 | ✓ | 技术支持 FAQ/下载/联系 |
| www_product | `/www/product` | `mdi:package-variant-closed` | 4 | — | 产品管理（分组） |
| www_product_series | `/www/product/series` | `mdi:layers-outline` | 1 | ✓ | 产品系列 CRUD |
| www_product_list | `/www/product/list` | `mdi:view-list-outline` | 2 | ✓ | 产品 CRUD + Section + 参数规格 |
| www_news | `/www/news` | `mdi:newspaper-variant-multiple-outline` | 5 | — | 新闻管理（分组） |
| www_news_articles | `/www/news/articles` | `mdi:article-outline` | 1 | ✓ | 新闻文章 CRUD |
| www_media | `/www/media` | `mdi:image-multiple-outline` | 6 | ✓ | 素材库（独立页面） |
| www_i18n | `/www/i18n` | `mdi:translate` | 7 | ✓ | 翻译词条管理（独立页面） |
| www_contact | `/www/contact` | `mdi:email-outline` | 8 | — | 联系表单（分组） |
| www_contact_settings | `/www/contact/settings` | `mdi:form-textbox` | 1 | ✓ | 表单字段/全局配置 |
| www_contact_submissions | `/www/contact/submissions` | `mdi:inbox-outline` | 2 | ✓ | 提交记录列表 |
| www_page-seo | `/www/page-seo` | `mdi:search-web` | 9 | ✓ | 页面级 SEO 覆盖（独立页面） |

---

## 4. 页面职责说明

### 4.1 全局配置

| 子页面 | 对应 proposal | 对应表 | 页面类型 |
|--------|-------------|--------|---------|
| 站点信息 | §1.1 | `www_site_settings` | 单表单（直接编辑保存） |
| 页脚配置 | §1.2 | `www_footer_settings` | 单表单 |
| 社交链接 | §1.3 | `www_social_links` | 列表（增删改排序） |
| SEO 默认值 | §1.4 | `www_seo_defaults` | 单表单 |

### 4.2 导航管理

| 子页面 | 对应 proposal | 对应表 | 页面类型 |
|--------|-------------|--------|---------|
| 导航入口 | §2.1 | `www_nav_items` | 列表（拖拽排序/增删改） |
| 导航外观 | §2.3 | `www_nav_appearance` | 单表单 |

### 4.3 页面管理

| 子页面 | 对应 proposal | 对应表 | 页面类型 |
|--------|-------------|--------|---------|
| 首页区块 | §3.1 | `www_section_blocks` (page_type=homepage) | Section 编辑器（拖拽排序/增删/配置面板） |
| 产品列表页 | §3.3 | `www_product_list_settings` | 单表单 |
| 新闻列表页 | §3.4 | `www_news_list_settings` | 单表单 |
| 关于我们 | §3.6 | `www_about_settings` | 单表单（多 Section 展开编辑） |
| 技术支持 | §3.7 | `www_support_settings` | 单表单（多 Section 展开编辑） |

### 4.4 产品管理

| 子页面 | 对应 proposal | 对应表 | 页面类型 |
|--------|-------------|--------|---------|
| 产品系列 | §4.1 | `www_product_series` | 列表 CRUD |
| 产品列表 | §4.2 §4.3 | `www_products` + `www_section_blocks` + `www_spec_groups` + `www_spec_items` | 列表 CRUD → 详情页编辑（Section + 参数规格） |

### 4.5 新闻管理

| 子页面 | 对应 proposal | 对应表 | 页面类型 |
|--------|-------------|--------|---------|
| 新闻文章 | §5.1 §5.2 | `www_news_articles` + `www_news_recommendations` | 列表 CRUD + 富文本编辑器 |

### 4.6 素材库

| 子页面 | 对应 proposal | 对应表 | 页面类型 |
|--------|-------------|--------|---------|
| 素材库 | §6 | `www_media` + `www_media_tags` + `www_media_tag_map` | 文件管理（上传/分类/标签/搜索/预览） |

### 4.7 翻译管理

| 子页面 | 对应 proposal | 对应表 | 页面类型 |
|--------|-------------|--------|---------|
| 翻译词条 | §8.3 | `www_i18n_entries` | 列表（搜索/筛选/编辑） |

### 4.8 联系表单

| 子页面 | 对应 proposal | 对应表 | 页面类型 |
|--------|-------------|--------|---------|
| 表单配置 | §9.1 §9.2 | `www_form_settings` + `www_form_fields` | 单表单 + 字段列表（拖拽排序） |
| 提交记录 | §9 | `www_form_submissions` | 列表（查看/标记已读/删除） |

### 4.9 页面 SEO

| 子页面 | 对应 proposal | 对应表 | 页面类型 |
|--------|-------------|--------|---------|
| 页面 SEO | §7.1 | `www_page_seo` | 列表（按页面类型筛选/编辑） |

---

## 5. 优先级与开发顺序

### P0 - 核心功能（一期必须）

| 序号 | 菜单 | 理由 |
|------|------|------|
| 1 | 产品系列 + 产品列表 | 官网核心内容，其他页面依赖产品数据 |
| 2 | 首页区块 | 官网首屏，营销关键页面 |
| 3 | 全局配置 | 站点基础信息，所有页面依赖 |
| 4 | 导航管理 | 站点导航骨架 |
| 5 | 素材库 | 图片和文件管理，所有页面依赖 |
| 6 | 翻译管理 | 双语支持基础 |

### P1 - 重要功能（一期完整）

| 序号 | 菜单 | 理由 |
|------|------|------|
| 7 | 新闻文章 | 内容营销 |
| 8 | 产品列表页 / 新闻列表页 | 列表展示配置 |
| 9 | 关于我们 / 技术支持 | 品牌展示页面 |
| 10 | 页面 SEO | 搜索引擎优化 |

### P2 - 次要功能（可后置）

| 序号 | 菜单 | 理由 |
|------|------|------|
| 11 | 联系表单 | 用户互动，优先级较低 |

---

## 6. 完整侧边栏菜单（最终视图）

```
📊 首页                    /home
🎧 耳机                    /headphone
📦 OTA 升级               /upgrade
🔗 分享码                  /share-code
─────────────────────────────
🌐 官网管理                /www
  📋 全局配置              /www/global
    · 站点信息             /www/global/basic
    · 页脚配置             /www/global/footer
    · 社交链接             /www/global/social
    · SEO 默认值           /www/global/seo
  📍 导航管理              /www/nav
    · 导航入口             /www/nav/items
    · 导航外观             /www/nav/appearance
  📄 页面管理              /www/page
    · 首页区块             /www/page/home
    · 产品列表页           /www/page/product-list
    · 新闻列表页           /www/page/news-list
    · 关于我们             /www/page/about
    · 技术支持             /www/page/support
  📦 产品管理              /www/product
    · 产品系列             /www/product/series
    · 产品列表             /www/product/list
  📰 新闻管理              /www/news
    · 新闻文章             /www/news/articles
  🖼️ 素材库               /www/media
  🌍 翻译管理              /www/i18n
  ✉️ 联系表单              /www/contact
    · 表单配置             /www/contact/settings
    · 提交记录             /www/contact/submissions
  🔍 页面 SEO             /www/page-seo
─────────────────────────────
⚙️ 系统                    /system（隐藏）
🧰 工具箱                  /toolbox
```