From 554ab520d17f9a3edf38a27214f09c17b71b6337 Mon Sep 17 00:00:00 2001
From: Script Generator <dev@scriptgen.local>
Date: Thu, 2 Jul 2026 19:50:47 +0800
Subject: [PATCH] =?UTF-8?q?fix(=E9=9C=80=E6=B1=82=E6=B1=A0):=20=E4=BF=AE?=
 =?UTF-8?q?=E5=A4=8D=E5=88=97=E8=A1=A8=E6=8D=A2=E8=A1=8C=E5=92=8C=E7=89=88?=
 =?UTF-8?q?=E6=9C=AC=E8=A7=A3=E7=BB=91=E7=8A=B6=E6=80=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 apps/web/app/requirements/page.tsx            | 61 ++++++++++++++----
 apps/web/app/versions/[id]/page.tsx           | 13 +++-
 apps/web/app/versions/page.tsx                |  3 +-
 apps/web/lib/requirement-table-layout.test.ts | 22 +++++++
 apps/web/lib/requirement-table-layout.ts      | 20 ++++++
 apps/web/lib/requirement-version-link.test.ts | 63 +++++++++++++++++++
 apps/web/lib/requirement-version-link.ts      | 29 +++++++++
 7 files changed, 194 insertions(+), 17 deletions(-)
 create mode 100644 apps/web/lib/requirement-table-layout.test.ts
 create mode 100644 apps/web/lib/requirement-table-layout.ts
 create mode 100644 apps/web/lib/requirement-version-link.test.ts
 create mode 100644 apps/web/lib/requirement-version-link.ts

diff --git a/apps/web/app/requirements/page.tsx b/apps/web/app/requirements/page.tsx
index aad5a95..ef369aa 100644
--- a/apps/web/app/requirements/page.tsx
+++ b/apps/web/app/requirements/page.tsx
@@ -13,6 +13,13 @@ import type { Requirement, RequirementStatus, SourceType } from '@/lib/requireme
 import { deriveReqDevStatus, canEditRequirement, canCloseRequirement, REQ_DEV_STATUS_LABEL, REQ_DEV_STATUS_COLOR } from '@/lib/linkage-engine';
 import { buildRequirementScopeTree, filterRequirementScopeTreeByKeyword, filterRequirementsByScope, type RequirementProductScopeNode, type RequirementScopeSelection } from '@/lib/requirement-scope';
 import { sortRequirementsByCreatedAt, type RequirementDateSort } from '@/lib/requirement-sort';
+import {
+  REQUIREMENT_TABLE_BADGE_CLASS,
+  REQUIREMENT_TABLE_NOWRAP_CELL_CLASS,
+  REQUIREMENT_TABLE_SMALL_BADGE_CLASS,
+  getRequirementTableTextClass,
+} from '@/lib/requirement-table-layout';
+import { getRequirementVersionSelectionPatch } from '@/lib/requirement-version-link';
 import { Pagination, usePagination } from '@/components/Pagination';
 import { RequirementModal } from '@/components/requirement/RequirementModal';
 import { RequirementDetail } from '@/components/requirement/RequirementDetail';
