Cursor进阶：构建高效的团队级Prompt模板库

# 项目概览
本项目是一个基于 Next.js 14 (App Router) 和 TailwindCSS 的企业级 SaaS 平台。

# 核心架构约束 (Core Architectural Constraints)
- **严格分离关注点**：所有的数据获取逻辑必须封装在 `src/services/` 目录下，禁止在 React Server Components 中直接连接数据库。
- **状态管理**：使用 Zustand 管理全局状态，禁止使用 Redux 或 Context API。
- **UI 组件库**：统一使用 Shadcn UI，所有新组件必须基于 TailwindCSS 编写，严禁使用内联样式 (`style={{...}}`)。

# 编码规范 (Coding Standards)
- **TypeScript**：必须使用 TypeScript。禁止使用 `any` 类型。所有的 API 响应必须定义清晰的 `interface` 或 `type`。
- **错误处理**：所有异步操作必须包含 `try/catch` 块，并统一调用 `src/utils/errorHandler.ts` 处理异常。

# AI 生成要求 (AI Generation Requirements)
- 在编写复杂的业务逻辑前，请先输出一段简短的伪代码或步骤计划，等待我确认后再生成具体代码。
- 只返回修改过的函数代码，其余部分使用 `// ... existing code ...` 占位，绝对不要删除我没有要求修改的逻辑。

作为高级 QA 工程师，请为以下目标代码编写单元测试。
约束条件：
1. 测试框架：使用 Vitest 和 React Testing Library。
2. 覆盖率要求：必须覆盖所有正常路径（Happy Path）和至少两个边界异常路径（Edge Cases）。
3. 外部依赖：必须使用 `vi.mock()` 模拟所有的网络请求和外部模块。
4. 测试描述：`it` 块的描述必须清晰说明测试意图（例如 "it('当 API 返回 401 时，应该触发登出逻辑')"）。

目标代码：
{代码块}

请重构以下代码，目标是提高可读性和降低圈复杂度（Cyclomatic Complexity）。
重构的绝对红线：
1. 严禁改变函数对外的签名（入参和返回值类型必须保持一致）。
2. 严禁改变任何外部可观察到的副作用（如 API 调用顺序、DOM 节点结构）。
3. 如果你在重构过程中发现潜在的 Bug，请在注释中用 `// TODO: [AI-WARNING]` 标出，不要擅自修改原有的业务逻辑。

重构步骤：
1. 首先分析当前代码的坏味道（Code Smell）。
2. 提出重构策略（例如提取子函数、使用策略模式替换 if-else）。
3. 给出重构后的完整代码。

我遇到了一个难以复现的 Bug。请像一个经验丰富的高级工程师一样帮我排查。
以下是错误日志：
{错误堆栈}

相关的业务代码：
{代码块}

请按照以下步骤进行分析：
1. **假设生成**：列出至少 3 种可能导致该 Bug 的根本原因。
2. **证据收集建议**：为了验证这些假设，我需要在代码的哪些位置添加 `console.log`，或者查看哪些网络请求面板？请给出具体的调试建议。
3. **修复方案（如果明确）**：如果你非常有把握，请给出修复代码，并解释为什么这样改有效。