fix: 修复统一广告模块路由参数类型规范问题 (Story 010.004)

为统一广告模块的 `/:id` 路由添加 request.params 定义，
使用 z.coerce.number<number>() 进行类型转换，使 RPC 客户端
能正确推断参数为 number 类型而非 string。

后端变更:
- unified-advertisements.admin.routes.ts: 为 getRoute/updateRoute/deleteRoute 添加 params 定义
- unified-advertisement-types.admin.routes.ts: 为 getRoute/updateRoute/deleteRoute 添加 params 定义
- 路由处理函数使用 c.req.valid('param') 替代 parseInt(c.req.param('id'))

前端变更:
- UnifiedAdvertisementManagement.tsx: 移除 String(id) 类型转换
- UnifiedAdvertisementTypeManagement.tsx: 移除 String(id) 类型转换

测试: 57/57 通过

🤖 Generated with [Claude Code](https://claude.com/claude-code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

docs/prd/epic-010-unified-ad-management.md

@@ -7,6 +7,8 @@
 | 1.0 | 2026-01-02 | 初始版本 | James (Claude Code) |
 | 1.1 | 2026-01-03 | 完成任务11：添加广告类型管理路由测试 | James (Claude Code) |
 | 1.2 | 2026-01-03 | 添加故事010.003：修复路由路径规范问题 | James (Claude Code) |
+| 1.3 | 2026-01-03 | 添加故事010.004：修复路由参数类型规范问题 | James (Claude Code) |
+| 1.4 | 2026-01-03 | 完成故事010.004：修复路由参数类型规范问题 | James (Claude Code) |
 
 ## 史诗目标
 
@@ -111,7 +113,35 @@
 **完成日期**: 2026-01-03
 **相关文件**: `docs/stories/010.003.story.md`
 
-### Story 4: Web集成和Server模块替换
+### Story 4: 修复路由参数类型规范问题 ✅ 已完成
+
+**标题**: 修复统一广告模块路由参数类型规范问题
+
+**描述**: 统一广告模块的路由定义中缺少 `params` schema 定义，导致 RPC 客户端推断出的 `:id` 参数类型为 `string`，而不是 `number`。需要在路由 schema 中添加 `params` 定义，使用 `z.coerce.number()` 进行类型转换。
+
+**问题说明**:
+- **错误**: 路由没有定义 `request.params`，导致 RPC 客户端推断 `:id` 为 `string` 类型
+- **正确**: 使用 `z.coerce.number<number>()` 定义 params，自动转换 string 到 number
+- **原因**: 参照 `createCrudRoutes` 的开发规范，所有路径参数都应明确定义类型
+
+**任务**:
+- [x] 修复 `unified-advertisements.admin.routes.ts` 的 params 定义（getRoute, updateRoute, deleteRoute）
+- [x] 修复 `unified-advertisement-types.admin.routes.ts` 的 params 定义
+- [x] 更新 UI 包移除类型转换（直接传递 number）
+- [x] 验证集成测试通过
+
+**修复内容**:
+1. **getRoute**: 添加 `request.params` 定义，使用 `z.coerce.number<number>()`
+2. **updateRoute**: 添加 `request.params` 定义
+3. **deleteRoute**: 添加 `request.params` 定义
+4. **前端 UI**: 移除 `String(id)` 类型转换
+5. **路由处理函数**: 使用 `c.req.valid('param')` 替代 `parseInt(c.req.param('id'))`
+
+**完成日期**: 2026-01-03
+**测试结果**: 57/57 测试通过
+**相关文件**: `docs/stories/010.004.story.md`
+
+### Story 5: Web集成和Server模块替换
 
 **标题**: 集成到租户后台、移除admin后台广告管理、Server切换模块
 

docs/stories/010.004.story.md

@@ -0,0 +1,175 @@
+# Story 010.004: 修复路由参数类型规范问题
+
+## 元数据
+| 字段 | 值 |
+|------|-----|
+| **史诗** | Epic 010: 统一广告管理系统 |
+| **状态** | Ready for Review |
+| **优先级** | 中 |
+| **故事类型** | 修复 (Bug Fix) |
+| **工作量** | 1小时 |
+| **负责人** | - |
+| **创建日期** | 2026-01-03 |
+
+## 故事描述
+
+### 问题描述
+统一广告模块 (`unified-advertisements-module`) 的路由定义中缺少 `params` schema 定义，导致 RPC 客户端推断出的 `:id` 参数类型为 `string`，而不是 `number`。这违反了后端模块开发规范，需要在路由 schema 中添加 `params` 定义，使用 `z.coerce.number()` 进行类型转换。
+
+### 问题影响
+- 前端 UI 包需要手动将 number 转换为 string（`String(id)`）
+- RPC 客户端类型推断不准确
+- 不符合 `createCrudRoutes` 的开发规范
+
+### 根本原因
+故事 010.001 实施时，路由定义使用的是手动方式而非 `createCrudRoutes`，没有在 schema 中定义 `request.params`，导致 Hono RPC 客户端无法正确推断参数类型。
+
+## 验收标准
+
+### 功能验收
+- [x] 所有管理员路由（广告、广告类型）的 `/:id` 操作都包含 `params` schema 定义
+- [x] `params` 使用 `z.coerce.number<number>()` 进行类型转换
+- [x] RPC 客户端能正确推断 `:id` 参数为 `number` 类型
+- [x] 集成测试全部通过
+
+### 技术验收
+- [x] 路由 schema 符合后端模块开发规范
+- [x] 前端 UI 包无需手动转换类型（可直接传递 number）
+- [x] 代码通过类型检查
+
+## 任务清单
+
+### 任务1: 修复管理员广告路由 params 定义
+- [x] 修改 `unified-advertisements.admin.routes.ts`
+  - [x] 为 `getRoute` 添加 `request.params` 定义
+  - [x] 为 `updateRoute` 添加 `request.params` 定义
+  - [x] 为 `deleteRoute` 添加 `request.params` 定义
+
+### 任务2: 修复管理员广告类型路由 params 定义
+- [x] 修改 `unified-advertisement-types.admin.routes.ts`
+  - [x] 为 `getRoute` 添加 `request.params` 定义
+  - [x] 为 `updateRoute` 添加 `request.params` 定义
+  - [x] 为 `deleteRoute` 添加 `request.params` 定义
+
+### 任务3: 更新 UI 包移除类型转换
+- [x] 修改 `unified-advertisement-management-ui` 组件
+  - [x] 移除 `String(id)` 类型转换
+  - [x] 验证类型检查通过
+
+### 任务4: 更新集成测试
+- [x] 更新集成测试中的 mock 数据类型
+- [x] 验证所有测试通过
+
+## 开发笔记
+
+### 修复参考
+对比项目 `createCrudRoutes` 的正确实现方式：
+
+**正确示例** (createCrudRoutes):
+```typescript
+const getRouteDef = createRoute({
+  method: 'get',
+  path: '/{id}',
+  middleware,
+  request: {
+    params: z.object({
+      id: z.coerce.number<number>().openapi({
+        param: { name: 'id', in: 'path' },
+        example: 1,
+        description: '资源ID'
+      })
+    })
+  },
+  // ...
+});
+```
+
+**错误示例** (修复前的 unified-advertisements-module):
+```typescript
+const getRoute = createRoute({
+  method: 'get',
+  path: '/:id',
+  middleware: [tenantAuthMiddleware] as const,
+  // ❌ 缺少 request.params 定义
+  responses: { /* ... */ }
+});
+```
+
+**正确示例** (修复后):
+```typescript
+const getRoute = createRoute({
+  method: 'get',
+  path: '/:id',
+  middleware: [tenantAuthMiddleware] as const,
+  request: {
+    params: z.object({
+      id: z.coerce.number<number>().openapi({
+        param: { name: 'id', in: 'path' },
+        example: 1,
+        description: '广告ID'
+      })
+    })
+  },
+  responses: { /* ... */ }
+});
+```
+
+### 修改文件清单
+
+#### 后端模块文件
+1. `packages/unified-advertisements-module/src/routes/admin/unified-advertisements.admin.routes.ts`
+2. `packages/unified-advertisements-module/src/routes/admin/unified-advertisement-types.admin.routes.ts`
+
+#### 前端 UI 文件
+3. `packages/unified-advertisement-management-ui/src/components/UnifiedAdvertisementManagement.tsx`
+4. `packages/unified-advertisement-management-ui/src/components/UnifiedAdvertisementTypeManagement.tsx`
+
+#### 测试文件
+5. `packages/unified-advertisements-module/tests/integration/unified-advertisements.integration.test.ts`
+
+### 关键变更说明
+
+**后端变更**:
+- 在每个带 `:id` 的路由中添加 `request.params` 定义
+- 使用 `z.coerce.number<number>()` 将字符串参数转换为数字
+
+**前端变更**:
+- 移除 `String(id)` 类型转换，直接传递 number 类型
+
+### 测试验证
+
+```bash
+# 后端模块测试
+pnpm --filter @d8d/unified-advertisements-module test
+
+# 前端 UI 包类型检查
+pnpm --filter @d8d/unified-advertisement-management-ui typecheck
+```
+
+## 完成备注
+
+### 实施总结
+已成功修复统一广告模块的路由参数类型规范问题。所有 `/:id` 路由现在都正确包含 `request.params` 定义，使用 `z.coerce.number<number>()` 进行类型转换。
+
+### 修改文件
+1. `packages/unified-advertisements-module/src/routes/admin/unified-advertisements.admin.routes.ts`
+2. `packages/unified-advertisements-module/src/routes/admin/unified-advertisement-types.admin.routes.ts`
+3. `packages/unified-advertisement-management-ui/src/components/UnifiedAdvertisementManagement.tsx`
+4. `packages/unified-advertisement-management-ui/src/components/UnifiedAdvertisementTypeManagement.tsx`
+
+### 测试结果
+- ✅ 后端模块集成测试: 57/57 通过
+- ✅ 后端模块类型检查: 通过
+
+### 开发代理
+- **Agent**: James (dev)
+- **模型**: d8d-model
+- **完成日期**: 2026-01-03
+
+## 相关文档
+
+- [后端模块包开发规范](../architecture/backend-module-package-standards.md)
+- [史诗 010: 统一广告管理系统](../prd/epic-010-unified-ad-management.md)
+- [故事 010.001: 创建统一广告模块](010.001.story.md)
+- [故事 010.002: 创建统一广告管理UI包](010.002.story.md)
+- [故事 010.003: 修复路由路径规范问题](010.003.story.md)

packages/unified-advertisement-management-ui/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@d8d/unified-advertisement-management-ui",
+  "version": "1.0.0",
+  "description": "统一广告管理界面包 - 提供统一广告管理和广告类型管理的完整前端界面，包括广告CRUD操作、类型管理、状态管理、图片上传等功能",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts",
+      "require": "./src/index.ts"
+    },
+    "./components": {
+      "types": "./src/components/index.ts",
+      "import": "./src/components/index.ts",
+      "require": "./src/components/index.ts"
+    },
+    "./api": {
+      "types": "./src/api/index.ts",
+      "import": "./src/api/index.ts",
+      "require": "./src/api/index.ts"
+    }
+  },
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "build": "unbuild",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts,.tsx",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@d8d/shared-types": "workspace:*",
+    "@d8d/shared-ui-components": "workspace:*",
+    "@d8d/unified-advertisements-module": "workspace:*",
+    "@d8d/file-management-ui-mt": "workspace:*",
+    "@hookform/resolvers": "^5.2.1",
+    "@tanstack/react-query": "^5.90.9",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "date-fns": "^4.1.0",
+    "hono": "^4.8.5",
+    "lucide-react": "^0.536.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "react-hook-form": "^7.61.1",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.3.1",
+    "zod": "^4.0.15"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.8.0",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/node": "^22.10.2",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.18.1",
+    "@typescript-eslint/parser": "^8.18.1",
+    "eslint": "^9.17.0",
+    "jsdom": "^26.0.0",
+    "typescript": "^5.8.3",
+    "unbuild": "^3.4.0",
+    "vitest": "^4.0.9"
+  },
+  "peerDependencies": {
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0"
+  },
+  "keywords": [
+    "advertisement",
+    "management",
+    "admin",
+    "ui",
+    "react",
+    "crud",
+    "banner",
+    "unified"
+  ],
+  "author": "D8D Team",
+  "license": "MIT"
+}

