From ea3b3e6d8fffc658b2b92ad4abcdc0429716dcaa Mon Sep 17 00:00:00 2001 From: gzkoala Date: Wed, 11 Mar 2026 10:59:47 +0800 Subject: [PATCH] =?UTF-8?q?docs(update):=E6=9B=B4=E6=96=B0Arabica=20Sprint?= =?UTF-8?q?3=E4=BB=A3=E7=A0=81=E5=8D=95=E5=85=83=E6=B5=8B=E8=AF=95?= =?UTF-8?q?=E6=A0=B7=E4=BE=8B=E8=AF=B4=E6=98=8E=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: gzkoala --- ...a-sprint3- code-unit-test-specification.md | 19 +++---------------- 1 file changed, 3 insertions(+), 16 deletions(-) diff --git a/projects/arabica/docs/test/arabica-sprint3- code-unit-test-specification.md b/projects/arabica/docs/test/arabica-sprint3- code-unit-test-specification.md index 0ddcfa1..44ebbfb 100644 --- a/projects/arabica/docs/test/arabica-sprint3- code-unit-test-specification.md +++ b/projects/arabica/docs/test/arabica-sprint3- code-unit-test-specification.md @@ -18,20 +18,7 @@ status: Active --> # Arabica Sprint 3 代码单元测试样例 -## 1. 概述 - -根据 **Arabica Sprint 3** 的架构设计，本阶段的核心目标是实现外部学术 API 的集成（文献查询）以及双轨制数据的标准化落盘。为保证该链路的高可用性与健壮性，本文档基于《Project Caffeine 项目代码测试规范指南》，为 Sprint 3 的核心组件（Service 层与 Controller 层）提供标准的 Jest 测试用例编写范例。 - -**Sprint 3 测试重点模块**： - -1. `src/services/literatureService.ts`：外部 API 网络请求（必须 Mock 网络）。 -2. `src/services/adapter/metadataMapper.ts`：原始 JSON 映射为标准字典（纯逻辑验证）。 -3. `src/services/vaultService.ts`：Markdown 与 YAML 写入（必须 Mock 磁盘 I/O）。 -4. `src/controllers/literatureController.ts`：工具调用的 Zod 参数校验与路由分发。 - ---- - -## 2. 测试架构概览 +## 1. 测试架构概览 在 Sprint 3 中，系统彻底从“提示词（Prompt）驱动”转向了“工具（Tool）驱动”。我们的测试重点也应该从原来的 Prompts 转移到**核心服务层（Services）和工具控制层（Controllers）**。 @@ -43,7 +30,7 @@ status: Active --- -## 3. 核心测试场景设计与示例 +## 2. 核心测试场景设计与示例 为了让您的 Jest 测试跑通，以下是针对 Sprint 3 真实文件的测试用例编写指南及代码示例。您可以在 `src/services/__test__/` 和 `src/controllers/__test__/` 目录下创建或修改对应的 `.test.ts` 文件。 @@ -284,7 +271,7 @@ describe('Tools Controller - Sprint 3 (意图驱动与容错机制)', () => { --- -## 4. 测试执行说明 +## 3. 测试执行说明 在您配置好上述的测试文件后，请在终端使用项目中 `package.json` 原有配置的命令执行测试：