通过 Scalar 防腐层浏览题库目录 #4

New Issue

wangziqi · 2026-07-27T07:48:09Z

wangziqi commented

2026-07-27 07:48:09 +00:00

Parent

#1

What to build

已登录学生能够从学习首页进入题库，浏览由 RuoYi 统一返回的科目、地区、分类和题库目录。内容可以暂时来自 Scalar，但学生浏览器只请求 RuoYi。

Acceptance criteria

建立内部 Catalog 契约，Scalar DTO 不进入业务层或前端。
Scalar 地址、凭据、超时和数据源开关均由服务端配置。
Scalar item/items/meta 被转换为项目标准响应和分页结构。
租户上下文由服务端安全上下文生成，调用方不能覆盖身份头。
正常、空数据、400、401、403、404、409、429、超时和 5xx 均有明确行为。
上游错误不会被转换为空列表或成功响应。
学生端具备学习首页入口、目录筛选、加载、空状态和错误状态。
浏览器 Network 中不存在直接 Scalar 请求。
日志记录脱敏后的上游 request ID、耗时、tenant 和结果。

Blocked by

#3 — 打通租户识别与学生登录

## Parent https://git.gongxue100.com/wangziqi/ruoyi-vue-pro/issues/1 ## What to build 已登录学生能够从学习首页进入题库，浏览由 RuoYi 统一返回的科目、地区、分类和题库目录。内容可以暂时来自 Scalar，但学生浏览器只请求 RuoYi。 ## Acceptance criteria - [ ] 建立内部 Catalog 契约，Scalar DTO 不进入业务层或前端。 - [ ] Scalar 地址、凭据、超时和数据源开关均由服务端配置。 - [ ] Scalar item/items/meta 被转换为项目标准响应和分页结构。 - [ ] 租户上下文由服务端安全上下文生成，调用方不能覆盖身份头。 - [ ] 正常、空数据、400、401、403、404、409、429、超时和 5xx 均有明确行为。 - [ ] 上游错误不会被转换为空列表或成功响应。 - [ ] 学生端具备学习首页入口、目录筛选、加载、空状态和错误状态。 - [ ] 浏览器 Network 中不存在直接 Scalar 请求。 - [ ] 日志记录脱敏后的上游 request ID、耗时、tenant 和结果。 ## Blocked by - #3 — 打通租户识别与学生登录

wangziqi added the

ready-for-agent

label 2026-07-27 07:48:09 +00:00

wangziqi referenced this issue

2026-07-27 07:50:45 +00:00

浏览题目并配置一次练习 #5

wangziqi referenced this issue

2026-07-27 07:50:50 +00:00

完成学生核心闭环验收与 Pilot 灰度 #11

wangziqi commented

2026-07-28 07:00:47 +00:00

Issue #4：Scalar 目录防腐层

已完成

建立内部 Catalog contract，Scalar DTO 不进入业务层和前端。
服务端配置 Scalar URL、token、超时和数据源开关。
转换单项/分页响应、元数据及上游错误。
注入服务端租户上下文，不接受前端身份覆盖。
覆盖正常、空数据、4xx、429、超时、5xx 和敏感字段契约测试。

验证

Education 模块测试：通过。
Harness contract / adapter tests：通过。

范围说明

真实 Scalar endpoint smoke 仍需部署环境和有效只读凭据，详见 issue #1 汇总。

代码：ce02f8a。

## Issue #4：Scalar 目录防腐层 ### 已完成 - 建立内部 Catalog contract，Scalar DTO 不进入业务层和前端。 - 服务端配置 Scalar URL、token、超时和数据源开关。 - 转换单项/分页响应、元数据及上游错误。 - 注入服务端租户上下文，不接受前端身份覆盖。 - 覆盖正常、空数据、4xx、429、超时、5xx 和敏感字段契约测试。 ### 验证 - Education 模块测试：通过。 - Harness contract / adapter tests：通过。 ### 范围说明真实 Scalar endpoint smoke 仍需部署环境和有效只读凭据，详见 issue #1 汇总。代码：`ce02f8a`。

wangziqi closed this issue

2026-07-28 07:03:51 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangziqi/ruoyi-vue-pro#4