Files
tech-log-frontend/tests/features/tech-log/management-delete-routing.test.ts
T
DongHyeonkaandClaude Opus 5 3af9be9e09 feat: 환경 구성(SETUP) 기록 종류를 더한다
다섯 종류는 전부 끝난 일을 남긴다. 없는 것은 읽는 사람이 자기 손으로 다시
하려면 무엇부터 하는가다. Case 의 environment 는 평문 한 칸이라 명령이
들어가지 않고, 같은 셋업을 쓰는 Case 가 넷이면 같은 문장이 네 벌 복제된다.

프로젝트는 필수, 주제는 선택으로 둔다. 주제 없는 셋업이 그 프로젝트의 공통
구성이고, 주제를 붙이면 그 주제의 구성이다 — 스키마를 나누지 않고 두 범위를
같은 종류로 받는다.

버전만 본문 밖에 둔다(pinnedVersions). 이 절차가 어느 버전 위에서 성립했는지는
그 기록의 유효 범위이고, 목록과 머리말이 본문을 열지 않고 보여 줘야 한다.
나머지 셋(실행 절차·구성 값·확인 방법)은 명령과 표를 담아야 하므로 본문이다.

이름은 SETUP 이다. ENVIRONMENT 가 영어로는 자연스럽지만 case_detail.environment
와 겹친다 — 이 저장소가 열네 번 밟은 실패가 「종류를 손으로 나열한 곳을
빠뜨린다」이고 그걸 찾는 수단이 grep 이다.

손으로 나열해 두었던 자리를 이번에 표로 바꿨다. publicPath 의 삼항 사슬은
마지막 else 가 「나머지 전부」여서 새 종류의 주소가 조용히 /questions/… 가
됐고, document-editor 의 칸 경로도 같은 모양이었다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
2026-09-09 14:12:44 +09:00

79 lines
3.6 KiB
TypeScript

import assert from "node:assert/strict";
import { test } from "vitest";
import { TECH_LOG_MANAGEMENT_CONTRIBUTION } from "../../../src/features/tech-log/contracts/tech-log-management-contract-contribution.ts";
import type { DeletableDocumentKind } from "../../../src/features/tech-log/application/ports/management-gateway.ts";
/**
* 종류마다 지우는 주소가 다르다. 이 대응이 어긋나면 지우려던 것과 다른 종류의 API 를 부른다.
*
* <p>실제로 그렇게 났다: 개념을 더할 때 관리 계약에 삭제 경로를 만들지 않았고, 게이트웨이가
* 종류를 삼항으로 이어 붙여 마지막 else 가 남은 것을 다 받아 갔다. 부르는 화면은 종류를
* `as "CASE" | "REFERENCE" | "QUESTION"` 으로 좁혀 넘겼으므로 타입도 잡지 못했다. 개념을
* 지우려 하면 질문 삭제가 불렸고 「질문을 찾을 수 없습니다」가 났다.
*/
const EXPECTED: Record<DeletableDocumentKind, { operationId: string; path: string }> = {
CASE: { operationId: "deleteCaseDraft", path: "/api/v1/studio/cases/{id}" },
REFERENCE: { operationId: "deleteReferenceDraft", path: "/api/v1/studio/references/{id}" },
QUESTION: { operationId: "deleteQuestion", path: "/api/v1/studio/questions/{id}" },
CONCEPT: { operationId: "deleteConceptDraft", path: "/api/v1/studio/concepts/{id}" },
SETUP: { operationId: "deleteSetupDraft", path: "/api/v1/studio/setups/{id}" },
};
test("지울 수 있는 종류마다 자기 주소가 있고 서로 겹치지 않는다", () => {
const byId = new Map(
TECH_LOG_MANAGEMENT_CONTRIBUTION.http.map((entry) => [entry.contract.operationId, entry]),
);
const paths = new Set<string>();
for (const [kind, expected] of Object.entries(EXPECTED)) {
const installed = byId.get(expected.operationId);
assert.ok(installed, `${kind} 를 지우는 ${expected.operationId} 가 계약에 있어야 한다`);
assert.equal(installed.contract.method, "DELETE");
assert.equal(
installed.contract.pathTemplate,
expected.path,
`${kind} 는 자기 주소로 나가야 한다`,
);
assert.ok(!paths.has(expected.path), `${kind} 가 다른 종류와 같은 주소를 쓴다`);
paths.add(expected.path);
}
});
/**
* 앞의 검사는 계약에 주소가 있는지만 본다. 그것만으로는 부족했다 — 계약에 개념 삭제를 넣고도
* 게이트웨이는 여전히 삼항의 마지막 else 로 질문 삭제를 불렀고, 배포된 뒤에야 서버 로그의
* `DELETE /api/v1/studio/questions/{id} 404` 로 드러났다.
*
* <p>타입이 잡아 주지 못한 이유: 메서드 매개변수는 TypeScript 에서 bivariant 라, 구현이 종류를
* 좁게 적어도 넓은 포트 시그니처를 만족한 것으로 통과한다.
*
* <p>그래서 여기서는 게이트웨이를 실제로 불러 어떤 연산이 실행되는지 본다.
*/
test("게이트웨이가 종류마다 그 종류의 연산을 부른다", async () => {
const { createHttpManagementGateway } = await import(
"../../../src/features/tech-log/adapters/http/http-management-gateway.ts"
);
const called: string[] = [];
const gateway = createHttpManagementGateway({
operations: {
execute: (operationId: string) => {
called.push(operationId);
return Promise.resolve({ kind: "SUCCESS", value: undefined });
},
},
} as never);
for (const kind of ["CASE", "REFERENCE", "QUESTION", "CONCEPT"] as const) {
await gateway.deleteDocument(kind, "11111111-1111-4111-8111-111111111111", 1);
}
assert.deepEqual(called, [
"deleteCaseDraft",
"deleteReferenceDraft",
"deleteQuestion",
"deleteConceptDraft",
]);
});