You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 

157 lines
4.7 KiB

<?php
declare(strict_types=1);
/**
* ScoreService.php
* Created by PhpStorm.
* Date: 2026/10/17
* Time: 09:40
* Author: qian.guo
* E-mail: yiyezhiqiutel@gmail.com
*/
namespace app\service;
use app\model\QuizModel;
use app\service\score\ScoreContext;
use app\service\score\ScoreEngine;
use app\service\score\ScoreResult;
/**
* 评分引擎对外门面
* 设计说明:
* - 控制器只跟本类打交道,不应该知道策略、工厂、DTO 的存在
* - 只暴露四个动作:算分、多策略对比、结果落库字段、策略清单
* - 题库数据经 QuizModel 读取后装配成 ScoreContext,策略内部不取数
* 这样同一批答案可以用不同策略重算,也是做算法对比的前提
*/
class ScoreService
{
// 评分编排器
private $score_engine;
public function __construct(ScoreEngine $score_engine)
{
$this->score_engine = $score_engine;
}
/**
* 执行评分
* score
* @param array $answer_list 作答,键为题号,值为选项 key
* @param string $alias 策略标识,为空取默认策略
* @return ScoreResult
*/
public function score($answer_list, $alias = '')
{
$context = $this->createContext($answer_list);
return $this->score_engine->score($context, $alias);
}
/**
* 同批答案多策略对比
* compare
* @param array $answer_list 作答
* @param array $alias_list 策略标识列表
* @param bool $with_debug 是否附带中间量
* @return array 键为策略标识
*/
public function compare($answer_list, $alias_list, $with_debug = false)
{
$context = $this->createContext($answer_list);
return $this->score_engine->compare($context, $alias_list, $with_debug);
}
/**
* 获取结果落库字段
* getPersistData
* @param ScoreResult $result 评分结果
* @return array
*
* 集中在这里转换,避免各处自行拼装导致有的地方记了策略名有的地方忘记录
* 那会让历史数据无法按算法口径分组
*/
public function getPersistData(ScoreResult $result)
{
$data = [];
$data['type_code'] = $result->type_code;
$data['type_name'] = $result->type_name;
$data['dimension_scores'] = json_encode($result->dimension_scores, JSON_UNESCAPED_UNICODE);
$data['radar_json'] = json_encode($result->radar, JSON_UNESCAPED_UNICODE);
$data['axes_json'] = json_encode($result->axes, JSON_UNESCAPED_UNICODE);
$data['confidence'] = $result->confidence;
$data['match_score'] = $result->match_score;
$data['score_strategy'] = $result->strategy;
$data['score_version'] = $result->strategy_version;
return $data;
}
/**
* 获取已注册的策略清单
* getStrategyList
* @return array
*/
public function getStrategyList()
{
return $this->score_engine->getStrategyList();
}
/**
* 获取当前生效的策略标识
* getDefaultStrategy
* @return string
*
* 给运维接口与落库默认值用,不要为拿一个字符串去跑一次评分(空答案会直接抛缺题异常)
*/
public function getDefaultStrategy()
{
return $this->score_engine->getDefaultAlias();
}
/**
* 装配评分输入
* createContext
* @param array $answer_list 作答
* @return ScoreContext
*/
private function createContext($answer_list)
{
$paper = QuizModel::getPaperInfo();
$answer_map = [];
foreach ($answer_list as $q_no => $answer_key) {
$answer_map[intval($q_no)] = strtoupper(trim((string) $answer_key));
}
$paper_code = '';
if (!empty($paper['code'])) {
$paper_code = (string) $paper['code'];
}
$radar = [];
if (!empty($paper['radar'])) {
$radar = (array) $paper['radar'];
}
$formula = 'product';
if (!empty($paper['function_formula'])) {
$formula = (string) $paper['function_formula'];
}
$param = [];
$param['paper_code'] = $paper_code;
$param['axis_list'] = QuizModel::getAxisList();
$param['pole_list'] = QuizModel::getPoleList();
$param['radar'] = $radar;
$param['function_list'] = QuizModel::getFunctionList();
$param['function_formula'] = $formula;
$param['question_list'] = QuizModel::getQuestionMap();
$param['answer_list'] = $answer_map;
$param['type_list'] = QuizModel::getTypeList();
return new ScoreContext($param);
}
}