diff --git a/public/release-manifest.json b/public/release-manifest.json index ca67358..7fbb2d9 100644 --- a/public/release-manifest.json +++ b/public/release-manifest.json @@ -38,28 +38,28 @@ }, "contractSet": { "setAlgorithm": "CA_CONTRACT_SET_V1", - "setDigest": "sha256:c841cbe2de536a2e3879e8dd42a9471f674d8164b1c0698bc6acd90a59721f43", + "setDigest": "sha256:c7c1680c3ff437bb8e41ee534e14e8a42b41689bc341f613d425814a6cc6a7c2", "packages": [ { "packageId": "@tech-log/management-contract", "version": "1.0.0", "digest": "sha256:a422ff091cdba5f17a27edfa12fec06e077bcc52c9615136ddecfa8df58a5f6e", "runtimeProtocolVersion": 1, - "sourceRevision": "f56a03b" + "sourceRevision": "fa67a64" }, { "packageId": "@tech-log/public-contract", "version": "2.1.0", "digest": "sha256:afe415880eb5d6289ae10abf493333c97270c323c16a7245a466d4db4466e630", "runtimeProtocolVersion": 1, - "sourceRevision": "f56a03b" + "sourceRevision": "fa67a64" }, { "packageId": "@tech-log/studio-contract", "version": "3.1.0", - "digest": "sha256:7e1ee18f7e6a6cb1750dd0baec28d975fb3b535116d8dfb57c17ae16ee8d2be8", + "digest": "sha256:7de83618e7bf5e0816f12136be91abc0e779c3ee06f86276a2b2498a5d51a4e0", "runtimeProtocolVersion": 1, - "sourceRevision": "f56a03b" + "sourceRevision": "fa67a64" } ] } diff --git a/src/features/tech-log/contracts/management/canonical-source.json b/src/features/tech-log/contracts/management/canonical-source.json index 2236a6e..7f3a010 100644 --- a/src/features/tech-log/contracts/management/canonical-source.json +++ b/src/features/tech-log/contracts/management/canonical-source.json @@ -2,7 +2,7 @@ "packageId": "@tech-log/management-contract", "version": "1.0.0", "digest": "sha256:a422ff091cdba5f17a27edfa12fec06e077bcc52c9615136ddecfa8df58a5f6e", - "sourceRevision": "f56a03b", + "sourceRevision": "fa67a64", "operationIds": [ "createCaseDraft", "getCaseForEdit", diff --git a/src/features/tech-log/contracts/public/canonical-source.json b/src/features/tech-log/contracts/public/canonical-source.json index 8743240..4b99b75 100644 --- a/src/features/tech-log/contracts/public/canonical-source.json +++ b/src/features/tech-log/contracts/public/canonical-source.json @@ -2,7 +2,7 @@ "packageId": "@tech-log/public-contract", "version": "2.1.0", "digest": "sha256:afe415880eb5d6289ae10abf493333c97270c323c16a7245a466d4db4466e630", - "sourceRevision": "f56a03b", + "sourceRevision": "fa67a64", "operationIds": [ "getPublicSite", "getPublicHome", diff --git a/src/features/tech-log/contracts/studio/canonical-source.json b/src/features/tech-log/contracts/studio/canonical-source.json index 3d388c7..52fa336 100644 --- a/src/features/tech-log/contracts/studio/canonical-source.json +++ b/src/features/tech-log/contracts/studio/canonical-source.json @@ -1,8 +1,8 @@ { "packageId": "@tech-log/studio-contract", "version": "3.1.0", - "digest": "sha256:7e1ee18f7e6a6cb1750dd0baec28d975fb3b535116d8dfb57c17ae16ee8d2be8", - "sourceRevision": "f56a03b", + "digest": "sha256:7de83618e7bf5e0816f12136be91abc0e779c3ee06f86276a2b2498a5d51a4e0", + "sourceRevision": "fa67a64", "operationIds": [ "getStudioSession", "getStudioDashboard", diff --git a/src/features/tech-log/contracts/studio/generated.ts b/src/features/tech-log/contracts/studio/generated.ts index c2f8f3e..4357de5 100644 --- a/src/features/tech-log/contracts/studio/generated.ts +++ b/src/features/tech-log/contracts/studio/generated.ts @@ -883,6 +883,7 @@ export interface components { title: string; publicPath: string | null; reason: string; + summary?: string; order: number; }; RenderContext: { diff --git a/src/features/tech-log/contracts/studio/studio-api.openapi.yaml b/src/features/tech-log/contracts/studio/studio-api.openapi.yaml index 0aa48d4..f79cd41 100644 --- a/src/features/tech-log/contracts/studio/studio-api.openapi.yaml +++ b/src/features/tech-log/contracts/studio/studio-api.openapi.yaml @@ -1265,6 +1265,9 @@ components: title: { type: string, minLength: 1, maxLength: 200 } publicPath: { type: [string, "null"], maxLength: 500 } reason: { type: string, maxLength: 100000 } + # 대상 문서의 요약. 관계 목록에서 제목만 보이면 왜 이것이 걸려 있는지 눌러 봐야 알 수 + # 있다. required 에 넣지 않는 이유는 이미 나가 있는 응답을 깨지 않기 위해서다. + summary: { type: string, maxLength: 2000 } order: { type: integer, minimum: 0 } RenderContext: type: object diff --git a/src/features/tech-log/presentation/public/components/public-document-header.tsx b/src/features/tech-log/presentation/public/components/public-document-header.tsx index e1e4663..255a135 100644 --- a/src/features/tech-log/presentation/public/components/public-document-header.tsx +++ b/src/features/tech-log/presentation/public/components/public-document-header.tsx @@ -41,6 +41,8 @@ export function publicRenderModelBase( title: relation.title, publicPath: relation.path, reason: relation.reason, + /* 계약이 관계마다 주는 요약. 여기서 버리면 목록에 제목만 남는다. */ + summary: relation.summary, order: index + 1, })), renderContext: { diff --git a/src/features/tech-log/presentation/shared/public-render/public-record-renderer.tsx b/src/features/tech-log/presentation/shared/public-render/public-record-renderer.tsx index 659b3a9..78652dc 100644 --- a/src/features/tech-log/presentation/shared/public-render/public-record-renderer.tsx +++ b/src/features/tech-log/presentation/shared/public-render/public-record-renderer.tsx @@ -121,6 +121,7 @@ function publicRelations( reason: relation.reason, title: relation.title, path: relation.publicPath, + summary: relation.summary, })); } diff --git a/tests/component/prose-text.test.tsx b/tests/component/prose-text.test.tsx index 0d37596..9d65a50 100644 --- a/tests/component/prose-text.test.tsx +++ b/tests/component/prose-text.test.tsx @@ -76,3 +76,41 @@ describe("릴리스 노트 목록 읽기", () => { expect(markdownLines("1. 첫째\n2. 둘째")).toEqual(["첫째", "둘째"]); }); }); + +/** + * 관계 목록의 요약. 계약은 관계마다 요약을 주는데 경계 세 곳(평탄화 → 렌더 모델 → 화면 목록)을 + * 지나며 조용히 사라졌다. 독자가 목록에서 보는 것이 제목뿐이라, 왜 이 기록이 걸려 있는지는 + * 눌러 봐야 알 수 있었다. + */ +describe("관계 목록", () => { + it("대상 요약을 제목 아래 보여 주되 링크 이름에는 넣지 않는다", async () => { + const { PublicDocumentRelations } = await import( + "../../src/features/tech-log/presentation/shared/public-render/public-document-relations.tsx" + ); + const { MemoryRouter: Router } = await import("react-router-dom"); + const { container, getByRole } = render( + + + , + ); + expect(container.querySelector(".document-relations li p")).toHaveTextContent( + "SPA가 public OAuth client로 code를 직접 교환한다.", + ); + /* + 링크 이름에 요약이 들어가면 관계 목록을 훑을 때 링크 하나하나가 문단이 되어 목록으로서 + 쓸모가 없어진다 — 이름은 「관계 이름 + 제목」까지다. + */ + const link = getByRole("link", { name: /이 기준의 근거가 된 기록/ }); + expect(link.getAttribute("aria-label")).toBeNull(); + expect(link).not.toHaveAccessibleName(/code를 직접 교환/); + }); +});