fix: 개념·환경 구성의 도식이 미리보기와 스냅샷에서 나온다

게시 Snapshot 화면이 figure 와 alt 는 그리면서 img src 를 비워 두었다. 서버는
주소를 제대로 실어 보냈고(renderModel 의 asset.publicPath) 화면이 그것을 버렸다.

원인은 kind === "CASE" ? model.bodyBlocks : [] 다. 개념이 더해진 뒤에도 그대로여서
개념·환경 구성은 해석기에 빈 목록이 갔다. 종류를 짚는 대신 본문 블록이 있으면
그것을 준다 — 새 종류가 본문을 가지면 저절로 걸린다.

프로젝트의 주요 주제는 고른 목록이 비어 있으면 기록에서 뽑는다. 고르는 것은
별도 동작이라 대부분 비어 있었고, 그동안 이 구역은 제목만 있는 빈 목록이었다.
이 프로젝트의 공개 기록이 어느 주제에 사는지가 곧 이 프로젝트가 다루는 주제다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
This commit is contained in:
DongHyeonka
2026-09-09 19:16:36 +09:00
co-authored by Claude Opus 5
parent 50c86841ff
commit 41b6457166
4 changed files with 52 additions and 13 deletions
@@ -35,6 +35,18 @@ export function ProjectOverviewPage() {
const { project, records, decisions, activity } = view.data;
if (!project) return <RegisteredNotFoundRoute />;
/* 고른 것이 있으면 그것, 없으면 기록이 사는 주제. 기록 순서를 그대로 따르고 중복만 없앤다. */
const topics =
project.topics.length > 0
? project.topics
: [
...new Map(
records
.filter((record) => record.topic && record.topicSlug)
.map((record) => [record.topicSlug, { name: record.topic, slug: record.topicSlug }]),
).values(),
];
return (
<main id="main-content" className="shell project-page">
<ProjectPageHeader project={project} title={project.title} />
@@ -98,11 +110,15 @@ export function ProjectOverviewPage() {
</div>
</section>
{/*
고른 주제가 없으면 이 구역을 그리지 않는다. 「주요 주제」라는 제목만 있고 아래가 빈
목록이면 읽는 사람에게는 이 프로젝트가 주제를 안 다룬다는 말이 아니라 화면이 덜
만들어졌다는 말로 읽힌다 — 공개 목록의 빈 라벨과 같은 규칙이다.
이 프로젝트가 다루는 주제.
고른 목록(`project.topics`)이 먼저다 — 작성자가 순서까지 정한 값이기 때문이다. 고르지
않았으면 기록에서 뽑는다: 이 프로젝트의 공개 기록이 어느 주제에 사는지가 곧 이 프로젝트가
다루는 주제다. 고르는 것은 별도 동작이라 대부분 비어 있었고, 그동안 이 구역은 제목만
있는 빈 목록이었다 — 프로젝트가 주제를 안 다룬다는 말이 아니라 화면이 덜 만들어졌다는
말로 읽혔다.
*/}
{project.topics.length > 0 ? (
{topics.length > 0 ? (
<section className="project-topics" aria-labelledby="project-topics-title">
<h2 id="project-topics-title">주요 주제</h2>
{/*
@@ -110,7 +126,7 @@ export function ProjectOverviewPage() {
버렸기 때문이고, 계약은 처음부터 이름과 slug 를 함께 주고 있었다.
*/}
<ul>
{project.topics.map((topic) => (
{topics.map((topic) => (
<li key={topic.slug || topic.name}>
{topic.slug ? <Link to={`/topics/${topic.slug}`}>{topic.name}</Link> : topic.name}
</li>
@@ -125,6 +125,27 @@ export function createAssetCatalogResolver(
});
}
/**
* 렌더 모델이 본문 블록을 갖고 있으면 그 블록들을 준다.
*
* <p>부르는 쪽이 `kind === "CASE" ? model.bodyBlocks : []` 로 종류를 짚고 있었다. 개념이
* 더해진 뒤에도 그대로여서, 개념·환경 구성의 미리보기와 게시 Snapshot 은 `<img>` 를 그리되
* `src` 가 비었다 — 서버는 주소를 제대로 실어 보냈고 화면이 그것을 버렸다.
*
* <p>블록이 있으면 쓰고 없으면 빈 목록이다. 새 종류가 본문을 가지면 여기서 저절로 걸린다.
*/
export function bodyBlocksOf(
model: object,
): readonly Readonly<{ type: string; key?: string; asset?: ResolvedAssetLike }>[] {
const blocks = (model as { bodyBlocks?: unknown }).bodyBlocks;
if (!Array.isArray(blocks)) return [];
return blocks as readonly Readonly<{
type: string;
key?: string;
asset?: ResolvedAssetLike;
}>[];
}
/** Public Preview · Snapshot: resolves from the descriptor the server already attached to the block. */
export function createResolvedAssetResolver(
blocks: readonly Readonly<{ type: string; key?: string; asset?: ResolvedAssetLike }>[],
@@ -10,7 +10,10 @@ import type {
} from "../../../contracts/studio/contract.ts";
import { deriveValidationState } from "../../../domain/studio/document-state.ts";
import { createLocalId } from "../../../domain/studio/local-id.ts";
import { createResolvedAssetResolver } from "../../shared/public-render/asset-resolvers.ts";
import {
bodyBlocksOf,
createResolvedAssetResolver,
} from "../../shared/public-render/asset-resolvers.ts";
import { PublicRecordRenderer } from "../../shared/public-render/public-record-renderer.tsx";
import { useStudio } from "../use-studio.ts";
import { GuardedStudioLink } from "./guarded-studio-link.tsx";
@@ -276,9 +279,7 @@ export function PublicPreviewScreen({ documentId }: { documentId: string }) {
model={previewDetail.preview.renderModel}
embedded
resolveEvidenceAsset={createResolvedAssetResolver(
previewDetail.preview.renderModel.kind === "CASE"
? previewDetail.preview.renderModel.bodyBlocks
: [],
bodyBlocksOf(previewDetail.preview.renderModel),
)}
resolvePublishedLabel={studio.resolvePublishedLabel}
/>
@@ -5,7 +5,10 @@ import {
type StudioGatewayError,
} from "../../../application/ports/studio-gateway-error.ts";
import type { PublicationSnapshot } from "../../../contracts/studio/contract.ts";
import { createResolvedAssetResolver } from "../../shared/public-render/asset-resolvers.ts";
import {
bodyBlocksOf,
createResolvedAssetResolver,
} from "../../shared/public-render/asset-resolvers.ts";
import { PublicRecordRenderer } from "../../shared/public-render/public-record-renderer.tsx";
import { GuardedStudioLink } from "./guarded-studio-link.tsx";
import {
@@ -153,9 +156,7 @@ export function PublicationEventPreviewScreen({
<PublicRecordRenderer
model={renderModel}
embedded
resolveEvidenceAsset={createResolvedAssetResolver(
renderModel.kind === "CASE" ? renderModel.bodyBlocks : [],
)}
resolveEvidenceAsset={createResolvedAssetResolver(bodyBlocksOf(renderModel))}
resolvePublishedLabel={studio.resolvePublishedLabel}
/>
</div>