|
|
# SZKP 地图服务 - 后端（Laravel + MySQL）
|
|
|
|
|
|
## 本地环境
|
|
|
|
|
|
- PHP：8.1（当前工程初始化为 Laravel 10）
|
|
|
- MySQL：8.x
|
|
|
|
|
|
## 数据库配置（本地）
|
|
|
|
|
|
已按你的要求写入 `.env`：
|
|
|
|
|
|
- **DB_DATABASE**: `szkp_map_local`
|
|
|
- **DB_USERNAME**: `root`
|
|
|
- **DB_PASSWORD**: `root123456`
|
|
|
|
|
|
## 初始化与启动
|
|
|
|
|
|
```bash
|
|
|
composer install
|
|
|
|
|
|
# 首次需要创建数据库（已创建可跳过）
|
|
|
mysql -uroot -proot123456 -e "CREATE DATABASE IF NOT EXISTS szkp_map_local DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
|
|
|
|
|
|
php artisan migrate
|
|
|
|
|
|
php artisan serve --host=127.0.0.1 --port=8000
|
|
|
```
|
|
|
|
|
|
启动后访问 `http://127.0.0.1:8000/`。
|
|
|
|
|
|
## 本地与测试环境切换
|
|
|
|
|
|
项目已提供两套后端环境文件：
|
|
|
|
|
|
- 本地：`.env`
|
|
|
- 测试：`.env.testing`（域名 `szkp-map.ali251.langye.net`）
|
|
|
|
|
|
本地启动（默认读取 `.env`）：
|
|
|
|
|
|
```bash
|
|
|
php artisan config:clear
|
|
|
php artisan serve --host=127.0.0.1 --port=8000
|
|
|
```
|
|
|
|
|
|
测试配置启动（读取 `.env.testing`）：
|
|
|
|
|
|
```bash
|
|
|
php artisan config:clear
|
|
|
php artisan serve --env=testing --host=0.0.0.0 --port=8000
|
|
|
```
|
|
|
|
|
|
如果测试库用户名不是 `szkp_map_ali251_`，请修改 `.env.testing` 中 `DB_USERNAME`。
|
|
|
|
|
|
### 前端测试模式
|
|
|
|
|
|
- 后台管理（`szkp-map-web`）：
|
|
|
- 本地：`npm run dev`
|
|
|
- 测试：`npm run dev:testing`
|
|
|
- H5（`szkp-map-h5`）：
|
|
|
- 本地：`npm run dev:h5`
|
|
|
- 测试：`npm run dev:h5:testing`
|
|
|
|
|
|
跨域已改为白名单配置，默认放行：
|
|
|
|
|
|
- `http://localhost:5173`
|
|
|
- `http://127.0.0.1:5173`
|
|
|
- `http://localhost:5174`
|
|
|
- `http://127.0.0.1:5174`
|
|
|
- `https://szkp-map.ali251.langye.net`
|
|
|
|
|
|
## 默认测试账号（`php artisan db:seed` 后）
|
|
|
|
|
|
- 超级管理员：`admin` / `admin123456`
|
|
|
- 场馆管理员：`venue_admin_01` / `admin123456`
|
|
|
|
|
|
场馆管理员已绑定一个默认场馆，用于测试“仅可编辑自己场馆、仅可核销自己场馆预约二维码”。
|
|
|
|
|
|
## 已提供接口（管理员与场馆权限）
|
|
|
|
|
|
- `POST /api/auth/login`
|
|
|
- `POST /api/auth/logout`
|
|
|
- `GET /api/me`
|
|
|
- `GET/POST/PUT /api/venues`（场馆管理员仅能查看/编辑自己绑定场馆）
|
|
|
- `GET/POST/PUT /api/admin-users`（仅超级管理员）
|
|
|
- `POST /api/reservations/verify`（按二维码核销，且限制到当前账号绑定场馆）
|
|
|
|