packages/unified-advertisement-management-ui/src/api/index.ts

@@ -0,0 +1,11 @@
+export {
+  UnifiedAdvertisementClientManager,
+  unifiedAdvertisementClientManager,
+  unifiedAdvertisementClient
+} from './unifiedAdvertisementClient';
+
+export {
+  UnifiedAdvertisementTypeClientManager,
+  unifiedAdvertisementTypeClientManager,
+  unifiedAdvertisementTypeClient
+} from './unifiedAdvertisementTypeClient';

packages/unified-advertisement-management-ui/src/api/unifiedAdvertisementClient.ts

@@ -0,0 +1,56 @@
+import { unifiedAdvertisementAdminRoutes } from '@d8d/unified-advertisements-module';
+import { rpcClient } from '@d8d/shared-ui-components/utils/hc';
+
+/**
+ * 统一广告 RPC 客户端管理器
+ * 使用单例模式管理客户端实例，支持初始化、获取和重置
+ */
+export class UnifiedAdvertisementClientManager {
+  private static instance: UnifiedAdvertisementClientManager;
+  private client: ReturnType<typeof rpcClient<typeof unifiedAdvertisementAdminRoutes>> | null = null;
+
+  private constructor() {}
+
+  public static getInstance(): UnifiedAdvertisementClientManager {
+    if (!UnifiedAdvertisementClientManager.instance) {
+      UnifiedAdvertisementClientManager.instance = new UnifiedAdvertisementClientManager();
+    }
+    return UnifiedAdvertisementClientManager.instance;
+  }
+
+  /**
+   * 初始化客户端
+   * @param baseUrl - API基础路径，默认为 '/'
+   */
+  public init(baseUrl: string = '/'): ReturnType<typeof rpcClient<typeof unifiedAdvertisementAdminRoutes>> {
+    return this.client = rpcClient<typeof unifiedAdvertisementAdminRoutes>(baseUrl);
+  }
+
+  /**
+   * 获取客户端实例
+   * 如果客户端未初始化，则自动初始化
+   */
+  public get(): ReturnType<typeof rpcClient<typeof unifiedAdvertisementAdminRoutes>> {
+    if (!this.client) {
+      return this.init();
+    }
+    return this.client;
+  }
+
+  /**
+   * 重置客户端（用于测试或重新初始化）
+   */
+  public reset(): void {
+    this.client = null;
+  }
+}
+
+// 导出单例实例
+const unifiedAdvertisementClientManager = UnifiedAdvertisementClientManager.getInstance();
+
+// 导出默认客户端实例（延迟初始化）
+export const unifiedAdvertisementClient = unifiedAdvertisementClientManager.get();
+
+export {
+  unifiedAdvertisementClientManager
+};

packages/unified-advertisement-management-ui/src/api/unifiedAdvertisementTypeClient.ts

@@ -0,0 +1,56 @@
+import { unifiedAdvertisementTypeAdminRoutes } from '@d8d/unified-advertisements-module';
+import { rpcClient } from '@d8d/shared-ui-components/utils/hc';
+
+/**
+ * 统一广告类型 RPC 客户端管理器
+ * 使用单例模式管理客户端实例，支持初始化、获取和重置
+ */
+export class UnifiedAdvertisementTypeClientManager {
+  private static instance: UnifiedAdvertisementTypeClientManager;
+  private client: ReturnType<typeof rpcClient<typeof unifiedAdvertisementTypeAdminRoutes>> | null = null;
+
+  private constructor() {}
+
+  public static getInstance(): UnifiedAdvertisementTypeClientManager {
+    if (!UnifiedAdvertisementTypeClientManager.instance) {
+      UnifiedAdvertisementTypeClientManager.instance = new UnifiedAdvertisementTypeClientManager();
+    }
+    return UnifiedAdvertisementTypeClientManager.instance;
+  }
+
+  /**
+   * 初始化客户端
+   * @param baseUrl - API基础路径，默认为 '/'
+   */
+  public init(baseUrl: string = '/'): ReturnType<typeof rpcClient<typeof unifiedAdvertisementTypeAdminRoutes>> {
+    return this.client = rpcClient<typeof unifiedAdvertisementTypeAdminRoutes>(baseUrl);
+  }
+
+  /**
+   * 获取客户端实例
+   * 如果客户端未初始化，则自动初始化
+   */
+  public get(): ReturnType<typeof rpcClient<typeof unifiedAdvertisementTypeAdminRoutes>> {
+    if (!this.client) {
+      return this.init();
+    }
+    return this.client;
+  }
+
+  /**
+   * 重置客户端（用于测试或重新初始化）
+   */
+  public reset(): void {
+    this.client = null;
+  }
+}
+
+// 导出单例实例
+const unifiedAdvertisementTypeClientManager = UnifiedAdvertisementTypeClientManager.getInstance();
+
+// 导出默认客户端实例（延迟初始化）
+export const unifiedAdvertisementTypeClient = unifiedAdvertisementTypeClientManager.get();
+
+export {
+  unifiedAdvertisementTypeClientManager
+};

packages/unified-advertisement-management-ui/src/components/UnifiedAdvertisementManagement.tsx

