12451 b553c4e519 feat: API 统一 + 设备详情补全 + H5 导航优化

- API 路由统一: 移除 /api/h5/，统一 /api/pms/ 入口
- 二进制改名: api-server -> pms-api（与服务名一致）
- nginx: 合并 /api/ + /pms/api/ 为 /api/pms/
- 新增 docs/API.md 接口文档
- 后端: CabinetDetail 增加 rssi/pow_fail/address/soc 等字段
- Redis 管道批量读取仓体实时数据（SOC/电压/电流/功率）
- DB: 所有 TIMESTAMP 列改为 DATETIME（修复类型不匹配）
- 用户管理: 新增创建时间/修改时间列，状态改用 Switch
- 角色管理/用户管理: 操作按钮改为图标
- PC 设备详情: 基本信息补全 RSSI/ICCID/电源/地址
- PC 卡片: 通道统计改用 Lucide 图标，颜色统一
- PC 二维码: canvas 渲染，含编号文字，支持右键下载
- H5: 按 uni-app 规范修正导航（navigateTo 替代 reLaunch）
- H5: 详情页加返回导航条
- H5: 扫码支持摄像头（jsQR）+ ?id= 参数
- H5: 底部 tabBar 在所有页面常显
- H5: 首页统计改为 6 项（设备/通道/空闲/充电/充满/故障）
- H5: 下拉刷新 / 上拉加载
- 产品首页: 添加业务联系
- 文档: 清理过时文件，补充缺失规范章节

2026-07-04 04:03:02 +08:00

4.1 KiB

Raw Blame History

name, description

name	description
vite-plugin-uni-pages	File-based routing system for Vite-powered uni-app projects with automatic page discovery and TypeScript support

vite-plugin-uni-pages

Provides file-based routing for uni-app projects using Vite. Automatically generates pages.json configuration from your file structure.

Installation

npm i -D @uni-helper/vite-plugin-uni-pages

Basic Setup

// vite.config.ts
import Uni from '@dcloudio/vite-plugin-uni'
import UniPages from '@uni-helper/vite-plugin-uni-pages'
import { defineConfig } from 'vite'

// Place UniPages before Uni
export default defineConfig({
  plugins: [UniPages(), Uni()],
})

TypeScript Support

Add types to tsconfig.json:

{
  "compilerOptions": {
    "types": ["@uni-helper/vite-plugin-uni-pages"]
  }
}

Global Configuration

Create pages.config.ts (or .js/.json) for global settings:

// pages.config.ts
import { defineUniPages } from '@uni-helper/vite-plugin-uni-pages'

export default defineUniPages({
  // Optional: manual pages have highest priority
  pages: [],
  globalStyle: {
    navigationBarTextStyle: 'black',
    navigationBarTitleText: '@uni-helper',
  },
})

Virtual Module

Access page metadata via virtual module:

/// <reference types="@uni-helper/vite-plugin-uni-pages/client" />
import { pages } from 'virtual:uni-pages'

console.log(pages)

definePage Macro

Define page configuration directly in SFC files:

<script setup lang="ts">
// Object form
definePage({
  style: {
    navigationBarTitleText: 'hello world',
  },
  middlewares: ['auth'],
})

// Function form (supports TypeScript, async)
definePage(() => {
  return {
    style: {
      navigationBarTitleText: 'dynamic title',
    },
  }
})

// Async form
definePage(async () => {
  const title = await fetchTitle()
  return {
    style: { navigationBarTitleText: title },
  }
})
</script>

Important Notes for definePage

Write inside <script> block
definePage runs in a different scope than SFC (no access to SFC variables)
Page path is auto-generated from file path
Only one definePage per file
Supports importing external libraries (pure JS only)
Supports TypeScript type imports (types are stripped)

Using with Condition Compile

<script setup>
import { isH5 } from '@uni-helper/uni-env'

definePage(() => {
  const title = isH5 ? 'H5 Environment' : 'Other Platform'
  return {
    style: { navigationBarTitleText: title },
  }
})
</script>

Configuration Options

export interface Options {
  /** Generate TypeScript declarations */
  dts?: boolean | string  // default: true (outputs uni-pages.d.ts)

  /** Config file pattern */
  configSource: string    // default: 'pages.config.(ts|mts|cts|js|cjs|mjs|json)'

  /** Default home page */
  homePage: string        // default: 'pages/index' or 'pages/index/index'

  /** Merge with existing pages.json */
  mergePages: boolean     // default: true

  /** Pages directory */
  dir: string             // default: 'src/pages'

  /** Sub-packages directories */
  subPackages: string[]   // e.g., ['src/pages-sub']

  /** Output directory for pages.json */
  outDir: string          // default: 'src'

  /** Exclude patterns */
  exclude: string[]       // default: []

  /** Route block language in SFC */
  routeBlockLang: 'json5' | 'jsonc' | 'json' | 'yaml' | 'yml'  // default: 'json5'

  // Lifecycle hooks
  onBeforeLoadUserConfig?: (ctx: PageContext) => void
  onAfterLoadUserConfig?: (ctx: PageContext) => void
  onBeforeScanPages?: (ctx: PageContext) => void
  onAfterScanPages?: (ctx: PageContext) => void
  onBeforeMergePageMetaData?: (ctx: PageContext) => void
  onAfterMergePageMetaData?: (ctx: PageContext) => void
  onBeforeWriteFile?: (ctx: PageContext) => void
  onAfterWriteFile?: (ctx: PageContext) => void
}

Usage with Layouts

<script setup>
definePage({
  layout: 'default',  // Specify layout
  middlewares: ['auth'],
})
</script>

4.1 KiB Raw Blame History