Browse Source

fix: mock 数据移入后端 data/,修复部署时找不到题库

原来题库放在 zhunxin-api 的上一级(项目的 mock/),是个错误设计:
- 部署通常只上传 zhunxin-api 一个目录,上一级不存在 → 线上找不到文件
- 后端依赖自己目录之外的文件属于隐式耦合,换机器就坏,而报错只显示「题库数据文件缺失」,根因不明显

改动:
- mock/quiz-mock.json -> zhunxin-api/data/quiz-mock.json(与代码一起部署)
- config/quiz.php 默认路径改为 root_path().'data/quiz-mock.json'
- 前端 scripts/sync-mock.mjs 从后端 data/ 读取(前端那份是构建期脱敏副本)
- tools/verify-mock.mjs 校验路径同步
main
qian.guo 1 month ago
parent
commit
6e315d1938
2 changed files with 2243 additions and 5 deletions
  1. +18
    -5
      config/quiz.php
  2. +2225
    -0
      data/quiz-mock.json

+ 18
- 5
config/quiz.php View File

@ -4,17 +4,30 @@ declare(strict_types=1);
/* /*
* 单一 mock 数据文件路径。 * 单一 mock 数据文件路径。
* *
* 当前阶段全部走 mock,所以整个题库(轴 / 极点 / 题目 / 类型 / 功能)
* 当前阶段全部走 mock,所以整个题库(轴 / 极点 / 题目 / 类型 / 认知功能)
* 只在这一个文件里。替换真实数据 = 替换这一个文件。 * 只在这一个文件里。替换真实数据 = 替换这一个文件。
* *
* 用 dirname(root_path()) 而不是写死相对路径:mock/ 放在项目根(TP 应用的上一级),
* 这样前端工程也能指向同一份文件,避免两份 mock 各自漂移。
* 部署时若 mock 不随代码走,改 .env 的 QUIZ_MOCK_PATH 即可。
* 路径策略(改过一次,记录原因):
* 最初把文件放在「应用的上一级」(项目的 ../mock/),理由是前端工程也想读同一份。
* 那个设计是错的:
* - 部署时通常只上传 zhunxin-api 这一个目录,上一级不一定存在,
* 结果是线上找不到文件、接口返回空
* - 让后端依赖自己目录之外的文件,属于隐式耦合,
* 换台机器就坏,而且报错只显示「题库数据文件缺失」,根因不明显
*
* 现在文件放在 **应用内部**:zhunxin-api/data/quiz-mock.json,
* 与代码一起走,上传目录即完整。
*
* 前端那份是构建期由 scripts/sync-mock.mjs 从后端文件生成的**脱敏副本**
* (剔除答案权重),属于构建产物,不参与运行时读取 —— 所以后端不再需要
* 为了「前后端共用一份」而把文件放到外面。
*
* 仍可用 .env 的 QUIZ_MOCK_PATH 覆盖(绝对路径),用于特殊部署。
*/ */
return [ return [
'mock_path' => env( 'mock_path' => env(
'quiz.mock_path', 'quiz.mock_path',
dirname(rtrim(root_path(), "/\\")) . DIRECTORY_SEPARATOR . 'mock' . DIRECTORY_SEPARATOR . 'quiz-mock.json'
root_path() . 'data' . DIRECTORY_SEPARATOR . 'quiz-mock.json'
), ),
// 单次答题会话作答上限(防脚本刷题)。与题目数量解耦:题目数由数据决定, // 单次答题会话作答上限(防脚本刷题)。与题目数量解耦:题目数由数据决定,


+ 2225
- 0
data/quiz-mock.json
File diff suppressed because it is too large
View File


Loading…
Cancel
Save