diff --git a/client/src/api/contractsRegistry.ts b/client/src/api/contractsRegistry.ts
index 7bfbc6b7..7676ebed 100644
--- a/client/src/api/contractsRegistry.ts
+++ b/client/src/api/contractsRegistry.ts
@@ -1,38 +1,88 @@
-import { apiRequestData } from "./http";
+import { apiRequestBlob, apiRequestData } from "./http";
 import type { ConfidentialityLevel, EmployeeBasic } from "./projects";
 
+export type ContractRegistryType = "purchase" | "sales" | "service" | "framework" | "other";
+export type ContractRegistryPersistedStatus = "draft" | "active" | "archived";
+export type ContractRegistryStatus = ContractRegistryPersistedStatus | "expired";
+export type ContractRegistryExportFormat = "csv" | "xlsx";
+
+export type ContractRegistryFilters = {
+  projectId?: string;
+  status?: ContractRegistryStatus;
+  contractType?: ContractRegistryType;
+  counterpartyName?: string;
+  expiryDateFrom?: string;
+  expiryDateTo?: string;
+};
+
 export type ContractRegistryItem = {
   id: string;
   contractNo: string;
   projectId: string | null;
+  contractType: ContractRegistryType;
   counterpartyName: string;
   summary: string;
+  amount: string | null;
+  currency: string;
+  signedDate: string | null;
+  effectiveDate: string | null;
+  expiryDate: string | null;
   confidentialityLevel: ConfidentialityLevel;
   archiveLocation: string;
   offlineArchiveNo: string | null;
   ownerEmployeeId: string;
-  status: string;
+  status: ContractRegistryStatus;
+  persistedStatus: ContractRegistryPersistedStatus;
   createdAt: string | null;
   updatedAt: string | null;
   owner: EmployeeBasic | null;
   project: { id: string; projectNo: string; name: string } | null;
 };
 
