MBTI_wang/README.md

mbti王

MBTI 性格测试小程序 · 管理后台 · API 服务

GitHub 仓库

• 地址: https://github.com/fnvtk/MBTI_wang
• 克隆: git clone https://github.com/fnvtk/MBTI_wang.git

日常同步

# 拉取最新
git pull origin main

# 提交并推送
git add .
git commit -m "描述"
git push origin main

产品与后台边界

• 见 开发文档/1、需求/管理后台与产品目标对齐.md（概览 / 用户运营 / 订单运营 / 系统设置 与小程序全链路文档对齐说明）

项目结构

• admin/ - Vue 管理后台
• api/ - ThinkPHP API
• miniprogram/ - 微信小程序

本地开发（管理后台 + API）

推荐 A：后台常驻（关终端 / 关 Cursor 仍可用）

在仓库根目录执行（自动释放 8787、5173，起 PHP + Vite，nohup 后台，并做接口自检）：

bash scripts/dev_stop.sh          # 可选：先停旧进程
bash scripts/dev_start_daemon.sh
# 或 admin 目录：npm run dev:daemon

浏览器：http://127.0.0.1:5173/admin/login
日志：api/runtime/php-dev-server.log、api/runtime/vite-dev-server.log
自检：bash scripts/dev_health.sh（或 npm run dev:health）
停止：bash scripts/dev_stop.sh

推荐 B：前台一键（调试用，Ctrl+C 即停）

bash scripts/dev_start.sh
# 或 admin 目录：npm run dev:all

（请保持 admin/.env.development 里 VITE_API_BASE_URL 留空，走 Vite 代理。）

可选环境变量：MBTI_PHP_BIN、MBTI_API_PORT、MBTI_ADMIN_PORT、MBTI_API_CURL_TIMEOUT（守护进程等 API 的 curl 秒数，默认 120）。
前端开发环境 axios 默认 180s 超时（云库慢）；可在 admin/.env.development 设 VITE_REQUEST_TIMEOUT_MS。
Vite 代理默认 180s（VITE_PROXY_TIMEOUT_MS 可改）。

手动分步（与旧流程一致）

1. 启动 API（需 PHP 8+）：

cd api/public
/usr/local/opt/php@8.4/bin/php -S 127.0.0.1:8787 router.php

2. 启动管理后台：

cd admin
npm install
npm run dev

接口经 Vite 转发到 http://127.0.0.1:8787。若 API 端口不是 8787，可执行
VITE_DEV_API_PROXY=http://127.0.0.1:端口 npm run dev。

从 kr 宝塔同步 .env

1. 在宝塔站点目录下载或复制线上 api/.env 到本机（任意路径）。
2. 执行：python3 scripts/apply_bt_download_env.py /你下载的路径/.env
   • 会自动备份当前 api/.env 为 api/.env.bak.<时间戳>。
3. 若宝塔里数据库是 127.0.0.1（指服务器本机），本机需隧道或改连云库：可复制 api/.env.local.merge.example 为 api/.env.local.merge，按注释写好覆盖项，再重新执行第 2 步（会追加合并）。
4. 管理端请保持 admin/.env.development 里 VITE_API_BASE_URL 留空，否则浏览器会直连 mbti.com 等域名，易出现 Network Error。