From 08939bdaaf12d975722f5e185e2c0630c5dad470 Mon Sep 17 00:00:00 2001
From: chyoo <chyoo@futuredrive.net>
Date: Mon, 6 Jul 2026 16:31:53 +0900
Subject: [PATCH] clarify app release build flow

---
 .../applications/BuildManagementPage.tsx      | 10 ++-----
 .../applications/ReleaseManagementPage.tsx    | 30 ++++++++++++++-----
 src/pages/launcher/LauncherBuildPage.tsx      |  6 ++--
 src/pages/operations/NoticesPage.tsx          | 23 +++++++-------
 4 files changed, 41 insertions(+), 28 deletions(-)

diff --git a/src/pages/applications/BuildManagementPage.tsx b/src/pages/applications/BuildManagementPage.tsx
index 62951a7..27b2146 100644
--- a/src/pages/applications/BuildManagementPage.tsx
+++ b/src/pages/applications/BuildManagementPage.tsx
@@ -100,8 +100,7 @@ export function BuildManagementPage() {
       setSelectedComponentId((prev) => {
         const valid = filteredSources.some((source) => source.id === prev);
         const next = valid ? prev : filteredSources[0]?.id || '';
-        const nextSource = filteredSources.find((source) => source.id === next);
-        setBranch(nextSource?.branch || 'develop');
+        setBranch('develop');
         return next;
       });
     } finally {
@@ -137,7 +136,7 @@ export function BuildManagementPage() {
     if (!componentOptions.some((source) => source.id === selectedComponentId)) {
       const nextComponent = componentOptions[0];
       setSelectedComponentId(nextComponent?.id || '');
-      setBranch(nextComponent?.branch || 'develop');
+      setBranch('develop');
     }
   }, [componentOptions, selectedComponentId]);
 
