feat(portal): 首页补齐产品功能、核心能力、界面预览、官方文档四个区块

用户反馈首页缺产品功能、核心能力与界面预览，且没有官方文档入口。新增区块 - 产品功能：三条产品线（iotLCM / 秀杰 DTU / XiuAdmin），每条列 6 项能力，卡片底部直达详情页 - 核心能力：8 张带标签的卡片，讲工程层面的硬指标（部署、接入、开放、治理、韧性、交付、数据、维护），与"产品功能"区分开：前者是做什么，后者是凭什么能用住 - 界面预览：ScreenshotPreview 组件，Web 管理端 / 小程序端两组标签切换，首屏大图 + 缩略图条，带浏览器窗口装饰 - 官方文档：6 个入口卡片（文档中心、Web 手册、小程序手册、部署手册、 OpenAPI 合同、门户部署说明），外链自动加 target=_blank 界面预览的占位机制 - previewShots 里 file 留空时渲染带图注的占位框，不报错、不影响构建 - 补图只改 file 字段，组件无需改动 - 新增 pages/public/screenshots/README.md 写清命名、尺寸、脱敏要求导航 - 增加产品功能、核心能力、界面预览、官方文档四个锚点项 - 窄屏（≤860px）隐藏中间三个锚点项，避免挤压验证 - 构建 13 页，208 条引用 0 失效 - 浏览器实测：7 个导航项、5 个 section 锚点齐全 - 移动端 390px 无横向溢出 - 文档站 5 个外链地址均实测 200 可达
2026-11-04 14:27:48 +08:00
parent ac1354da9e
commit ccb3f5e39a
8 changed files with 766 additions and 6 deletions
@@ -19,6 +19,120 @@ export const stats: Stat[] = [
  { num: '100', unit: '%', label: 'Apache-2.0 许可' },
 ]

+/* ============================================================
+   产品功能 —— 首页「产品功能」区块，按产品线列功能点
+   ============================================================ */
+
+export interface ProductLine {
+  id: string
+  name: string
+  /** 一句话定位 */
+  tagline: string
+  /** 该产品线的功能清单，取 6 条最能说明问题的 */
+  features: string[]
+  /** 对应详情页 */
+  page: string
+}
+
+export const productLines: ProductLine[] = [
+  {
+    id: 'iotlcm',
+    name: 'iotLCM 物联网卡',
+    tagline: 'SIM 卡从入库到销户的全流程',
+    features: [
+      '卡信息检索与批量导入',
+      '入库 / 库存 / 出库三级流转',
+      '批量开停复机与续费',
+      '套餐、流量池与定价',
+      '三大运营商协议直连',
+      '达量断网与智能诊断',
+    ],
+    page: '/projects/iotlcm/',
+  },
+  {
+    id: 'xiu-dtu',
+    name: '秀杰 DTU 设备',
+    tagline: 'DTU 设备从生产到运行监控',
+    features: [
+      '产品、型号与生产批次',
+      '固件版本与 OTA 升级',
+      '配置分组与下发状态',
+      '代理商划拨与回收',
+      'HTTP / TCP 双通道接入',
+      '设备在线状态监控',
+    ],
+    page: '/projects/xiu-dtu/',
+  },
+  {
+    id: 'xiu-admin',
+    name: 'XiuAdmin 中后台',
+    tagline: '22 项内置功能的应用底座',
+    features: [
+      '多租户与租户套餐',
+      '用户、部门、岗位、角色',
+      '菜单与按钮级权限',
+      '代码生成（CURD / 树表）',
+      '定时任务与消息队列',
+      '服务监控与操作日志',
+    ],
+    page: '/projects/xiu-admin/',
+  },
+]
+
+/* ============================================================
+   核心能力 —— 首页「核心能力」区块，强调工程层面的硬指标
+   ============================================================ */
+
+export interface CoreAbility {
+  title: string
+  text: string
+  /** 卡片角标，一个词概括 */
+  tag: string
+}
+
+export const coreAbilities: CoreAbility[] = [
+  {
+    tag: '部署',
+    title: '单机一条命令起',
+    text: 'Docker Compose 编排齐备，首次启动自动建库建表、导入种子数据与时序库建表，不需要本地编译，约一分钟可用。',
+  },
+  {
+    tag: '接入',
+    title: '运营商协议内置',
+    text: '中国移动 OneLink、中国电信 5G CMP、中国联通 10646 的接口差异收敛在对接层，上层业务不感知底层协议。',
+  },
+  {
+    tag: '开放',
+    title: '版本化对外接口',
+    text: 'V3 版本化接口、旧版兼容接口与运营商能力代理三套合同并行，升级不破坏既有调用方。',
+  },
+  {
+    tag: '治理',
+    title: '多租户权限模型',
+    text: '租户、部门、岗位、角色四层结构，菜单与按钮级权限、数据范围划分，关键操作全程留痕。',
+  },
+  {
+    tag: '韧性',
+    title: '上游抖动隔离',
+    text: '独立的通道缓存转发层，上游接口异常或超时不直接传导到管理端，配合健康探针与运行期 DNS 解析自动跟随容器 IP 变化。',
+  },
+  {
+    tag: '交付',
+    title: '离线可部署',
+    text: '镜像可导出为归档文件带入内网，无外网环境同样能完成安装与升级，适合企业内网与客户现场。',
+  },
+  {
+    tag: '数据',
+    title: '时序数据留存',
+    text: '流量与状态按账期落入时序库，月度账单自动生成、每小时增量更新，长期趋势分析不失真。',
+  },
+  {
+    tag: '维护',
+    title: '文档与代码同仓',
+    text: '使用手册、部署手册与接口合同与代码同仓维护，随平台一起发布，版本不会脱节。',
+  },
+]
+
 export interface Capability {
  title: string
  text: string
@@ -170,3 +284,98 @@ export const dtuGroups: CapGroup[] = [
    ],
  },
 ]
