fix: 결정 문서가 작성자가 채운 칸을 그대로 보여 준다

공개 결정 화면에 네 가지가 어긋나 있었다 — 제목 자리에 결정문 전문이 나오고, 요약이 아예
없고, 줄바꿈이 전부 접히고, 영향과 근거 기록이 늘 비어 있었다.

원인은 하나로 모인다. 결정에는 상세 endpoint 가 없다 — 공개 주소가 목록 위의 앵커다. 그런데
계약의 목록 항목에 title·summary·consequences·evidence 가 없어서, 프론트는 statement 를
제목 자리에도 쓰고 영향은 빈 배열로 고정해 두고 있었다. DB 에는 작성자가 쓴 값이 그대로
들어 있었다 — 제목, 여러 줄 요약, 영향 4건.

근거는 두 자리에서 온다. `sourceQuestion`/`sourceCase` 는 결정 하나가 원천 하나를 지목하던
예전 모양이고 지금 작성자는 관계로 여러 개를 건다. 둘을 합치되 같은 경로는 한 번만 싣는다.

줄바꿈은 별개 원인이다. 이 칸들은 Markdown 을 거치지 않고 텍스트 노드로 들어가는데 이 화면만
`PlainText` 를 쓰지 않고 값을 그대로 넣고 있었다. 글자만 확인하는 테스트로는 접힘이 보이지
않으므로, 두 줄짜리 픽스처를 두고 `<br>` 이 남는지 요소로 묻는다 — 되돌리면 빨개진다.

즉시 미리보기도 같은 구조로 맞췄다. 미리보기와 공개가 다르게 그리면 무엇을 믿을지 알 수 없다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0189NzCryfeqDzS81EWidnBx
This commit is contained in:
DongHyeonka
2026-08-29 20:29:45 +09:00
co-authored by Claude Opus 5
parent 3b6ba64c08
commit 31afb4d800
12 changed files with 174 additions and 33 deletions
@@ -252,6 +252,59 @@ describe("TechLog project screens", () => {
]);
});
/*
결정에는 상세 화면이 없다 — 공개 주소가 이 목록 위의 앵커다. 그래서 작성자가 채운 칸이 전부
여기 그려져야 하는데, 계약의 목록 항목에 제목·요약·영향·근거가 없어 화면은 제목 자리에 결정문
전문을 그리고 영향과 근거를 늘 빈 목록으로 뒀다.
그리고 이 칸들은 Markdown 을 거치지 않고 텍스트 노드로 들어간다 — 작성자가 나눠 쓴 줄을
HTML 이 공백으로 접어 여러 문단이 한 줄로 이어져 보였다. 글자만 확인하면 그 접힘은 보이지
않으므로 줄바꿈이 실제 요소로 남는지 함께 묻는다.
*/
it("renders every authored field of a decision and keeps the author's line breaks", async () => {
const { container } = await renderPublicRoute(
"TECH_LOG_PROJECT_DECISIONS",
"/projects/backend-skeleton/decisions",
);
const [first] = Array.from(
container.querySelectorAll(".project-decision-list > li > article"),
);
const headings = Array.from(first!.querySelectorAll("h3"), (item) => item.textContent);
expect(headings).toEqual(["결정", "판단 이유", "영향", "근거 기록"]);
// 제목과 요약은 다른 칸이다 — 예전에는 둘 다 결정문이었다.
expect(first!.querySelector("h2")?.textContent).toBe("파일 저장 계약을 하나로 통합합니다");
expect(first!.querySelector("header p")?.textContent).toContain(
"저장 기술이 달라도",
);
const consequences = Array.from(
first!.querySelectorAll("section:nth-of-type(3) li"),
(item) => item.textContent,
);
expect(consequences.length).toBeGreaterThan(0);
});
it("keeps a multi-line decision field from collapsing into one line", async () => {
const { container } = await renderPublicRoute(
"TECH_LOG_PROJECT_DECISIONS",
"/projects/backend-skeleton/decisions",
);
/*
`PlainText` 는 줄바꿈을 `<br>` 로 남긴다. 글자만 비교하면 접혔는지 알 수 없다 — 접힌 화면도
같은 글자를 갖기 때문이다. 그래서 요소로 확인한다. 첫 결정의 요약이 두 줄짜리 픽스처다.
*/
const [first] = Array.from(
container.querySelectorAll(".project-decision-list > li > article"),
);
const summary = first!.querySelector("header p");
expect(summary?.textContent).toContain("저장 기술이 달라도");
expect(summary?.textContent).toContain("그래서 호출 계약을");
expect(summary?.querySelectorAll("br")).toHaveLength(1);
});
/*
활동은 로그다 — 언제 무엇을 올렸는지만 적는다. 각 줄에 그 기록으로 가는 링크가 있으면 같은
글에 닿는 길이 둘이 되고, 읽는 사람은 "기록"과 "활동"이 어떻게 다른지 매번 다시 판단해야 한다.