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.
|
|
|
|
|
# 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/` | 页面 |
|