@@ -0,0 +1,764 @@
+import React, { useState } from 'react';
+import { useQuery, useMutation } from '@tanstack/react-query';
+import { Plus, Edit, Trash2, Search } from 'lucide-react';
+import { format } from 'date-fns';
+import { Input } from '@d8d/shared-ui-components/components/ui/input';
+import { Button } from '@d8d/shared-ui-components/components/ui/button';
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@d8d/shared-ui-components/components/ui/card';
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@d8d/shared-ui-components/components/ui/table';
+import { Badge } from '@d8d/shared-ui-components/components/ui/badge';
+import { Skeleton } from '@d8d/shared-ui-components/components/ui/skeleton';
+import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from '@d8d/shared-ui-components/components/ui/dialog';
+import { Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage } from '@d8d/shared-ui-components/components/ui/form';
+import { useForm } from 'react-hook-form';
+import { zodResolver } from '@hookform/resolvers/zod';
+import { toast } from 'sonner';
+import { DataTablePagination } from '@d8d/shared-ui-components/components/admin/DataTablePagination';
+import { FileSelector } from '@d8d/file-management-ui-mt';
+import { UnifiedAdvertisementTypeSelector } from './UnifiedAdvertisementTypeSelector';
+import { unifiedAdvertisementClientManager } from '../api/unifiedAdvertisementClient';
+import {
+  CreateUnifiedAdvertisementDto,
+  UpdateUnifiedAdvertisementDto
+} from '@d8d/unified-advertisements-module/schemas';
+import type {
+  UnifiedAdvertisementSearchParams,
+  UnifiedAdvertisementResponse,
+  CreateUnifiedAdvertisementRequest,
+  UpdateUnifiedAdvertisementRequest
+} from '../types';
+
+type CreateRequest = CreateUnifiedAdvertisementRequest;
+type UpdateRequest = UpdateUnifiedAdvertisementRequest;
+
+const createFormSchema = CreateUnifiedAdvertisementDto;
+const updateFormSchema = UpdateUnifiedAdvertisementDto;
+
+/**
+ * 统一广告管理组件
+ * 提供广告的列表展示、创建、编辑、删除功能
+ */
+export const UnifiedAdvertisementManagement: React.FC = () => {
+  const [searchParams, setSearchParams] = useState<UnifiedAdvertisementSearchParams>({
+    page: 1,
+    pageSize: 10
+  });
+  const [isModalOpen, setIsModalOpen] = useState(false);
+  const [editingAdvertisement, setEditingAdvertisement] = useState<UnifiedAdvertisementResponse | null>(null);
+  const [isCreateForm, setIsCreateForm] = useState(true);
+  const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
+  const [advertisementToDelete, setAdvertisementToDelete] = useState<number | null>(null);
+
+  // 表单实例
+  const createForm = useForm<CreateRequest>({
+    resolver: zodResolver(createFormSchema),
+    defaultValues: {
+      title: '',
+      typeId: undefined,
+      code: '',
+      url: '',
+      imageFileId: undefined,
+      sort: 0,
+      status: 1,
+      actionType: 1
+    }
+  });
+
+  const updateForm = useForm<UpdateRequest>({
+    resolver: zodResolver(updateFormSchema),
+    defaultValues: {}
+  });
+
+  // 数据查询
+  const { data, isLoading, refetch } = useQuery({
+    queryKey: ['unified-advertisements', searchParams],
+    queryFn: async () => {
+      const res = await unifiedAdvertisementClientManager.get().index.$get({
+        query: {
+          page: searchParams.page,
+          pageSize: searchParams.pageSize,
+          keyword: searchParams.keyword,
+          status: searchParams.status
+        }
+      });
+      if (res.status !== 200) throw new Error('获取广告列表失败');
+      return await res.json();
+    }
+  });
+
+  // 创建广告
+  const createMutation = useMutation({
+    mutationFn: async (data: CreateRequest) => {
+      const res = await unifiedAdvertisementClientManager.get().index.$post({ json: data });
+      if (res.status !== 201) throw new Error('创建广告失败');
+      return await res.json();
+    },
+    onSuccess: () => {
+      toast.success('广告创建成功');
+      setIsModalOpen(false);
+      createForm.reset();
+      refetch();
+    },
+    onError: (error) => {
+      toast.error(error instanceof Error ? error.message : '创建广告失败');
+    }
+  });
+
+  // 更新广告
+  const updateMutation = useMutation({
+    mutationFn: async ({ id, data }: { id: number; data: UpdateRequest }) => {
+      const res = await unifiedAdvertisementClientManager.get()[':id'].$put({
+        param: { id },
+        json: data
+      });
+      if (res.status !== 200) throw new Error('更新广告失败');
+      return await res.json();
+    },
+    onSuccess: () => {
+      toast.success('广告更新成功');
+      setIsModalOpen(false);
+      setEditingAdvertisement(null);
+      refetch();
+    },
+    onError: (error) => {
+      toast.error(error instanceof Error ? error.message : '更新广告失败');
+    }
+  });
+
+  // 删除广告
+  const deleteMutation = useMutation({
+    mutationFn: async (id: number) => {
+      const res = await unifiedAdvertisementClientManager.get()[':id'].$delete({
+        param: { id }
+      });
+      if (res.status !== 200) throw new Error('删除广告失败');
+      return await res.json();
+    },
+    onSuccess: () => {
+      toast.success('广告删除成功');
+      setDeleteDialogOpen(false);
+      setAdvertisementToDelete(null);
+      refetch();
+    },
+    onError: (error) => {
+      toast.error(error instanceof Error ? error.message : '删除广告失败');
+    }
+  });
+
+  // 处理搜索
+  const handleSearch = (e: React.FormEvent) => {
+    e.preventDefault();
+    setSearchParams(prev => ({ ...prev, page: 1 }));
+    refetch();
+  };
+
+  // 处理创建广告
+  const handleCreateAdvertisement = () => {
+    setIsCreateForm(true);
+    setEditingAdvertisement(null);
+    createForm.reset();
+    setIsModalOpen(true);
+  };
+
+  // 处理编辑广告
+  const handleEditAdvertisement = (advertisement: UnifiedAdvertisementResponse) => {
+    setIsCreateForm(false);
+    setEditingAdvertisement(advertisement);
+    updateForm.reset({
+      title: advertisement.title || undefined,
+      typeId: advertisement.typeId || undefined,
+      code: advertisement.code || undefined,
+      url: advertisement.url || undefined,
+      imageFileId: advertisement.imageFileId || undefined,
+      sort: advertisement.sort || undefined,
+      status: advertisement.status || undefined,
+      actionType: advertisement.actionType || undefined
+    });
+    setIsModalOpen(true);
+  };
+
+  // 处理删除广告
+  const handleDeleteAdvertisement = (id: number) => {
+    setAdvertisementToDelete(id);
+    setDeleteDialogOpen(true);
+  };
+
+  // 确认删除
+  const confirmDelete = () => {
+    if (advertisementToDelete) {
+      deleteMutation.mutate(advertisementToDelete);
+    }
+  };
+
+  // 处理创建表单提交
+  const handleCreateSubmit = async (data: CreateRequest) => {
+    try {
+      await createMutation.mutateAsync(data);
+    } catch (error) {
+      throw error;
+    }
+  };
+
+  // 处理编辑表单提交
+  const handleUpdateSubmit = async (data: UpdateRequest) => {
+    if (!editingAdvertisement) return;
+
+    try {
+      await updateMutation.mutateAsync({
+        id: editingAdvertisement.id,
+        data
+      });
+    } catch (error) {
+      throw error;
+    }
+  };
+
+  return (
+    <div className="space-y-4">
+      <div className="flex justify-between items-center">
+        <h1 className="text-2xl font-bold">统一广告管理</h1>
+        <Button onClick={handleCreateAdvertisement} data-testid="create-unified-advertisement-button">
+          <Plus className="mr-2 h-4 w-4" />
+          创建广告
+        </Button>
+      </div>
+
+      <Card>
+        <CardHeader>
+          <CardTitle>广告列表</CardTitle>
+          <CardDescription>管理所有租户的广告内容</CardDescription>
+        </CardHeader>
+        <CardContent>
+          <div className="mb-4">
+            <form onSubmit={handleSearch} className="flex gap-2">
+              <div className="relative flex-1 max-w-sm">
+                <Search className="absolute left-2 top-2.5 h-4 w-4 text-muted-foreground" />
+                <Input
+                  placeholder="搜索广告标题或别名..."
+                  value={searchParams.keyword || ''}
+                  onChange={(e) => setSearchParams(prev => ({ ...prev, keyword: e.target.value }))}
+                  className="pl-8"
+                  data-testid="search-input"
+                />
+              </div>
+              <Button type="submit" variant="outline">
+                搜索
+              </Button>
+            </form>
+          </div>
+
+          <div className="rounded-md border">
+            <div className="relative w-full overflow-x-auto">
+              <Table>
+                <TableHeader>
+                  <TableRow>
+                    <TableHead>ID</TableHead>
+                    <TableHead>标题</TableHead>
+                    <TableHead>类型</TableHead>
+                    <TableHead>别名</TableHead>
+                    <TableHead>图片</TableHead>
+                    <TableHead>状态</TableHead>
+                    <TableHead>排序</TableHead>
+                    <TableHead>创建时间</TableHead>
+                    <TableHead className="text-right">操作</TableHead>
+                  </TableRow>
+                </TableHeader>
+                <TableBody>
+                  {isLoading ? (
+                    Array.from({ length: 5 }).map((_, index) => (
+                      <TableRow key={index}>
+                        <TableCell><Skeleton className="h-4 w-8" /></TableCell>
+                        <TableCell><Skeleton className="h-4 w-32" /></TableCell>
+                        <TableCell><Skeleton className="h-4 w-20" /></TableCell>
+                        <TableCell><Skeleton className="h-4 w-24" /></TableCell>
+                        <TableCell><Skeleton className="h-8 w-8 rounded" /></TableCell>
+                        <TableCell><Skeleton className="h-6 w-12 rounded-full" /></TableCell>
+                        <TableCell><Skeleton className="h-4 w-8" /></TableCell>
+                        <TableCell><Skeleton className="h-4 w-24" /></TableCell>
+                        <TableCell>
+                          <div className="flex justify-end gap-2">
+                            <Skeleton className="h-8 w-8 rounded" />
+                            <Skeleton className="h-8 w-8 rounded" />
+                          </div>
+                        </TableCell>
+                      </TableRow>
+                    ))
+                  ) : data?.data?.list && data.data.list.length > 0 ? (
+                    data.data.list.map((advertisement) => (
+                      <TableRow key={advertisement.id}>
+                        <TableCell>{advertisement.id}</TableCell>
+                        <TableCell>{advertisement.title || '-'}</TableCell>
+                        <TableCell>
+                          {advertisement.advertisementType?.name || '-'}
+                        </TableCell>
+                        <TableCell>
+                          <code className="text-xs bg-muted px-1 rounded">{advertisement.code || '-'}</code>
+                        </TableCell>
+                        <TableCell>
+                          {advertisement.imageFile?.fullUrl ? (
+                            <img
+                              src={advertisement.imageFile.fullUrl}
+                              alt={advertisement.title || '广告图片'}
+                              className="w-16 h-10 object-cover rounded"
+                              onError={(e) => {
+                                e.currentTarget.src = '/placeholder.png';
+                              }}
+                            />
+                          ) : (
+                            <span className="text-muted-foreground text-xs">无图片</span>
+                          )}
+                        </TableCell>
+                        <TableCell>
+                          <Badge variant={advertisement.status === 1 ? 'default' : 'secondary'}>
+                            {advertisement.status === 1 ? '启用' : '禁用'}
+                          </Badge>
+                        </TableCell>
+                        <TableCell>{advertisement.sort}</TableCell>
+                        <TableCell>
+                          {advertisement.createdAt ? format(new Date(advertisement.createdAt), 'yyyy-MM-dd HH:mm') : '-'}
+                        </TableCell>
+                        <TableCell className="text-right">
+                          <div className="flex justify-end gap-2">
+                            <Button
+                              variant="ghost"
+                              size="icon"
+                              onClick={() => handleEditAdvertisement(advertisement)}
+                              data-testid={`edit-button-${advertisement.id}`}
+                            >
+                              <Edit className="h-4 w-4" />
+                            </Button>
+                            <Button
+                              variant="ghost"
+                              size="icon"
+                              onClick={() => handleDeleteAdvertisement(advertisement.id)}
+                              data-testid={`delete-button-${advertisement.id}`}
+                            >
+                              <Trash2 className="h-4 w-4" />
+                            </Button>
+                          </div>
+                        </TableCell>
+                      </TableRow>
+                    ))
+                  ) : (
+                    <TableRow>
+                      <TableCell colSpan={9} className="text-center py-8">
+                        <p className="text-muted-foreground">暂无广告数据</p>
+                      </TableCell>
+                    </TableRow>
+                  )}
+                </TableBody>
+              </Table>
+            </div>
+          </div>
+
+          <DataTablePagination
+            currentPage={searchParams.page}
+            pageSize={searchParams.pageSize}
+            totalCount={data?.data?.total || 0}
+            onPageChange={(page, pageSize) => setSearchParams(prev => ({ ...prev, page, pageSize }))}
+          />
+        </CardContent>
+      </Card>
+
+      {/* 创建/编辑对话框 */}
+      <Dialog open={isModalOpen} onOpenChange={setIsModalOpen}>
+        <DialogContent className="sm:max-w-[600px] max-h-[90vh] overflow-y-auto">
+          <DialogHeader>
+            <DialogTitle data-testid="modal-title">
+              {isCreateForm ? '创建广告' : '编辑广告'}
+            </DialogTitle>
+            <DialogDescription data-testid="modal-description">
+              {isCreateForm ? '创建一个新的广告' : '编辑现有广告信息'}
+            </DialogDescription>
+          </DialogHeader>
+
+          {isCreateForm ? (
+            // 创建表单（独立渲染）
+            <Form {...createForm}>
+              <form onSubmit={createForm.handleSubmit(handleCreateSubmit)} className="space-y-4">
+                <FormField
+                  control={createForm.control}
+                  name="title"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel className="flex items-center">
+                        标题 <span className="text-red-500 ml-1">*</span>
+                      </FormLabel>
+                      <FormControl>
+                        <Input placeholder="请输入广告标题" {...field} data-testid="title-input" />
+                      </FormControl>
+                      <FormDescription>广告显示的标题文本，最多30个字符</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={createForm.control}
+                  name="typeId"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel className="flex items-center">
+                        广告类型 <span className="text-red-500 ml-1">*</span>
+                      </FormLabel>
+                      <FormControl>
+                        <UnifiedAdvertisementTypeSelector
+                          value={field.value}
+                          onChange={field.onChange}
+                          placeholder="请选择广告类型"
+                          testId="type-selector"
+                        />
+                      </FormControl>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={createForm.control}
+                  name="code"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel className="flex items-center">
+                        调用别名 <span className="text-red-500 ml-1">*</span>
+                      </FormLabel>
+                      <FormControl>
+                        <Input placeholder="请输入调用别名" {...field} data-testid="code-input" />
+                      </FormControl>
+                      <FormDescription>用于程序调用的唯一标识，最多20个字符</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={createForm.control}
+                  name="imageFileId"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>广告图片</FormLabel>
+                      <FormControl>
+                        <FileSelector
+                          value={field.value || undefined}
+                          onChange={field.onChange}
+                          maxSize={2}
+                          uploadPath="/unified-advertisements"
+                          previewSize="medium"
+                          placeholder="选择广告图片"
+                          title="选择广告图片"
+                          description="上传新图片或从已有图片中选择"
+                          filterType="image"
+                        />
+                      </FormControl>
+                      <FormDescription>推荐尺寸：1200x400px，支持jpg、png格式</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={createForm.control}
+                  name="url"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>跳转链接</FormLabel>
+                      <FormControl>
+                        <Input placeholder="请输入跳转链接" {...field} data-testid="url-input" />
+                      </FormControl>
+                      <FormDescription>点击广告后跳转的URL地址</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <div className="grid grid-cols-2 gap-4">
+                  <FormField
+                    control={createForm.control}
+                    name="actionType"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>跳转类型</FormLabel>
+                        <FormControl>
+                          <select
+                            {...field}
+                            className="h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm"
+                            value={field.value || 1}
+                            onChange={(e) => field.onChange(parseInt(e.target.value))}
+                            data-testid="action-type-select"
+                          >
+                            <option value={0}>不跳转</option>
+                            <option value={1}>Web页面</option>
+                            <option value={2}>小程序页面</option>
+                          </select>
+                        </FormControl>
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+
+                  <FormField
+                    control={createForm.control}
+                    name="sort"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>排序值</FormLabel>
+                        <FormControl>
+                          <Input
+                            type="number"
+                            placeholder="排序值"
+                            {...field}
+                            onChange={(e) => field.onChange(parseInt(e.target.value))}
+                            data-testid="sort-input"
+                          />
+                        </FormControl>
+                        <FormDescription>数值越大排序越靠前</FormDescription>
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                <FormField
+                  control={createForm.control}
+                  name="status"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>状态</FormLabel>
+                      <FormControl>
+                        <select
+                          {...field}
+                          className="h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm"
+                          value={field.value || 1}
+                          onChange={(e) => field.onChange(parseInt(e.target.value))}
+                          data-testid="status-select"
+                        >
+                          <option value={1}>启用</option>
+                          <option value={0}>禁用</option>
+                        </select>
+                      </FormControl>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <DialogFooter>
+                  <Button type="button" variant="outline" onClick={() => setIsModalOpen(false)}>
+                    取消
+                  </Button>
+                  <Button type="submit" disabled={createMutation.isPending} data-testid="create-submit-button">
+                    创建
+                  </Button>
+                </DialogFooter>
+              </form>
+            </Form>
+          ) : (
+            // 编辑表单（独立渲染）
+            <Form {...updateForm}>
+              <form onSubmit={updateForm.handleSubmit(handleUpdateSubmit)} className="space-y-4">
+                <FormField
+                  control={updateForm.control}
+                  name="title"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel className="flex items-center">
+                        标题 <span className="text-red-500 ml-1">*</span>
+                      </FormLabel>
+                      <FormControl>
+                        <Input placeholder="请输入广告标题" {...field} data-testid="title-input" />
+                      </FormControl>
+                      <FormDescription>广告显示的标题文本，最多30个字符</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={updateForm.control}
+                  name="typeId"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel className="flex items-center">
+                        广告类型 <span className="text-red-500 ml-1">*</span>
+                      </FormLabel>
+                      <FormControl>
+                        <UnifiedAdvertisementTypeSelector
+                          value={field.value}
+                          onChange={field.onChange}
+                          testId="type-selector"
+                        />
+                      </FormControl>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={updateForm.control}
+                  name="code"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel className="flex items-center">
+                        调用别名 <span className="text-red-500 ml-1">*</span>
+                      </FormLabel>
+                      <FormControl>
+                        <Input placeholder="请输入调用别名" {...field} data-testid="code-input" />
+                      </FormControl>
+                      <FormDescription>用于程序调用的唯一标识，最多20个字符</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={updateForm.control}
+                  name="imageFileId"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>广告图片</FormLabel>
+                      <FormControl>
+                        <FileSelector
+                          value={field.value || undefined}
+                          onChange={field.onChange}
+                          maxSize={2}
+                          uploadPath="/unified-advertisements"
+                          previewSize="medium"
+                          placeholder="选择广告图片"
+                          title="选择广告图片"
+                          description="上传新图片或从已有图片中选择"
+                          filterType="image"
+                        />
+                      </FormControl>
+                      <FormDescription>推荐尺寸：1200x400px，支持jpg、png格式</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={updateForm.control}
+                  name="url"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>跳转链接</FormLabel>
+                      <FormControl>
+                        <Input placeholder="请输入跳转链接" {...field} data-testid="url-input" />
+                      </FormControl>
+                      <FormDescription>点击广告后跳转的URL地址</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <div className="grid grid-cols-2 gap-4">
+                  <FormField
+                    control={updateForm.control}
+                    name="actionType"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>跳转类型</FormLabel>
+                        <FormControl>
+                          <select
+                            {...field}
+                            className="h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm"
+                            value={field.value || 1}
+                            onChange={(e) => field.onChange(parseInt(e.target.value))}
+                            data-testid="action-type-select"
+                          >
+                            <option value={0}>不跳转</option>
+                            <option value={1}>Web页面</option>
+                            <option value={2}>小程序页面</option>
+                          </select>
+                        </FormControl>
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+
+                  <FormField
+                    control={updateForm.control}
+                    name="sort"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>排序值</FormLabel>
+                        <FormControl>
+                          <Input
+                            type="number"
+                            placeholder="排序值"
+                            {...field}
+                            onChange={(e) => field.onChange(parseInt(e.target.value))}
+                            data-testid="sort-input"
+                          />
+                        </FormControl>
+                        <FormDescription>数值越大排序越靠前</FormDescription>
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+                </div>
+
+                <FormField
+                  control={updateForm.control}
+                  name="status"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>状态</FormLabel>
+                      <FormControl>
+                        <select
+                          {...field}
+                          className="h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm"
+                          value={field.value || 1}
+                          onChange={(e) => field.onChange(parseInt(e.target.value))}
+                          data-testid="status-select"
+                        >
+                          <option value={1}>启用</option>
+                          <option value={0}>禁用</option>
+                        </select>
+                      </FormControl>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <DialogFooter>
+                  <Button type="button" variant="outline" onClick={() => setIsModalOpen(false)}>
+                    取消
+                  </Button>
+                  <Button type="submit" disabled={updateMutation.isPending} data-testid="update-submit-button">
+                    更新
+                  </Button>
+                </DialogFooter>
+              </form>
+            </Form>
+          )}
+        </DialogContent>
+      </Dialog>
+
+      {/* 删除确认对话框 */}
+      <Dialog open={deleteDialogOpen} onOpenChange={setDeleteDialogOpen}>
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle data-testid="delete-dialog-title">确认删除</DialogTitle>
+            <DialogDescription data-testid="delete-dialog-description">
+              确定要删除这个广告吗？此操作无法撤销。
+            </DialogDescription>
+          </DialogHeader>
+          <DialogFooter>
+            <Button variant="outline" onClick={() => setDeleteDialogOpen(false)}>
+              取消
+            </Button>
+            <Button
+              variant="destructive"
+              onClick={confirmDelete}
+              disabled={deleteMutation.isPending}
+              data-testid="confirm-delete-button"
+            >
+              {deleteMutation.isPending ? '删除中...' : '删除'}
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </div>
+  );
+};
+
+export default UnifiedAdvertisementManagement;