+
+/* ============================================================
+   界面预览 —— 首页「界面预览」区块
+   ============================================================ */
+
+export interface PreviewShot {
+  /** 截图文件名，放在 pages/public/screenshots/ 下；为空时渲染占位框 */
+  file: string
+  /** 图注，说明这张图看的是什么 */
+  caption: string
+  /** 所属端，用于标签切换 */
+  group: 'web' | 'app'
+}
+
+/**
+ * 每个分组的第一张是首屏大图，其余进下方缩略图条。
+ *
+ * 图片放置约定：pages/public/screenshots/<file>
+ * 建议尺寸 1600x1000（web）/ 750x1334（app），单张控制在 400KB 以内。
+ * file 留空时页面显示占位框与图注，不会报错 —— 补图时只改 file 字段即可。
+ */
+export const previewShots: Record<'web' | 'app', PreviewShot[]> = {
+  web: [
+    { file: '', caption: '管理端工作台：卡量与用量概览', group: 'web' },
+    { file: '', caption: '卡信息列表：三码检索与批量操作', group: 'web' },
+    { file: '', caption: '业务受理：开通、续费与变更套餐', group: 'web' },
+    { file: '', caption: '套餐与定价配置', group: 'web' },
+    { file: '', caption: '通道与上游接入管理', group: 'web' },
+    { file: '', caption: '企业、用户与角色权限', group: 'web' },
+  ],
+  app: [
+    { file: '', caption: '用户端首页：公开查卡入口', group: 'app' },
+    { file: '', caption: '卡片详情与用量', group: 'app' },
+    { file: '', caption: '业务办理：续费与套餐变更', group: 'app' },
+    { file: '', caption: '智能诊断：按链路排查问题', group: 'app' },
+  ],
+}
+
+/* ============================================================
+   官方文档 —— 首页「官方文档」区块
+   ============================================================ */
+
+export interface DocEntry {
+  name: string
+  /** 这份文档解决什么问题 */
+  desc: string
+  url: string
+  /** 归属项目名，用于分组显示 */
+  project: string
+}
+
+/**
+ * 文档站是随 iotLCM 发布的独立站点（VitePress），按手册分册。
+ * 地址可用 DOCS_BASE 环境变量在构建时覆盖，见 .vitepress/config.mts。
+ */
+const DOCS_BASE = 'http://open.5iot.com:5051/docs'
+
+export const docs: DocEntry[] = [
+  {
+    name: '文档中心',
+    desc: '全部手册的入口页，按端与用途分册索引',
+    url: `${DOCS_BASE}/`,
+    project: 'iotLCM',
+  },
+  {
+    name: '使用手册 · Web 管理端',
+    desc: '查卡、业务受理、套餐定价、库存出入库、通道管理、企业用户与角色、工单、API 凭证',
+    url: `${DOCS_BASE}/manual/web/`,
+    project: 'iotLCM',
+  },
+  {
+    name: '使用手册 · 小程序端',
+    desc: '公开查卡、卡片排查、客户管理与划拨、工单、批次执行日志、消息与个人中心',
+    url: `${DOCS_BASE}/manual/mini-program/`,
+    project: 'iotLCM',
+  },
+  {
+    name: '部署手册',
+    desc: '环境要求、一键部署、配置说明、离线部署、拆分部署、自建镜像、运维与排错',
+    url: `${DOCS_BASE}/deploy/`,
+    project: 'iotLCM',
+  },
+  {
+    name: 'OpenAPI 合同',
+    desc: '鉴权方式、V3 接口、旧版兼容接口、运营商能力代理',
+    url: `${DOCS_BASE}/openapi/`,
+    project: 'iotLCM',
+  },
+  {
+    name: '门户部署说明',
+    desc: '本门户自身的构建参数、镜像形态与容器部署方式',
+    url: '/guide/portal-deploy',
+    project: '门户站',
+  },
+]