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
@@ -2,7 +2,7 @@
"packageId": "@tech-log/management-contract",
"version": "1.0.0",
"digest": "sha256:762aa81e6906469939fddd833c204ed3ca53f0fa96371f18a5ea1edaf76a64e8",
"sourceRevision": "2c25ccc",
"sourceRevision": "987c1b8",
"operationIds": [
"createCaseDraft",
"getCaseForEdit",
@@ -1,8 +1,8 @@
{
"packageId": "@tech-log/public-contract",
"version": "2.1.0",
"digest": "sha256:66391f3a3fd91b632094de9f40814ccd42f2fec00d251e7134f33c9b663dfb18",
"sourceRevision": "2c25ccc",
"digest": "sha256:c80f62cd37862ea48cef750e9966164570dfa0ceaf9ddc1872d497b0462a2a00",
"sourceRevision": "987c1b8",
"operationIds": [
"getPublicSite",
"getPublicHome",
@@ -743,12 +743,25 @@ export interface components {
activeQuestion?: components["schemas"]["RelatedEntry"];
selectedRecords: components["schemas"]["RelatedEntry"][];
};
/** @description 결정 화면은 상세 endpoint 없이 이 목록 하나로 그려진다(공개 주소가
* `/projects/{slug}/decisions#{slug}` 인 앵커다). 화면이 그리는 칸은 전부 여기 있어야 한다.
* */
ProjectDecisionItem: {
/** Format: uuid */
id: string;
/** @description 작성자가 붙인 제목. 결정문(`statement`)과 다르다 — 제목은 한 줄이고 결정문은 여러 문단일 수 있다. */
title: string;
/** @description 제목 바로 아래에 오는 요약. */
summary: string;
statement: string;
status: string;
rationaleSummary?: string;
/** @description 이 결정이 남기는 영향. 작성자가 순서대로 적는다. */
consequences: string[];
/** @description 이 결정의 근거로 연결한 공개 기록. `sourceQuestion`/`sourceCase` 는 예전의 단일 지목이고,
* 지금 작성자는 관계로 여러 개를 건다.
* */
evidence: components["schemas"]["RelatedEntry"][];
/** Format: date-time */
decidedAt: string;
sourceQuestion?: components["schemas"]["RelatedEntry"];
@@ -1749,20 +1749,45 @@ components:
items:
$ref: '#/components/schemas/RelatedEntry'
ProjectDecisionItem:
description: |
결정 화면은 상세 endpoint 없이 이 목록 하나로 그려진다(공개 주소가
`/projects/{slug}/decisions#{slug}` 인 앵커다). 화면이 그리는 칸은 전부 여기 있어야 한다.
type: object
required:
- id
- title
- summary
- statement
- status
- consequences
- evidence
- decidedAt
properties:
id: *id004
title:
type: string
description: 작성자가 붙인 제목. 결정문(`statement`)과 다르다 — 제목은 한 줄이고 결정문은 여러 문단일 수 있다.
summary:
type: string
description: 제목 바로 아래에 오는 요약.
statement:
type: string
status:
type: string
rationaleSummary:
type: string
consequences:
type: array
description: 이 결정이 남기는 영향. 작성자가 순서대로 적는다.
items:
type: string
evidence:
type: array
description: |
이 결정의 근거로 연결한 공개 기록. `sourceQuestion`/`sourceCase` 는 예전의 단일 지목이고,
지금 작성자는 관계로 여러 개를 건다.
items:
$ref: '#/components/schemas/RelatedEntry'
decidedAt: *id003
sourceQuestion:
$ref: '#/components/schemas/RelatedEntry'
@@ -2,7 +2,7 @@
"packageId": "@tech-log/studio-contract",
"version": "3.1.0",
"digest": "sha256:96f655d75fc19c535eb87e24f5320fdc382d6d982aaa75b67fe6acbde1ee8ff2",
"sourceRevision": "2c25ccc",
"sourceRevision": "987c1b8",
"operationIds": [
"getStudioSession",
"getStudioDashboard",