文件
huaqiapp/server/application/common/service/AssessmentService.php
linda 3baa52e95a feat(consult): 咨询改为在线预约表单 + 新增 SDS/SAS/16PF 付费心理测评
一、心理咨询(M9)
- 前端不再选咨询师时段,改为「分类 + 表单」:11 类(婚恋/青少年/职场人际/情绪疏导/
  人生卡点/成长迷茫/脱单指导/分手挽回/社恐咨询/抑郁焦虑/情绪压力)
- 表单字段:称呼、手机号(11 位校验)、方便联系时间、困扰描述(≥5 字),提交后由咨询助理联系
- 支持查看/取消我的预约;同一用户 10 分钟内防重复提交
- 新增表 fa_consult_booking(含跟进状态与备注),后台可跟进

二、心理测评(付费)
- 新增三个付费量表:抑郁自评 SDS(20 题,1-4 级 + 10 道反向题,标准分=粗分×1.25 取整)、
  焦虑自评 SAS(20 题,5 道反向题)、卡特尔 16PF 简版(48 题 / 16 维度,三选项)
- 华东:测评需付费,未付费拦截并返回 need_pay;新增 fa_assessment_order 订单表与下单接口
- 计分:标准分分级(正常/轻度/中度/重度)+ 16PF 维度剖面(1-10 分、高/中/低解读)
- 风险识别:SDS 自伤条目高分或重度 → risk_flag + 危机热线
- 结果页新增 16PF 16 维条形剖面与「预约咨询师解读」入口

三、管理端
- 新增后台模块:心理预约(分类/状态/备注跟进)、测评订单(支付状态可改)
- ManageConfig 增加对应字段配置;菜单脚本 db/06_consult_assessment.sql(可重复执行)
- fa_assessment 增加 price 字段;测评列表/详情接口返回价格与购买状态

四、验证(全绿)
- 咨询+测评专项:54 项断言(分类、表单校验、防重复、脱敏、取消、题库、付费拦截、
  下单、付费后 SDS=62/轻度、SAS=56/轻度、16PF 16 维满分、危机干预)
- 前台接口 78 项、后台自检 33 项(28 模块)、契约 0 偏差、Vue 20/20、SCSS 19/19、无 emoji
2026-11-06 16:00:52 +08:00

393 行
14 KiB
PHP

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