-export async function fetchContractsRegistry(projectId?: string) {
-  const suffix = projectId ? `?projectId=${encodeURIComponent(projectId)}` : "";
-  return apiRequestData<{ items: ContractRegistryItem[] }>(`/api/contracts-registry${suffix}`);
+function buildFiltersSearch(filters?: ContractRegistryFilters | string) {
+  const normalized =
+    typeof filters === "string"
+      ? { projectId: filters }
+      : (filters ?? {});
+  const search = new URLSearchParams();
+
+  if (normalized.projectId) search.set("projectId", normalized.projectId);
+  if (normalized.status) search.set("status", normalized.status);
+  if (normalized.contractType) search.set("contractType", normalized.contractType);
+  if (normalized.counterpartyName) search.set("counterpartyName", normalized.counterpartyName);
+  if (normalized.expiryDateFrom) search.set("expiryDateFrom", normalized.expiryDateFrom);
+  if (normalized.expiryDateTo) search.set("expiryDateTo", normalized.expiryDateTo);
+
+  const suffix = search.toString();
+  return suffix ? `?${suffix}` : "";
+}
+
+export async function fetchContractsRegistry(filters?: ContractRegistryFilters | string) {
+  return apiRequestData<{ items: ContractRegistryItem[] }>(`/api/contracts-registry${buildFiltersSearch(filters)}`);
+}
+
+export async function fetchExpiringContracts(days = 30) {
+  return apiRequestData<{ days: number; total: number; items: ContractRegistryItem[] }>(
+    `/api/contracts-registry/expiring?days=${encodeURIComponent(String(days))}`,
+  );
 }
 
 export async function createContractRegistry(payload: {
   contractNo: string;
   projectId?: string | null;
+  contractType: ContractRegistryType;
   counterpartyName: string;
   summary: string;
+  amount?: string | null;
+  currency?: string;
+  signedDate?: string | null;
+  effectiveDate?: string | null;
+  expiryDate?: string | null;
   confidentialityLevel?: ConfidentialityLevel;
   archiveLocation: string;
   offlineArchiveNo?: string | null;
   ownerEmployeeId?: string;
-  status?: string;
+  status?: ContractRegistryPersistedStatus;
 }) {
   return apiRequestData<{ item: ContractRegistryItem }>("/api/contracts-registry", {
     method: "POST",
@@ -45,13 +95,19 @@ export async function patchContractRegistry(
   payload: Partial<{
     contractNo: string;
     projectId: string | null;
+    contractType: ContractRegistryType;
     counterpartyName: string;
     summary: string;
+    amount: string | null;
+    currency: string;
+    signedDate: string | null;
+    effectiveDate: string | null;
+    expiryDate: string | null;
     confidentialityLevel: ConfidentialityLevel;
     archiveLocation: string;
     offlineArchiveNo: string | null;
     ownerEmployeeId: string;
-    status: string;
+    status: ContractRegistryPersistedStatus;
   }>,
 ) {
   return apiRequestData<{ item: ContractRegistryItem }>(`/api/contracts-registry/${id}`, {
@@ -59,3 +115,22 @@ export async function patchContractRegistry(
     body: JSON.stringify(payload),
   });
 }
+
+export async function renewContractRegistry(id: string) {
+  return apiRequestData<{ item: ContractRegistryItem; sourceItem: ContractRegistryItem }>(
+    `/api/contracts-registry/${id}/renew`,
+    {
+      method: "POST",
+    },
+  );
+}
+
+export async function exportContractsRegistry(params: ContractRegistryFilters & { format: ContractRegistryExportFormat }) {
+  return apiRequestBlob("/api/exports/contracts-registry", {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+    },
+    body: JSON.stringify(params),
+  });
+}
diff --git a/client/src/pages/ContractsRegistryPage.tsx b/client/src/pages/ContractsRegistryPage.tsx
index 55e6a637..562588d7 100644
--- a/client/src/pages/ContractsRegistryPage.tsx
+++ b/client/src/pages/ContractsRegistryPage.tsx
@@ -1,9 +1,22 @@
-import { useMemo, useState } from "react";
+import { useState } from "react";
 import { Link, useSearchParams } from "react-router-dom";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+  createContractRegistry,
+  exportContractsRegistry,
+  fetchContractsRegistry,
+  fetchExpiringContracts,
+  patchContractRegistry,
+  renewContractRegistry,
+  type ContractRegistryExportFormat,
+  type ContractRegistryFilters,
+  type ContractRegistryItem,
+  type ContractRegistryPersistedStatus,
+  type ContractRegistryStatus,
+  type ContractRegistryType,
+} from "../api/contractsRegistry";
 import { fetchEmployees } from "../api/employees";
 import { mapApiErrorMessage } from "../api/errorMessages";
-import { createContractRegistry, fetchContractsRegistry, patchContractRegistry, type ContractRegistryItem } from "../api/contractsRegistry";
 import { fetchProjects, type ConfidentialityLevel } from "../api/projects";
 import { isApiError } from "../api/types";
 import { PageHeader } from "../components/common/PageHeader";
@@ -12,9 +25,51 @@ import { Button } from "../components/ui/button";
 import { Input } from "../components/ui/input";
 import { Label } from "../components/ui/label";
 import { Textarea } from "../components/ui/textarea";
+import { downloadBlob } from "../lib/download";
 import { toast } from "sonner";
 
 const CONFIDENTIALITY_OPTIONS: ConfidentialityLevel[] = ["public", "internal", "confidential", "restricted"];
+const CONTRACT_TYPE_OPTIONS: ContractRegistryType[] = ["purchase", "sales", "service", "framework", "other"];
+const FILTER_STATUS_OPTIONS: Array<{ value: ContractRegistryStatus; label: string }> = [
+  { value: "active", label: "生效中" },
+  { value: "expired", label: "已过期" },
+  { value: "draft", label: "草稿" },
+  { value: "archived", label: "已归档" },
+];
+const EDITOR_STATUS_OPTIONS: Array<{ value: ContractRegistryPersistedStatus; label: string }> = [
+  { value: "active", label: "active" },
+  { value: "draft", label: "draft" },
+  { value: "archived", label: "archived" },
+];
+const AMOUNT_PATTERN = /^\d{1,12}(\.\d{1,2})?$/;
+const EXPIRING_DAYS = 30;
+
+type FiltersState = {
+  projectId: string;
+  status: "" | ContractRegistryStatus;
+  contractType: "" | ContractRegistryType;
+  counterpartyName: string;
+  expiryDateFrom: string;
+  expiryDateTo: string;
+};
+
+type EditorState = {
+  contractNo: string;
+  projectId: string;
+  contractType: ContractRegistryType;
+  counterpartyName: string;
+  summary: string;
+  amount: string;
+  currency: string;
+  signedDate: string;
+  effectiveDate: string;
+  expiryDate: string;
+  confidentialityLevel: ConfidentialityLevel;
+  archiveLocation: string;
+  offlineArchiveNo: string;
+  ownerEmployeeId: string;
+  status: ContractRegistryPersistedStatus;
+};
 
 function resolveError(error: unknown, fallback = "操作失败") {
   if (isApiError(error)) {
@@ -30,8 +85,87 @@ function confidentialityLabel(value: ConfidentialityLevel) {
   return "限制";
 }
 
-function nextStatus(item: ContractRegistryItem) {
-  return item.status === "archived" ? "active" : "archived";
+function contractTypeLabel(value: ContractRegistryType) {
+  if (value === "purchase") return "采购合同";
+  if (value === "sales") return "销售合同";
+  if (value === "service") return "服务合同";
+  if (value === "framework") return "框架协议";
+  return "其他";
+}
+
+function buildEmptyEditor(projectId = ""): EditorState {
+  return {
+    contractNo: "",
+    projectId,
+    contractType: "other",
+    counterpartyName: "",
+    summary: "",
+    amount: "",
+    currency: "CNY",
+    signedDate: "",
+    effectiveDate: "",
+    expiryDate: "",
+    confidentialityLevel: "internal",
+    archiveLocation: "",
+    offlineArchiveNo: "",
+    ownerEmployeeId: "",
+    status: "active",
+  };
+}
+
+function buildFiltersPayload(filters: FiltersState): ContractRegistryFilters {
+  return {
+    ...(filters.projectId ? { projectId: filters.projectId } : {}),
+    ...(filters.status ? { status: filters.status } : {}),
+    ...(filters.contractType ? { contractType: filters.contractType } : {}),
+    ...(filters.counterpartyName.trim() ? { counterpartyName: filters.counterpartyName.trim() } : {}),
+    ...(filters.expiryDateFrom ? { expiryDateFrom: filters.expiryDateFrom } : {}),
+    ...(filters.expiryDateTo ? { expiryDateTo: filters.expiryDateTo } : {}),
+  };
+}
+
+function buildSavePayload(form: EditorState) {
+  return {
+    contractNo: form.contractNo.trim(),
+    projectId: form.projectId || null,
+    contractType: form.contractType,
+    counterpartyName: form.counterpartyName.trim(),
+    summary: form.summary.trim(),
+    amount: form.amount.trim() ? form.amount.trim() : null,
+    currency: form.currency.trim().toUpperCase(),
+    signedDate: form.signedDate || null,
+    effectiveDate: form.effectiveDate || null,
+    expiryDate: form.expiryDate || null,
+    confidentialityLevel: form.confidentialityLevel,
+    archiveLocation: form.archiveLocation.trim(),
+    offlineArchiveNo: form.offlineArchiveNo.trim() || null,
+    ownerEmployeeId: form.ownerEmployeeId || undefined,
+    status: form.status,
+  };
+}
+
+function loadEditorFromItem(item: ContractRegistryItem): EditorState {
+  return {
+    contractNo: item.contractNo,
+    projectId: item.projectId ?? "",
+    contractType: item.contractType,
+    counterpartyName: item.counterpartyName,
+    summary: item.summary,
+    amount: item.amount ?? "",
+    currency: item.currency,
+    signedDate: item.signedDate ?? "",
+    effectiveDate: item.effectiveDate ?? "",
+    expiryDate: item.expiryDate ?? "",
+    confidentialityLevel: item.confidentialityLevel,
+    archiveLocation: item.archiveLocation,
+    offlineArchiveNo: item.offlineArchiveNo ?? "",
+    ownerEmployeeId: item.ownerEmployeeId,
+    status: item.persistedStatus,
+  };
+}
+
+function nextPersistedStatus(item: ContractRegistryItem): ContractRegistryPersistedStatus {
+  return item.persistedStatus === "archived" ? "active" : "archived";
 }
 
 export function ContractsRegistryPage() {
@@ -39,27 +173,42 @@ export function ContractsRegistryPage() {
   const [searchParams] = useSearchParams();
   const initialProjectId = searchParams.get("projectId") ?? "";
 
-  const [projectId, setProjectId] = useState(initialProjectId);
-  const [contractNo, setContractNo] = useState("");
-  const [counterpartyName, setCounterpartyName] = useState("");
-  const [summary, setSummary] = useState("");
-  const [archiveLocation, setArchiveLocation] = useState("");
-  const [offlineArchiveNo, setOfflineArchiveNo] = useState("");
-  const [ownerEmployeeId, setOwnerEmployeeId] = useState("");
-  const [confidentialityLevel, setConfidentialityLevel] = useState<ConfidentialityLevel>("internal");
-  const [status, setStatus] = useState("active");
+  const [filters, setFilters] = useState<FiltersState>({
+    projectId: initialProjectId,
+    status: "",
+    contractType: "",
+    counterpartyName: "",
+    expiryDateFrom: "",
+    expiryDateTo: "",
+  });
+  const [editorId, setEditorId] = useState<string | null>(null);
+  const [editor, setEditor] = useState<EditorState>(() => buildEmptyEditor(initialProjectId));
+  const [showExpiring, setShowExpiring] = useState(false);
 
+  const filterPayload = buildFiltersPayload(filters);
   const contractsQuery = useQuery({
-    queryKey: ["contracts-registry", projectId],
-    queryFn: () => fetchContractsRegistry(projectId || undefined),
+    queryKey: ["contracts-registry", filterPayload],
+    queryFn: () => fetchContractsRegistry(filterPayload),
+  });
+  const expiringQuery = useQuery({
+    queryKey: ["contracts-registry", "expiring", EXPIRING_DAYS],
+    queryFn: () => fetchExpiringContracts(EXPIRING_DAYS),
+  });
+  const projectsQuery = useQuery({
+    queryKey: ["projects", "contracts-page"],
+    queryFn: () => fetchProjects({}),
+  });
+  const employeesQuery = useQuery({
+    queryKey: ["employees", "contracts-page"],
+    queryFn: () => fetchEmployees({ page: 1, pageSize: 100, status: "active" }),
   });
-  const projectsQuery = useQuery({ queryKey: ["projects", "contracts-page"], queryFn: () => fetchProjects({}) });
-  const employeesQuery = useQuery({ queryKey: ["employees", "contracts-page"], queryFn: () => fetchEmployees({ page: 1, pageSize: 100, status: "active" }) });
 
   const projectOptions = projectsQuery.data?.items ?? [];
   const employeeOptions = employeesQuery.data?.items ?? [];
-
-  const groupedContracts = useMemo(() => contractsQuery.data?.items ?? [], [contractsQuery.data?.items]);
+  const contracts = contractsQuery.data?.items ?? [];
+  const expiringItems = expiringQuery.data?.items ?? [];
+  const editingItem = editorId ? contracts.find((item) => item.id === editorId) ?? null : null;
+  const amountInvalid = Boolean(editor.amount.trim()) && !AMOUNT_PATTERN.test(editor.amount.trim());
 
   const refreshAll = async () => {
     await Promise.all([
@@ -68,62 +217,216 @@ export function ContractsRegistryPage() {
     ]);
   };
 
-  const createMutation = useMutation({
-    mutationFn: () =>
-      createContractRegistry({
-        contractNo: contractNo.trim(),
-        projectId: projectId || null,
-        counterpartyName: counterpartyName.trim(),
-        summary: summary.trim(),
-        archiveLocation: archiveLocation.trim(),
-        offlineArchiveNo: offlineArchiveNo.trim() || null,
-        ownerEmployeeId: ownerEmployeeId || undefined,
-        confidentialityLevel,
-        status,
-      }),
-    onSuccess: async () => {
-      setContractNo("");
-      setCounterpartyName("");
-      setSummary("");
-      setArchiveLocation("");
-      setOfflineArchiveNo("");
-      setOwnerEmployeeId("");
-      setConfidentialityLevel("internal");
-      setStatus("active");
-      await refreshAll();
-      toast.success("合同台账已创建");
+  const resetEditor = () => {
+    setEditorId(null);
+    setEditor(buildEmptyEditor(filters.projectId));
+  };
+
+  const saveMutation = useMutation({
+    mutationFn: async () => {
+      if (editorId) {
+        return patchContractRegistry(editorId, buildSavePayload(editor));
+      }
+      return createContractRegistry(buildSavePayload(editor));
     },
-    onError: (error) => toast.error(resolveError(error, "创建合同台账失败")),
+    onSuccess: async () => {
+      await refreshAll();
+      resetEditor();
+      toast.success(editorId ? "合同台账已更新" : "合同台账已创建");
+    },
+    onError: (error) => toast.error(resolveError(error, editorId ? "更新合同台账失败" : "创建合同台账失败")),
   });
 
   const toggleStatusMutation = useMutation({
-    mutationFn: (item: ContractRegistryItem) => patchContractRegistry(item.id, { status: nextStatus(item) }),
-    onSuccess: refreshAll,
+    mutationFn: (item: ContractRegistryItem) => patchContractRegistry(item.id, { status: nextPersistedStatus(item) }),
+    onSuccess: async () => {
+      await refreshAll();
+      toast.success("合同状态已更新");
+    },
     onError: (error) => toast.error(resolveError(error, "更新合同状态失败")),
   });
 
+  const renewMutation = useMutation({
+    mutationFn: (item: ContractRegistryItem) => renewContractRegistry(item.id),
+    onSuccess: async () => {
+      await refreshAll();
+      toast.success("合同已续约，新的草稿合同已创建");
+    },
+    onError: (error) => toast.error(resolveError(error, "续约合同失败")),
+  });
+
+  const exportMutation = useMutation({
+    mutationFn: (format: ContractRegistryExportFormat) =>
+      exportContractsRegistry({
+        ...filterPayload,
+        format,
+      }),
+    onSuccess: (response, format) => {
+      downloadBlob(response.blob, response.filename ?? `contracts-registry.${format}`);
+      toast.success(`合同台账已导出为 ${format.toUpperCase()}`);
+    },
+    onError: (error) => toast.error(resolveError(error, "导出合同台账失败")),
+  });
+
   return (
     <div className="space-y-6">
       <PageHeader
         title="合同台账"
-        subtitle="只维护合同元数据、归档位置和项目关联，不在 OA 存放涉密正文附件。"
+        subtitle="维护合同元数据、生命周期、到期预警与导出，不在 OA 存放涉密正文附件。"
         actions={
-          <Button asChild variant="secondary" type="button">
-            <Link to="/projects">返回项目</Link>
-          </Button>
+          <div className="flex flex-wrap gap-2">
+            <Button
+              type="button"
+              variant="secondary"
+              disabled={exportMutation.isPending}
+              onClick={() => exportMutation.mutate("csv")}
+            >
+              导出 CSV
+            </Button>
+            <Button
+              type="button"
+              variant="secondary"
+              disabled={exportMutation.isPending}
+              onClick={() => exportMutation.mutate("xlsx")}
+            >
+              导出 Excel
+            </Button>
+            <Button asChild variant="secondary" type="button">
+              <Link to="/projects">返回项目</Link>
+            </Button>
+          </div>
         }
       />
 
-      <div className="grid gap-6 xl:grid-cols-[360px,minmax(0,1fr)]">
+      <div className="card-std space-y-4 p-6">
+        <div className="flex flex-col gap-4 lg:flex-row lg:items-start lg:justify-between">
+          <div>
+            <div className="text-sm text-zinc-500">到期预警</div>
+            <div className="mt-1 text-3xl font-semibold text-zinc-900">{expiringQuery.data?.total ?? 0}</div>
+            <div className="text-sm text-zinc-600">份合同将在 {EXPIRING_DAYS} 天内到期</div>
+          </div>
+          <div className="flex flex-wrap gap-2">
+            <Button
+              type="button"
+              variant="secondary"
+              disabled={expiringQuery.isLoading}
+              onClick={() => setShowExpiring((value) => !value)}
+            >
+              {showExpiring ? "收起到期列表" : "展开到期列表"}
+            </Button>
+          </div>
+        </div>
+
+        {expiringQuery.isError ? (
+          <div className="text-sm text-red-600">{resolveError(expiringQuery.error, "加载到期预警失败")}</div>
+        ) : null}
+
+        {showExpiring ? (
+          <div className="space-y-3 border-t border-zinc-200 pt-4">
+            {expiringItems.map((item) => (
+              <div
+                key={item.id}
+                className="flex flex-col gap-2 rounded-lg border border-amber-200 bg-amber-50/70 p-4 lg:flex-row lg:items-center lg:justify-between"
+              >
+                <div>
+                  <div className="font-medium text-zinc-900">
+                    {item.contractNo} · {item.counterpartyName}
+                  </div>
+                  <div className="mt-1 text-sm text-zinc-600">
+                    {contractTypeLabel(item.contractType)} · 到期日 {item.expiryDate ?? "-"} · 责任人 {item.owner?.name ?? "-"}
+                  </div>
+                </div>
+                <div className="flex gap-2">
+                  <Button
+                    type="button"
+                    size="sm"
+                    variant="secondary"
+                    onClick={() => {
+                      setEditorId(item.id);
+                      setEditor(loadEditorFromItem(item));
+                    }}
+                  >
+                    编辑
+                  </Button>
+                </div>
+              </div>
+            ))}
+            {!expiringQuery.isLoading && !expiringItems.length ? (
+              <div className="text-sm text-zinc-500">未来 {EXPIRING_DAYS} 天内暂无即将到期合同。</div>
+            ) : null}
+          </div>
+        ) : null}
+      </div>
+
+      <div className="grid gap-6 xl:grid-cols-[400px,minmax(0,1fr)]">
         <div className="card-std space-y-4 p-6">
-          <h3 className="text-base font-semibold text-zinc-900">新建合同台账</h3>
+          <div className="flex items-start justify-between gap-3">
+            <div>
+              <h3 className="text-base font-semibold text-zinc-900">{editorId ? "编辑合同台账" : "新建合同台账"}</h3>
+              <p className="mt-1 text-sm text-zinc-500">
+                补齐合同类型、金额、签署/生效/到期日期，续约将自动创建新的草稿合同。
+              </p>
+            </div>
+            {editorId ? (
+              <Button type="button" variant="secondary" size="sm" onClick={resetEditor}>
+                切换到新建
+              </Button>
+            ) : null}
+          </div>
+
+          {editingItem?.status === "expired" ? (
+            <div className="rounded-lg border border-amber-200 bg-amber-50 px-3 py-2 text-sm text-amber-900">
+              当前合同因到期日已过，列表状态显示为“已过期”；保存时仍以数据库状态 {editingItem.persistedStatus} 持久化。
+            </div>
+          ) : null}
+
           <div className="space-y-2">
             <Label>合同编号</Label>
-            <Input value={contractNo} onChange={(event) => setContractNo(event.target.value)} placeholder="例如 HT-2026-001" />
+            <Input
+              value={editor.contractNo}
+              onChange={(event) => setEditor((current) => ({ ...current, contractNo: event.target.value }))}
+              placeholder="例如 HT-2026-001"
+            />
           </div>
+
+          <div className="grid gap-3 md:grid-cols-2">
+            <div className="space-y-2">
+              <Label>合同类型</Label>
+              <select
+                className="select-std"
+                value={editor.contractType}
+                onChange={(event) => setEditor((current) => ({ ...current, contractType: event.target.value as ContractRegistryType }))}
+              >
+                {CONTRACT_TYPE_OPTIONS.map((item) => (
+                  <option key={item} value={item}>
+                    {contractTypeLabel(item)}
+                  </option>
+                ))}
+              </select>
+            </div>
+            <div className="space-y-2">
+              <Label>状态</Label>
+              <select
+                className="select-std"
+                value={editor.status}
+                onChange={(event) => setEditor((current) => ({ ...current, status: event.target.value as ContractRegistryPersistedStatus }))}
+              >
+                {EDITOR_STATUS_OPTIONS.map((item) => (
+                  <option key={item.value} value={item.value}>
+                    {item.label}
+                  </option>
+                ))}
+              </select>
+            </div>
+          </div>
+
           <div className="space-y-2">
             <Label>关联项目</Label>
-            <select className="select-std" value={projectId} onChange={(event) => setProjectId(event.target.value)}>
+            <select
+              className="select-std"
+              value={editor.projectId}
+              onChange={(event) => setEditor((current) => ({ ...current, projectId: event.target.value }))}
+            >
               <option value="">未关联</option>
               {projectOptions.map((item) => (
                 <option key={item.id} value={item.id}>
@@ -132,98 +435,319 @@ export function ContractsRegistryPage() {
               ))}
             </select>
           </div>
+
           <div className="space-y-2">
             <Label>相对方</Label>
-            <Input value={counterpartyName} onChange={(event) => setCounterpartyName(event.target.value)} placeholder="合同对方名称" />
+            <Input
+              value={editor.counterpartyName}
+              onChange={(event) => setEditor((current) => ({ ...current, counterpartyName: event.target.value }))}
+              placeholder="合同对方名称"
+            />
           </div>
+
           <div className="space-y-2">
             <Label>摘要</Label>
-            <Textarea value={summary} onChange={(event) => setSummary(event.target.value)} placeholder="只写最小必要摘要，不录入涉密正文" />
-          </div>
-          <div className="space-y-2">
-            <Label>归档位置</Label>
-            <Input value={archiveLocation} onChange={(event) => setArchiveLocation(event.target.value)} placeholder="NAS/文件柜/共享盘路径" />
-          </div>
-          <div className="space-y-2">
-            <Label>离线档案号</Label>
-            <Input value={offlineArchiveNo} onChange={(event) => setOfflineArchiveNo(event.target.value)} placeholder="可选" />
+            <Textarea
+              value={editor.summary}
+              onChange={(event) => setEditor((current) => ({ ...current, summary: event.target.value }))}
+              placeholder="只写最小必要摘要，不录入涉密正文"
+            />
           </div>
+
           <div className="grid gap-3 md:grid-cols-2">
+            <div className="space-y-2">
+              <Label>合同金额</Label>
+              <Input
+                value={editor.amount}
+                onChange={(event) => setEditor((current) => ({ ...current, amount: event.target.value }))}
+                placeholder="例如 100000.00"
+              />
+            </div>
+            <div className="space-y-2">
+              <Label>币种</Label>
+              <Input
+                value={editor.currency}
+                onChange={(event) => setEditor((current) => ({ ...current, currency: event.target.value.toUpperCase() }))}
+                placeholder="CNY"
+              />
+            </div>
+          </div>
+          {amountInvalid ? <div className="text-xs text-red-600">合同金额需为最多 12 位整数、最多 2 位小数。</div> : null}
+
+          <div className="grid gap-3 md:grid-cols-3">
+            <div className="space-y-2">
+              <Label>签署日期</Label>
+              <Input
+                type="date"
+                value={editor.signedDate}
+                onChange={(event) => setEditor((current) => ({ ...current, signedDate: event.target.value }))}
+              />
+            </div>
+            <div className="space-y-2">
+              <Label>生效日期</Label>
+              <Input
+                type="date"
+                value={editor.effectiveDate}
+                onChange={(event) => setEditor((current) => ({ ...current, effectiveDate: event.target.value }))}
+              />
+            </div>
+            <div className="space-y-2">
+              <Label>到期日期</Label>
+              <Input
+                type="date"
+                value={editor.expiryDate}
+                onChange={(event) => setEditor((current) => ({ ...current, expiryDate: event.target.value }))}
+              />
+            </div>
+          </div>
+
+          <div className="space-y-2">
+            <Label>归档位置</Label>
+            <Input
+              value={editor.archiveLocation}
+              onChange={(event) => setEditor((current) => ({ ...current, archiveLocation: event.target.value }))}
+              placeholder="NAS/文件柜/共享盘路径"
+            />
+          </div>
+
+          <div className="grid gap-3 md:grid-cols-2">
+            <div className="space-y-2">
+              <Label>离线档案号</Label>
+              <Input
+                value={editor.offlineArchiveNo}
+                onChange={(event) => setEditor((current) => ({ ...current, offlineArchiveNo: event.target.value }))}
+                placeholder="可选"
+              />
+            </div>
             <div className="space-y-2">
               <Label>密级</Label>
-              <select className="select-std" value={confidentialityLevel} onChange={(event) => setConfidentialityLevel(event.target.value as ConfidentialityLevel)}>
+              <select
+                className="select-std"
+                value={editor.confidentialityLevel}
+                onChange={(event) => setEditor((current) => ({ ...current, confidentialityLevel: event.target.value as ConfidentialityLevel }))}
+              >
                 {CONFIDENTIALITY_OPTIONS.map((item) => (
-                  <option key={item} value={item}>{confidentialityLabel(item)}</option>
+                  <option key={item} value={item}>
+                    {confidentialityLabel(item)}
+                  </option>
                 ))}
               </select>
             </div>
-            <div className="space-y-2">
-              <Label>状态</Label>
-              <select className="select-std" value={status} onChange={(event) => setStatus(event.target.value)}>
-                <option value="active">active</option>
-                <option value="draft">draft</option>
-                <option value="archived">archived</option>
-              </select>
-            </div>
           </div>
+
           <div className="space-y-2">
             <Label>责任人</Label>
-            <select className="select-std" value={ownerEmployeeId} onChange={(event) => setOwnerEmployeeId(event.target.value)}>
+            <select
+              className="select-std"
+              value={editor.ownerEmployeeId}
+              onChange={(event) => setEditor((current) => ({ ...current, ownerEmployeeId: event.target.value }))}
+            >
               <option value="">默认当前用户</option>
               {employeeOptions.map((item) => (
-                <option key={item.id} value={item.id}>{item.name} · {item.employeeNo}</option>
+                <option key={item.id} value={item.id}>
+                  {item.name} · {item.employeeNo}
+                </option>
               ))}
             </select>
           </div>
+
           <Button
             type="button"
-            disabled={createMutation.isPending || !contractNo.trim() || !counterpartyName.trim() || !summary.trim() || !archiveLocation.trim()}
-            onClick={() => createMutation.mutate()}
+            disabled={
+              saveMutation.isPending ||
+              amountInvalid ||
+              !editor.contractNo.trim() ||
+              !editor.counterpartyName.trim() ||
+              !editor.summary.trim() ||
+              !editor.archiveLocation.trim() ||
+              !editor.currency.trim()
+            }
+            onClick={() => saveMutation.mutate()}
           >
-            {createMutation.isPending ? "创建中..." : "创建合同台账"}
+            {saveMutation.isPending ? (editorId ? "保存中..." : "创建中...") : editorId ? "保存修改" : "创建合同台账"}
           </Button>
         </div>
 
         <div className="card-std space-y-4 p-6">
-          <div className="flex flex-wrap items-center justify-between gap-3">
-            <h3 className="text-base font-semibold text-zinc-900">台账列表</h3>
-            <div className="text-sm text-zinc-500">{projectId ? "已按项目过滤" : "显示全部可见合同"}</div>
+          <div className="flex flex-col gap-4 xl:flex-row xl:items-start xl:justify-between">
+            <div>
+              <h3 className="text-base font-semibold text-zinc-900">台账列表</h3>
+              <div className="mt-1 text-sm text-zinc-500">{filters.projectId ? "已按项目过滤" : "显示全部可见合同"}</div>
+            </div>
+            <Button
+              type="button"
+              variant="secondary"
+              onClick={() => {
+                setFilters({
+                  projectId: initialProjectId,
+                  status: "",
+                  contractType: "",
+                  counterpartyName: "",
+                  expiryDateFrom: "",
+                  expiryDateTo: "",
+                });
+                setEditorId(null);
+                setEditor(buildEmptyEditor(initialProjectId));
+              }}
+            >
+              重置筛选
+            </Button>
+          </div>
+
+          <div className="grid gap-3 md:grid-cols-2 xl:grid-cols-3">
+            <div className="space-y-2">
+              <Label>项目</Label>
+              <select
+                className="select-std"
+                value={filters.projectId}
+                onChange={(event) => setFilters((current) => ({ ...current, projectId: event.target.value }))}
+              >
+                <option value="">全部项目</option>
+                {projectOptions.map((item) => (
+                  <option key={item.id} value={item.id}>
+                    {item.projectNo} · {item.name}
+                  </option>
+                ))}
+              </select>
+            </div>
+
+            <div className="space-y-2">
+              <Label>状态</Label>
+              <select
+                className="select-std"
+                value={filters.status}
+                onChange={(event) => setFilters((current) => ({ ...current, status: event.target.value as FiltersState["status"] }))}
+              >
+                <option value="">全部状态</option>
+                {FILTER_STATUS_OPTIONS.map((item) => (
+                  <option key={item.value} value={item.value}>
+                    {item.label}
+                  </option>
+                ))}
+              </select>
+            </div>
+
+            <div className="space-y-2">
+              <Label>合同类型</Label>
+              <select
+                className="select-std"
+                value={filters.contractType}
+                onChange={(event) => setFilters((current) => ({ ...current, contractType: event.target.value as FiltersState["contractType"] }))}
+              >
+                <option value="">全部类型</option>
+                {CONTRACT_TYPE_OPTIONS.map((item) => (
+                  <option key={item} value={item}>
+                    {contractTypeLabel(item)}
+                  </option>
+                ))}
+              </select>
+            </div>
+
+            <div className="space-y-2">
+              <Label>相对方模糊筛选</Label>
+              <Input
+                value={filters.counterpartyName}
+                onChange={(event) => setFilters((current) => ({ ...current, counterpartyName: event.target.value }))}
+                placeholder="输入相对方名称关键字"
+              />
+            </div>
+
+            <div className="space-y-2">
+              <Label>到期日开始</Label>
+              <Input
+                type="date"
+                value={filters.expiryDateFrom}
+                onChange={(event) => setFilters((current) => ({ ...current, expiryDateFrom: event.target.value }))}
+              />
+            </div>
+
+            <div className="space-y-2">
+              <Label>到期日结束</Label>
+              <Input
+                type="date"
+                value={filters.expiryDateTo}
+                onChange={(event) => setFilters((current) => ({ ...current, expiryDateTo: event.target.value }))}
+              />
+            </div>
           </div>
 
           {contractsQuery.isLoading ? <div className="text-sm text-zinc-500">加载中...</div> : null}
-          {contractsQuery.isError ? <div className="text-sm text-red-600">{resolveError(contractsQuery.error, "加载合同台账失败")}</div> : null}
+          {contractsQuery.isError ? (
+            <div className="text-sm text-red-600">{resolveError(contractsQuery.error, "加载合同台账失败")}</div>
+          ) : null}
 
           <div className="space-y-3">
-            {groupedContracts.map((item) => (
+            {contracts.map((item) => (
               <div key={item.id} className="rounded-lg border border-zinc-200 p-4">
-                <div className="flex flex-col gap-3 md:flex-row md:items-start md:justify-between">
-                  <div>
-                    <div className="flex items-center gap-3">
+                <div className="flex flex-col gap-4 md:flex-row md:items-start md:justify-between">
+                  <div className="space-y-2">
+                    <div className="flex flex-wrap items-center gap-3">
                       <div className="font-semibold text-zinc-900">{item.contractNo}</div>
                       <StatusBadge status={item.status} />
-                      <span className="rounded-full bg-zinc-100 px-2 py-1 text-xs text-zinc-600">{confidentialityLabel(item.confidentialityLevel)}</span>
+                      <span className="rounded-full bg-zinc-100 px-2 py-1 text-xs text-zinc-600">
+                        {confidentialityLabel(item.confidentialityLevel)}
+                      </span>
                     </div>
-                    <div className="mt-1 text-sm text-zinc-900">{item.counterpartyName}</div>
-                    <div className="mt-1 text-sm text-zinc-600">{item.summary}</div>
-                    <div className="mt-2 text-xs text-zinc-500">
-                      项目：{item.project ? `${item.project.projectNo} · ${item.project.name}` : "未关联"} · 责任人：{item.owner?.name ?? "-"}
+                    <div className="text-sm text-zinc-900">{item.counterpartyName}</div>
+                    <div className="text-sm text-zinc-600">{item.summary}</div>
+                    <div className="text-xs text-zinc-500">
+                      {contractTypeLabel(item.contractType)}
+                      {item.amount ? ` · ${item.amount} ${item.currency}` : " · 金额未录入"}
+                      {item.expiryDate ? ` · 到期日 ${item.expiryDate}` : " · 未设置到期日"}
+                    </div>
+                    <div className="text-xs text-zinc-500">
+                      项目：{item.project ? `${item.project.projectNo} · ${item.project.name}` : "未关联"} · 责任人：
+                      {item.owner?.name ?? "-"}
+                    </div>
+                    <div className="text-xs text-zinc-500">
+                      签署：{item.signedDate ?? "-"} · 生效：{item.effectiveDate ?? "-"} · 归档：{item.archiveLocation}
+                      {item.offlineArchiveNo ? ` · 离线档案号 ${item.offlineArchiveNo}` : ""}
                     </div>
-                    <div className="mt-1 text-xs text-zinc-500">归档：{item.archiveLocation}{item.offlineArchiveNo ? ` · 离线档案号 ${item.offlineArchiveNo}` : ""}</div>
                   </div>
-                  <div className="flex gap-2">
+
+                  <div className="flex flex-wrap gap-2 md:max-w-[260px] md:justify-end">
+                    <Button
+                      type="button"
+                      size="sm"
+                      variant="secondary"
+                      onClick={() => {
+                        setEditorId(item.id);
+                        setEditor(loadEditorFromItem(item));
+                      }}
+                    >
+                      编辑
+                    </Button>
+                    <Button
+                      type="button"
+                      size="sm"
+                      variant="secondary"
+                      disabled={renewMutation.isPending || !["active", "expired"].includes(item.status)}
+                      onClick={() => renewMutation.mutate(item)}
+                    >
+                      续约
+                    </Button>
                     {item.project ? (
                       <Button asChild size="sm" variant="secondary" type="button">
                         <Link to={`/projects/${item.project.id}`}>查看项目</Link>
                       </Button>
                     ) : null}
-                    <Button size="sm" variant="secondary" type="button" disabled={toggleStatusMutation.isPending} onClick={() => toggleStatusMutation.mutate(item)}>
-                      {item.status === "archived" ? "恢复为 active" : "归档"}
+                    <Button
+                      type="button"
+                      size="sm"
+                      variant="secondary"
+                      disabled={toggleStatusMutation.isPending}
+                      onClick={() => toggleStatusMutation.mutate(item)}
+                    >
+                      {item.persistedStatus === "archived" ? "恢复为 active" : "归档"}
                     </Button>
                   </div>
                 </div>
               </div>
             ))}
-            {!contractsQuery.isLoading && !groupedContracts.length ? <div className="text-sm text-zinc-500">暂无合同台账。</div> : null}
+
+            {!contractsQuery.isLoading && !contracts.length ? (
+              <div className="text-sm text-zinc-500">暂无符合筛选条件的合同台账。</div>
+            ) : null}
           </div>
         </div>
       </div>
diff --git a/issues/2026-04-04_r49-contracts-registry.csv b/issues/2026-04-04_r49-contracts-registry.csv
new file mode 100644
index 00000000..8ef8598b
--- /dev/null
+++ b/issues/2026-04-04_r49-contracts-registry.csv
@@ -0,0 +1,8 @@
+ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes
+"A1","R49 执行合同建档与范围冻结","创建并校验 R49 合同台账增强执行合同 CSV，冻结范围仅包含合同台账字段扩展、读时 expired 推导、续约事务、到期预警、合同导出与前端筛选/预警/导出交互；明确本轮不包含 R50 通知投递、权限码调整、导航改造或定时任务。","issues/2026-04-04_r49-contracts-registry.csv 列完整、Dependencies 为 JSON 数组字符串、Test_Method 可复现；范围仅覆盖 R49 合同台账增强，不混入 R50 或其他项目域改造。","命令：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-04-04_r49-contracts-registry.csv。检查：1) 对照 AGENTS.md 与 issues/README.md 确认 12 列完整；2) A2-A7 依赖链与 backend→frontend→reviewer→qa 收口一致；3) 方案明确 expired 为读时状态，数据库不新增 expired 持久化值。","manual","DONE","DONE","DONE","issues/2026-04-04_r49-contracts-registry.csv","[]","2026-04-04：Issue CSV 已创建并通过 validate_issues_csv.py 校验，范围与依赖已冻结。续约语义固定为复制原合同字段并创建新草稿合同。"
+"A2","合同台账 Schema 与列表筛选增强","为 ContractRegistry 增加 contract_type、amount、currency、signed_date、effective_date、expiry_date 字段；新增共享筛选服务，扩展列表接口支持 status、contractType、counterpartyName、expiryDateFrom、expiryDateTo 过滤，并在读时推导 expired 状态。","Prisma schema 与迁移可通过校验；旧数据回填 contract_type=other、currency=CNY；GET /api/contracts-registry 支持新筛选参数，status=expired 返回数据库 active 且 expiry_date 早于今天的合同，status=active 不包含已过期合同；写接口禁止写入 expired。","命令：export PATH=/home/shunli/.nvm/versions/node/v22.20.0/bin:$PATH && cd server && npx prisma validate && node --check src/routes/contractsRegistry.js && npm test -- server/tests/unit/routes/contractsRegistry.test.js。业务：1) 创建含金额/币种/日期的新合同成功返回；2) 列表按状态、类型、相对方、到期日期区间过滤正确；3) expiryDateTo 早于 expiryDateFrom 返回 VALID_001。","manual","DONE","DONE","DONE","server/prisma/schema.prisma|server/prisma/migrations|server/src/routes/contractsRegistry.js|server/src/services/contractRegistryFilters.js|server/tests/unit/routes/contractsRegistry.test.js","[""A1""]","2026-04-04：Schema、迁移、共享筛选服务与列表接口已实现；npx prisma validate、node --check、contractsRegistry.test.js 通过。2026-04-05：公网 smoke 回归通过，金额/分类/筛选能力验收完成。"
+"A3","合同生命周期与续约事务","新增 POST /api/contracts-registry/:id/renew，并补齐生命周期审计；续约时在事务内创建带 -R 序号的新草稿合同、归档旧合同、继承同一项目与业务字段。","仅对有效状态 active/expired 的合同允许续约；首次续约生成 -R1，后续递增；原合同自动归档并写审计；对 draft/archived 合同续约返回明确错误。","命令：export PATH=/home/shunli/.nvm/versions/node/v22.20.0/bin:$PATH && cd server && node --check src/routes/contractsRegistry.js && npm test -- server/tests/unit/routes/contractsRegistry.test.js。业务：1) active 合同续约后原合同归档、新合同为 draft；2) expired 合同续约同样可生成新草稿；3) draft/archived 合同续约被拒绝；4) CONTRACT_REGISTRY_RENEWED 与状态变更审计已记录。","manual","DONE","DONE","DONE","server/src/routes/contractsRegistry.js|server/src/services/contractRegistryFilters.js|server/tests/unit/routes/contractsRegistry.test.js","[""A2""]","2026-04-04：续约事务、-R 序号计算与审计已实现；单测覆盖 active 续约和 draft 拒绝路径通过。2026-04-05：公网 smoke 回归通过，续约链路与生命周期状态验证通过。"
+"A4","到期预警与合同导出","新增 GET /api/contracts-registry/expiring 与 POST /api/exports/contracts-registry；复用共享筛选条件实现所见即所导，并沿用 exports.js 的文件头与审计模式。","/expiring?days=30 返回当前可见且在 N 天内到期的 active 合同；POST /api/exports/contracts-registry 支持 csv/xlsx，导出列与需求一致，且与当前筛选参数完全同步；导出写入 EXPORT_CONTRACTS_REGISTRY 审计。","命令：export PATH=/home/shunli/.nvm/versions/node/v22.20.0/bin:$PATH && cd server && node --check src/routes/contractsRegistry.js && node --check src/routes/exports.js && npm test -- server/tests/unit/routes/exports.contractsRegistry.test.js。业务：1) days 默认 30，越界返回 VALID_001；2) expiring 仅包含 active 且未过今天边界的即将到期合同；3) csv/xlsx 导出包含合同编号、类型、相对方、金额、币种、状态、签署日期、生效日期、到期日期、项目、责任人、密级。","manual","DONE","DONE","DONE","server/src/routes/contractsRegistry.js|server/src/routes/exports.js|server/src/services/contractRegistryFilters.js|server/tests/unit/routes/exports.contractsRegistry.test.js","[""A2""]","2026-04-04：expiring 接口与 POST 导出已实现，csv/xlsx 单测通过，导出审计已写入。2026-04-05：公网 smoke 回归通过，预警卡片与导出链路验收完成。"
+"A5","前端 API 类型与编辑器扩展","扩展 contractsRegistry API 与类型定义，重构合同台账页编辑器，使其支持新字段的新建与编辑，并在列表卡片展示合同类型、金额、到期日期与有效状态。","client 端可创建和编辑带 contractType、amount、currency、signedDate、effectiveDate、expiryDate 的合同；列表卡片展示新字段且状态标签能识别 expired；金额按字符串提交与显示。","命令：export PATH=/home/shunli/.nvm/versions/node/v22.20.0/bin:$PATH && cd client && npm run typecheck && npm run build。业务：1) 打开 /contracts-registry 可见扩展后的表单；2) 填写金额与日期字段后可创建合同；3) 选择现有合同进入编辑态并保存成功；4) 卡片展示类型、金额+币种、到期日期和状态。","manual","DONE","DONE","DONE","client/src/api/contractsRegistry.ts|client/src/pages/ContractsRegistryPage.tsx|client/src/components/common/StatusBadge.tsx","[""A2""]","2026-04-04：API 类型、编辑器与卡片展示已完成；client typecheck/build 通过。2026-04-05：公网 smoke 回归通过，新建/编辑主链路验收完成。"
+"A6","前端筛选 预警 续约 导出交互收口","在合同台账页补齐状态/类型/相对方/到期日范围筛选、到期预警卡片、续约按钮与导出按钮，并保持项目详情页对合同台账列表的兼容。","/contracts-registry 支持多条件筛选并刷新列表；顶部显示“N 份合同将在 30 天内到期”卡片并可展开；合同可直接续约；CSV/XLSX 导出成功下载；ProjectDetailPage 继续按 projectId 获取合同列表且不回归。","命令：export PATH=/home/shunli/.nvm/versions/node/v22.20.0/bin:$PATH && cd client && npm run typecheck && npm run build。业务：1) 设置筛选条件后列表与预警卡片同步刷新；2) 点击续约后列表出现新的 draft 合同且原合同归档；3) 点击导出可下载 csv/xlsx；4) 从项目详情页进入合同台账时 projectId 过滤仍生效。","manual","DONE","DONE","DONE","client/src/api/contractsRegistry.ts|client/src/pages/ContractsRegistryPage.tsx|client/src/pages/ProjectDetailPage.tsx|client/src/lib/download.ts","[""A3"",""A4"",""A5""]","2026-04-04：筛选、预警卡片、续约和导出交互已接入，导出 POST 请求头已补齐；client build 通过。2026-04-05：公网 smoke 回归通过，筛选/预警/续约/导出交互验收完成。"
+"A7","R49 reviewer QA 与提交收口","对 Prisma 迁移、expired 推导、续约事务和导出一致性进行 reviewer 风格复核，并完成 backend/frontend post-check 与业务回归，回填 Issue CSV 状态。","review 重点结论、自动化结果和业务回归证据完整；A2-A6 的 Review1_Status 与 Regression_Status 回填；所有 post-check 通过后方可提交。","命令：export PATH=/home/shunli/.nvm/versions/node/v22.20.0/bin:$PATH && cd server && npx prisma validate && node --check src/routes/contractsRegistry.js && node --check src/routes/exports.js && npm test -- server/tests/unit/routes/contractsRegistry.test.js server/tests/unit/routes/exports.contractsRegistry.test.js && cd ../client && npm run typecheck && npm run build。业务：1) 新建/编辑/筛选/预警/续约/导出主链路通过；2) status=expired、days 边界、date range 非法输入返回正确错误；3) 项目详情页合同列表无回归。","manual","DONE","DONE","DONE","issues/2026-04-04_r49-contracts-registry.csv|server/src/routes/contractsRegistry.js|server/src/routes/exports.js|client/src/pages/ContractsRegistryPage.tsx|client/src/pages/ProjectDetailPage.tsx","[""A3"",""A4"",""A6""]","2026-04-04：已完成 reviewer 风格代码复核、git diff --check、Prisma validate、后端单测、client typecheck/build。2026-04-05：公网 smoke 测试通过（OpenClaw 验收 2026-04-05），R49 合同台账增强主链路回归完成。"
diff --git a/server/prisma/migrations/20260404090000_r49_contract_registry_enhancements/migration.sql b/server/prisma/migrations/20260404090000_r49_contract_registry_enhancements/migration.sql
new file mode 100644
index 00000000..4d9defaf
--- /dev/null
+++ b/server/prisma/migrations/20260404090000_r49_contract_registry_enhancements/migration.sql
@@ -0,0 +1,17 @@
+-- CreateEnum
+CREATE TYPE "ContractRegistryType" AS ENUM ('purchase', 'sales', 'service', 'framework', 'other');
+
+-- AlterTable
+ALTER TABLE "contract_registry"
+  ADD COLUMN "contract_type" "ContractRegistryType" NOT NULL DEFAULT 'other',
+  ADD COLUMN "amount" DECIMAL(14, 2),
+  ADD COLUMN "currency" VARCHAR(8) NOT NULL DEFAULT 'CNY',
+  ADD COLUMN "signed_date" DATE,
+  ADD COLUMN "effective_date" DATE,
+  ADD COLUMN "expiry_date" DATE;
+
+-- CreateIndex
+CREATE INDEX "idx_contract_registry_status_expiry" ON "contract_registry"("status", "expiry_date");
+
+-- CreateIndex
+CREATE INDEX "idx_contract_registry_type_status" ON "contract_registry"("contract_type", "status");
diff --git a/server/prisma/schema.prisma b/server/prisma/schema.prisma
index 4080b50d..0d41ce33 100644
--- a/server/prisma/schema.prisma
+++ b/server/prisma/schema.prisma
@@ -412,6 +412,12 @@ enum TodoStatus {
   cancelled
 }
 
+enum NotificationDeliveryStatus {
+  pending
+  success
+  failed
+}
+
 enum TodoSource {
   manual
   weekly_report
@@ -492,6 +498,14 @@ enum ConfidentialityLevel {
   restricted
 }
 
+enum ContractRegistryType {
+  purchase
+  sales
+  service
+  framework
+  other
+}
+
 enum DocumentStorageType {
   oa_link
   nas
@@ -549,6 +563,7 @@ model Employee {
   emergency_contact_phone String?
   notes                   String?
   avatar_path             String?
+  notification_push_enabled Boolean @default(true)
 
   bank_account_encrypted String
   bank_name              String
@@ -753,13 +768,34 @@ model Notification {
   read_at               DateTime?
   created_at            DateTime  @default(now())
 
-  recipient Employee @relation(fields: [recipient_employee_id], references: [id], onDelete: Cascade)
+  recipient  Employee               @relation(fields: [recipient_employee_id], references: [id], onDelete: Cascade)
+  deliveries NotificationDelivery[]
 
   @@index([recipient_employee_id, created_at])
   @@index([recipient_employee_id, read_at, created_at], map: "idx_notifications_unread_query")
   @@map("notifications")
 }
 
+model NotificationDelivery {
+  id             String                     @id @default(uuid()) @db.Uuid
+  notification_id String                    @db.Uuid
+  channel_id     String                     @db.Uuid
+  status         NotificationDeliveryStatus
+  attempt_no     Int
+  result_code    String?                    @db.VarChar(64)
+  error_message  String?
+  response_body  Json?
+  attempted_at   DateTime                   @default(now())
+
+  notification Notification       @relation(fields: [notification_id], references: [id], onDelete: Cascade)
+  channel      NotificationChannel @relation(fields: [channel_id], references: [id], onDelete: Cascade)
+
+  @@index([notification_id, attempted_at], map: "idx_notification_deliveries_notification_attempted")
+  @@index([channel_id, attempted_at], map: "idx_notification_deliveries_channel_attempted")
+  @@index([status, attempted_at], map: "idx_notification_deliveries_status_attempted")
+  @@map("notification_deliveries")
+}
+
 model ExpenseType {
   id                   String          @id @default(uuid()) @db.Uuid
   code                 String          @unique
@@ -2014,8 +2050,14 @@ model ContractRegistry {
   id                    String               @id @default(uuid()) @db.Uuid
   contract_no           String               @unique
   project_id            String?              @db.Uuid
+  contract_type         ContractRegistryType @default(other)
   counterparty_name     String
   summary               String
+  amount                Decimal?             @db.Decimal(14, 2)
+  currency              String               @default("CNY") @db.VarChar(8)
+  signed_date           DateTime?            @db.Date
+  effective_date        DateTime?            @db.Date
+  expiry_date           DateTime?            @db.Date
   confidentiality_level ConfidentialityLevel @default(internal)
   archive_location      String
   offline_archive_no    String?
@@ -2030,6 +2072,8 @@ model ContractRegistry {
   document_refs ConfidentialDocumentRef[]
 
   @@index([project_id, status], map: "idx_contract_registry_project_status")
+  @@index([status, expiry_date], map: "idx_contract_registry_status_expiry")
+  @@index([contract_type, status], map: "idx_contract_registry_type_status")
   @@index([owner_employee_id, created_at], map: "idx_contract_registry_owner_created")
   @@map("contract_registry")
 }
@@ -2649,6 +2693,8 @@ model NotificationChannel {
   updated_at DateTime @default(now()) @updatedAt
   updated_by String?  @db.Uuid
 
+  deliveries NotificationDelivery[]
+
   @@unique([channel_type, name], map: "notification_channels_type_name_ux")
   @@index([enabled, channel_type], map: "idx_notification_channels_enabled_type")
   @@map("notification_channels")
diff --git a/server/src/routes/contractsRegistry.js b/server/src/routes/contractsRegistry.js
index 94eef7b7..3230a8ec 100644
--- a/server/src/routes/contractsRegistry.js
+++ b/server/src/routes/contractsRegistry.js
@@ -1,147 +1,381 @@
 const { z } = require("zod");
 
-const { AppError } = require("../utils/AppError");
-const { sendData } = require("../utils/reply");
-const { buildAuditLogData } = require("../utils/audit");
+const {
+  CONTRACT_REGISTRY_PERSISTED_STATUS_VALUES,
+  CONTRACT_REGISTRY_TYPE_VALUES,
+  buildContractRegistryExpiringWhere,
+  buildContractRegistryValidationError,
+  buildContractRegistryWhere,
+  canManageContractRegistry,
+  formatContractRegistryAmount,
+  formatContractRegistryDateOnly,
+  parseContractRegistryExpiringQuery,
+  parseContractRegistryFilters,
+  resolveContractRegistryEffectiveStatus,
+  resolveContractRegistryToday,
+} = require("../services/contractRegistryFilters");
 const { FEATURE_FLAG_KEYS, evaluateFeatureFlag } = require("../services/featureFlags");
+const { AppError } = require("../utils/AppError");
+const { buildAuditLogData } = require("../utils/audit");
+const { parseDateOnlyString } = require("../utils/date");
+const { sendData } = require("../utils/reply");
 
 const UUID_SCHEMA = z.string().uuid();
+const DATE_ONLY_SCHEMA = z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
 const CONFIDENTIALITY_SCHEMA = z.enum(["public", "internal", "confidential", "restricted"]);
-const LIST_QUERY_SCHEMA = z.object({ projectId: UUID_SCHEMA.optional() });
-const WRITE_SCHEMA = z.object({
-  contractNo: z.string().trim().min(1).max(80),
-  projectId: UUID_SCHEMA.nullable().optional(),
-  counterpartyName: z.string().trim().min(1).max(200),
-  summary: z.string().trim().min(1).max(4000),
-  confidentialityLevel: CONFIDENTIALITY_SCHEMA.optional(),
-  archiveLocation: z.string().trim().min(1).max(500),
-  offlineArchiveNo: z.string().trim().max(120).nullable().optional(),
-  ownerEmployeeId: UUID_SCHEMA.optional(),
-  status: z.string().trim().min(1).max(32).optional(),
-}).strict();
-const PATCH_SCHEMA = WRITE_SCHEMA.partial().refine((value) => Object.keys(value).length > 0, { message: "empty_patch" });
+const CONTRACT_TYPE_SCHEMA = z.enum(CONTRACT_REGISTRY_TYPE_VALUES);
+const STATUS_WRITE_SCHEMA = z.enum(CONTRACT_REGISTRY_PERSISTED_STATUS_VALUES);
+const MONEY_INPUT_SCHEMA = z.string().regex(/^\d{1,12}(\.\d{1,2})?$/);
+const CURRENCY_SCHEMA = z
+  .string()
+  .trim()
+  .min(1)
+  .max(8)
+  .transform((value) => value.toUpperCase());
 
-function buildValidationError(details, statusCode = 400) {
-  return new AppError({ code: "VALID_001", message: "参数校验失败", statusCode, details });
-}
+const WRITE_SCHEMA = z
+  .object({
+    contractNo: z.string().trim().min(1).max(80),
+    projectId: UUID_SCHEMA.nullable().optional(),
+    contractType: CONTRACT_TYPE_SCHEMA,
+    counterpartyName: z.string().trim().min(1).max(200),
+    summary: z.string().trim().min(1).max(4000),
+    amount: MONEY_INPUT_SCHEMA.nullable().optional(),
+    currency: CURRENCY_SCHEMA.optional(),
+    signedDate: DATE_ONLY_SCHEMA.nullable().optional(),
+    effectiveDate: DATE_ONLY_SCHEMA.nullable().optional(),
+    expiryDate: DATE_ONLY_SCHEMA.nullable().optional(),
+    confidentialityLevel: CONFIDENTIALITY_SCHEMA.optional(),
+    archiveLocation: z.string().trim().min(1).max(500),
+    offlineArchiveNo: z.string().trim().max(120).nullable().optional(),
+    ownerEmployeeId: UUID_SCHEMA.optional(),
+    status: STATUS_WRITE_SCHEMA.optional(),
+  })
+  .strict();
+
+const PATCH_SCHEMA = WRITE_SCHEMA.partial().refine((value) => Object.keys(value).length > 0, {
+  message: "empty_patch",
+});
+
+const CONTRACT_REGISTRY_INCLUDE = {
+  owner: { select: { id: true, employee_no: true, name: true } },
+  project: { select: { id: true, project_no: true, name: true } },
+};
 
 function parseBody(schema, body) {
   const parsed = schema.safeParse(body ?? {});
-  if (!parsed.success) throw buildValidationError(parsed.error.flatten());
+  if (!parsed.success) {
+    throw buildContractRegistryValidationError(parsed.error.flatten());
+  }
   return parsed.data;
 }
 
 async function ensureFeatureEnabled(fastify, request) {
-  const gate = await evaluateFeatureFlag({ prisma: fastify.prisma, config: fastify.config, flagKey: FEATURE_FLAG_KEYS.projectLinking, departmentId: request.employee.department_id ?? null, strictDepartment: false });
-  if (!gate.enabled) throw buildValidationError({ featureFlag: "project_linking_v1_disabled", reason: gate.reason }, 409);
+  const gate = await evaluateFeatureFlag({
+    prisma: fastify.prisma,
+    config: fastify.config,
+    flagKey: FEATURE_FLAG_KEYS.projectLinking,
+    departmentId: request.employee.department_id ?? null,
+    strictDepartment: false,
+  });
+  if (!gate.enabled) {
+    throw buildContractRegistryValidationError(
+      { featureFlag: "project_linking_v1_disabled", reason: gate.reason },
+      409,
+    );
+  }
 }
 
-function canManage(fastify, employee) {
-  return fastify.hasPermission(employee, "project.manage") || fastify.hasPermission(employee, "project.view_all") || fastify.hasPermission(employee, "system.settings");
-}
-
-async function writeAudit(fastify, request, action, targetId, extra = {}) {
+async function writeAudit(prisma, request, action, targetId, extra = {}) {
   try {
-    await fastify.prisma.auditLog.create({ data: buildAuditLogData(request, { actorId: request.employee.id, action, targetType: "contract_registry", targetId, extra }) });
+    await prisma.auditLog.create({
+      data: buildAuditLogData(request, {
+        actorId: request.employee.id,
+        action,
+        targetType: "contract_registry",
+        targetId,
+        extra,
+      }),
+    });
   } catch (error) {
     request.log.error({ err: error, action, targetId }, "contract registry audit failed");
   }
 }
 
-function mapRow(item) {
+function parseOptionalDate(value) {
+  return value ? parseDateOnlyString(value) : null;
+}
+
+function mapRow(item, today) {
   return {
     id: item.id,
     contractNo: item.contract_no,
     projectId: item.project_id ?? null,
+    contractType: item.contract_type,
     counterpartyName: item.counterparty_name,
     summary: item.summary,
+    amount: formatContractRegistryAmount(item.amount),
+    currency: item.currency,
+    signedDate: formatContractRegistryDateOnly(item.signed_date),
+    effectiveDate: formatContractRegistryDateOnly(item.effective_date),
+    expiryDate: formatContractRegistryDateOnly(item.expiry_date),
     confidentialityLevel: item.confidentiality_level,
     archiveLocation: item.archive_location,
     offlineArchiveNo: item.offline_archive_no ?? null,
     ownerEmployeeId: item.owner_employee_id,
-    status: item.status,
+    status: resolveContractRegistryEffectiveStatus(item, today),
+    persistedStatus: item.status,
     createdAt: item.created_at?.toISOString?.() ?? null,
     updatedAt: item.updated_at?.toISOString?.() ?? null,
-    owner: item.owner ? { id: item.owner.id, employeeNo: item.owner.employee_no, name: item.owner.name } : null,
-    project: item.project ? { id: item.project.id, projectNo: item.project.project_no, name: item.project.name } : null,
+    owner: item.owner
+      ? { id: item.owner.id, employeeNo: item.owner.employee_no, name: item.owner.name }
+      : null,
+    project: item.project
+      ? { id: item.project.id, projectNo: item.project.project_no, name: item.project.name }
+      : null,
   };
 }
 
+function buildNotFoundError() {
+  return new AppError({ code: "SYS_404", message: "Not Found", statusCode: 404 });
+}
+
+function buildRenewalContractNo(baseContractNo, rows) {
+  const escaped = baseContractNo.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const pattern = new RegExp(`^${escaped}-R(\\d+)$`);
+  const maxRenewalIndex = rows.reduce((currentMax, row) => {
+    const match = row.contract_no.match(pattern);
+    if (!match) {
+      return currentMax;
+    }
+    return Math.max(currentMax, Number(match[1]) || 0);
+  }, 0);
+
+  return `${baseContractNo}-R${maxRenewalIndex + 1}`;
+}
+
 async function contractsRegistryRoutes(fastify) {
   fastify.get("/contracts-registry", { preHandler: fastify.authenticate }, async (request, reply) => {
     await ensureFeatureEnabled(fastify, request);
-    const parsed = LIST_QUERY_SCHEMA.safeParse(request.query ?? {});
-    if (!parsed.success) throw buildValidationError(parsed.error.flatten());
+    const filters = parseContractRegistryFilters(request.query);
+    const today = resolveContractRegistryToday(fastify.config.appTimezone);
     const rows = await fastify.prisma.contractRegistry.findMany({
-      where: {
-        AND: [
-          parsed.data.projectId ? { project_id: parsed.data.projectId } : {},
-          canManage(fastify, request.employee)
-            ? {}
-            : {
-                OR: [
-                  { owner_employee_id: request.employee.id },
-                  { project: { owner_employee_id: request.employee.id } },
-                  { project: { manager_employee_id: request.employee.id } },
-                  { project: { members: { some: { employee_id: request.employee.id, left_at: null } } } },
-                ],
-              },
-        ],
-      },
-      orderBy: { updated_at: "desc" },
-      include: { owner: { select: { id: true, employee_no: true, name: true } }, project: { select: { id: true, project_no: true, name: true } } },
+      where: buildContractRegistryWhere({
+        filters,
+        employee: request.employee,
+        hasPermission: fastify.hasPermission,
+        timeZone: fastify.config.appTimezone,
+      }),
+      orderBy: [{ updated_at: "desc" }, { id: "desc" }],
+      include: CONTRACT_REGISTRY_INCLUDE,
+    });
+
+    return sendData(reply, request, { items: rows.map((item) => mapRow(item, today)) });
+  });
+
+  fastify.get("/contracts-registry/expiring", { preHandler: fastify.authenticate }, async (request, reply) => {
+    await ensureFeatureEnabled(fastify, request);
+    const { days } = parseContractRegistryExpiringQuery(request.query);
+    const today = resolveContractRegistryToday(fastify.config.appTimezone);
+    const rows = await fastify.prisma.contractRegistry.findMany({
+      where: buildContractRegistryExpiringWhere({
+        employee: request.employee,
+        hasPermission: fastify.hasPermission,
+        timeZone: fastify.config.appTimezone,
+        days,
+      }),
+      orderBy: [{ expiry_date: "asc" }, { updated_at: "desc" }, { id: "desc" }],
+      include: CONTRACT_REGISTRY_INCLUDE,
+    });
+
+    return sendData(reply, request, {
+      days,
+      total: rows.length,
+      items: rows.map((item) => mapRow(item, today)),
     });
-    return sendData(reply, request, { items: rows.map(mapRow) });
   });
 
   fastify.post("/contracts-registry", { preHandler: fastify.authenticate }, async (request, reply) => {
     await ensureFeatureEnabled(fastify, request);
-    if (!canManage(fastify, request.employee)) {
-      throw new AppError({ code: "PERM_001", message: "无权限", statusCode: 403, details: { permission: "project.manage" } });
+    if (!canManageContractRegistry(fastify.hasPermission, request.employee)) {
+      throw new AppError({
+        code: "PERM_001",
+        message: "无权限",
+        statusCode: 403,
+        details: { permission: "project.manage" },
+      });
     }
+
     const body = parseBody(WRITE_SCHEMA, request.body);
+    const today = resolveContractRegistryToday(fastify.config.appTimezone);
     const created = await fastify.prisma.contractRegistry.create({
       data: {
         contract_no: body.contractNo,
         project_id: body.projectId ?? null,
+        contract_type: body.contractType,
         counterparty_name: body.counterpartyName,
         summary: body.summary,
+        amount: body.amount ?? null,
+        currency: body.currency ?? "CNY",
+        signed_date: parseOptionalDate(body.signedDate),
+        effective_date: parseOptionalDate(body.effectiveDate),
+        expiry_date: parseOptionalDate(body.expiryDate),
         confidentiality_level: body.confidentialityLevel ?? "internal",
         archive_location: body.archiveLocation,
         offline_archive_no: body.offlineArchiveNo ?? null,
         owner_employee_id: body.ownerEmployeeId ?? request.employee.id,
         status: body.status ?? "active",
       },
-      include: { owner: { select: { id: true, employee_no: true, name: true } }, project: { select: { id: true, project_no: true, name: true } } },
+      include: CONTRACT_REGISTRY_INCLUDE,
+    });
+
+    await writeAudit(fastify.prisma, request, "CONTRACT_REGISTRY_CREATED", created.id, {
+      contractNo: created.contract_no,
+    });
+    return reply.code(201).send({
+      requestId: request.id,
+      data: { item: mapRow(created, today) },
     });
-    await writeAudit(fastify, request, "CONTRACT_REGISTRY_CREATED", created.id, { contractNo: created.contract_no });
-    return reply.code(201).send({ requestId: request.id, data: { item: mapRow(created) } });
   });
 
   fastify.patch("/contracts-registry/:id", { preHandler: fastify.authenticate }, async (request, reply) => {
     await ensureFeatureEnabled(fastify, request);
-    if (!canManage(fastify, request.employee)) {
-      throw new AppError({ code: "PERM_001", message: "无权限", statusCode: 403, details: { permission: "project.manage" } });
+    if (!canManageContractRegistry(fastify.hasPermission, request.employee)) {
+      throw new AppError({
+        code: "PERM_001",
+        message: "无权限",
+        statusCode: 403,
+        details: { permission: "project.manage" },
+      });
     }
+
     const contractId = UUID_SCHEMA.parse(request.params?.id);
     const body = parseBody(PATCH_SCHEMA, request.body);
+    const existing = await fastify.prisma.contractRegistry.findUnique({
+      where: { id: contractId },
+      select: { id: true, status: true, contract_no: true },
+    });
+    if (!existing) {
+      throw buildNotFoundError();
+    }
+
+    const today = resolveContractRegistryToday(fastify.config.appTimezone);
     const updated = await fastify.prisma.contractRegistry.update({
       where: { id: contractId },
       data: {
         ...(body.contractNo !== undefined ? { contract_no: body.contractNo } : {}),
         ...(body.projectId !== undefined ? { project_id: body.projectId ?? null } : {}),
+        ...(body.contractType !== undefined ? { contract_type: body.contractType } : {}),
         ...(body.counterpartyName !== undefined ? { counterparty_name: body.counterpartyName } : {}),
         ...(body.summary !== undefined ? { summary: body.summary } : {}),
-        ...(body.confidentialityLevel !== undefined ? { confidentiality_level: body.confidentialityLevel } : {}),
+        ...(body.amount !== undefined ? { amount: body.amount ?? null } : {}),
+        ...(body.currency !== undefined ? { currency: body.currency } : {}),
+        ...(body.signedDate !== undefined ? { signed_date: parseOptionalDate(body.signedDate) } : {}),
+        ...(body.effectiveDate !== undefined ? { effective_date: parseOptionalDate(body.effectiveDate) } : {}),
+        ...(body.expiryDate !== undefined ? { expiry_date: parseOptionalDate(body.expiryDate) } : {}),
+        ...(body.confidentialityLevel !== undefined
+          ? { confidentiality_level: body.confidentialityLevel }
+          : {}),
         ...(body.archiveLocation !== undefined ? { archive_location: body.archiveLocation } : {}),
         ...(body.offlineArchiveNo !== undefined ? { offline_archive_no: body.offlineArchiveNo ?? null } : {}),
         ...(body.ownerEmployeeId !== undefined ? { owner_employee_id: body.ownerEmployeeId } : {}),
         ...(body.status !== undefined ? { status: body.status } : {}),
       },
-      include: { owner: { select: { id: true, employee_no: true, name: true } }, project: { select: { id: true, project_no: true, name: true } } },
+      include: CONTRACT_REGISTRY_INCLUDE,
+    });
+
+    await writeAudit(fastify.prisma, request, "CONTRACT_REGISTRY_UPDATED", updated.id, {
+      fields: Object.keys(body),
+    });
+    if (body.status !== undefined && body.status !== existing.status) {
+      await writeAudit(fastify.prisma, request, "CONTRACT_REGISTRY_STATUS_CHANGED", updated.id, {
+        fromStatus: existing.status,
+        toStatus: body.status,
+      });
+    }
+
+    return sendData(reply, request, { item: mapRow(updated, today) });
+  });
+
+  fastify.post("/contracts-registry/:id/renew", { preHandler: fastify.authenticate }, async (request, reply) => {
+    await ensureFeatureEnabled(fastify, request);
+    if (!canManageContractRegistry(fastify.hasPermission, request.employee)) {
+      throw new AppError({
+        code: "PERM_001",
+        message: "无权限",
+        statusCode: 403,
+        details: { permission: "project.manage" },
+      });
+    }
+
+    const contractId = UUID_SCHEMA.parse(request.params?.id);
+    const today = resolveContractRegistryToday(fastify.config.appTimezone);
+    const result = await fastify.prisma.$transaction(async (tx) => {
+      const original = await tx.contractRegistry.findUnique({
+        where: { id: contractId },
+        include: CONTRACT_REGISTRY_INCLUDE,
+      });
+      if (!original) {
+        throw buildNotFoundError();
+      }
+
+      const effectiveStatus = resolveContractRegistryEffectiveStatus(original, today);
+      if (!["active", "expired"].includes(effectiveStatus)) {
+        throw buildContractRegistryValidationError({ status: "renew_not_allowed" }, 409);
+      }
+
+      const baseContractNo = original.contract_no.replace(/-R\d+$/, "");
+      const lineageRows = await tx.contractRegistry.findMany({
+        where: { contract_no: { startsWith: baseContractNo } },
+        select: { contract_no: true },
+      });
+      const nextContractNo = buildRenewalContractNo(baseContractNo, lineageRows);
+
+      const renewed = await tx.contractRegistry.create({
+        data: {
+          contract_no: nextContractNo,
+          project_id: original.project_id ?? null,
+          contract_type: original.contract_type,
+          counterparty_name: original.counterparty_name,
+          summary: original.summary,
+          amount: original.amount ?? null,
+          currency: original.currency,
+          signed_date: original.signed_date,
+          effective_date: original.effective_date,
+          expiry_date: original.expiry_date,
+          confidentiality_level: original.confidentiality_level,
+          archive_location: original.archive_location,
+          offline_archive_no: original.offline_archive_no ?? null,
+          owner_employee_id: original.owner_employee_id,
+          status: "draft",
+        },
+        include: CONTRACT_REGISTRY_INCLUDE,
+      });
+
+      const archivedSource = await tx.contractRegistry.update({
+        where: { id: original.id },
+        data: { status: "archived" },
+        include: CONTRACT_REGISTRY_INCLUDE,
+      });
+
+      await writeAudit(tx, request, "CONTRACT_REGISTRY_RENEWED", renewed.id, {
+        sourceContractId: original.id,
+        sourceContractNo: original.contract_no,
+        renewedContractNo: renewed.contract_no,
+      });
+      await writeAudit(tx, request, "CONTRACT_REGISTRY_STATUS_CHANGED", archivedSource.id, {
+        fromStatus: original.status,
+        toStatus: "archived",
+        reason: "renew",
+      });
+
+      return { renewed, archivedSource };
+    });
+
+    return sendData(reply, request, {
+      item: mapRow(result.renewed, today),
+      sourceItem: mapRow(result.archivedSource, today),
     });
-    await writeAudit(fastify, request, "CONTRACT_REGISTRY_UPDATED", updated.id, { fields: Object.keys(body) });
-    return sendData(reply, request, { item: mapRow(updated) });
   });
 }
 
diff --git a/server/src/routes/exports.js b/server/src/routes/exports.js
index 89c9b323..d8462994 100644
--- a/server/src/routes/exports.js
+++ b/server/src/routes/exports.js
@@ -3,11 +3,21 @@ const { Readable } = require("node:stream");
 const ExcelJS = require("exceljs");
 const { z } = require("zod");
 
+const {
+  CONTRACT_REGISTRY_FILTER_INPUT_SCHEMA,
+  buildContractRegistryWhere,
+  formatContractRegistryAmount,
+  formatContractRegistryDateOnly,
+  parseContractRegistryFilters,
+  resolveContractRegistryEffectiveStatus,
+  resolveContractRegistryToday,
+} = require("../services/contractRegistryFilters");
 const {
   EMPLOYMENT_STATUS_VALUES,
   buildEmployeeDirectoryWhere,
   parseEmployeeDirectoryFilters,
 } = require("../services/employeeDirectoryFilters");
+const { FEATURE_FLAG_KEYS, evaluateFeatureFlag } = require("../services/featureFlags");
 const {
   HISTORY_STATUS_VALUES,
   buildPresenceValidationError,
@@ -88,6 +98,11 @@ const PRESENCE_HISTORY_EXPORT_QUERY_SCHEMA = z.object({
   employeeId: z.string().uuid().optional(),
   status: z.enum(HISTORY_STATUS_VALUES).optional(),
 });
+
+const CONTRACT_REGISTRY_EXPORT_BODY_SCHEMA = CONTRACT_REGISTRY_FILTER_INPUT_SCHEMA.extend({
+  format: EXPORT_FORMAT_SCHEMA.optional(),
+});
+
 const PRESENCE_HISTORY_EXPORT_LIMIT = 5000;
 
 function csvCell(value) {
@@ -118,6 +133,20 @@ function parseQuery(schema, query) {
   return parsed.data;
 }
 
+function parseBody(schema, body) {
+  const parsed = schema.safeParse(body ?? {});
+  if (!parsed.success) {
+    throw new AppError({
+      code: "VALID_001",
+      message: "参数校验失败",
+      statusCode: 400,
+      details: parsed.error.flatten(),
+    });
+  }
+
+  return parsed.data;
+}
+
 function resolveExportFormat(query) {
   return query.format ?? "csv";
 }
@@ -302,6 +331,170 @@ function setExportHeaders(reply, format, filename) {
   reply.header("content-disposition", `attachment; filename=\"${filename}\"`);
 }
 
+async function ensureContractsRegistryExportEnabled(fastify, request) {
+  const gate = await evaluateFeatureFlag({
+    prisma: fastify.prisma,
+    config: fastify.config,
+    flagKey: FEATURE_FLAG_KEYS.projectLinking,
+    departmentId: request.employee.department_id ?? null,
+    strictDepartment: false,
+  });
+
+  if (!gate.enabled) {
+    throw new AppError({
+      code: "VALID_001",
+      message: "参数校验失败",
+      statusCode: 409,
+      details: { featureFlag: "project_linking_v1_disabled", reason: gate.reason },
+    });
+  }
+}
+
+function confidentialityLevelLabel(value) {
+  if (value === "public") return "公开";
+  if (value === "internal") return "内部";
+  if (value === "confidential") return "机密";
+  return "限制";
+}
+
+function contractRegistryTypeLabel(value) {
+  if (value === "purchase") return "采购合同";
+  if (value === "sales") return "销售合同";
+  if (value === "service") return "服务合同";
+  if (value === "framework") return "框架协议";
+  return "其他";
+}
+
+function contractRegistryStatusLabel(value) {
+  if (value === "draft") return "草稿";
+  if (value === "active") return "生效中";
+  if (value === "expired") return "已过期";
+  if (value === "archived") return "已归档";
+  return value ?? "";
+}
+
+function mapContractRegistryExportRow(item, today) {
+  const effectiveStatus = resolveContractRegistryEffectiveStatus(item, today);
+  return [
+    item.contract_no,
+    contractRegistryTypeLabel(item.contract_type),
+    item.counterparty_name,
+    formatContractRegistryAmount(item.amount),
+    item.currency,
+    contractRegistryStatusLabel(effectiveStatus),
+    formatContractRegistryDateOnly(item.signed_date),
+    formatContractRegistryDateOnly(item.effective_date),
+    formatContractRegistryDateOnly(item.expiry_date),
+    item.project ? `${item.project.project_no} · ${item.project.name}` : "",
+    item.owner?.name ?? "",
+    confidentialityLevelLabel(item.confidentiality_level),
+  ];
+}
+
+async function* streamContractsRegistryCsv(prisma, where, today) {
+  yield "\ufeff";
+  yield csvRow([
+    "合同编号",
+    "类型",
+    "相对方",
+    "金额",
+    "币种",
+    "状态",
+    "签署日期",
+    "生效日期",
+    "到期日期",
+    "项目",
+    "责任人",
+    "密级",
+  ]);
+
+  const batchSize = 500;
+  let cursorUpdatedAt = null;
+  let cursorId = null;
+
+  while (true) {
+    const rows = await prisma.contractRegistry.findMany({
+      where: {
+        ...where,
+        ...(cursorUpdatedAt
+          ? {
+              OR: [
+                { updated_at: { lt: cursorUpdatedAt } },
+                { updated_at: cursorUpdatedAt, id: { lt: cursorId } },
+              ],
+            }
+          : {}),
+      },
+      orderBy: [{ updated_at: "desc" }, { id: "desc" }],
+      take: batchSize,
+      include: {
+        owner: { select: { name: true } },
+        project: { select: { project_no: true, name: true } },
+      },
+    });
+
+    if (!rows.length) {
+      break;
+    }
+
+    for (const item of rows) {
+      yield csvRow(mapContractRegistryExportRow(item, today));
+    }
+
+    const last = rows[rows.length - 1];
+    cursorUpdatedAt = last.updated_at;
+    cursorId = last.id;
+  }
+}
+
+async function buildContractsRegistryXlsx(prisma, where, today) {
+  const workbook = new ExcelJS.Workbook();
+  const sheet = workbook.addWorksheet("contracts_registry");
+
+  sheet.columns = [
+    { header: "合同编号", key: "contractNo", width: 22 },
+    { header: "类型", key: "contractType", width: 16 },
+    { header: "相对方", key: "counterpartyName", width: 24 },
+    { header: "金额", key: "amount", width: 16 },
+    { header: "币种", key: "currency", width: 12 },
+    { header: "状态", key: "status", width: 12 },
+    { header: "签署日期", key: "signedDate", width: 14 },
+    { header: "生效日期", key: "effectiveDate", width: 14 },
+    { header: "到期日期", key: "expiryDate", width: 14 },
+    { header: "项目", key: "projectName", width: 24 },
+    { header: "责任人", key: "ownerName", width: 16 },
+    { header: "密级", key: "confidentialityLevel", width: 12 },
+  ];
+
+  const rows = await prisma.contractRegistry.findMany({
+    where,
+    orderBy: [{ updated_at: "desc" }, { id: "desc" }],
+    include: {
+      owner: { select: { name: true } },
+      project: { select: { project_no: true, name: true } },
+    },
+  });
+
+  for (const item of rows) {
+    sheet.addRow({
+      contractNo: item.contract_no,
+      contractType: contractRegistryTypeLabel(item.contract_type),
+      counterpartyName: item.counterparty_name,
+      amount: formatContractRegistryAmount(item.amount),
+      currency: item.currency,
+      status: contractRegistryStatusLabel(resolveContractRegistryEffectiveStatus(item, today)),
+      signedDate: formatContractRegistryDateOnly(item.signed_date),
+      effectiveDate: formatContractRegistryDateOnly(item.effective_date),
+      expiryDate: formatContractRegistryDateOnly(item.expiry_date),
+      projectName: item.project ? `${item.project.project_no} · ${item.project.name}` : "",
+      ownerName: item.owner?.name ?? "",
+      confidentialityLevel: confidentialityLevelLabel(item.confidentiality_level),
+    });
+  }
+
+  return workbook.xlsx.writeBuffer();
+}
+
 async function* streamReimbursementsCsv(prisma, where, limit) {
   yield "\ufeff";
   yield csvRow([
@@ -952,6 +1145,63 @@ async function buildPresenceHistoryXlsx(items) {
 }
 
 async function exportsRoutes(fastify) {
+  fastify.post(
+    "/exports/contracts-registry",
+    {
+      preHandler: fastify.authenticate,
+    },
+    async (request, reply) => {
+      await ensureContractsRegistryExportEnabled(fastify, request);
+      const parsedBody = parseBody(CONTRACT_REGISTRY_EXPORT_BODY_SCHEMA, request.body);
+      const format = parsedBody.format ?? "csv";
+      const filters = parseContractRegistryFilters({
+        projectId: parsedBody.projectId,
+        status: parsedBody.status,
+        contractType: parsedBody.contractType,
+        counterpartyName: parsedBody.counterpartyName,
+        expiryDateFrom: parsedBody.expiryDateFrom,
+        expiryDateTo: parsedBody.expiryDateTo,
+      });
+      const where = buildContractRegistryWhere({
+        filters,
+        employee: request.employee,
+        hasPermission: fastify.hasPermission,
+        timeZone: fastify.config.appTimezone,
+      });
+      const matchedTotal = await fastify.prisma.contractRegistry.count({ where });
+
+      await fastify.prisma.auditLog.create({
+        data: buildAuditLogData(request, {
+          actorId: request.employee.id,
+          action: "EXPORT_CONTRACTS_REGISTRY",
+          targetType: "export",
+          extra: {
+            format,
+            projectId: filters.projectId ?? null,
+            status: filters.status ?? null,
+            contractType: filters.contractType ?? null,
+            counterpartyName: filters.counterpartyName ?? null,
+            expiryDateFrom: filters.expiryDateFrom ?? null,
+            expiryDateTo: filters.expiryDateTo ?? null,
+            matchedTotal,
+          },
+        }),
+      });
+
+      const filename = exportFilename("contracts-registry", format);
+      const today = resolveContractRegistryToday(fastify.config.appTimezone);
+      setExportHeaders(reply, format, filename);
+
+      if (format === "xlsx") {
+        const buffer = await buildContractsRegistryXlsx(fastify.prisma, where, today);
+        return reply.send(Buffer.from(buffer));
+      }
+
+      const stream = Readable.from(streamContractsRegistryCsv(fastify.prisma, where, today));
+      return reply.send(stream);
+    },
+  );
+
   fastify.get(
     "/exports/employees",
     {
diff --git a/server/src/services/contractRegistryFilters.js b/server/src/services/contractRegistryFilters.js
new file mode 100644
index 00000000..624cdfe6
--- /dev/null
+++ b/server/src/services/contractRegistryFilters.js
@@ -0,0 +1,233 @@
+const { z } = require("zod");
+
+const { AppError } = require("../utils/AppError");
+const { currentDateString, parseDateOnlyString } = require("../utils/date");
+
+const CONTRACT_REGISTRY_TYPE_VALUES = ["purchase", "sales", "service", "framework", "other"];
+const CONTRACT_REGISTRY_PERSISTED_STATUS_VALUES = ["draft", "active", "archived"];
+const CONTRACT_REGISTRY_EFFECTIVE_STATUS_VALUES = [...CONTRACT_REGISTRY_PERSISTED_STATUS_VALUES, "expired"];
+const DATE_ONLY_SCHEMA = z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
+
+const CONTRACT_REGISTRY_FILTER_INPUT_SCHEMA = z
+  .object({
+    projectId: z.string().uuid().optional(),
+    status: z.enum(CONTRACT_REGISTRY_EFFECTIVE_STATUS_VALUES).optional(),
+    contractType: z.enum(CONTRACT_REGISTRY_TYPE_VALUES).optional(),
+    counterpartyName: z.string().trim().max(200).optional(),
+    expiryDateFrom: DATE_ONLY_SCHEMA.optional(),
+    expiryDateTo: DATE_ONLY_SCHEMA.optional(),
+  })
+  .strict();
+
+const CONTRACT_REGISTRY_EXPIRING_QUERY_SCHEMA = z
+  .object({
+    days: z.coerce.number().int().min(1).max(365).optional(),
+  })
+  .strict();
+
+function buildContractRegistryValidationError(details, statusCode = 400) {
+  return new AppError({
+    code: "VALID_001",
+    message: "参数校验失败",
+    statusCode,
+    details,
+  });
+}
+
+function parseContractRegistryFilters(input) {
+  const parsed = CONTRACT_REGISTRY_FILTER_INPUT_SCHEMA.safeParse(input ?? {});
+  if (!parsed.success) {
+    throw buildContractRegistryValidationError(parsed.error.flatten());
+  }
+
+  const filters = {
+    ...parsed.data,
+    counterpartyName: parsed.data.counterpartyName?.trim() || undefined,
+  };
+
+  if (filters.expiryDateFrom && filters.expiryDateTo) {
+    const start = parseDateOnlyString(filters.expiryDateFrom);
+    const end = parseDateOnlyString(filters.expiryDateTo);
+    if (start > end) {
+      throw buildContractRegistryValidationError({
+        expiryDateTo: "must_be_after_or_equal_expiryDateFrom",
+      });
+    }
+  }
+
+  return filters;
+}
+
+function parseContractRegistryExpiringQuery(input) {
+  const parsed = CONTRACT_REGISTRY_EXPIRING_QUERY_SCHEMA.safeParse(input ?? {});
+  if (!parsed.success) {
+    throw buildContractRegistryValidationError(parsed.error.flatten());
+  }
+
+  return {
+    days: parsed.data.days ?? 30,
+  };
+}
+
+function resolveContractRegistryToday(timeZone) {
+  return parseDateOnlyString(currentDateString(timeZone ?? "Asia/Shanghai"));
+}
+
+function addUtcDays(dateValue, days) {
+  const next = new Date(dateValue.getTime());
+  next.setUTCDate(next.getUTCDate() + days);
+  return next;
+}
+
+function canManageContractRegistry(hasPermission, employee) {
+  return (
+    hasPermission(employee, "project.manage") ||
+    hasPermission(employee, "project.view_all") ||
+    hasPermission(employee, "system.settings")
+  );
+}
+
+function buildContractRegistryScopeWhere({ employee, hasPermission }) {
+  if (canManageContractRegistry(hasPermission, employee)) {
+    return {};
+  }
+
+  return {
+    OR: [
+      { owner_employee_id: employee.id },
+      { project: { owner_employee_id: employee.id } },
+      { project: { manager_employee_id: employee.id } },
+      { project: { members: { some: { employee_id: employee.id, left_at: null } } } },
+    ],
+  };
+}
+
+function buildEffectiveStatusWhere(status, today) {
+  if (!status) {
+    return null;
+  }
+
+  if (status === "draft") {
+    return { status: "draft" };
+  }
+
+  if (status === "archived") {
+    return { status: "archived" };
+  }
+
+  if (status === "expired") {
+    return {
+      status: "active",
+      expiry_date: { lt: today },
+    };
+  }
+
+  return {
+    status: "active",
+    OR: [{ expiry_date: null }, { expiry_date: { gte: today } }],
+  };
+}
+
+function buildContractRegistryWhere({ filters, employee, hasPermission, timeZone }) {
+  const today = resolveContractRegistryToday(timeZone);
+  const conditions = [];
+  const scopeWhere = buildContractRegistryScopeWhere({ employee, hasPermission });
+  if (Object.keys(scopeWhere).length) {
+    conditions.push(scopeWhere);
+  }
+
+  if (filters.projectId) {
+    conditions.push({ project_id: filters.projectId });
+  }
+  if (filters.contractType) {
+    conditions.push({ contract_type: filters.contractType });
+  }
+  if (filters.counterpartyName) {
+    conditions.push({
+      counterparty_name: {
+        contains: filters.counterpartyName,
+        mode: "insensitive",
+      },
+    });
+  }
+  if (filters.expiryDateFrom || filters.expiryDateTo) {
+    conditions.push({
+      expiry_date: {
+        ...(filters.expiryDateFrom ? { gte: parseDateOnlyString(filters.expiryDateFrom) } : {}),
+        ...(filters.expiryDateTo ? { lte: parseDateOnlyString(filters.expiryDateTo) } : {}),
+      },
+    });
+  }
+
+  const statusWhere = buildEffectiveStatusWhere(filters.status, today);
+  if (statusWhere) {
+    conditions.push(statusWhere);
+  }
+
+  return conditions.length ? { AND: conditions } : {};
+}
+
+function buildContractRegistryExpiringWhere({ employee, hasPermission, timeZone, days }) {
+  const today = resolveContractRegistryToday(timeZone);
+  const conditions = [];
+  const scopeWhere = buildContractRegistryScopeWhere({ employee, hasPermission });
+  if (Object.keys(scopeWhere).length) {
+    conditions.push(scopeWhere);
+  }
+
+  conditions.push({ status: "active" });
+  conditions.push({
+    expiry_date: {
+      gte: today,
+      lte: addUtcDays(today, days),
+    },
+  });
+
+  return { AND: conditions };
+}
+
+function resolveContractRegistryEffectiveStatus(item, todayOrTimeZone) {
+  const today = todayOrTimeZone instanceof Date ? todayOrTimeZone : resolveContractRegistryToday(todayOrTimeZone);
+  if (!item || item.status !== "active" || !item.expiry_date) {
+    return item?.status ?? "draft";
+  }
+  return item.expiry_date < today ? "expired" : item.status;
+}
+
+function formatContractRegistryDateOnly(value) {
+  return value?.toISOString?.()?.slice(0, 10) ?? null;
+}
+
+function formatContractRegistryAmount(value) {
+  if (value == null) {
+    return null;
+  }
+  if (typeof value === "number") {
+    return value.toFixed(2);
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value.toFixed === "function") {
+    return value.toFixed(2);
+  }
+  return String(value);
+}
+
+module.exports = {
+  CONTRACT_REGISTRY_EFFECTIVE_STATUS_VALUES,
+  CONTRACT_REGISTRY_EXPIRING_QUERY_SCHEMA,
+  CONTRACT_REGISTRY_FILTER_INPUT_SCHEMA,
+  CONTRACT_REGISTRY_PERSISTED_STATUS_VALUES,
+  CONTRACT_REGISTRY_TYPE_VALUES,
+  buildContractRegistryExpiringWhere,
+  buildContractRegistryValidationError,
+  buildContractRegistryWhere,
+  canManageContractRegistry,
+  formatContractRegistryAmount,
+  formatContractRegistryDateOnly,
+  parseContractRegistryExpiringQuery,
+  parseContractRegistryFilters,
+  resolveContractRegistryEffectiveStatus,
+  resolveContractRegistryToday,
+};
diff --git a/server/tests/unit/routes/contractsRegistry.test.js b/server/tests/unit/routes/contractsRegistry.test.js
new file mode 100644
index 00000000..35ee4bd7
--- /dev/null
+++ b/server/tests/unit/routes/contractsRegistry.test.js
@@ -0,0 +1,453 @@
+const Fastify = require("fastify");
+
+const contractsRegistryRoutes = require("../../../src/routes/contractsRegistry");
+const { AppError } = require("../../../src/utils/AppError");
+const { currentDateString, parseDateOnlyString } = require("../../../src/utils/date");
+
+const ACTOR_ID = "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa";
+const PROJECT_ID = "11111111-1111-4111-8111-111111111111";
+const OWNER_ID = "22222222-2222-4222-8222-222222222222";
+const MANAGER_ID = "33333333-3333-4333-8333-333333333333";
+const MEMBER_ID = "44444444-4444-4444-8444-444444444444";
+const DEPARTMENT_ID = "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb";
+
+function buildFeatureFlagRecord(flagKey) {
+  return {
+    id: `flag-${flagKey}`,
+    flag_key: flagKey,
+    override_mode: "force_on",
+    rollout_type: "global",
+    department_ids: [],
+    note: "unit-test",
+    version: 1,
+    created_at: new Date("2026-04-04T08:00:00.000Z"),
+    created_by: null,
+    updated_at: new Date("2026-04-04T08:00:00.000Z"),
+    updated_by: null,
+  };
+}
+
+function buildContractRow(overrides = {}) {
+  return {
+    id: "55555555-5555-4555-8555-555555555551",
+    contract_no: "HT-2026-001",
+    project_id: PROJECT_ID,
+    contract_type: "service",
+    counterparty_name: "测试客户",
+    summary: "合同摘要",
+    amount: "100000.00",
+    currency: "CNY",
+    signed_date: new Date("2026-03-01T00:00:00.000Z"),
+    effective_date: new Date("2026-03-05T00:00:00.000Z"),
+    expiry_date: new Date("2026-03-31T00:00:00.000Z"),
+    confidentiality_level: "internal",
+    archive_location: "/archive/contracts/001",
+    offline_archive_no: "OFF-001",
+    owner_employee_id: OWNER_ID,
+    status: "active",
+    created_at: new Date("2026-03-01T08:00:00.000Z"),
+    updated_at: new Date("2026-04-01T08:00:00.000Z"),
+    owner: {
+      id: OWNER_ID,
+      employee_no: "E001",
+      name: "Owner",
+    },
+    project: {
+      id: PROJECT_ID,
+      project_no: "PRJ-001",
+      name: "试点项目",
+    },
+    ...overrides,
+  };
+}
+
+function mapSelectedRow(row, select) {
+  if (!select) {
+    return row;
+  }
+
+  return Object.entries(select).reduce((result, [key, enabled]) => {
+    if (enabled === true) {
+      result[key] = row[key];
+    }
+    return result;
+  }, {});
+}
+
+function cloneRow(row) {
+  return {
+    ...row,
+    owner: row.owner ? { ...row.owner } : null,
+    project: row.project ? { ...row.project } : null,
+  };
+}
+
+function buildStatefulPrisma(initialContracts) {
+  const state = {
+    contracts: initialContracts.map((item) => cloneRow(item)),
+    audits: [],
+  };
+
+  const auditCreate = vi.fn(async ({ data }) => {
+    state.audits.push(data);
+    return data;
+  });
+
+  const contractRegistry = {
+    findMany: vi.fn(async ({ where, select, include }) => {
+      let rows = [...state.contracts];
+      if (where?.contract_no?.startsWith) {
+        rows = rows.filter((item) => item.contract_no.startsWith(where.contract_no.startsWith));
+      }
+
+      if (select) {
+        return rows.map((item) => mapSelectedRow(item, select));
+      }
+
+      if (include) {
+        return rows.map((item) => cloneRow(item));
+      }
+
+      return rows.map((item) => cloneRow(item));
+    }),
+    findUnique: vi.fn(async ({ where, select, include }) => {
+      const row = state.contracts.find((item) => item.id === where.id);
+      if (!row) {
+        return null;
+      }
+      if (select) {
+        return mapSelectedRow(row, select);
+      }
+      if (include) {
+        return cloneRow(row);
+      }
+      return cloneRow(row);
+    }),
+    create: vi.fn(async ({ data, include }) => {
+      const created = buildContractRow({
+        id: `66666666-6666-4666-8666-${String(state.contracts.length + 1).padStart(12, "0")}`,
+        contract_no: data.contract_no,
+        project_id: data.project_id ?? null,
+        contract_type: data.contract_type,
+        counterparty_name: data.counterparty_name,
+        summary: data.summary,
+        amount: data.amount ?? null,
+        currency: data.currency,
+        signed_date: data.signed_date,
+        effective_date: data.effective_date,
+        expiry_date: data.expiry_date,
+        confidentiality_level: data.confidentiality_level,
+        archive_location: data.archive_location,
+        offline_archive_no: data.offline_archive_no,
+        owner_employee_id: data.owner_employee_id,
+        status: data.status,
+      });
+      state.contracts.push(created);
+      return include ? cloneRow(created) : created;
+    }),
+    update: vi.fn(async ({ where, data, include }) => {
+      const index = state.contracts.findIndex((item) => item.id === where.id);
+      if (index < 0) {
+        return null;
+      }
+      state.contracts[index] = {
+        ...state.contracts[index],
+        ...data,
+        updated_at: new Date("2026-04-04T09:30:00.000Z"),
+      };
+      return include ? cloneRow(state.contracts[index]) : state.contracts[index];
+    }),
+  };
+
+  return {
+    state,
+    prisma: {
+      featureFlag: {
+        findUnique: vi.fn().mockImplementation(async ({ where }) => buildFeatureFlagRecord(where.flag_key)),
+      },
+      auditLog: {
+        create: auditCreate,
+      },
+      contractRegistry,
+      $transaction: async (callback) =>
+        callback({
+          auditLog: { create: auditCreate },
+          contractRegistry,
+        }),
+    },
+    auditCreate,
+  };
+}
+
+async function buildApp(options = {}) {
+  const app = Fastify();
+  const actor = options.actor ?? {
+    id: ACTOR_ID,
+    department_id: DEPARTMENT_ID,
+    permissionCodes: ["project.manage"],
+  };
+  const prisma =
+    options.prisma ??
+    (() => {
+      const fallback = {
+        featureFlag: {
+          findUnique: vi.fn().mockImplementation(async ({ where }) => buildFeatureFlagRecord(where.flag_key)),
+        },
+        auditLog: {
+          create: vi.fn().mockResolvedValue({}),
+        },
+        contractRegistry: {
+          findMany: vi.fn().mockResolvedValue([]),
+          findUnique: vi.fn().mockResolvedValue(null),
+          create: vi.fn().mockResolvedValue(buildContractRow()),
+          update: vi.fn().mockResolvedValue(buildContractRow()),
+        },
+      };
+      fallback.$transaction = async (callback) => callback(fallback);
+      return fallback;
+    })();
+
+  app.decorate("authenticate", async (request) => {
+    request.employee = actor;
+  });
+  app.decorate("hasPermission", (employee, permissionCode) => {
+    const permissionCodes = employee.permissionCodes ?? [];
+    return permissionCodes.includes("*") || permissionCodes.includes(permissionCode);
+  });
+  app.decorate("config", {
+    appTimezone: "Asia/Shanghai",
+    projectLinkingEnabled: true,
+  });
+  app.decorate("prisma", prisma);
+  app.setErrorHandler((error, request, reply) => {
+    if (error instanceof AppError) {
+      return reply.status(error.statusCode).send({
+        requestId: request.id,
+        error: { code: error.code, message: error.message, details: error.details ?? {} },
+      });
+    }
+    return reply.status(500).send({
+      requestId: request.id,
+      error: { code: "SYS_001", message: "服务器内部错误", details: {} },
+    });
+  });
+
+  await app.register(contractsRegistryRoutes, { prefix: "/api" });
+  return { app, prisma };
+}
+
+describe("contracts registry routes", () => {
+  it("lists contracts with expired filtering and computed status", async () => {
+    const contractFindMany = vi.fn().mockResolvedValue([buildContractRow()]);
+    const { app } = await buildApp({
+      prisma: (() => {
+        const prisma = {
+        featureFlag: {
+          findUnique: vi.fn().mockImplementation(async ({ where }) => buildFeatureFlagRecord(where.flag_key)),
+        },
+        auditLog: { create: vi.fn().mockResolvedValue({}) },
+        contractRegistry: {
+          findMany: contractFindMany,
+          findUnique: vi.fn().mockResolvedValue(null),
+          create: vi.fn(),
+          update: vi.fn(),
+        },
+        };
+        prisma.$transaction = async (callback) => callback(prisma);
+        return prisma;
+      })(),
+    });
+
+    const today = parseDateOnlyString(currentDateString("Asia/Shanghai"));
+    const response = await app.inject({
+      method: "GET",
+      url: `/api/contracts-registry?status=expired&contractType=service&counterpartyName=%E6%B5%8B%E8%AF%95&expiryDateFrom=2026-03-01&expiryDateTo=2026-03-31`,
+    });
+
+    expect(response.statusCode).toBe(200);
+    const payload = response.json();
+    expect(payload.data.items[0]).toEqual(
+      expect.objectContaining({
+        status: "expired",
+        persistedStatus: "active",
+        contractType: "service",
+        amount: "100000.00",
+      }),
+    );
+    expect(contractFindMany).toHaveBeenCalledWith(
+      expect.objectContaining({
+        where: {
+          AND: expect.arrayContaining([
+            expect.objectContaining({ status: "active", expiry_date: { lt: today } }),
+            expect.objectContaining({ contract_type: "service" }),
+            expect.objectContaining({
+              counterparty_name: expect.objectContaining({ contains: "测试", mode: "insensitive" }),
+            }),
+            expect.objectContaining({
+              expiry_date: expect.objectContaining({
+                gte: new Date("2026-03-01T00:00:00.000Z"),
+                lte: new Date("2026-03-31T00:00:00.000Z"),
+              }),
+            }),
+          ]),
+        },
+      }),
+    );
+
+    await app.close();
+  });
+
+  it("rejects invalid expiry date range", async () => {
+    const { app } = await buildApp();
+    const response = await app.inject({
+      method: "GET",
+      url: "/api/contracts-registry?expiryDateFrom=2026-04-10&expiryDateTo=2026-04-01",
+    });
+
+    expect(response.statusCode).toBe(400);
+    expect(response.json().error).toEqual(
+      expect.objectContaining({
+        code: "VALID_001",
+        details: expect.objectContaining({
+          expiryDateTo: "must_be_after_or_equal_expiryDateFrom",
+        }),
+      }),
+    );
+
+    await app.close();
+  });
+
+  it("returns expiring contracts within the default window", async () => {
+    const contractFindMany = vi.fn().mockResolvedValue([
+      buildContractRow({
+        id: "contract-2",
+        contract_no: "HT-2026-002",
+        expiry_date: new Date("2026-04-10T00:00:00.000Z"),
+      }),
+    ]);
+    const { app } = await buildApp({
+      prisma: (() => {
+        const prisma = {
+        featureFlag: {
+          findUnique: vi.fn().mockImplementation(async ({ where }) => buildFeatureFlagRecord(where.flag_key)),
+        },
+        auditLog: { create: vi.fn().mockResolvedValue({}) },
+        contractRegistry: {
+          findMany: contractFindMany,
+          findUnique: vi.fn().mockResolvedValue(null),
+          create: vi.fn(),
+          update: vi.fn(),
+        },
+        };
+        prisma.$transaction = async (callback) => callback(prisma);
+        return prisma;
+      })(),
+    });
+
+    const today = parseDateOnlyString(currentDateString("Asia/Shanghai"));
+    const end = new Date(today.getTime());
+    end.setUTCDate(end.getUTCDate() + 30);
+
+    const response = await app.inject({
+      method: "GET",
+      url: "/api/contracts-registry/expiring",
+    });
+
+    expect(response.statusCode).toBe(200);
+    expect(response.json().data).toEqual(
+      expect.objectContaining({
+        days: 30,
+        total: 1,
+      }),
+    );
+    expect(contractFindMany).toHaveBeenCalledWith(
+      expect.objectContaining({
+        where: {
+          AND: expect.arrayContaining([
+            { status: "active" },
+            expect.objectContaining({
+              expiry_date: expect.objectContaining({
+                gte: today,
+                lte: end,
+              }),
+            }),
+          ]),
+        },
+      }),
+    );
+
+    await app.close();
+  });
+
+  it("renews an active contract into the next draft revision and archives the source", async () => {
+    const stateful = buildStatefulPrisma([
+      buildContractRow({
+        id: "55555555-5555-4555-8555-555555555551",
+        contract_no: "HT-2026-001",
+        status: "active",
+      }),
+      buildContractRow({
+        id: "55555555-5555-4555-8555-555555555552",
+        contract_no: "HT-2026-001-R1",
+        status: "archived",
+      }),
+    ]);
+    const { app } = await buildApp({ prisma: stateful.prisma });
+
+    const response = await app.inject({
+      method: "POST",
+      url: "/api/contracts-registry/55555555-5555-4555-8555-555555555551/renew",
+    });
+
+    expect(response.statusCode).toBe(200);
+    expect(response.json().data).toEqual(
+      expect.objectContaining({
+        item: expect.objectContaining({
+          contractNo: "HT-2026-001-R2",
+          status: "draft",
+          persistedStatus: "draft",
+        }),
+        sourceItem: expect.objectContaining({
+          contractNo: "HT-2026-001",
+          status: "archived",
+          persistedStatus: "archived",
+        }),
+      }),
+    );
+    expect(stateful.state.contracts.find((item) => item.id === "55555555-5555-4555-8555-555555555551")?.status).toBe("archived");
+    expect(
+      stateful.state.contracts.some((item) => item.contract_no === "HT-2026-001-R2" && item.status === "draft"),
+    ).toBe(true);
+    expect(stateful.state.audits.map((item) => item.action)).toEqual(
+      expect.arrayContaining(["CONTRACT_REGISTRY_RENEWED", "CONTRACT_REGISTRY_STATUS_CHANGED"]),
+    );
+
+    await app.close();
+  });
+
+  it("rejects renewing a draft contract", async () => {
+    const stateful = buildStatefulPrisma([
+      buildContractRow({
+        id: "55555555-5555-4555-8555-555555555553",
+        contract_no: "HT-2026-003",
+        status: "draft",
+      }),
+    ]);
+    const { app } = await buildApp({ prisma: stateful.prisma });
+
+    const response = await app.inject({
+      method: "POST",
+      url: "/api/contracts-registry/55555555-5555-4555-8555-555555555553/renew",
+    });
+
+    expect(response.statusCode).toBe(409);
+    expect(response.json().error).toEqual(
+      expect.objectContaining({
+        code: "VALID_001",
+        details: expect.objectContaining({ status: "renew_not_allowed" }),
+      }),
+    );
+
+    await app.close();
+  });
+});
diff --git a/server/tests/unit/routes/exports.contractsRegistry.test.js b/server/tests/unit/routes/exports.contractsRegistry.test.js
new file mode 100644
index 00000000..8ed19025
--- /dev/null
+++ b/server/tests/unit/routes/exports.contractsRegistry.test.js
@@ -0,0 +1,206 @@
+const Fastify = require("fastify");
+
+const exportsRoutes = require("../../../src/routes/exports");
+
+const ACTOR_ID = "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa";
+const PROJECT_ID = "11111111-1111-4111-8111-111111111111";
+const OWNER_ID = "22222222-2222-4222-8222-222222222222";
+const DEPARTMENT_ID = "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb";
+
+function buildFeatureFlagRecord(flagKey) {
+  return {
+    id: `flag-${flagKey}`,
+    flag_key: flagKey,
+    override_mode: "force_on",
+    rollout_type: "global",
+    department_ids: [],
+    note: "unit-test",
+    version: 1,
+    created_at: new Date("2026-04-04T08:00:00.000Z"),
+    created_by: null,
+    updated_at: new Date("2026-04-04T08:00:00.000Z"),
+    updated_by: null,
+  };
+}
+
+function buildContractRow(overrides = {}) {
+  return {
+    id: "contract-1",
+    contract_no: "HT-2026-001",
+    project_id: PROJECT_ID,
+    contract_type: "service",
+    counterparty_name: "测试客户",
+    summary: "合同摘要",
+    amount: "88000.00",
+    currency: "CNY",
+    signed_date: new Date("2026-03-01T00:00:00.000Z"),
+    effective_date: new Date("2026-03-05T00:00:00.000Z"),
+    expiry_date: new Date("2026-03-31T00:00:00.000Z"),
+    confidentiality_level: "internal",
+    archive_location: "/archive/contracts/001",
+    offline_archive_no: "OFF-001",
+    owner_employee_id: OWNER_ID,
+    status: "active",
+    created_at: new Date("2026-03-01T08:00:00.000Z"),
+    updated_at: new Date("2026-04-01T08:00:00.000Z"),
+    owner: {
+      name: "Owner",
+    },
+    project: {
+      project_no: "PRJ-001",
+      name: "试点项目",
+    },
+    ...overrides,
+  };
+}
+
+async function buildApp(options = {}) {
+  const app = Fastify();
+  const actor = options.actor ?? {
+    id: ACTOR_ID,
+    department_id: DEPARTMENT_ID,
+    permissionCodes: ["project.manage"],
+  };
+  const count = options.count ?? vi.fn().mockResolvedValue(1);
+  const findMany =
+    options.findMany ??
+    vi.fn().mockImplementation(async ({ where }) => {
+      if (where?.OR) {
+        return [];
+      }
+      return [buildContractRow()];
+    });
+  const auditCreate = options.auditCreate ?? vi.fn().mockResolvedValue({});
+
+  app.decorate("authenticate", async (request) => {
+    request.employee = actor;
+  });
+  app.decorate("requirePermission", (permissionCode) => async (request) => {
+    request.employee = actor;
+    const permissionCodes = actor.permissionCodes ?? [];
+    if (!permissionCodes.includes("*") && !permissionCodes.includes(permissionCode)) {
+      throw new Error(`unexpected permission check: ${permissionCode}`);
+    }
+  });
+  app.decorate("hasPermission", (employee, permissionCode) => {
+    const permissionCodes = employee.permissionCodes ?? [];
+    return permissionCodes.includes("*") || permissionCodes.includes(permissionCode);
+  });
+  app.decorate("config", {
+    appTimezone: "Asia/Shanghai",
+    projectLinkingEnabled: true,
+  });
+  app.decorate("prisma", {
+    featureFlag: {
+      findUnique: vi.fn().mockImplementation(async ({ where }) => buildFeatureFlagRecord(where.flag_key)),
+    },
+    auditLog: {
+      create: auditCreate,
+    },
+    contractRegistry: {
+      count,
+      findMany,
+    },
+  });
+
+  await app.register(exportsRoutes, { prefix: "/api" });
+  return { app, count, findMany, auditCreate };
+}
+
+describe("contracts registry export route", () => {
+  it("exports filtered contracts registry as csv", async () => {
+    const { app, count, findMany, auditCreate } = await buildApp();
+
+    const response = await app.inject({
+      method: "POST",
+      url: "/api/exports/contracts-registry",
+      payload: {
+        format: "csv",
+        status: "expired",
+        contractType: "service",
+        counterpartyName: "测试",
+        expiryDateFrom: "2026-03-01",
+        expiryDateTo: "2026-03-31",
+      },
+    });
+
+    expect(response.statusCode).toBe(200);
+    expect(response.headers["content-type"]).toContain("text/csv");
+    expect(response.headers["content-disposition"]).toContain("contracts-registry-");
+    expect(response.body).toContain("合同编号");
+    expect(response.body).toContain("服务合同");
+    expect(response.body).toContain("已过期");
+    expect(count).toHaveBeenCalledWith(
+      expect.objectContaining({
+        where: expect.objectContaining({
+          AND: expect.arrayContaining([
+            expect.objectContaining({ contract_type: "service" }),
+            expect.objectContaining({
+              counterparty_name: expect.objectContaining({ contains: "测试", mode: "insensitive" }),
+            }),
+          ]),
+        }),
+      }),
+    );
+    expect(findMany).toHaveBeenCalled();
+    expect(auditCreate).toHaveBeenCalledWith(
+      expect.objectContaining({
+        data: expect.objectContaining({
+          action: "EXPORT_CONTRACTS_REGISTRY",
+          extra: expect.objectContaining({
+            format: "csv",
+            status: "expired",
+            contractType: "service",
+            counterpartyName: "测试",
+            matchedTotal: 1,
+          }),
+        }),
+      }),
+    );
+
+    await app.close();
+  });
+
+  it("exports contracts registry as xlsx", async () => {
+    const { app, auditCreate } = await buildApp({
+      count: vi.fn().mockResolvedValue(1),
+      findMany: vi.fn().mockResolvedValue([
+        buildContractRow({
+          id: "contract-2",
+          contract_no: "HT-2026-002",
+          contract_type: "purchase",
+          status: "archived",
+          expiry_date: new Date("2026-04-15T00:00:00.000Z"),
+        }),
+      ]),
+    });
+
+    const response = await app.inject({
+      method: "POST",
+      url: "/api/exports/contracts-registry",
+      payload: {
+        format: "xlsx",
+      },
+    });
+
+    expect(response.statusCode).toBe(200);
+    expect(response.headers["content-type"]).toContain(
+      "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    );
+    expect(response.headers["content-disposition"]).toContain("contracts-registry-");
+    expect(Buffer.from(response.rawPayload).length).toBeGreaterThan(0);
+    expect(auditCreate).toHaveBeenCalledWith(
+      expect.objectContaining({
+        data: expect.objectContaining({
+          action: "EXPORT_CONTRACTS_REGISTRY",
+          extra: expect.objectContaining({
+            format: "xlsx",
+            matchedTotal: 1,
+          }),
+        }),
+      }),
+    );
+
+    await app.close();
+  });
+});