原来题库放在 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 校验路径同步
规范《代码规范.md》第 27 行要求控制器位于 app/api/controller/Xxx.php。 上一轮为修复 404 曾挪到 app/controller/,属于违规且与规范冲突。 改动: - app/controller/* -> app/api/controller/*,命名空间改为 app\api\controller - 路由 app/api/route/api.php:规则去掉 api 前缀(多应用中间件会剥掉应用名), 只写 v1/xxx,URL 仍是 /api/v1/xxx - 根 route/ 清空:多应用下与应用内路由同时定义会让命中顺序不可预期 - 新增 app/index/ 默认应用:访问域名根路径返回服务状态与可用接口,便于排错 - composer.json 显式声明 topthink/think-multi-app(否则下次 composer install 会卸掉) 注意:部署后需 composer update topthink/think-multi-app 以刷新 composer.lock。
以官方 ThinkPHP 8 骨架为底,接入业务代码: - 评分引擎:4 策略(dimension_sum / weighted_sum / average_pct / centroid_distance)+ 工厂 + 编排器 - 接口:health / auth(2) / user(3) / quiz(2) / system(1),共 9 条 - 统一响应体 code/msg/data + 24 个细分错误码 - 中间件:Trace / LoginCheck / RateLimitCheck - 数据源为 JSON mock,不依赖数据库 - 单测 29 用例(待 composer require phpunit 后可跑)