packages/unified-advertisement-management-ui/src/components/UnifiedAdvertisementTypeManagement.tsx

@@ -0,0 +1,557 @@
+import React, { useState } from 'react';
+import { useQuery, useMutation } from '@tanstack/react-query';
+import { Plus, Edit, Trash2, Search } from 'lucide-react';
+import { format } from 'date-fns';
+import { Input } from '@d8d/shared-ui-components/components/ui/input';
+import { Button } from '@d8d/shared-ui-components/components/ui/button';
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@d8d/shared-ui-components/components/ui/card';
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@d8d/shared-ui-components/components/ui/table';
+import { Badge } from '@d8d/shared-ui-components/components/ui/badge';
+import { Skeleton } from '@d8d/shared-ui-components/components/ui/skeleton';
+import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from '@d8d/shared-ui-components/components/ui/dialog';
+import { Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage } from '@d8d/shared-ui-components/components/ui/form';
+import { Switch } from '@d8d/shared-ui-components/components/ui/switch';
+import { Textarea } from '@d8d/shared-ui-components/components/ui/textarea';
+import { useForm } from 'react-hook-form';
+import { zodResolver } from '@hookform/resolvers/zod';
+import { toast } from 'sonner';
+import { DataTablePagination } from '@d8d/shared-ui-components/components/admin/DataTablePagination';
+import { unifiedAdvertisementTypeClientManager } from '../api/unifiedAdvertisementTypeClient';
+import {
+  CreateUnifiedAdvertisementTypeDto,
+  UpdateUnifiedAdvertisementTypeDto
+} from '@d8d/unified-advertisements-module/schemas';
+import type {
+  UnifiedAdvertisementTypeSearchParams,
+  UnifiedAdvertisementTypeResponse,
+  CreateUnifiedAdvertisementTypeRequest,
+  UpdateUnifiedAdvertisementTypeRequest
+} from '../types';
+
+type CreateRequest = CreateUnifiedAdvertisementTypeRequest;
+type UpdateRequest = UpdateUnifiedAdvertisementTypeRequest;
+
+const createFormSchema = CreateUnifiedAdvertisementTypeDto;
+const updateFormSchema = UpdateUnifiedAdvertisementTypeDto;
+
+/**
+ * 统一广告类型管理组件
+ * 提供广告类型的列表展示、创建、编辑、删除功能
+ */
+export const UnifiedAdvertisementTypeManagement: React.FC = () => {
+  const [searchParams, setSearchParams] = useState<UnifiedAdvertisementTypeSearchParams>({
+    page: 1,
+    pageSize: 10
+  });
+  const [isModalOpen, setIsModalOpen] = useState(false);
+  const [editingType, setEditingType] = useState<UnifiedAdvertisementTypeResponse | null>(null);
+  const [isCreateForm, setIsCreateForm] = useState(true);
+  const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
+  const [typeToDelete, setTypeToDelete] = useState<number | null>(null);
+
+  // 表单实例
+  const createForm = useForm<CreateRequest>({
+    resolver: zodResolver(createFormSchema),
+    defaultValues: {
+      name: '',
+      code: '',
+      remark: '',
+      status: 1
+    }
+  });
+
+  const updateForm = useForm<UpdateRequest>({
+    resolver: zodResolver(updateFormSchema),
+    defaultValues: {}
+  });
+
+  // 数据查询
+  const { data, isLoading, refetch } = useQuery({
+    queryKey: ['unified-advertisement-types', searchParams],
+    queryFn: async () => {
+      const res = await unifiedAdvertisementTypeClientManager.get().index.$get({
+        query: {
+          page: searchParams.page,
+          pageSize: searchParams.pageSize,
+          keyword: searchParams.keyword,
+          status: searchParams.status
+        }
+      });
+      if (res.status !== 200) throw new Error('获取广告类型列表失败');
+      return await res.json();
+    }
+  });
+
+  // 创建广告类型
+  const createMutation = useMutation({
+    mutationFn: async (data: CreateRequest) => {
+      const res = await unifiedAdvertisementTypeClientManager.get().index.$post({ json: data });
+      if (res.status !== 201) throw new Error('创建广告类型失败');
+      return await res.json();
+    },
+    onSuccess: () => {
+      toast.success('广告类型创建成功');
+      setIsModalOpen(false);
+      createForm.reset();
+      refetch();
+    },
+    onError: (error) => {
+      toast.error(error instanceof Error ? error.message : '创建广告类型失败');
+    }
+  });
+
+  // 更新广告类型
+  const updateMutation = useMutation({
+    mutationFn: async ({ id, data }: { id: number; data: UpdateRequest }) => {
+      const res = await unifiedAdvertisementTypeClientManager.get()[':id'].$put({
+        param: { id },
+        json: data
+      });
+      if (res.status !== 200) throw new Error('更新广告类型失败');
+      return await res.json();
+    },
+    onSuccess: () => {
+      toast.success('广告类型更新成功');
+      setIsModalOpen(false);
+      setEditingType(null);
+      refetch();
+    },
+    onError: (error) => {
+      toast.error(error instanceof Error ? error.message : '更新广告类型失败');
+    }
+  });
+
+  // 删除广告类型
+  const deleteMutation = useMutation({
+    mutationFn: async (id: number) => {
+      const res = await unifiedAdvertisementTypeClientManager.get()[':id'].$delete({
+        param: { id }
+      });
+      if (res.status !== 200) throw new Error('删除广告类型失败');
+      return await res.json();
+    },
+    onSuccess: () => {
+      toast.success('广告类型删除成功');
+      setDeleteDialogOpen(false);
+      setTypeToDelete(null);
+      refetch();
+    },
+    onError: (error) => {
+      toast.error(error instanceof Error ? error.message : '删除广告类型失败');
+    }
+  });
+
+  // 处理搜索
+  const handleSearch = (e: React.FormEvent) => {
+    e.preventDefault();
+    setSearchParams(prev => ({ ...prev, page: 1 }));
+    refetch();
+  };
+
+  // 处理创建广告类型
+  const handleCreateType = () => {
+    setIsCreateForm(true);
+    setEditingType(null);
+    createForm.reset();
+    setIsModalOpen(true);
+  };
+
+  // 处理编辑广告类型
+  const handleEditType = (type: UnifiedAdvertisementTypeResponse) => {
+    setIsCreateForm(false);
+    setEditingType(type);
+    updateForm.reset({
+      name: type.name,
+      code: type.code,
+      remark: type.remark || '',
+      status: type.status
+    });
+    setIsModalOpen(true);
+  };
+
+  // 处理删除广告类型
+  const handleDeleteType = (id: number) => {
+    setTypeToDelete(id);
+    setDeleteDialogOpen(true);
+  };
+
+  // 确认删除
+  const confirmDelete = () => {
+    if (typeToDelete) {
+      deleteMutation.mutate(typeToDelete);
+    }
+  };
+
+  // 处理创建表单提交
+  const handleCreateSubmit = async (data: CreateRequest) => {
+    try {
+      await createMutation.mutateAsync(data);
+    } catch (error) {
+      throw error;
+    }
+  };
+
+  // 处理编辑表单提交
+  const handleUpdateSubmit = async (data: UpdateRequest) => {
+    if (!editingType) return;
+
+    try {
+      await updateMutation.mutateAsync({
+        id: editingType.id,
+        data
+      });
+    } catch (error) {
+      throw error;
+    }
+  };
+
+  return (
+    <div className="space-y-4">
+      <div className="flex justify-between items-center">
+        <h1 className="text-2xl font-bold">统一广告类型管理</h1>
+        <Button onClick={handleCreateType} data-testid="create-unified-advertisement-type-button">
+          <Plus className="mr-2 h-4 w-4" />
+          创建类型
+        </Button>
+      </div>
+
+      <Card>
+        <CardHeader>
+          <CardTitle>广告类型列表</CardTitle>
+          <CardDescription>管理所有广告类型配置</CardDescription>
+        </CardHeader>
+        <CardContent>
+          <div className="mb-4">
+            <form onSubmit={handleSearch} className="flex gap-2">
+              <div className="relative flex-1 max-w-sm">
+                <Search className="absolute left-2 top-2.5 h-4 w-4 text-muted-foreground" />
+                <Input
+                  placeholder="搜索类型名称或调用别名..."
+                  value={searchParams.keyword || ''}
+                  onChange={(e) => setSearchParams(prev => ({ ...prev, keyword: e.target.value }))}
+                  className="pl-8"
+                  data-testid="search-input"
+                />
+              </div>
+              <Button type="submit" variant="outline">
+                搜索
+              </Button>
+            </form>
+          </div>
+
+          <div className="rounded-md border">
+            <Table>
+              <TableHeader>
+                <TableRow>
+                  <TableHead>ID</TableHead>
+                  <TableHead>类型名称</TableHead>
+                  <TableHead>调用别名</TableHead>
+                  <TableHead>状态</TableHead>
+                  <TableHead>创建时间</TableHead>
+                  <TableHead className="text-right">操作</TableHead>
+                </TableRow>
+              </TableHeader>
+              <TableBody>
+                {isLoading ? (
+                  Array.from({ length: 5 }).map((_, index) => (
+                    <TableRow key={index}>
+                      <TableCell><Skeleton className="h-4 w-8" /></TableCell>
+                      <TableCell><Skeleton className="h-4 w-32" /></TableCell>
+                      <TableCell><Skeleton className="h-4 w-24" /></TableCell>
+                      <TableCell><Skeleton className="h-6 w-12 rounded-full" /></TableCell>
+                      <TableCell><Skeleton className="h-4 w-24" /></TableCell>
+                      <TableCell>
+                        <div className="flex justify-end gap-2">
+                          <Skeleton className="h-8 w-8 rounded" />
+                          <Skeleton className="h-8 w-8 rounded" />
+                        </div>
+                      </TableCell>
+                    </TableRow>
+                  ))
+                ) : data?.data?.list && data.data.list.length > 0 ? (
+                  data.data.list.map((type) => (
+                    <TableRow key={type.id} data-testid={`type-row-${type.id}`}>
+                      <TableCell className="font-medium">{type.id}</TableCell>
+                      <TableCell>{type.name}</TableCell>
+                      <TableCell>
+                        <code className="text-xs bg-muted px-2 py-1 rounded">{type.code}</code>
+                      </TableCell>
+                      <TableCell>
+                        <Badge variant={type.status === 1 ? 'default' : 'secondary'}>
+                          {type.status === 1 ? '启用' : '禁用'}
+                        </Badge>
+                      </TableCell>
+                      <TableCell className="text-sm">
+                        {type.createdAt ? format(new Date(type.createdAt), 'yyyy-MM-dd HH:mm') : '-'}
+                      </TableCell>
+                      <TableCell className="text-right">
+                        <div className="flex justify-end gap-2">
+                          <Button
+                            variant="ghost"
+                            size="icon"
+                            onClick={() => handleEditType(type)}
+                            data-testid={`edit-button-${type.id}`}
+                          >
+                            <Edit className="h-4 w-4" />
+                          </Button>
+                          <Button
+                            variant="ghost"
+                            size="icon"
+                            onClick={() => handleDeleteType(type.id)}
+                            data-testid={`delete-button-${type.id}`}
+                          >
+                            <Trash2 className="h-4 w-4" />
+                          </Button>
+                        </div>
+                      </TableCell>
+                    </TableRow>
+                  ))
+                ) : (
+                  <TableRow>
+                    <TableCell colSpan={6} className="text-center py-8">
+                      <p className="text-muted-foreground">暂无广告类型数据</p>
+                    </TableCell>
+                  </TableRow>
+                )}
+              </TableBody>
+            </Table>
+          </div>
+
+          <DataTablePagination
+            currentPage={searchParams.page}
+            pageSize={searchParams.pageSize}
+            totalCount={data?.data?.total || 0}
+            onPageChange={(page, pageSize) => setSearchParams(prev => ({ ...prev, page, pageSize }))}
+          />
+        </CardContent>
+      </Card>
+
+      {/* 创建/编辑对话框 */}
+      <Dialog open={isModalOpen} onOpenChange={setIsModalOpen}>
+        <DialogContent className="sm:max-w-[500px] max-h-[90vh] overflow-y-auto" data-testid="type-modal">
+          <DialogHeader>
+            <DialogTitle data-testid="modal-title">
+              {isCreateForm ? '创建广告类型' : '编辑广告类型'}
+            </DialogTitle>
+            <DialogDescription data-testid="modal-description">
+              {isCreateForm ? '创建一个新的广告类型配置' : '编辑现有广告类型信息'}
+            </DialogDescription>
+          </DialogHeader>
+
+          {isCreateForm ? (
+            // 创建表单（独立渲染）
+            <Form {...createForm}>
+              <form onSubmit={createForm.handleSubmit(handleCreateSubmit)} className="space-y-4">
+                <FormField
+                  control={createForm.control}
+                  name="name"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel className="flex items-center">
+                        类型名称 <span className="text-red-500 ml-1">*</span>
+                      </FormLabel>
+                      <FormControl>
+                        <Input placeholder="请输入类型名称" {...field} data-testid="create-name-input" />
+                      </FormControl>
+                      <FormDescription>例如：首页轮播、侧边广告等</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={createForm.control}
+                  name="code"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel className="flex items-center">
+                        调用别名 <span className="text-red-500 ml-1">*</span>
+                      </FormLabel>
+                      <FormControl>
+                        <Input placeholder="请输入调用别名" {...field} data-testid="create-code-input" />
+                      </FormControl>
+                      <FormDescription>用于程序调用的唯一标识，建议使用英文小写和下划线</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={createForm.control}
+                  name="remark"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>备注</FormLabel>
+                      <FormControl>
+                        <Textarea
+                          placeholder="请输入备注信息（可选）"
+                          className="resize-none"
+                          {...field}
+                          data-testid="create-remark-textarea"
+                        />
+                      </FormControl>
+                      <FormDescription>对广告类型的详细描述</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={createForm.control}
+                  name="status"
+                  render={({ field }) => (
+                    <FormItem className="flex flex-row items-center justify-between rounded-lg border p-4">
+                      <div className="space-y-0.5">
+                        <FormLabel className="text-base">启用状态</FormLabel>
+                        <FormDescription>
+                          禁用后该类型下的广告将无法正常展示
+                        </FormDescription>
+                      </div>
+                      <FormControl>
+                        <Switch
+                          checked={field.value === 1}
+                          onCheckedChange={(checked) => field.onChange(checked ? 1 : 0)}
+                          data-testid="create-status-switch"
+                        />
+                      </FormControl>
+                    </FormItem>
+                  )}
+                />
+
+                <DialogFooter>
+                  <Button type="button" variant="outline" onClick={() => setIsModalOpen(false)}>
+                    取消
+                  </Button>
+                  <Button type="submit" disabled={createMutation.isPending} data-testid="create-submit-button">
+                    {createMutation.isPending ? '创建中...' : '创建'}
+                  </Button>
+                </DialogFooter>
+              </form>
+            </Form>
+          ) : (
+            // 编辑表单（独立渲染）
+            <Form {...updateForm}>
+              <form onSubmit={updateForm.handleSubmit(handleUpdateSubmit)} className="space-y-4">
+                <FormField
+                  control={updateForm.control}
+                  name="name"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel className="flex items-center">
+                        类型名称 <span className="text-red-500 ml-1">*</span>
+                      </FormLabel>
+                      <FormControl>
+                        <Input placeholder="请输入类型名称" {...field} data-testid="edit-name-input" />
+                      </FormControl>
+                      <FormDescription>例如：首页轮播、侧边广告等</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={updateForm.control}
+                  name="code"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel className="flex items-center">
+                        调用别名 <span className="text-red-500 ml-1">*</span>
+                      </FormLabel>
+                      <FormControl>
+                        <Input placeholder="请输入调用别名" {...field} data-testid="edit-code-input" />
+                      </FormControl>
+                      <FormDescription>用于程序调用的唯一标识，建议使用英文小写和下划线</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={updateForm.control}
+                  name="remark"
+                  render={({ field }) => (
+                    <FormItem>
+                      <FormLabel>备注</FormLabel>
+                      <FormControl>
+                        <Textarea
+                          placeholder="请输入备注信息（可选）"
+                          className="resize-none"
+                          {...field}
+                          data-testid="edit-remark-textarea"
+                        />
+                      </FormControl>
+                      <FormDescription>对广告类型的详细描述</FormDescription>
+                      <FormMessage />
+                    </FormItem>
+                  )}
+                />
+
+                <FormField
+                  control={updateForm.control}
+                  name="status"
+                  render={({ field }) => (
+                    <FormItem className="flex flex-row items-center justify-between rounded-lg border p-4">
+                      <div className="space-y-0.5">
+                        <FormLabel className="text-base">启用状态</FormLabel>
+                        <FormDescription>
+                          禁用后该类型下的广告将无法正常展示
+                        </FormDescription>
+                      </div>
+                      <FormControl>
+                        <Switch
+                          checked={field.value === 1}
+                          onCheckedChange={(checked) => field.onChange(checked ? 1 : 0)}
+                          data-testid="edit-status-switch"
+                        />
+                      </FormControl>
+                    </FormItem>
+                  )}
+                />
+
+                <DialogFooter>
+                  <Button type="button" variant="outline" onClick={() => setIsModalOpen(false)}>
+                    取消
+                  </Button>
+                  <Button type="submit" disabled={updateMutation.isPending} data-testid="update-submit-button">
+                    {updateMutation.isPending ? '更新中...' : '更新'}
+                  </Button>
+                </DialogFooter>
+              </form>
+            </Form>
+          )}
+        </DialogContent>
+      </Dialog>
+
+      {/* 删除确认对话框 */}
+      <Dialog open={deleteDialogOpen} onOpenChange={setDeleteDialogOpen}>
+        <DialogContent data-testid="delete-dialog">
+          <DialogHeader>
+            <DialogTitle data-testid="delete-dialog-title">确认删除</DialogTitle>
+            <DialogDescription data-testid="delete-dialog-description">
+              确定要删除这个广告类型吗？此操作无法撤销。
+              <br />
+              <span className="text-destructive">
+                注意：删除后，该类型下的所有广告将失去类型关联。
+              </span>
+            </DialogDescription>
+          </DialogHeader>
+          <DialogFooter>
+            <Button variant="outline" onClick={() => setDeleteDialogOpen(false)} data-testid="delete-cancel-button">
+              取消
+            </Button>
+            <Button
+              variant="destructive"
+              onClick={confirmDelete}
+              disabled={deleteMutation.isPending}
+              data-testid="delete-confirm-button"
+            >
+              {deleteMutation.isPending ? '删除中...' : '删除'}
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </div>
+  );
+};
+
+export default UnifiedAdvertisementTypeManagement;

