SZKP 地图服务 - 后端（Laravel + MySQL）

本地环境

• PHP：8.1（当前工程初始化为 Laravel 10）
• MySQL：8.x

数据库配置（本地）

已按你的要求写入 .env：

• DB_DATABASE: szkp_map_local
• DB_USERNAME: root
• DB_PASSWORD: root123456

初始化与启动

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）：

php artisan config:clear
php artisan serve --host=127.0.0.1 --port=8000

测试配置启动（读取 .env.testing）：

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（按二维码核销，且限制到当前账号绑定场馆）