You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
# 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/` | 页面 |