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.
 

142 lines
4.0 KiB

<?php
declare(strict_types=1);
/**
* Common.php
* Created by PhpStorm.
* Date: 2026/10/17
* Time: 09:40
* Author: qian.guo
* E-mail: yiyezhiqiutel@gmail.com
*/
namespace app\controller;
use app\BaseController;
use app\service\ScoreService;
use app\service\WxService;
use think\Request;
/**
* 公共控制器
* 设计说明:
* - 健康检查不查数据库、不查 Redis:这两个依赖还没接(数据库设计与建表已延后)
* 它证明「进程活着 + 框架能出统一响应体」,并回带微信登录模式
* 因为「登录不生效」最常见的原因就是 WX_MOCK 与环境的组合不对
* - 策略清单只在调试环境开放:算法信息属于内部资产
* 暴露出去等于告诉对方「我们有几套算法、分别叫什么」
*/
class Common extends BaseController
{
// 评分服务
private $score_service;
// 微信服务
private $wx_service;
public function __construct(ScoreService $score_service, WxService $wx_service)
{
parent::__construct();
$this->score_service = $score_service;
$this->wx_service = $wx_service;
}
/**
* 健康检查
* health
* @param Request $request 请求对象
* @return \think\response\Json
*/
public function health(Request $request)
{
$data = [];
$data['service'] = 'zhunxin-api';
$data['status'] = 'ok';
$data['timestamp'] = date('Y-m-d H:i:s');
$data['client_ip'] = $request->ip();
$data['wx'] = $this->wx_service->getConfigSummary();
$data['site'] = $this->getSiteSummary();
$data['db'] = $this->getDbSummary();
return json([
'code' => config('code.success'),
'msg' => 'success',
'data' => $data
]);
}
/**
* 站点配置摘要
* getSiteSummary
*
* 只回带「配了没」与地址本身,不含任何密钥。
* 联调时最常见的两个问题靠它一眼判定:
* - 前端请求的域名与后端认知的域名不一致(分享链接会指向错误地址)
* - APP_URL 根本没读进来(.env 写了但键名拼错)
*
* @return array
*/
private function getSiteSummary()
{
$url = (string) config('site.url');
$summary = [];
$summary['url'] = $url;
$summary['configured'] = $url !== '';
$summary['api_prefix'] = (string) config('site.api_prefix');
return $summary;
}
/**
* 数据库配置摘要
* getDbSummary
*
* 只回答一个问题:连库信息配齐了没。
* 不返回主机、库名、账号 —— health 是公开接口,
* 这些信息足够拼出内网拓扑,不该对未登录者开放。
*
* 注意:configured=true 不代表能连上。本接口**刻意不查库** ——
* 健康检查一旦依赖数据库,库挂时会连「进程是否活着」都判断不了。
*
* @return array
*/
private function getDbSummary()
{
$database = (string) config('database.connections.mysql.database');
$summary = [];
$summary['configured'] = $database !== '';
return $summary;
}
/**
* 获取已注册的评分策略清单
* getStrategyList
* @return \think\response\Json
*/
public function getStrategyList()
{
if (!app()->isDebug()) {
return json([
'code' => config('code.fail'),
'msg' => '接口不存在',
'data' => [
'err_code' => config('code.err.not_found')
]
]);
}
$data = [];
$data['default'] = $this->score_service->getDefaultStrategy();
$data['strategies'] = $this->score_service->getStrategyList();
return json([
'code' => config('code.success'),
'msg' => 'success',
'data' => $data
]);
}
}