iotlcm-admin-ui

iotLCM 物联网卡全生命周期管理平台的管理前端 —— 卡资产、通信管理、资费交易、告警工单、统计分析、账号治理。

配套后端：iotlcm-admin-svr。

上游与许可

本项目基于 Vben Admin 5.5.9（MIT License）二次开发。

• 上游版权与许可声明完整保留在 LICENSE 与各源文件的 @Author / @Copyright 头中
• iotLCM 相关的业务页面、API 封装与配置为本项目新增
• 上游仓库：vbenjs/vue-vben-admin
• 上游自带的说明文档保留在 vue/README.md

技术栈

• Vue 3 + Vite + TypeScript
• Vben Admin 5.5.9（Ant Design Vue 版：apps/web-antd）
• Pinia（状态）、Vue Router、TailwindCSS + UnoCSS（原子化样式）
• pnpm workspace + Turborepo（monorepo）

快速开始

cd vue
pnpm install
pnpm dev:antd

开发服务器默认监听 http://127.0.0.1:5666/。

构建：

pnpm build:antd

产物在 vue/apps/web-antd/dist/。

配置

环境变量文件在 vue/apps/web-antd/：

文件	用途
.env	通用配置（应用标题、命名空间、客户端 ID、store 加密密钥）
.env.development	开发环境（端口、API 地址）
.env.production	生产环境（压缩策略、路由模式、PWA）

公开版里的凭据是占位符：

变量	占位	说明
VITE_GLOB_CLIENT_ID	your-client-id	OAuth 客户端 ID
VITE_APP_STORE_SECURE_KEY	please-replace-me-with-your-own-key	localStorage 加密密钥
TIANDITU_CONFIG.API_KEY	YOUR_TIANDITU_KEY	天地图 API Key（src/config/tianditu.ts）

⚠️ VITE_APP_STORE_SECURE_KEY 必须是自己的随机值——它用于加密持久化的 store，换设备时 store 数据将无法解密。

目录结构

iotlcm-admin-ui/
├── Makefile                   # 容器构建与推送
└── vue/                       # Vben Admin monorepo
    ├── apps/web-antd/         # iotLCM 管理端应用（主应用）
    │   ├── src/api/iotlcm/    # iotLCM 业务 API 封装
    │   ├── src/views/iotlcm/  # iotLCM 业务页面
    │   ├── src/config/        # 应用配置（含天地图配置）
    │   └── .env*              # 环境变量
    ├── packages/              # 内部共享包
    └── internal/              # 构建期工具

容器化构建

docker build --rm -f vue/build/Dockerfile --platform linux/amd64 -t iotlcm-admin-ui:latest .

推送到自己的镜像仓库：

REGISTRY=<your-registry> make dockerpush

License

MIT —— 含 Vben Admin 上游的 MIT 声明。