packages/unified-advertisement-management-ui/src/components/UnifiedAdvertisementTypeSelector.tsx

@@ -0,0 +1,66 @@
+import { useQuery } from '@tanstack/react-query';
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue
+} from '@d8d/shared-ui-components/components/ui/select';
+import { unifiedAdvertisementTypeClientManager } from '../api/unifiedAdvertisementTypeClient';
+import type { UnifiedAdvertisementTypeListItem } from '../types';
+
+interface UnifiedAdvertisementTypeSelectorProps {
+  value: number | undefined;
+  onChange: (value: number) => void;
+  placeholder?: string;
+  testId?: string;
+}
+
+/**
+ * 统一广告类型选择器组件
+ */
+export const UnifiedAdvertisementTypeSelector: React.FC<UnifiedAdvertisementTypeSelectorProps> = ({
+  value,
+  onChange,
+  placeholder = '请选择广告类型',
+  testId = 'advertisement-type-selector'
+}) => {
+  // 查询所有启用的广告类型
+  const { data: typesData, isLoading } = useQuery({
+    queryKey: ['unified-advertisement-types', { page: 1, pageSize: 100, status: 1 }],
+    queryFn: async () => {
+      const res = await unifiedAdvertisementTypeClientManager.get().index.$get({
+        query: { page: 1, pageSize: 100, status: 1 }
+      });
+      if (res.status !== 200) throw new Error('获取广告类型列表失败');
+      return await res.json();
+    }
+  });
+
+  const types = typesData?.data?.list || [];
+
+  return (
+    <Select
+      value={value?.toString()}
+      onValueChange={(val) => onChange(parseInt(val))}
+      data-testid={testId}
+    >
+      <SelectTrigger data-testid={`${testId}-trigger`}>
+        <SelectValue placeholder={isLoading ? '加载中...' : placeholder} />
+      </SelectTrigger>
+      <SelectContent>
+        {types.map((type: UnifiedAdvertisementTypeListItem) => (
+          <SelectItem
+            key={type.id}
+            value={type.id.toString()}
+            data-testid={`${testId}-item-${type.id}`}
+          >
+            {type.name}
+          </SelectItem>
+        ))}
+      </SelectContent>
+    </Select>
+  );
+};
+
+export default UnifiedAdvertisementTypeSelector;

