slake-school-web

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

环境

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

安装与启动

cd slake-school-web
npm install
npm run dev

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

本地接口联调

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

   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：

   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:// 或端口。

构建

npm run build

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

目录说明（简要）

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