@@ -488,29 +495,50 @@ function RequirementsPageContent() {
 
                         {/* 需求来源 */}
                         <td className="px-4 py-3 text-[13px] text-[var(--ink-soft)]">
-                          {SOURCE_TYPE_LABEL[req.sourceType]}: {req.sourceTarget}
+                          {(() => {
+                            const sourceText = `${SOURCE_TYPE_LABEL[req.sourceType]}: ${req.sourceTarget}`;
+                            return (
+                              <span className={getRequirementTableTextClass('source')} title={sourceText}>
+                                {sourceText}
+                              </span>
+                            );
+                          })()}
                         </td>
 
                         {/* 所属项目 */}
                         <td className="px-4 py-3 text-[12px] text-[var(--ink-soft)]">
-                          {allProjects.find((p) => p.id === req.projectId)?.name ?? '-'}
+                          {(() => {
+                            const projectName = allProjects.find((p) => p.id === req.projectId)?.name ?? '-';
+                            return (
+                              <span className={getRequirementTableTextClass('project')} title={projectName}>
+                                {projectName}
+                              </span>
+                            );
+                          })()}
                         </td>
 
                         {/* 需求类型 */}
                         <td className="px-4 py-3 text-[12px] text-[var(--ink-soft)]">
-                          {types.find((t) => t.id === req.typeId)?.name ?? '-'}
+                          {(() => {
+                            const typeName = types.find((t) => t.id === req.typeId)?.name ?? '-';
+                            return (
+                              <span className={getRequirementTableTextClass('type')} title={typeName}>
+                                {typeName}
+                              </span>
+                            );
+                          })()}
                         </td>
 
                         {/* 状态 */}
-                        <td className="px-4 py-3">
-                          <span className={`inline-flex items-center rounded-md px-2 py-0.5 text-[11px] font-medium ${REQ_STATUS_COLOR[req.status]}`}>
+                        <td className={REQUIREMENT_TABLE_NOWRAP_CELL_CLASS}>
+                          <span className={`${REQUIREMENT_TABLE_BADGE_CLASS} ${REQ_STATUS_COLOR[req.status]}`}>
                             {REQ_STATUS_LABEL[req.status]}
                           </span>
                         </td>
 
                         {/* 优先级 */}
-                        <td className="px-4 py-3">
-                          <span className={`inline-flex items-center rounded-md px-2 py-0.5 text-[11px] font-medium ${PRIORITY_COLORS[req.priority] ?? 'bg-zinc-100 text-zinc-500'}`}>
+                        <td className={REQUIREMENT_TABLE_NOWRAP_CELL_CLASS}>
+                          <span className={`${REQUIREMENT_TABLE_SMALL_BADGE_CLASS} ${PRIORITY_COLORS[req.priority] ?? 'bg-zinc-100 text-zinc-500'}`}>
                             {req.priority}
                           </span>
                         </td>
@@ -521,11 +549,11 @@ function RequirementsPageContent() {
                         </td>
 
                         {/* 开发状态 */}
-                        <td className="px-4 py-3">
+                        <td className={REQUIREMENT_TABLE_NOWRAP_CELL_CLASS}>
                           {(() => {
                             const devStatus = deriveReqDevStatus(req.id, devTasks);
                             return (
-                              <span className={`inline-flex items-center rounded-md px-2 py-0.5 text-[10px] font-medium ${REQ_DEV_STATUS_COLOR[devStatus]}`}>
+                              <span className={`${REQUIREMENT_TABLE_SMALL_BADGE_CLASS} ${REQ_DEV_STATUS_COLOR[devStatus]}`}>
                                 {REQ_DEV_STATUS_LABEL[devStatus]}
                               </span>
                             );
@@ -534,17 +562,19 @@ function RequirementsPageContent() {
 
                         {/* 录入人员 */}
                         <td className="px-4 py-3 text-[12px] text-[var(--ink-soft)]">
-                          {req.creator}
+                          <span className={getRequirementTableTextClass('creator')} title={req.creator}>
+                            {req.creator}
+                          </span>
                         </td>
 
                         {/* 录入日期 */}
-                        <td className="px-4 py-3 text-[var(--ink-muted)] tabular-nums">
+                        <td className="px-4 py-3 text-[var(--ink-muted)] tabular-nums whitespace-nowrap">
                           {new Date(req.createdAt).toISOString().slice(0, 10)}
                         </td>
 
                         {/* 操作 */}
                         <td className="px-4 py-3 text-right" onClick={(e) => e.stopPropagation()}>
-                          <div className="flex items-center justify-end gap-1">
+                          <div className="flex items-center justify-end gap-1 whitespace-nowrap">
                             {/* 编辑：待评审/已采纳/已规划，且开发中不可编辑 */}
                             {(['pending_review', 'adopted', 'planned'] as const).includes(req.status as any) && canEditRequirement(req.id, devTasks) && (
                               <button
@@ -638,7 +668,12 @@ function RequirementsPageContent() {
           onClose={() => { setShowModal(false); setEditingReq(null); }}
           onSubmit={(data) => {
             if (editingReq) {
-              updateRequirement(editingReq.id, data);
+              const versionPatch = getRequirementVersionSelectionPatch(
+                editingReq,
+                data.versionId,
+                data.versionId !== editingReq.versionId ? currentUserName : editingReq.addedToVersionBy,
+              );
+              updateRequirement(editingReq.id, { ...data, ...versionPatch });
             } else {
               createRequirement(data);
             }
diff --git a/apps/web/app/versions/[id]/page.tsx b/apps/web/app/versions/[id]/page.tsx
index 0f44a10..ddce690 100644
--- a/apps/web/app/versions/[id]/page.tsx
+++ b/apps/web/app/versions/[id]/page.tsx
@@ -29,6 +29,7 @@ import { hasPermission } from '@/lib/permissions';
 import { calcActualElapsedHours, formatActualDuration } from '@/lib/work-hours';
 import { formatDateTime, formatLocalDate } from '@/lib/format';
 import { getProjectAdoptedRequirementCandidates } from '@/lib/requirement-selector';
+import { getRequirementVersionSelectionPatch, getRequirementVersionUnlinkPatch } from '@/lib/requirement-version-link';
 import { calcBugSeverityRanking, calcPersonalEffortRanking, calcStageEffortMetrics, calcVersionOverviewEffortTotals } from '@/lib/version-overview';
 import { addVersionMembers, DEFAULT_VERSION_MEMBER_ROLE, filterVersionMemberCandidates } from '@/lib/version-members';
 import { addRecommendedVersionMembers, getDefaultRecommendedMemberNames, recommendVersionMembers, type MemberRecommendationGroup, type RecommendableRole } from '@/lib/member-recommendation';
@@ -230,7 +231,7 @@ export default function VersionDetailPage() {
       buttons.push({ label: '删除', action: () => {
         if (confirm('确认删除该版本？关联的需求会回到需求池，版本下的计划、开发任务、测试用例、Bug 将被清除。')) {
           // 释放关联需求
-          requirements.filter((r) => r.versionId === version.id).forEach((r) => updateRequirement(r.id, { versionId: undefined, addedToVersionBy: undefined }));
+          requirements.filter((r) => r.versionId === version.id).forEach((r) => updateRequirement(r.id, getRequirementVersionUnlinkPatch(r)));
           // 清理计划任务
           plans.filter((p) => p.versionId === version.id).forEach((p) => deletePlan(p.id));
           // 清理开发任务
@@ -861,11 +862,17 @@ export default function VersionDetailPage() {
             readOnly={versionReadonly}
             onLink={(ids, addedBy) => {
               if (versionReadonly) return;
-              ids.forEach((id) => updateRequirement(id, { versionId: version.id, addedToVersionBy: addedBy }));
+              ids.forEach((id) => {
+                const requirement = requirements.find((item) => item.id === id);
+                if (!requirement) return;
+                updateRequirement(id, getRequirementVersionSelectionPatch(requirement, version.id, addedBy));
+              });
             }}
             onUnlink={(id) => {
               if (versionReadonly) return;
-              updateRequirement(id, { versionId: undefined, addedToVersionBy: undefined });
+              const requirement = requirements.find((item) => item.id === id);
+              if (!requirement) return;
+              updateRequirement(id, getRequirementVersionUnlinkPatch(requirement));
             }}
             onCreateChange={(data) => {
               if (versionReadonly) return;
diff --git a/apps/web/app/versions/page.tsx b/apps/web/app/versions/page.tsx
index 5450341..f151162 100644
--- a/apps/web/app/versions/page.tsx
+++ b/apps/web/app/versions/page.tsx
@@ -20,6 +20,7 @@ import { useXiaobaoWarningRisks } from '@/hooks/useXiaobaoWarningRisks';
 import type { XiaobaoVersionRisk } from '@/lib/xiaobao-risk';
 import { getRiskScoreTone } from '@/lib/xiaobao-warning-view';
 import { buildVersionScopeTree, filterVersionsForList, type VersionListScope, type VersionProductNode } from '@/lib/version-list';
+import { getRequirementVersionUnlinkPatch } from '@/lib/requirement-version-link';
 import {
   VERSION_DEVELOPMENT_TYPE_OPTIONS,
   canSubmitNewVersionForm,
@@ -158,7 +159,7 @@ function VersionsPageContent() {
     setOpenMenuId(null);
     if (action === 'delete') {
       if (!confirm('确认删除该版本？关联的需求会回到需求池。')) return;
-      requirements.filter((r) => r.versionId === version.id).forEach((r) => updateRequirement(r.id, { versionId: undefined, addedToVersionBy: undefined }));
+      requirements.filter((r) => r.versionId === version.id).forEach((r) => updateRequirement(r.id, getRequirementVersionUnlinkPatch(r)));
       deleteVersion(version.productId, version.id);
       return;
     }
diff --git a/apps/web/lib/requirement-table-layout.test.ts b/apps/web/lib/requirement-table-layout.test.ts
new file mode 100644
index 0000000..a8b251a
--- /dev/null
+++ b/apps/web/lib/requirement-table-layout.test.ts
@@ -0,0 +1,22 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import {
+  REQUIREMENT_TABLE_BADGE_CLASS,
+  getRequirementTableTextClass,
+} from './requirement-table-layout';
+
+test('keeps requirement table badges on one line', () => {
+  assert.match(REQUIREMENT_TABLE_BADGE_CLASS, /\bwhitespace-nowrap\b/);
+  assert.match(REQUIREMENT_TABLE_BADGE_CLASS, /\bshrink-0\b/);
+});
+
+test('clips long requirement source project type and creator cells', () => {
+  for (const column of ['source', 'project', 'type', 'creator'] as const) {
+    const className = getRequirementTableTextClass(column);
+
+    assert.match(className, /\btruncate\b/);
+    assert.match(className, /\bblock\b/);
+    assert.match(className, /\bmax-w-\[/);
+  }
+});
diff --git a/apps/web/lib/requirement-table-layout.ts b/apps/web/lib/requirement-table-layout.ts
new file mode 100644
index 0000000..c42b03d
--- /dev/null
+++ b/apps/web/lib/requirement-table-layout.ts
@@ -0,0 +1,20 @@
+export type RequirementTableTextColumn = 'source' | 'project' | 'type' | 'creator';
+
+const TEXT_COLUMN_MAX_WIDTH: Record<RequirementTableTextColumn, string> = {
+  source: 'max-w-[170px]',
+  project: 'max-w-[120px]',
+  type: 'max-w-[96px]',
+  creator: 'max-w-[96px]',
+};
+
+export const REQUIREMENT_TABLE_NOWRAP_CELL_CLASS = 'px-4 py-3 whitespace-nowrap';
+
+export const REQUIREMENT_TABLE_BADGE_CLASS =
+  'inline-flex h-6 min-w-[3.25rem] shrink-0 items-center justify-center whitespace-nowrap rounded-md px-2 py-0.5 text-[11px] font-medium';
+
+export const REQUIREMENT_TABLE_SMALL_BADGE_CLASS =
+  'inline-flex h-5 min-w-[2.75rem] shrink-0 items-center justify-center whitespace-nowrap rounded-md px-2 py-0.5 text-[10px] font-medium';
+
+export function getRequirementTableTextClass(column: RequirementTableTextColumn): string {
+  return `block truncate ${TEXT_COLUMN_MAX_WIDTH[column]}`;
+}
diff --git a/apps/web/lib/requirement-version-link.test.ts b/apps/web/lib/requirement-version-link.test.ts
new file mode 100644
index 0000000..e38379d
--- /dev/null
+++ b/apps/web/lib/requirement-version-link.test.ts
@@ -0,0 +1,63 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import type { Requirement } from './requirement';
+import {
+  getRequirementVersionSelectionPatch,
+  getRequirementVersionUnlinkPatch,
+} from './requirement-version-link';
+
+function requirement(patch: Partial<Requirement> = {}): Requirement {
+  return {
+    id: 'req-1',
+    code: 'REQ-001',
+    title: 'Requirement',
+    description: '',
+    productId: 'product-1',
+    projectId: 'project-1',
+    versionId: 'version-1',
+    sourceType: 'internal',
+    sourceTarget: '',
+    platforms: [],
+    typeId: 'type-1',
+    status: 'planned',
+    priority: 'P2',
+    effort: 'M',
+    creator: 'tester',
+    createdAt: '2026-07-02T00:00:00.000Z',
+    addedToVersionBy: 'pm',
+    ...patch,
+  };
+}
+
+test('unlinking a version-scoped requirement returns it to adopted', () => {
+  for (const status of ['planned', 'developing', 'testing', 'released'] as const) {
+    assert.deepEqual(getRequirementVersionUnlinkPatch(requirement({ status })), {
+      versionId: undefined,
+      addedToVersionBy: undefined,
+      status: 'adopted',
+    });
+  }
+});
+
+test('unlinking keeps other requirement statuses unchanged', () => {
+  assert.deepEqual(getRequirementVersionUnlinkPatch(requirement({ status: 'adopted' })), {
+    versionId: undefined,
+    addedToVersionBy: undefined,
+  });
+});
+
+test('clearing version from requirement edit uses the same unlink semantics', () => {
+  assert.deepEqual(getRequirementVersionSelectionPatch(requirement(), ''), {
+    versionId: undefined,
+    addedToVersionBy: undefined,
+    status: 'adopted',
+  });
+});
+
+test('selecting a version preserves the current business status', () => {
+  assert.deepEqual(getRequirementVersionSelectionPatch(requirement({ status: 'adopted' }), 'version-2', 'pm2'), {
+    versionId: 'version-2',
+    addedToVersionBy: 'pm2',
+  });
+});
diff --git a/apps/web/lib/requirement-version-link.ts b/apps/web/lib/requirement-version-link.ts
new file mode 100644
index 0000000..de60319
--- /dev/null
+++ b/apps/web/lib/requirement-version-link.ts
@@ -0,0 +1,29 @@
+import type { Requirement } from './requirement';
+
+type RequirementVersionPatch = Pick<Partial<Requirement>, 'versionId' | 'addedToVersionBy' | 'status'>;
+const VERSION_SCOPED_REQUIREMENT_STATUSES = new Set<Requirement['status']>(['planned', 'developing', 'testing', 'released']);
+
+export function getRequirementVersionUnlinkPatch(
+  requirement: Pick<Requirement, 'status'>,
+): RequirementVersionPatch {
+  return {
+    versionId: undefined,
+    addedToVersionBy: undefined,
+    ...(VERSION_SCOPED_REQUIREMENT_STATUSES.has(requirement.status) ? { status: 'adopted' as const } : {}),
+  };
+}
+
+export function getRequirementVersionSelectionPatch(
+  requirement: Pick<Requirement, 'status' | 'addedToVersionBy'>,
+  versionId?: string,
+  addedBy?: string,
+): RequirementVersionPatch {
+  if (!versionId) {
+    return getRequirementVersionUnlinkPatch(requirement);
+  }
+
+  return {
+    versionId,
+    addedToVersionBy: addedBy || requirement.addedToVersionBy,
+  };
+}