架构使用指南

> **文档版本**: v1.0.0
> **创建日期**: 2026-02-12
> **最后更新**: 2026-02-12
> **维护人**: 未来鸟FutureBird码巢企业服务引擎开发组
> **状态**: [最新]

---

# Schema 快速使用指南

## &#127919; 5秒选择指南

```
我要操作 → 哪种数据？ → 用哪个Schema？

用户/员工/薪资/订单/CRM → Storage Schema
微信/企业微信/小程序 → Infrastructure Schema
API监控/媒体管理 → Infrastructure Schema
邮件/短信/通知 → Storage Schema
```

---

## &#128230; 快速导入

### Infrastructure Schema（基础设施）

```typescript
import {
  // 微信
  wechatFans, wechatMenus, wechatTemplates,
  // 企业微信
  weworkUsers, weworkDepartments,
  // API 监控
  apiMonitorLogs, apiAlertRules,
  // 媒体
  mediaResources, mediaCategories,
} from '@/infrastructure/database/shared/schema';
```

### Storage Schema（业务数据）

```typescript
import {
  // 用户
  users, employees,
  // 薪资
  salarySlips, salaryConfigs,
  // 企业
  saasCompanies, saasTenants,
  // 邮件
  emailTemplates, emailSendRecords,
  // 短信
  smsTemplates, smsSendRecords,
} from '@/storage/database/shared/schema';
```

---

## &#128161; 常见场景

### 场景 1：查询员工工资

```typescript
import { employees, salarySlips } from '@/storage/database/shared/schema';
import { eq } from 'drizzle-orm';

const result = await db.select()
  .from(salarySlips)
  .innerJoin(employees, eq(salarySlips.employeeId, employees.id))
  .where(eq(salarySlips.salaryPeriod, '2024-01'));
```

### 场景 2：微信粉丝管理

```typescript
import { wechatFans } from '@/infrastructure/database/shared/schema';
import { eq } from 'drizzle-orm';

const fans = await db.select()
  .from(wechatFans)
  .where(eq(wechatFans.subscribeStatus, 1));
```

### 场景 3：API 监控

```typescript
import { apiMonitorLogs } from '@/infrastructure/database/shared/schema';
import { gt } from 'drizzle-orm';

const slowRequests = await db.select()
  .from(apiMonitorLogs)
  .where(gt(apiMonitorLogs.responseTime, 1000));
```

---

## ⚠️ 常见错误

### ❌ 错误 1：导错 Schema

```typescript
// 错误：微信表不在 Storage Schema
import { wechatFans } from '@/storage/database/shared/schema';

// 正确
import { wechatFans } from '@/infrastructure/database/shared/schema';
```

### ❌ 错误 2：重复定义

```typescript
// 不要在两个 Schema 中都定义同一个表
// 只在 Storage Schema 中定义，Infrastructure 通过 import 引用
```

---

## &#128218; 完整文档

查看详细文档：[Schema 结构说明](../05-数据库/DATABASE_SCHEMA.md)

---

## &#128295; 快速参考

| 功能 | Schema | 文件路径 |
|------|--------|----------|
| 用户管理 | Storage | `src/storage/database/shared/schema.ts` |
| 薪资管理 | Storage | `src/storage/database/shared/schema.ts` |
| 微信集成 | Infrastructure | `src/infrastructure/database/shared/schema.ts` |
| API 监控 | Infrastructure | `src/infrastructure/database/shared/schema.ts` |

---

**提示**: 不确定时先查 [完整文档](../05-数据库/DATABASE_SCHEMA.md)