packages/unified-advertisement-management-ui/src/components/index.ts

@@ -0,0 +1,3 @@
+export { UnifiedAdvertisementManagement } from './UnifiedAdvertisementManagement';
+export { UnifiedAdvertisementTypeManagement } from './UnifiedAdvertisementTypeManagement';
+export { UnifiedAdvertisementTypeSelector } from './UnifiedAdvertisementTypeSelector';

packages/unified-advertisement-management-ui/src/index.ts

@@ -0,0 +1,34 @@
+// 组件导出
+export {
+  UnifiedAdvertisementManagement,
+  UnifiedAdvertisementTypeManagement,
+  UnifiedAdvertisementTypeSelector
+} from './components';
+
+// API客户端导出
+export {
+  UnifiedAdvertisementClientManager,
+  unifiedAdvertisementClientManager,
+  unifiedAdvertisementClient,
+  UnifiedAdvertisementTypeClientManager,
+  unifiedAdvertisementTypeClientManager,
+  unifiedAdvertisementTypeClient
+} from './api';
+
+// 类型导出
+export type {
+  UnifiedAdvertisementListResponse,
+  UnifiedAdvertisementListItem,
+  UnifiedAdvertisementDetailResponse,
+  UnifiedAdvertisementResponse,
+  CreateUnifiedAdvertisementRequest,
+  UpdateUnifiedAdvertisementRequest,
+  UnifiedAdvertisementSearchParams,
+  UnifiedAdvertisementTypeListResponse,
+  UnifiedAdvertisementTypeListItem,
+  UnifiedAdvertisementTypeDetailResponse,
+  UnifiedAdvertisementTypeResponse,
+  CreateUnifiedAdvertisementTypeRequest,
+  UpdateUnifiedAdvertisementTypeRequest,
+  UnifiedAdvertisementTypeSearchParams
+} from './types';

packages/unified-advertisement-management-ui/src/types/index.ts

@@ -0,0 +1,107 @@
+import type { InferRequestType, InferResponseType } from 'hono/client';
+import { unifiedAdvertisementClient } from '../api/unifiedAdvertisementClient';
+import { unifiedAdvertisementTypeClient } from '../api/unifiedAdvertisementTypeClient';
+
+// ==================== 统一广告类型定义 ====================
+
+/**
+ * 广告列表响应类型
+ */
+export type UnifiedAdvertisementListResponse = InferResponseType<
+  (typeof unifiedAdvertisementClient)['index']['$get'],
+  200
+>;
+
+/**
+ * 广告列表项类型
+ */
+export type UnifiedAdvertisementListItem = UnifiedAdvertisementListResponse['data']['list'][0];
+
+/**
+ * 广告详情响应类型
+ */
+export type UnifiedAdvertisementDetailResponse = InferResponseType<
+  (typeof unifiedAdvertisementClient)[':id']['$get'],
+  200
+>;
+
+/**
+ * 广告响应类型（用于表单显示）
+ */
+export type UnifiedAdvertisementResponse = UnifiedAdvertisementDetailResponse['data'];
+
+/**
+ * 创建广告请求类型
+ */
+export type CreateUnifiedAdvertisementRequest = InferRequestType<
+  (typeof unifiedAdvertisementClient)['index']['$post']
+>['json'];
+
+/**
+ * 更新广告请求类型
+ */
+export type UpdateUnifiedAdvertisementRequest = InferRequestType<
+  (typeof unifiedAdvertisementClient)[':id']['$put']
+>['json'];
+
+/**
+ * 广告搜索参数类型
+ */
+export interface UnifiedAdvertisementSearchParams {
+  page: number;
+  pageSize: number;
+  keyword?: string;
+  status?: number;
+}
+
+// ==================== 统一广告类型类型定义 ====================
+
+/**
+ * 广告类型列表响应类型
+ */
+export type UnifiedAdvertisementTypeListResponse = InferResponseType<
+  (typeof unifiedAdvertisementTypeClient)['index']['$get'],
+  200
+>;
+
+/**
+ * 广告类型列表项类型
+ */
+export type UnifiedAdvertisementTypeListItem = UnifiedAdvertisementTypeListResponse['data']['list'][0];
+
+/**
+ * 广告类型详情响应类型
+ */
+export type UnifiedAdvertisementTypeDetailResponse = InferResponseType<
+  (typeof unifiedAdvertisementTypeClient)[':id']['$get'],
+  200
+>;
+
+/**
+ * 广告类型响应类型（用于表单显示）
+ */
+export type UnifiedAdvertisementTypeResponse = UnifiedAdvertisementTypeDetailResponse['data'];
+
+/**
+ * 创建广告类型请求类型
+ */
+export type CreateUnifiedAdvertisementTypeRequest = InferRequestType<
+  (typeof unifiedAdvertisementTypeClient)['index']['$post']
+>['json'];
+
+/**
+ * 更新广告类型请求类型
+ */
+export type UpdateUnifiedAdvertisementTypeRequest = InferRequestType<
+  (typeof unifiedAdvertisementTypeClient)[':id']['$put']
+>['json'];
+
+/**
+ * 广告类型搜索参数类型
+ */
+export interface UnifiedAdvertisementTypeSearchParams {
+  page: number;
+  pageSize: number;
+  keyword?: string;
+  status?: number;
+}

packages/unified-advertisement-management-ui/tests/integration/unified-advertisement-management.integration.test.tsx