<?php
namespace app\common\service;
use think\Db;
/**
* 量表测评服务(M7 关系测评 / M9 心理测评 共用)
*
* 支持两类题库:
* 1) 新格式(对象):{scale, options[], items[], dims{}, note}
* - SDS / SAS:标准分 = 粗分 × 1.25,支持反向计分
* - 16PF:按维度计分,输出 16 项人格剖面
* 2) 旧格式(题目字符串数组):0-4 五级计分(历史量表,保持兼容)
*/
class AssessmentService
{
/** 危机干预提示(合规文案) */
public static function crisis()
{
return [
'title' => '请优先照顾当下的安全',
'text' => '如果出现伤害自己或他人的念头,请立即联系身边的人陪伴,并拨打心理援助热线:12356(心理援助)或 120(急救)。',
'hotlines' => [
['name' => '全国心理援助热线', 'phone' => '12356'],
['name' => '北京心理危机研究与干预中心', 'phone' => '010-82951332'],
],
'action' => '如需专业帮助,可提交在线预约',
];
}
/**
* 量表列表(含价格与是否已购买)
*/
public static function lists($scope = '', $userId = 0)
{
$query = Db::name('assessment')->where('status', 'normal');
if ($scope) {
$query->where('scope', $scope);
}
$list = $query->order('weigh', 'desc')->select();
$member = $userId ? MemberService::status($userId) : ['is_member' => false];
$result = [];
foreach ($list as $item) {
$parsed = self::parseQuestions($item['questions']);
$price = (float)($item['price'] ?? 0);
$needPay = $item['access'] === 'pay' && $price > 0;
$paid = !$needPay || ($userId && self::isPaid($userId, (int)$item['id']));
$last = $userId ? Db::name('assessment_record')
->where('user_id', $userId)
->where('assessment_id', $item['id'])
->order('id', 'desc')
->find() : null;
$result[] = [
'id' => (int)$item['id'],
'code' => $item['code'],
'title' => $item['title'],
'intro' => $item['intro'],
'scope' => $item['scope'],
'level' => $item['level'],
'access' => $item['access'],
'price' => $price,
'need_pay' => $needPay,
'paid' => $paid,
'locked' => !$paid,
'questions' => count($parsed['items']),
'scale' => $parsed['scale'],
'note' => $parsed['note'],
'last_score' => $last ? (float)$last['score'] : null,
'last_result' => $last ? $last['result'] : '',
'last_date' => $last ? date('Y-m-d', (int)$last['createtime']) : '',
];
}
return $result;
}
/**
* 量表详情(题目与选项)
*/
public static function detail($id, $userId = 0)
{
$item = Db::name('assessment')->where('id', (int)$id)->where('status', 'normal')->find();
if (!$item) {
return null;
}
$parsed = self::parseQuestions($item['questions']);
$price = (float)($item['price'] ?? 0);
$needPay = $item['access'] === 'pay' && $price > 0;
return [
'id' => (int)$item['id'],
'code' => $item['code'],
'title' => $item['title'],
'intro' => $item['intro'],
'scope' => $item['scope'],
'scale' => $parsed['scale'],
'note' => $parsed['note'],
'questions' => count($parsed['items']),
'items' => $parsed['items'],
'options' => $parsed['options'],
'dims' => $parsed['dims'],
'price' => $price,
'need_pay' => $needPay,
'paid' => !$needPay || ($userId && self::isPaid($userId, (int)$item['id'])),
];
}
/**
* 提交作答(answers 为选项下标)
*/
public static function submit($userId, $assessmentId, $answers)
{
$item = Db::name('assessment')->where('id', (int)$assessmentId)->where('status', 'normal')->find();
if (!$item) {
return ['error' => '量表不存在'];
}
$parsed = self::parseQuestions($item['questions']);
$answers = is_array($answers) ? array_values($answers) : [];
if (count($answers) !== count($parsed['items'])) {
return ['error' => '请完成全部题目'];
}
$options = $parsed['options'];
$optionCount = count($options);
// 下标 → 选项值
$values = [];
foreach ($answers as $index) {
$idx = (int)$index;
$idx = max(0, min($optionCount - 1, $idx));
$values[] = (int)$options[$idx]['value'];
}
$scoring = json_decode($item['scoring'], true) ?: [];
$type = $scoring['type'] ?? 'legacy';
if ($type === 'standard_score') {
$result = self::scoreStandard($parsed, $scoring, $values);
} elseif ($type === 'profile') {
$result = self::scoreProfile($parsed, $scoring, $values);
} else {
$result = self::scoreLegacy($parsed, $scoring, $values);
}
$risk = $result['risk_flag'];
$advice = $result['advice'];
if ($risk) {
array_unshift($advice, '检测到需要关注的风险信号,建议尽快寻求专业支持。');
}
$id = Db::name('assessment_record')->insertGetId([
'user_id' => $userId,
'assessment_id' => (int)$item['id'],
'answers' => json_encode($values),
'score' => $result['score'],
'result' => $result['result'],
'report' => $result['result_text'],
'risk_flag' => $risk,
'createtime' => time(),
]);
return [
'id' => (int)$id,
'title' => $item['title'],
'scale' => $parsed['scale'],
'score' => $result['score'],
'max' => $result['max'],
'result' => $result['result'],
'result_text' => $result['result_text'],
'advice' => $advice,
'dims' => $result['dims'],
'risk_flag' => $risk,
'crisis' => $risk ? self::crisis() : null,
'disclaimer' => '测评结果仅供参考,不能替代专业诊断。',
];
}
/* ============================================================
* 题库解析
* ============================================================ */
public static function parseQuestions($questionsJson)
{
$data = json_decode($questionsJson, true);
if (!is_array($data)) {
return ['scale' => '', 'note' => '', 'items' => [], 'options' => self::options(), 'dims' => [], 'legacy' => false];
}
// 旧格式:["题目1","题目2",...]
if (array_keys($data) === range(0, count($data) - 1)) {
$items = [];
foreach ($data as $text) {
$items[] = ['q' => $text, 'dim' => '', 'rev' => 0];
}
return ['scale' => 'BASIC', 'note' => '', 'items' => $items, 'options' => self::options(), 'dims' => [], 'legacy' => true];
}
// 新格式
$items = [];
foreach (($data['items'] ?? []) as $row) {
$items[] = [
'q' => $row['q'] ?? '',
'dim' => $row['dim'] ?? '',
'rev' => (int)($row['rev'] ?? 0),
];
}
$options = $data['options'] ?? self::options();
$options = array_map(function ($opt) {
return ['text' => $opt['text'], 'value' => (int)$opt['value']];
}, $options);
return [
'scale' => $data['scale'] ?? 'BASIC',
'note' => $data['note'] ?? '',
'items' => $items,
'options' => $options,
'dims' => $data['dims'] ?? [],
'legacy' => false,
];
}
public static function options()
{
return [
['text' => '没有', 'value' => 0],
['text' => '偶尔', 'value' => 1],
['text' => '有时', 'value' => 2],
['text' => '经常', 'value' => 3],
['text' => '总是', 'value' => 4],
];
}
/** 是否已购买该测评 */
public static function isPaid($userId, $assessmentId)
{
return Db::name('assessment_order')
->where('user_id', $userId)
->where('assessment_id', $assessmentId)
->where('pay_status', 'paid')
->count() > 0;
}
/* ============================================================
* 计分实现
* ============================================================ */
/** 标准分类型(SDS / SAS) */
protected static function scoreStandard($parsed, $scoring, $values)
{
$min = (int)($scoring['raw_range'][0] ?? 1);
$max = (int)($scoring['raw_range'][1] ?? 4);
$raw = 0;
// 反向题位置(SDS 第 19 题为自伤念头,单独取原始值做风险判断)
$selfHarmIndex = 18;
foreach ($parsed['items'] as $i => $item) {
$v = $values[$i];
$raw += $item['rev'] ? ($min + $max - $v) : $v;
}
// 常规口径:标准分 = 粗分 × 1.25,取整数部分
$standard = (int)floor($raw * (float)($scoring['factor'] ?? 1.25));
$resultKey = 'normal';
$resultText = '';
$levels = $scoring['levels'] ?? [];
foreach ($levels as $level) {
if ($standard < (int)$level['lt']) {
$resultKey = $level['key'];
$resultText = $level['text'];
break;
}
}
if (!$resultText && $levels) {
$last = end($levels);
$resultKey = $last['key'];
$resultText = $last['text'];
}
$risk = 0;
if (isset($values[$selfHarmIndex]) && $values[$selfHarmIndex] >= 3 && $parsed['scale'] === 'SDS') {
$risk = 1;
}
if (in_array($resultKey, ['severe'], true)) {
$risk = 1;
}
$advice = [$resultText, '本标准分为粗分 × 1.25,分数越高代表困扰越明显。'];
if ($parsed['scale'] === 'SDS') {
$advice[] = '建议连续记录两周情绪,并保持规律作息与日照。';
} else {
$advice[] = '可以尝试 4-7-8 呼吸与规律运动,减少咖啡因摄入。';
}
return [
'score' => $standard,
'max' => (int)floor(count($parsed['items']) * $max * (float)($scoring['factor'] ?? 1.25)),
'result' => $resultKey,
'result_text' => $resultText,
'advice' => $advice,
'dims' => [],
'risk_flag' => $risk,
];
}
/** 人格剖面类型(16PF) */
protected static function scoreProfile($parsed, $scoring, $values)
{
$maxRaw = (int)($scoring['max_raw'] ?? 6);
$raw = [];
foreach ($parsed['items'] as $i => $item) {
$dim = $item['dim'] ?: 'X';
if (!isset($raw[$dim])) {
$raw[$dim] = 0;
}
$raw[$dim] += $values[$i];
}
$dims = [];
$highest = null;
foreach (($parsed['dims'] ?: []) as $key => $meta) {
$r = $raw[$key] ?? 0;
$std = (int)round($r / max(1, $maxRaw) * 9) + 1;
$std = max(1, min(10, $std));
$level = $std >= 7 ? 'high' : ($std <= 4 ? 'low' : 'mid');
$dims[] = [
'key' => $key,
'name' => $meta['name'],
'raw' => $r,
'score' => $std,
'level' => $level,
'text' => $level === 'high' ? $meta['high'] : ($level === 'low' ? $meta['low'] : '表现居中,视情境灵活调整'),
];
if ($highest === null || $std > $highest['score']) {
$highest = ['key' => $key, 'name' => $meta['name'], 'score' => $std];
}
}
$top = array_slice(array_values(array_filter($dims, function ($d) {
return $d['level'] === 'high';
})), 0, 3);
$topNames = $top ? implode('、', array_column($top, 'name')) : ($highest ? $highest['name'] : '');
return [
'score' => $highest ? $highest['score'] : 0,
'max' => 10,
'result' => $highest ? $highest['key'] : '',
'result_text' => '最突出的特质:' . ($topNames ?: '暂无') . '。16PF 描述的是倾向而非优劣,请结合具体情境理解。',
'advice' => [
'高分维度代表你更常表现的行为倾向,低分维度代表相反倾向。',
'同一维度在不同情境下可能不同,建议结合近半年的真实经历回看。',
'如需深入解读,可提交心理咨询预约,由咨询师一对一分析。',
],
'dims' => $dims,
'risk_flag' => 0,
];
}
/** 旧格式(0-4 五级) */
protected static function scoreLegacy($parsed, $scoring, $values)
{
$score = array_sum($values);
$levels = $scoring['levels'] ?? [];
$max = (int)($scoring['max'] ?? count($parsed['items']) * 4);
$resultKey = 'low';
$resultText = '';
foreach ($levels as $level) {
if ($score < (int)$level['lt']) {
$resultKey = $level['key'];
$resultText = $level['text'];
break;
}
}
if (!$resultText && $levels) {
$last = end($levels);
$resultKey = $last['key'];
$resultText = $last['text'];
}
return [
'score' => $score,
'max' => $max,
'result' => $resultKey,
'result_text' => $resultText,
'advice' => ['测评结果不是诊断,仅用于自我觉察。', $resultText],
'dims' => [],
'risk_flag' => $score >= $max ? 1 : 0,
];
}
}