MiFaZhan
f7cab5ad5c
mirror-to-gitee / mirror (push) Successful in 14s
把原来 12 个独立仓合并为单仓多服务结构，各仓完整提交历史通过
read-tree 并入保留（137 个提交，blame 可追溯）。
目录：
admin-svr/ admin-ui/ app/{server,app}/ openapi/ worker-svr/
upstream-chan/ upstream-proxy/ sms/ bot/ docs/ onelink-mock/ deploy/
同时：
- 新增根 README（目录说明、快速开始、源码构建、镜像发布、许可）
- 新增根 Makefile（make build / test / images / docs）
- 新增根 .gitattributes / .gitignore，删掉 12 份重复的 Apache LICENSE
（admin-ui/ 与 app/app/ 的 MIT 上游许可保留）
- 各服务的 .gitea/workflows 收敛到仓根：trigger-jenkins.yml（tag 构建全部
服务）+ mirror-to-gitee.yml（自动建 Gitee 仓后镜像）
- 文档内跨仓绝对链接改为仓内相对路径；部署/构建文档改为单仓路径
91 lines
2.8 KiB
Markdown
91 lines
2.8 KiB
Markdown
# iotlcm-admin-ui
|
||
|
||
iotLCM 物联网卡全生命周期管理平台的**管理前端** —— 卡资产、通信管理、资费交易、告警工单、统计分析、账号治理。
|
||
|
||
配套后端：同仓 [`admin-svr/`](../admin-svr)。
|
||
|
||
## 上游与许可
|
||
|
||
本项目基于 **[Vben Admin](https://github.com/vbenjs/vue-vben-admin) 5.5.9**（MIT License）二次开发。
|
||
|
||
- 上游版权与许可声明完整保留在 [`LICENSE`](./LICENSE) 与各源文件的 `@Author` / `@Copyright` 头中
|
||
- iotLCM 相关的业务页面、API 封装与配置为本项目新增
|
||
- 上游仓库：[vbenjs/vue-vben-admin](https://github.com/vbenjs/vue-vben-admin)
|
||
- 上游自带的说明文档保留在 [`vue/README.md`](./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）
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
cd vue
|
||
pnpm install
|
||
pnpm dev:antd
|
||
```
|
||
|
||
开发服务器默认监听 `http://127.0.0.1:5666/`。
|
||
|
||
构建：
|
||
|
||
```bash
|
||
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 数据将无法解密。
|
||
|
||
## 目录结构
|
||
|
||
```text
|
||
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/ # 构建期工具
|
||
```
|
||
|
||
## 容器化构建
|
||
|
||
```bash
|
||
docker build --rm -f vue/build/Dockerfile --platform linux/amd64 -t iotlcm-admin-ui:latest .
|
||
```
|
||
|
||
推送到自己的镜像仓库：
|
||
|
||
```bash
|
||
REGISTRY=<your-registry> make dockerpush
|
||
```
|
||
|
||
## License
|
||
|
||
[MIT](./LICENSE) —— 含 Vben Admin 上游的 MIT 声明。
|