89 lines
2.9 KiB
Markdown
89 lines
2.9 KiB
Markdown
# mbti王
|
||
|
||
MBTI 性格测试小程序 · 管理后台 · API 服务
|
||
|
||
## GitHub 仓库
|
||
|
||
- **地址**: https://github.com/fnvtk/MBTI_wang
|
||
- **克隆**: `git clone https://github.com/fnvtk/MBTI_wang.git`
|
||
|
||
## 日常同步
|
||
|
||
```bash
|
||
# 拉取最新
|
||
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
|
||
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
|
||
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+）：
|
||
|
||
```bash
|
||
cd api/public
|
||
/usr/local/opt/php@8.4/bin/php -S 127.0.0.1:8787 router.php
|
||
```
|
||
|
||
2. 启动管理后台：
|
||
|
||
```bash
|
||
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**。
|