# SBTI 社交爆火评测系统 — 项目说明

---

## 一、项目是做什么的

**SBTI** 是一套「社交向」性格测评：用**荒诞、抽象、意识流**式题目引发共鸣，通过计分与模板匹配生成**人格画像**，并配合文案与视觉（海报/结果页）形成**可分享**的传播素材。整体逻辑参考爆火的 SBTI 玩法：**31 道题 → 多维度计分 → 匹配人格 → 输出标签与展示文案**（规划中强调 AI 风格文案与 Canvas 海报）。

---

## 二、技术栈与目录

| 层级 | 技术 |

|------|------|

| 后端 | FastAdmin（ThinkPHP 5.1）+ MySQL 5.7+ |

| 前端 | Uniapp（Vue2），可发布 **H5** 与**微信小程序** |

| 路径 | 说明 |

|------|------|

| `houduan/` | 后端 API、FastAdmin 管理后台 |

| `qianduan/` | 前端页面与交互（测评流程、结果等） |

**数据库名**：`ai_sbti`（见 README）。

---

## 三、功能概览

### 1. 用户侧（前端）

- **首页**：进入测评入口（`pages/index/index`）。

- **答题**：沉浸式单题流程（`pages/quiz/quiz`），设计目标为单页连续作答、过渡顺滑。

- **结果页**：展示匹配到的人格与文案等（`pages/result/result`）。

- **支付相关**：完成支付页（`pages/pay/pay`），与后端支付开关、微信能力配合使用。

### 2. 业务逻辑（requirements 中的设计）

- **题目形态**：支持普通题（题干+选项）、意识流/盲选题（可无题干或配图）、以及**特殊选项组合**直接指向特定人格（如「酒鬼」类人格）。

- **计分算法（抽象维度）**：题目映射到约 **4～5 个维度**（如清醒度、荒诞感、社交力等）；汇总分数后做区间归档，再按**关键词/标签**从人格库中匹配最接近的画像。

- **数据模型要点**：

  - **题库** `sbti_questions`：题干、类型、插图、`options`（JSON：选项文本、标签、分值等）。

  - **人格库** `sbti_personalities`：名称、四位码、标签、描述文案、背景模板等。

  - **测评记录** `sbti_records`：用户标识、昵称、原始答案轨迹、结果名称、时间等。

### 3. 后端 API（已实现接口示例）

后端 `Sbti` 控制器提供（具体以代码为准）：

| 方法 | 路径 | 用途 |

|------|------|------|

| GET | `/api/sbti/questions` | 拉取题目列表 |

| POST | `/api/sbti/submit` | 提交答案并计分、匹配人格 |

| GET | `/api/sbti/settings` | 获取配置（如支付开关） |

| GET | `/api/sbti/wxoauth` | 发起微信 OAuth |

| GET | `/api/sbti/wxcallback` | OAuth 回调 |

| POST | `/api/sbti/prepay` | 创建微信支付订单 |

| POST | `/api/sbti/paynotify` | 微信支付异步通知 |

计分维度在代码中示例为：`S` 社交力、`A` 荒诞感、`I` 内耗值、`C` 清醒度、`M` 摸鱼力等；提交时需 **恰好 31 条答案**，且题库需为 31 题，否则接口会报错提示。

### 4. 管理后台（FastAdmin）

后台可对 SBTI 相关数据进行维护，例如：**题目**、**人格**、**测评记录**、**订单**、**站点/业务设置**等（对应 `application/admin` 下 `sbti` 模块）。

### 5. 规划中的增强（requirements「重点开发计划」）

- 阶段化推进：后端 API 与 CRUD 后台 → 前端沉浸式刷题 → **结果生成器**（多文案随机组合，增加复测趣味）。

- 视觉：简约或波普/黑白抽象风；**海报用 Canvas 渲染**，支持一键保存。

---

## 四、如何使用（本地）

### 1. 访问地址（README 约定）

在已搭建本地虚拟环境的前提下：

| 环境 | 地址 |

|------|------|

| 前端 H5 | `http://localhost:8080/#/` |

| 后端站点 | `http://ai-sbti.io/`（需本机 hosts / 虚拟主机指向本项目后端） |

### 2. 典型使用流程

1. **准备数据库**：创建库 `ai_sbti`，导入或执行项目提供的建表/初始化脚本（如 `houduan/extend` 下的构建脚本，以实际仓库为准）。

2. **配置后端**：在 FastAdmin / ThinkPHP 配置中填写数据库连接、站点 URL、若启用支付则配置微信与支付参数。

3. **启动前端**：在 `qianduan` 目录安装依赖并运行开发服务（端口以本地为准，README 示例为 8080）。

4. **管理内容**：登录 FastAdmin 后台，维护 31 道题目与人格库，保证与接口校验一致。

5. **用户路径**：浏览器或小程序打开前端 → 首页进入测评 → 逐题作答 → 查看结果；若开启付费，按流程完成支付页。

### 3. 开发协作说明（README 规范）

- 允许使用自动化工具执行数据库迁移与代码生成等终端操作。

- UI 倾向强风格化；结果卡片需便于保存与分享。

---