@@ -0,0 +1,541 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { render, screen, waitFor } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { UnifiedAdvertisementManagement } from '../../src/components/UnifiedAdvertisementManagement';
+import { unifiedAdvertisementClientManager } from '../../src/api/unifiedAdvertisementClient';
+import { unifiedAdvertisementTypeClientManager } from '../../src/api/unifiedAdvertisementTypeClient';
+
+// Mock RPC 客户端
+vi.mock('../../src/api/unifiedAdvertisementClient', () => ({
+  unifiedAdvertisementClientManager: {
+    get: vi.fn()
+  }
+}));
+
+vi.mock('../../src/api/unifiedAdvertisementTypeClient', () => ({
+  unifiedAdvertisementTypeClientManager: {
+    get: vi.fn()
+  }
+}));
+
+// Mock FileSelector 组件
+vi.mock('@d8d/file-management-ui-mt', () => ({
+  FileSelector: ({ value, onChange }: { value?: number; onChange: (val: number) => void }) => (
+    <div data-testid="file-selector">
+      <button onClick={() => onChange(123)}>选择文件</button>
+      {value && <span data-testid="selected-file-id">{value}</span>}
+    </div>
+  )
+}));
+
+// Mock DataTablePagination 组件
+vi.mock('@d8d/shared-ui-components/components/admin/DataTablePagination', () => ({
+  DataTablePagination: ({ currentPage, pageSize, totalCount, onPageChange }: any) => (
+    <div data-testid="pagination">
+      <span>第 {currentPage} 页</span>
+      <span>共 {totalCount} 条</span>
+      <button onClick={() => onPageChange(currentPage + 1, pageSize)}>下一页</button>
+    </div>
+  )
+}));
+
+const createTestQueryClient = () => new QueryClient({
+  defaultOptions: {
+    queries: {
+      retry: false,
+      gcTime: 0
+    },
+    mutations: {
+      retry: false
+    }
+  }
+});
+
+const wrapper = ({ children }: { children: React.ReactNode }) => (
+  <QueryClientProvider client={createTestQueryClient()}>
+    {children}
+  </QueryClientProvider>
+});
+
+describe('UnifiedAdvertisementManagement - 集成测试', () => {
+  const mockGetClient = vi.mocked(unifiedAdvertisementClientManager.get);
+  const mockTypeGetClient = vi.mocked(unifiedAdvertisementTypeClientManager.get);
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  describe('列表加载', () => {
+    it('应该成功加载并显示广告列表', async () => {
+      const mockListResponse = {
+        json: async () => ({
+          code: 200,
+          data: {
+            list: [
+              {
+                id: 1,
+                title: '首页轮播广告',
+                code: 'home_banner',
+                typeId: 1,
+                status: 1,
+                sort: 100,
+                url: 'https://example.com',
+                actionType: 1,
+                imageFileId: 10,
+                createdAt: '2024-01-01T00:00:00Z',
+                updatedAt: '2024-01-01T00:00:00Z',
+                imageFile: {
+                  id: 10,
+                  fileName: 'banner.jpg',
+                  fullUrl: 'https://example.com/banner.jpg'
+                },
+                advertisementType: {
+                  id: 1,
+                  name: '首页轮播',
+                  code: 'home_banner_type'
+                }
+              }
+            ],
+            total: 1,
+            page: 1,
+            pageSize: 10
+          }
+        }),
+        status: 200
+      };
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue(mockListResponse),
+          $post: vi.fn()
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      mockTypeGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [{ id: 1, name: '首页轮播', code: 'home_banner_type', status: 1 }],
+                total: 1
+              }
+            }),
+            status: 200
+          })
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementManagement />, { wrapper });
+
+      await waitFor(() => {
+        expect(screen.getByText('统一广告管理')).toBeInTheDocument();
+        expect(screen.getByText('首页轮播广告')).toBeInTheDocument();
+        expect(screen.getByText('home_banner')).toBeInTheDocument();
+      });
+    });
+
+    it('应该显示空状态当没有数据时', async () => {
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [],
+                total: 0,
+                page: 1,
+                pageSize: 10
+              }
+            }),
+            status: 200
+          }),
+          $post: vi.fn()
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      mockTypeGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: { list: [], total: 0 }
+            }),
+            status: 200
+          })
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementManagement />, { wrapper });
+
+      await waitFor(() => {
+        expect(screen.getByText('暂无广告数据')).toBeInTheDocument();
+      });
+    });
+  });
+
+  describe('创建广告', () => {
+    it('应该打开创建模态框并提交表单', async () => {
+      const user = userEvent.setup();
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: { list: [], total: 0, page: 1, pageSize: 10 }
+            }),
+            status: 200
+          }),
+          $post: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 201,
+              data: { id: 1, title: '新广告' }
+            }),
+            status: 201
+          })
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      mockTypeGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [
+                  { id: 1, name: '首页轮播', code: 'home', status: 1 }
+                ],
+                total: 1
+              }
+            }),
+            status: 200
+          })
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementManagement />, { wrapper });
+
+      // 点击创建按钮
+      await user.click(screen.getByTestId('create-unified-advertisement-button'));
+
+      // 验证模态框打开
+      await waitFor(() => {
+        expect(screen.getByTestId('modal-title')).toHaveTextContent('创建广告');
+        expect(screen.getByTestId('modal-description')).toHaveTextContent('创建一个新的广告');
+      });
+
+      // 填写表单
+      const titleInput = screen.getByTestId('title-input');
+      await user.type(titleInput, '新广告');
+
+      const codeInput = screen.getByTestId('code-input');
+      await user.type(codeInput, 'new_ad');
+
+      // 提交表单
+      const submitButton = screen.getByTestId('create-submit-button');
+      await user.click(submitButton);
+
+      await waitFor(() => {
+        expect(mockGetClient().index.$post).toHaveBeenCalled();
+      });
+    });
+  });
+
+  describe('编辑广告', () => {
+    it('应该打开编辑模态框并提交更新', async () => {
+      const user = userEvent.setup();
+
+      const mockData = {
+        id: 1,
+        title: '原标题',
+        code: 'original_code',
+        typeId: 1,
+        status: 1,
+        sort: 50,
+        url: 'https://example.com',
+        actionType: 1,
+        imageFileId: 10,
+        createdAt: '2024-01-01T00:00:00Z',
+        updatedAt: '2024-01-01T00:00:00Z',
+        imageFile: {
+          id: 10,
+          fileName: 'banner.jpg',
+          fullUrl: 'https://example.com/banner.jpg'
+        },
+        advertisementType: {
+          id: 1,
+          name: '首页轮播',
+          code: 'home_banner_type'
+        }
+      };
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [mockData],
+                total: 1,
+                page: 1,
+                pageSize: 10
+              }
+            }),
+            status: 200
+          }),
+          $post: vi.fn()
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: { ...mockData, title: '更新标题' }
+            }),
+            status: 200
+          }),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      mockTypeGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [
+                  { id: 1, name: '首页轮播', code: 'home', status: 1 }
+                ],
+                total: 1
+              }
+            }),
+            status: 200
+          })
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementManagement />, { wrapper });
+
+      // 等待列表加载
+      await waitFor(() => {
+        expect(screen.getByText('原标题')).toBeInTheDocument();
+      });
+
+      // 点击编辑按钮
+      await user.click(screen.getByTestId('edit-button-1'));
+
+      // 验证编辑模态框打开
+      await waitFor(() => {
+        expect(screen.getByTestId('modal-title')).toHaveTextContent('编辑广告');
+        expect(screen.getByTestId('modal-description')).toHaveTextContent('编辑现有广告信息');
+      });
+
+      // 修改标题
+      const titleInput = screen.getByTestId('title-input');
+      await user.clear(titleInput);
+      await user.type(titleInput, '更新标题');
+
+      // 提交更新
+      const submitButton = screen.getByTestId('update-submit-button');
+      await user.click(submitButton);
+
+      await waitFor(() => {
+        expect(mockGetClient()[':id'].$put).toHaveBeenCalledWith({
+          param: { id: 1 },
+          json: expect.objectContaining({
+            title: '更新标题'
+          })
+        });
+      });
+    });
+  });
+
+  describe('删除广告', () => {
+    it('应该显示删除确认对话框并执行删除', async () => {
+      const user = userEvent.setup();
+
+      const mockData = {
+        id: 1,
+        title: '要删除的广告',
+        code: 'to_delete',
+        typeId: 1,
+        status: 1,
+        sort: 50,
+        url: '',
+        actionType: 0,
+        imageFileId: null,
+        createdAt: '2024-01-01T00:00:00Z',
+        updatedAt: '2024-01-01T00:00:00Z',
+        imageFile: null,
+        advertisementType: {
+          id: 1,
+          name: '首页轮播',
+          code: 'home'
+        }
+      };
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [mockData],
+                total: 1,
+                page: 1,
+                pageSize: 10
+              }
+            }),
+            status: 200
+          }),
+          $post: vi.fn()
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              message: 'Advertisement deleted successfully'
+            }),
+            status: 200
+          })
+        }
+      } as any);
+
+      mockTypeGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: { list: [], total: 0 }
+            }),
+            status: 200
+          })
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementManagement />, { wrapper });
+
+      // 等待列表加载
+      await waitFor(() => {
+        expect(screen.getByText('要删除的广告')).toBeInTheDocument();
+      });
+
+      // 点击删除按钮
+      await user.click(screen.getByTestId('delete-button-1'));
+
+      // 验证删除确认对话框显示
+      await waitFor(() => {
+        expect(screen.getByTestId('delete-dialog-title')).toHaveTextContent('确认删除');
+      });
+
+      // 确认删除
+      const confirmButton = screen.getByTestId('confirm-delete-button');
+      await user.click(confirmButton);
+
+      await waitFor(() => {
+        expect(mockGetClient()[':id']['$delete']).toHaveBeenCalledWith({
+          param: { id: 1 }
+        });
+      });
+    });
+  });
+
+  describe('搜索功能', () => {
+    it('应该根据关键词搜索广告', async () => {
+      const user = userEvent.setup();
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [
+                  {
+                    id: 1,
+                    title: '搜索结果广告',
+                    code: 'search_result',
+                    typeId: 1,
+                    status: 1,
+                    sort: 50,
+                    url: '',
+                    actionType: 0,
+                    imageFileId: null,
+                    createdAt: '2024-01-01T00:00:00Z',
+                    updatedAt: '2024-01-01T00:00:00Z',
+                    imageFile: null,
+                    advertisementType: {
+                      id: 1,
+                      name: '类型',
+                      code: 'type'
+                    }
+                  }
+                ],
+                total: 1,
+                page: 1,
+                pageSize: 10
+              }
+            }),
+            status: 200
+          }),
+          $post: vi.fn()
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      mockTypeGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: { list: [], total: 0 }
+            }),
+            status: 200
+          })
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementManagement />, { wrapper });
+
+      // 输入搜索关键词
+      const searchInput = screen.getByTestId('search-input');
+      await user.type(searchInput, '搜索');
+
+      // 提交搜索
+      const searchButton = screen.getByRole('button', { name: '搜索' });
+      await user.click(searchButton);
+
+      await waitFor(() => {
+        expect(mockGetClient().index.$get).toHaveBeenCalledWith({
+          query: expect.objectContaining({
+            keyword: '搜索'
+          })
+        });
+      });
+    });
+  });
+});

packages/unified-advertisement-management-ui/tests/integration/unified-advertisement-type-management.integration.test.tsx

@@ -0,0 +1,445 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { render, screen, waitFor } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { UnifiedAdvertisementTypeManagement } from '../../src/components/UnifiedAdvertisementTypeManagement';
+import { unifiedAdvertisementTypeClientManager } from '../../src/api/unifiedAdvertisementTypeClient';
+
+// Mock RPC 客户端
+vi.mock('../../src/api/unifiedAdvertisementTypeClient', () => ({
+  unifiedAdvertisementTypeClientManager: {
+    get: vi.fn()
+  }
+}));
+
+// Mock DataTablePagination 组件
+vi.mock('@d8d/shared-ui-components/components/admin/DataTablePagination', () => ({
+  DataTablePagination: ({ currentPage, pageSize, totalCount, onPageChange }: any) => (
+    <div data-testid="pagination">
+      <span>第 {currentPage} 页</span>
+      <span>共 {totalCount} 条</span>
+      <button onClick={() => onPageChange(currentPage + 1, pageSize)}>下一页</button>
+    </div>
+  )
+}));
+
+const createTestQueryClient = () => new QueryClient({
+  defaultOptions: {
+    queries: {
+      retry: false,
+      gcTime: 0
+    },
+    mutations: {
+      retry: false
+    }
+  }
+});
+
+const wrapper = ({ children }: { children: React.ReactNode }) => (
+  <QueryClientProvider client={createTestQueryClient()}>
+    {children}
+  </QueryClientProvider>
+});
+
+describe('UnifiedAdvertisementTypeManagement - 集成测试', () => {
+  const mockGetClient = vi.mocked(unifiedAdvertisementTypeClientManager.get);
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  describe('列表加载', () => {
+    it('应该成功加载并显示广告类型列表', async () => {
+      const mockListResponse = {
+        json: async () => ({
+          code: 200,
+          data: {
+            list: [
+              {
+                id: 1,
+                name: '首页轮播',
+                code: 'home_banner',
+                status: 1,
+                remark: '首页轮播广告位',
+                createdAt: '2024-01-01T00:00:00Z',
+                updatedAt: '2024-01-01T00:00:00Z'
+              }
+            ],
+            total: 1,
+            page: 1,
+            pageSize: 10
+          }
+        }),
+        status: 200
+      };
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue(mockListResponse),
+          $post: vi.fn()
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementTypeManagement />, { wrapper });
+
+      await waitFor(() => {
+        expect(screen.getByText('统一广告类型管理')).toBeInTheDocument();
+        expect(screen.getByText('首页轮播')).toBeInTheDocument();
+        expect(screen.getByText('home_banner')).toBeInTheDocument();
+      });
+    });
+
+    it('应该显示空状态当没有数据时', async () => {
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [],
+                total: 0,
+                page: 1,
+                pageSize: 10
+              }
+            }),
+            status: 200
+          }),
+          $post: vi.fn()
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementTypeManagement />, { wrapper });
+
+      await waitFor(() => {
+        expect(screen.getByText('暂无广告类型数据')).toBeInTheDocument();
+      });
+    });
+  });
+
+  describe('创建广告类型', () => {
+    it('应该打开创建模态框并提交表单', async () => {
+      const user = userEvent.setup();
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: { list: [], total: 0, page: 1, pageSize: 10 }
+            }),
+            status: 200
+          }),
+          $post: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 201,
+              data: { id: 1, name: '新类型' }
+            }),
+            status: 201
+          })
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementTypeManagement />, { wrapper });
+
+      // 点击创建按钮
+      await user.click(screen.getByTestId('create-unified-advertisement-type-button'));
+
+      // 验证模态框打开
+      await waitFor(() => {
+        expect(screen.getByTestId('modal-title')).toHaveTextContent('创建广告类型');
+        expect(screen.getByTestId('modal-description')).toHaveTextContent('创建一个新的广告类型配置');
+      });
+
+      // 填写表单
+      const nameInput = screen.getByTestId('create-name-input');
+      await user.type(nameInput, '新类型');
+
+      const codeInput = screen.getByTestId('create-code-input');
+      await user.type(codeInput, 'new_type');
+
+      // 提交表单
+      const submitButton = screen.getByTestId('create-submit-button');
+      await user.click(submitButton);
+
+      await waitFor(() => {
+        expect(mockGetClient().index.$post).toHaveBeenCalled();
+      });
+    });
+  });
+
+  describe('编辑广告类型', () => {
+    it('应该打开编辑模态框并提交更新', async () => {
+      const user = userEvent.setup();
+
+      const mockData = {
+        id: 1,
+        name: '原类型名',
+        code: 'original_code',
+        status: 1,
+        remark: '备注',
+        createdAt: '2024-01-01T00:00:00Z',
+        updatedAt: '2024-01-01T00:00:00Z'
+      };
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [mockData],
+                total: 1,
+                page: 1,
+                pageSize: 10
+              }
+            }),
+            status: 200
+          }),
+          $post: vi.fn()
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: { ...mockData, name: '更新类型名' }
+            }),
+            status: 200
+          }),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementTypeManagement />, { wrapper });
+
+      // 等待列表加载
+      await waitFor(() => {
+        expect(screen.getByText('原类型名')).toBeInTheDocument();
+      });
+
+      // 点击编辑按钮
+      await user.click(screen.getByTestId('edit-button-1'));
+
+      // 验证编辑模态框打开
+      await waitFor(() => {
+        expect(screen.getByTestId('modal-title')).toHaveTextContent('编辑广告类型');
+        expect(screen.getByTestId('modal-description')).toHaveTextContent('编辑现有广告类型信息');
+      });
+
+      // 修改名称
+      const nameInput = screen.getByTestId('edit-name-input');
+      await user.clear(nameInput);
+      await user.type(nameInput, '更新类型名');
+
+      // 提交更新
+      const submitButton = screen.getByTestId('update-submit-button');
+      await user.click(submitButton);
+
+      await waitFor(() => {
+        expect(mockGetClient()[':id'].$put).toHaveBeenCalledWith({
+          param: { id: 1 },
+          json: expect.objectContaining({
+            name: '更新类型名'
+          })
+        });
+      });
+    });
+  });
+
+  describe('删除广告类型', () => {
+    it('应该显示删除确认对话框并执行删除', async () => {
+      const user = userEvent.setup();
+
+      const mockData = {
+        id: 1,
+        name: '要删除的类型',
+        code: 'to_delete',
+        status: 1,
+        remark: '',
+        createdAt: '2024-01-01T00:00:00Z',
+        updatedAt: '2024-01-01T00:00:00Z'
+      };
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [mockData],
+                total: 1,
+                page: 1,
+                pageSize: 10
+              }
+            }),
+            status: 200
+          }),
+          $post: vi.fn()
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              message: 'Advertisement type deleted successfully'
+            }),
+            status: 200
+          })
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementTypeManagement />, { wrapper });
+
+      // 等待列表加载
+      await waitFor(() => {
+        expect(screen.getByText('要删除的类型')).toBeInTheDocument();
+      });
+
+      // 点击删除按钮
+      await user.click(screen.getByTestId('delete-button-1'));
+
+      // 验证删除确认对话框显示
+      await waitFor(() => {
+        expect(screen.getByTestId('delete-dialog-title')).toHaveTextContent('确认删除');
+      });
+
+      // 确认删除
+      const confirmButton = screen.getByTestId('delete-confirm-button');
+      await user.click(confirmButton);
+
+      await waitFor(() => {
+        expect(mockGetClient()[':id']['$delete']).toHaveBeenCalledWith({
+          param: { id: 1 }
+        });
+      });
+    });
+  });
+
+  describe('搜索功能', () => {
+    it('应该根据关键词搜索广告类型', async () => {
+      const user = userEvent.setup();
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: {
+                list: [
+                  {
+                    id: 1,
+                    name: '搜索结果类型',
+                    code: 'search_result',
+                    status: 1,
+                    remark: '',
+                    createdAt: '2024-01-01T00:00:00Z',
+                    updatedAt: '2024-01-01T00:00:00Z'
+                  }
+                ],
+                total: 1,
+                page: 1,
+                pageSize: 10
+              }
+            }),
+            status: 200
+          }),
+          $post: vi.fn()
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementTypeManagement />, { wrapper });
+
+      // 输入搜索关键词
+      const searchInput = screen.getByTestId('search-input');
+      await user.type(searchInput, '搜索');
+
+      // 提交搜索
+      const searchButton = screen.getByRole('button', { name: '搜索' });
+      await user.click(searchButton);
+
+      await waitFor(() => {
+        expect(mockGetClient().index.$get).toHaveBeenCalledWith({
+          query: expect.objectContaining({
+            keyword: '搜索'
+          })
+        });
+      });
+    });
+  });
+
+  describe('状态切换', () => {
+    it('应该正确处理创建表单中的状态切换', async () => {
+      const user = userEvent.setup();
+
+      mockGetClient.mockReturnValue({
+        index: {
+          $get: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 200,
+              data: { list: [], total: 0, page: 1, pageSize: 10 }
+            }),
+            status: 200
+          }),
+          $post: vi.fn().mockResolvedValue({
+            json: async () => ({
+              code: 201,
+              data: { id: 1, name: '新类型', status: 0 }
+            }),
+            status: 201
+          })
+        },
+        ':id': {
+          $get: vi.fn(),
+          $put: vi.fn(),
+          $delete: vi.fn()
+        }
+      } as any);
+
+      render(<UnifiedAdvertisementTypeManagement />, { wrapper });
+
+      // 点击创建按钮
+      await user.click(screen.getByTestId('create-unified-advertisement-type-button'));
+
+      // 切换状态开关（关闭）
+      const switchElement = screen.getByTestId('create-status-switch');
+      await user.click(switchElement);
+
+      // 填写必要字段
+      await user.type(screen.getByTestId('create-name-input'), '禁用类型');
+      await user.type(screen.getByTestId('create-code-input'), 'disabled_type');
+
+      // 提交表单
+      const submitButton = screen.getByTestId('create-submit-button');
+      await user.click(submitButton);
+
+      await waitFor(() => {
+        expect(mockGetClient().index.$post).toHaveBeenCalledWith({
+          json: expect.objectContaining({
+            status: 0
+          })
+        });
+      });
+    });
+  });
+});

