# slake-school-web

高校雷达网 **PC 管理后台** 前端：Vue 3、Vite、TypeScript、Element Plus，与 `../slake-school-service`（Laravel）联调。

## 环境

- Node.js **18+**（建议 LTS）
- npm 或 pnpm

## 安装与启动

```bash
cd slake-school-web
npm install
npm run dev
```

浏览器打开终端提示的地址（默认 `http://127.0.0.1:5173`）。

## 本地接口联调

1. 先启动后端（默认 `http://127.0.0.1:8000`）：

   ```bash
   cd ../slake-school-service
   php artisan serve
   ```

2. 本仓库已配置 **Vite 代理**：开发环境下请求 `VITE_API_BASE_URL`（默认 `/api`）会转发到 `VITE_PROXY_TARGET`（默认 `http://127.0.0.1:8000`），与 Laravel 的 `/api` 路由前缀一致。

3. 业务请求请使用 `src/utils/http.ts` 导出的 `http` 实例，不要写死后端全路径。

4. 若后端端口或域名不同，可复制 `.env.example` 为 `.env.development.local` 覆盖变量（已忽略提交）。

## 天地图（高校雷达网地图）

Key 通过环境变量 `VITE_TIANDITU_TK` 配置（见 `.env.development`）。

天地图控制台会为 Key 配置**域名白名单**，须与浏览器地址栏里的站点一致。当前约定为：

| 环境 | 访问地址示例 |
| --- | --- |
| 线上 | `https://slake.ali251.langye.net`（或你实际部署的前端域名） |
| 本地联调 | 见下表 |

在 `127.0.0.1:5173` 下打开页面时，Referer 不是白名单域名，地图瓦片/SDK 可能被天地图拒绝。

**本地要与线上一致**，任选其一：

1. **推荐**：在本机 `hosts` 增加一行后，用白名单域名访问 Vite：
   ```text
   127.0.0.1 slake.ali251.langye.net
   ```
   然后打开 `http://slake.ali251.langye.net:5173`（不要用 `127.0.0.1`）。

2. 在天地图控制台白名单中**额外增加** `127.0.0.1`、`localhost`（仅方便本机调试，上线仍以正式域名为准）。

白名单一般填**主机名**即可，例如 `slake.ali251.langye.net`，无需带 `https://` 或端口。

## 构建

```bash
npm run build
```

产物在 `dist/`，`VITE_API_BASE_URL` 以 `.env.production` / 构建时环境为准。

## 目录说明（简要）

| 路径 | 说明 |
| --- | --- |
| `src/router/` | 路由 |
| `src/utils/http.ts` | Axios 封装，baseURL 来自 `VITE_API_BASE_URL` |
| `src/views/` | 页面 |