# kadmin-web

**Repository Path**: topextend/kadmin-web

## Basic Information

- **Project Name**: kadmin-web
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-11
- **Last Updated**: 2026-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cloud Platform Web

平台管理后台前端（Vue 3 + Vite + Element Plus），对接 `admin-api`。

## 技术栈

- Vue 3.5 + TypeScript + Vite 8
- Pinia、Vue Router、vue-i18n
- Element Plus（按需加载）

## 开发

```bash
cd apps/platform-web
npm install
npm run dev
```

默认：`http://127.0.0.1:5174`

Vite 将 `/admin`、`/storage` 代理到 `http://127.0.0.1:8787`（需先启动 admin-api：`npm run api`）。

首次使用请访问 **`/install`** 完成安装并创建管理员账号。

## 环境变量

| 文件 | 用途 |
|------|------|
| `.env.local` | 本地覆盖（可选） |
| `.env.production` | **生产构建**，配置分域名 API |

```env
# 开发留空 → 同源 /admin（vite proxy）
VITE_API_URL=

# 生产示例
VITE_API_URL=https://api.example.com/admin
```

## 与后端对接

| 项 | 开发 | 生产（分域名） |
|----|------|----------------|
| API base | `/admin` | `https://api.example.com/admin` |
| 登录 | `POST /admin/auth/login` | `POST https://api.example.com/admin/auth/login` |
| Token | `Authorization: Bearer` | 同左 |

后端 `.env` 需配置 `CORS_ORIGINS` 包含前端 Origin。

## 构建与部署

```bash
npm run build
```

构建自动读取 `.env.production`。将 `dist/` 部署到 **admin.example.com**（纯静态，无需 API 反代）。

详见 [deploy/DEPLOY.md](../../deploy/DEPLOY.md)。

## 管理员账号

由 **`/install` 安装向导**创建，无预置默认密码。