packages/unified-advertisement-management-ui/tests/setup.ts

@@ -0,0 +1,29 @@
+import '@testing-library/jest-dom';
+import { vi } from 'vitest';
+
+// Mock sonner
+vi.mock('sonner', () => ({
+  toast: {
+    success: vi.fn(),
+    error: vi.fn(),
+    warning: vi.fn(),
+    info: vi.fn()
+  }
+}));
+
+// Mock scrollIntoView for Radix UI components
+Element.prototype.scrollIntoView = vi.fn();
+
+// Mock IntersectionObserver
+global.IntersectionObserver = vi.fn().mockImplementation(() => ({
+  observe: vi.fn(),
+  unobserve: vi.fn(),
+  disconnect: vi.fn()
+})) as any;
+
+// Mock ResizeObserver
+global.ResizeObserver = vi.fn().mockImplementation(() => ({
+  observe: vi.fn(),
+  unobserve: vi.fn(),
+  disconnect: vi.fn()
+})) as any;

packages/unified-advertisement-management-ui/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "composite": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "tests"
+  ]
+}

packages/unified-advertisement-management-ui/vitest.config.ts

@@ -0,0 +1,32 @@
+import { defineConfig } from 'vitest/config';
+import path from 'path';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'jsdom',
+    setupFiles: ['./tests/setup.ts'],
+    fileParallelism: false,
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      exclude: [
+        'node_modules/',
+        'tests/',
+        '**/*.test.ts',
+        '**/*.test.tsx',
+        '**/*.config.*',
+        '**/dist/**'
+      ]
+    }
+  },
+  resolve: {
+    alias: {
+      '@d8d/unified-advertisement-management-ui': path.resolve(__dirname, './src'),
+      '@d8d/shared-types': path.resolve(__dirname, '../shared-types/src'),
+      '@d8d/shared-ui-components': path.resolve(__dirname, '../shared-ui-components/src'),
+      '@d8d/unified-advertisements-module': path.resolve(__dirname, '../unified-advertisements-module/src'),
+      '@d8d/file-management-ui-mt': path.resolve(__dirname, '../file-management-ui-mt/src')
+    }
+  }
+});

packages/unified-advertisements-module/src/routes/admin/unified-advertisement-types.admin.routes.ts

@@ -130,6 +130,15 @@ const getRoute = createRoute({
   method: 'get',
   path: '/:id',
   middleware: [tenantAuthMiddleware] as const,
+  request: {
+    params: z.object({
+      id: z.coerce.number<number>().openapi({
+        param: { name: 'id', in: 'path' },
+        example: 1,
+        description: '广告类型ID'
+      })
+    })
+  },
   responses: {
     200: {
       description: '成功获取广告类型详情',
@@ -222,6 +231,13 @@ const updateRoute = createRoute({
   path: '/:id',
   middleware: [tenantAuthMiddleware] as const,
   request: {
+    params: z.object({
+      id: z.coerce.number<number>().openapi({
+        param: { name: 'id', in: 'path' },
+        example: 1,
+        description: '广告类型ID'
+      })
+    }),
     body: {
       content: {
         'application/json': {
@@ -275,6 +291,15 @@ const deleteRoute = createRoute({
   method: 'delete',
   path: '/:id',
   middleware: [tenantAuthMiddleware] as const,
+  request: {
+    params: z.object({
+      id: z.coerce.number<number>().openapi({
+        param: { name: 'id', in: 'path' },
+        example: 1,
+        description: '广告类型ID'
+      })
+    })
+  },
   responses: {
     200: {
       description: '成功删除广告类型',
@@ -351,7 +376,7 @@ const app = new OpenAPIHono<AdminContext>()
   })
   .openapi(getRoute, async (c) => {
     try {
-      const id = parseInt(c.req.param('id'));
+      const { id } = c.req.valid('param');
       const service = getService();
 
       const advertisementType = await service.getById(id);
@@ -398,7 +423,7 @@ const app = new OpenAPIHono<AdminContext>()
   })
   .openapi(updateRoute, async (c) => {
     try {
-      const id = parseInt(c.req.param('id'));
+      const { id } = c.req.valid('param');
       const body = c.req.valid('json');
       const superAdminId = c.get('superAdminId') || 1;
       const service = getService();
@@ -425,7 +450,7 @@ const app = new OpenAPIHono<AdminContext>()
   })
   .openapi(deleteRoute, async (c) => {
     try {
-      const id = parseInt(c.req.param('id'));
+      const { id } = c.req.valid('param');
       const superAdminId = c.get('superAdminId') || 1;
       const service = getService();
 

packages/unified-advertisements-module/src/routes/admin/unified-advertisements.admin.routes.ts

@@ -130,6 +130,15 @@ const getRoute = createRoute({
   method: 'get',
   path: '/:id',
   middleware: [tenantAuthMiddleware] as const,
+  request: {
+    params: z.object({
+      id: z.coerce.number<number>().openapi({
+        param: { name: 'id', in: 'path' },
+        example: 1,
+        description: '广告ID'
+      })
+    })
+  },
   responses: {
     200: {
       description: '成功获取广告详情',
@@ -222,6 +231,13 @@ const updateRoute = createRoute({
   path: '/:id',
   middleware: [tenantAuthMiddleware] as const,
   request: {
+    params: z.object({
+      id: z.coerce.number<number>().openapi({
+        param: { name: 'id', in: 'path' },
+        example: 1,
+        description: '广告ID'
+      })
+    }),
     body: {
       content: {
         'application/json': {
@@ -275,6 +291,15 @@ const deleteRoute = createRoute({
   method: 'delete',
   path: '/:id',
   middleware: [tenantAuthMiddleware] as const,
+  request: {
+    params: z.object({
+      id: z.coerce.number<number>().openapi({
+        param: { name: 'id', in: 'path' },
+        example: 1,
+        description: '广告ID'
+      })
+    })
+  },
   responses: {
     200: {
       description: '成功删除广告',
@@ -352,7 +377,7 @@ const app = new OpenAPIHono<AdminContext>()
   })
   .openapi(getRoute, async (c) => {
     try {
-      const id = parseInt(c.req.param('id'));
+      const { id } = c.req.valid('param');
       const service = getService();
 
       const advertisement = await service.getById(id, ['imageFile', 'advertisementType']);
@@ -402,7 +427,7 @@ const app = new OpenAPIHono<AdminContext>()
   })
   .openapi(updateRoute, async (c) => {
     try {
-      const id = parseInt(c.req.param('id'));
+      const { id } = c.req.valid('param');
       const body = c.req.valid('json');
       const superAdminId = c.get('superAdminId') || 1;
       const service = getService();
@@ -432,7 +457,7 @@ const app = new OpenAPIHono<AdminContext>()
   })
   .openapi(deleteRoute, async (c) => {
     try {
-      const id = parseInt(c.req.param('id'));
+      const { id } = c.req.valid('param');
       const superAdminId = c.get('superAdminId') || 1;
       const service = getService();