@@ -225,9 +224,8 @@ export function BuildManagementPage() {
                 className="mt-2 h-9 w-full rounded-md border border-input bg-background px-3 text-sm text-foreground outline-none focus:ring-2 focus:ring-ring"
                 value={selectedComponent?.id ?? ''}
                 onChange={(event) => {
-                  const next = componentOptions.find((source) => source.id === event.target.value);
                   setSelectedComponentId(event.target.value);
-                  setBranch(next?.branch || 'develop');
+                  setBranch('develop');
                 }}
               >
                 {componentOptions.length === 0 ? <option value="">구성요소 없음</option> : null}
@@ -242,8 +240,6 @@ export function BuildManagementPage() {
                 onChange={(event) => setBranch(event.target.value)}
               >
                 <option value="develop">develop</option>
-                <option value="release">release</option>
-                <option value="main">main</option>
               </select>
             </label>
             <label className="block md:col-span-2">
diff --git a/src/pages/applications/ReleaseManagementPage.tsx b/src/pages/applications/ReleaseManagementPage.tsx
index f845c9a..f143b0d 100644
--- a/src/pages/applications/ReleaseManagementPage.tsx
+++ b/src/pages/applications/ReleaseManagementPage.tsx
@@ -29,6 +29,10 @@ function statusTone(status: string): 'neutral' | 'green' | 'amber' | 'red' | 'bl
 type ImageTags = {
   images?: Record<string, string>;
   artifacts?: Record<string, string>;
+  error?: string;
+  promotion?: {
+    sourceBuildJobIds?: string[];
+  };
 };
 
 function releaseArtifacts(release: AppRelease) {
@@ -71,6 +75,17 @@ function usedReleaseValues(releases: AppRelease[]) {
   return new Set(releases.flatMap(releaseArtifacts));
 }
 
+function usedReleaseBuildIds(releases: AppRelease[]) {
+  const ids = new Set<string>();
+  for (const release of releases) {
+    const imageTags = release.imageTags as ImageTags | null | undefined;
+    for (const id of imageTags?.promotion?.sourceBuildJobIds ?? []) {
+      ids.add(id);
+    }
+  }
+  return ids;
+}
+
 function latestBuildIdsByComponent(builds: BuildJob[]) {
   const map = new Map<string, BuildJob>();
   for (const build of builds) {
@@ -139,12 +154,13 @@ export function ReleaseManagementPage() {
   const [page, setPage] = useState(1);
   const loadingVisible = useMinimumLoading(loading);
   const usedValues = useMemo(() => usedReleaseValues(releases), [releases]);
+  const usedBuildIds = useMemo(() => usedReleaseBuildIds(releases), [releases]);
   const candidateBuilds = useMemo(
     () => builds.filter((build) => {
       const value = buildValue(build);
-      return isDevelopBuild(build) && Boolean(buildCommit(build)) && (!value || !usedValues.has(value));
+      return isDevelopBuild(build) && Boolean(buildCommit(build)) && !usedBuildIds.has(build.id) && (!value || !usedValues.has(value));
     }),
-    [builds, usedValues]
+    [builds, usedBuildIds, usedValues]
   );
 
   const candidateGroups = useMemo(
@@ -207,7 +223,7 @@ export function ReleaseManagementPage() {
     if (!selectedAppId) return;
     try {
       await createRelease({ appId: selectedAppId, version, branch: 'release', buildJobIds: selectedBuildIds });
-      toast({ type: 'success', message: '릴리즈가 생성되었습니다.' });
+      toast({ type: 'success', message: '릴리즈 생성을 시작했습니다.' });
       setVersion('');
       setSelectedBuildIds([]);
       setReleaseModalOpen(false);
@@ -222,7 +238,7 @@ export function ReleaseManagementPage() {
       <PageTitle
         eyebrow="어플리케이션"
         title="릴리즈 관리"
-        description="검증에 성공한 develop 빌드 결과를 release 브랜치로 승격해 배포 가능한 릴리즈를 생성합니다."
+        description="검증에 성공한 develop 빌드를 release로 승격한 뒤 release 기준으로 다시 빌드합니다."
         actions={
           <Button className="h-8 px-3 text-[13px]" disabled={candidateBuilds.length === 0} onClick={() => openReleaseModal()}>
             <Plus className="size-4" />
@@ -235,7 +251,7 @@ export function ReleaseManagementPage() {
 
       <div className="grid gap-4 xl:grid-cols-[minmax(0,1fr)_320px]">
         <Card className="min-w-0 overflow-hidden">
-          <CardHeader title="릴리즈 목록" description="성공한 빌드 결과를 버전 단위로 묶은 배포 후보입니다." />
+          <CardHeader title="릴리즈 목록" description="release 브랜치에서 빌드된 산출물 기준의 배포 후보입니다." />
           <div className="space-y-3 p-4">
             {filteredReleases.length === 0 ? (
               <div className="flex min-h-44 items-center justify-center text-center text-sm text-muted-foreground">
@@ -299,7 +315,7 @@ export function ReleaseManagementPage() {
         </Card>
 
         <Card className="min-w-0 overflow-hidden">
-          <CardHeader title="릴리즈 후보" description="아직 릴리즈에 포함되지 않은 develop 성공 빌드입니다." />
+          <CardHeader title="릴리즈 후보" description="아직 릴리즈 처리에 사용되지 않은 develop 성공 빌드입니다." />
           <div className="space-y-3 p-4">
             {candidateGroups.length === 0 ? (
               <div className="rounded-md border border-border px-3 py-4 text-center text-sm text-muted-foreground">
@@ -333,7 +349,7 @@ export function ReleaseManagementPage() {
           </select>
           <input className="h-9 w-full rounded-md border border-input bg-background px-3 text-sm outline-none" value={version} onChange={(event) => setVersion(event.target.value)} placeholder="버전 예: 0.1.1" />
           <div className="rounded-md border border-border bg-muted/20 px-3 py-2 text-xs leading-5 text-muted-foreground">
-            develop 성공 빌드만 선택할 수 있으며, 생성 시 각 저장소의 release 브랜치를 선택한 commit으로 fast-forward 합니다.
+            선택한 develop 커밋을 release로 승격한 뒤 release 브랜치에서 다시 빌드합니다.
           </div>
           <div className="max-h-72 space-y-2 overflow-y-auto rounded-md border border-border p-2">
             {modalBuilds.length === 0 ? (
diff --git a/src/pages/launcher/LauncherBuildPage.tsx b/src/pages/launcher/LauncherBuildPage.tsx
index 13f8675..30b2be8 100644
--- a/src/pages/launcher/LauncherBuildPage.tsx
+++ b/src/pages/launcher/LauncherBuildPage.tsx
@@ -117,7 +117,7 @@ export function LauncherBuildPage() {
         setBuildEnv(nextBuildEnv.variables ?? []);
         const nextVersion = nextVersions.find((item) => item.isActive) ?? nextVersions[0];
         setVersion(nextVersion?.version ?? '');
-        setBranch(target === 'launcher-backend' ? nextSource.source.backend?.branch ?? 'release' : nextSource.source.client?.branch ?? nextVersion?.branch ?? 'release');
+        setBranch('release');
         setCommitSha(target === 'launcher-backend' ? nextSource.source.backend?.commitSha ?? '' : nextSource.source.client?.commitSha ?? nextVersion?.commitSha ?? '');
       })
       .catch((error: Error) => {
@@ -133,12 +133,12 @@ export function LauncherBuildPage() {
   useEffect(() => {
     if (!source) return;
     if (target === 'launcher-backend') {
-      setBranch(source.backend?.branch ?? 'release');
+      setBranch('release');
       setCommitSha(source.backend?.commitSha ?? '');
       return;
     }
 
-    setBranch(source.client?.branch ?? activeVersion?.branch ?? 'release');
+    setBranch('release');
     setCommitSha(source.client?.commitSha ?? activeVersion?.commitSha ?? '');
   }, [activeVersion?.branch, activeVersion?.commitSha, source, target]);
 
diff --git a/src/pages/operations/NoticesPage.tsx b/src/pages/operations/NoticesPage.tsx
index 5749344..aeea07b 100644
--- a/src/pages/operations/NoticesPage.tsx
+++ b/src/pages/operations/NoticesPage.tsx
@@ -58,11 +58,17 @@ function toApiDateTime(value: string) {
   return value ? new Date(value).toISOString() : undefined;
 }
 
-function exposureText(row: LauncherNotice) {
-  if (!row.startsAt && !row.endsAt) return '상시';
-  if (row.startsAt && row.endsAt) return `${formatNoticeDateTime(row.startsAt)} ~ ${formatNoticeDateTime(row.endsAt)}`;
-  if (row.startsAt) return `${formatNoticeDateTime(row.startsAt)}부터`;
-  return `${formatNoticeDateTime(row.endsAt)}까지`;
+function exposureCell(row: LauncherNotice) {
+  if (!row.startsAt && !row.endsAt) {
+    return <span className="text-muted-foreground">상시</span>;
+  }
+
+  return (
+    <div className="min-w-40 text-xs leading-5 text-muted-foreground">
+      <p>{row.startsAt ? formatNoticeDateTime(row.startsAt) : '-'}</p>
+      <p>~ {row.endsAt ? formatNoticeDateTime(row.endsAt) : '-'}</p>
+    </div>
+  );
 }
 
 function toForm(notice: LauncherNotice): NoticeForm {
@@ -237,12 +243,7 @@ export function NoticesPage() {
       },
       { key: 'appKey', header: '대상 앱', cell: (row) => <StatusBadge status={row.appName} tone={isLauncherNoticeKey(row.appKey) ? 'violet' : 'blue'} /> },
       { key: 'status', header: '상태', cell: (row) => <StatusBadge status={row.status ?? (row.isActive ? '게시중' : '비활성')} /> },
-      { key: 'exposure', header: '노출 일시', cell: (row) => <span className="text-muted-foreground">{exposureText(row)}</span> },
-      {
-        key: 'linkUrl',
-        header: '링크주소',
-        cell: (row) => row.linkUrl ? <span className="block max-w-56 truncate text-muted-foreground">{row.linkUrl}</span> : <span className="text-muted-foreground">-</span>
-      },
+      { key: 'exposure', header: '노출 일시', className: 'w-48 px-5 py-3 font-medium', cell: exposureCell },
       { key: 'createdAt', header: '생성일시', cell: (row) => <span className="text-muted-foreground">{formatNoticeDateTime(row.createdAt)}</span> },
       {
         key: 'actions',