feat(inbox): 素材持久化 CRUD — 数据库表 + API + 前端接入

- 新增 materials 表（id/projectId/description/associatedDate/status/createdAt/updatedAt）
- 新增 4 个后端 API 路由（list/create/get/delete）+ 13 个测试
- 新增 use-materials hooks（TanStack Query）
- 收集箱页面重构为三层架构（InboxPage + MaterialSidebar + MaterialDetailPanel）
- MaterialCard: Popconfirm 删除确认 + 粗粒度时间格式
- MaterialContent: 展示状态标签 + createdAt
- 更新开发文档 backend.md / frontend.md

tests/web/features/inbox/MaterialCard.test.tsx

@@ -1,21 +1,24 @@
-import { fireEvent, screen } from "@testing-library/react";
+import { fireEvent, screen, waitFor } from "@testing-library/react";
 import { describe, expect, test, vi } from "bun:test";
 import { createElement } from "react";
 
-import type { Material } from "../../../../src/web/features/inbox/types";
+import type { Material } from "../../../../src/shared/api";
 
 import { MaterialCard } from "../../../../src/web/features/inbox/components/MaterialCard";
 import { renderWithProviders } from "../../test-utils";
 
 const MOCK_MATERIAL: Material = {
   associatedDate: "2026-06-03",
-  createdAt: new Date().toISOString(),
+  createdAt: "2026-06-03T00:00:00.000Z",
   description: "测试素材描述",
   id: "test-id",
+  projectId: "project-1",
+  status: "pending",
+  updatedAt: "2026-06-03T00:00:00.000Z",
 };
 
 describe("MaterialCard", () => {
-  test("渲染素材描述和日期信息", () => {
+  test("渲染素材描述和创建时间", () => {
     renderWithProviders(
       createElement(MaterialCard, {
         material: MOCK_MATERIAL,
@@ -25,7 +28,7 @@ describe("MaterialCard", () => {
       }),
     );
     expect(screen.getByText("测试素材描述")).not.toBeNull();
-    expect(screen.getByText(/2026-06-03/)).not.toBeNull();
+    expect(screen.getByText("今天")).not.toBeNull();
   });
 
   test("点击卡片触发 onSelect", () => {
@@ -43,7 +46,7 @@ describe("MaterialCard", () => {
     expect(onSelect).toHaveBeenCalledTimes(1);
   });
 
-  test("点击删除按钮触发 onDelete 且不触发 onSelect", () => {
+  test("点击删除按钮弹出确认框，确认后触发 onDelete", async () => {
     const onDelete = vi.fn();
     const onSelect = vi.fn();
     renderWithProviders(
@@ -55,11 +58,20 @@ describe("MaterialCard", () => {
       }),
     );
     fireEvent.click(screen.getByLabelText("删除"));
-    expect(onDelete).toHaveBeenCalledTimes(1);
+
+    await waitFor(() => {
+      expect(screen.getByText("确认删除该素材？")).not.toBeNull();
+    });
+
+    fireEvent.click(screen.getByText("删 除"));
+
+    await waitFor(() => {
+      expect(onDelete).toHaveBeenCalledTimes(1);
+    });
     expect(onSelect).not.toHaveBeenCalled();
   });
 
-  test("选中状态添加 app-inbox-card-selected 类", () => {
+  test("选中状态不再使用 app-inbox-card-selected 类", () => {
     renderWithProviders(
       createElement(MaterialCard, {
         material: MOCK_MATERIAL,
@@ -69,6 +81,6 @@ describe("MaterialCard", () => {
       }),
     );
     const card = screen.getByText("测试素材描述").closest(".app-inbox-card-selected");
-    expect(card).not.toBeNull();
+    expect(card).toBeNull();
   });
 });