다섯 종류는 전부 끝난 일을 남긴다. 없는 것은 읽는 사람이 자기 손으로 다시 하려면 무엇부터 하는가다. 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
79 lines
3.6 KiB
TypeScript
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",
|
|
]);
|
|
});
|