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.

2.3 KiB

slake-school-web

高校雷达网 PC 管理后台 前端Vue 3、Vite、TypeScript、Element Plus../slake-school-serviceLaravel联调。

环境

  • 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.1localhost(仅方便本机调试,上线仍以正式域名为准)。

白名单一般填主机名即可,例如 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/ 页面