companyId统一规范

# companyId 统一规范

## 背景

系统中 `companyId` 存在多种格式混乱的问题：
- UUID 格式（正确）：`13c43e7a-3ef2-4f5a-9fa3-da872cd27f07`
- 简写格式（错误）：`company-001`
- tenantId 格式（错误）：`tenant-001`

这导致数据关联失败，如面试通过后候选人未出现在 Offer 管理列表。

## 规范

### 1. 格式规范

**统一使用 UUID 格式**，来源：`saas_companies.id` 表

```sql
-- 正确示例
13c43e7a-3ef2-4f5a-9fa3-da872cd27f07

-- 错误示例（禁止使用）
company-001
tenant-001
```

### 2. 获取方式

| 场景 | 获取方式 |
|------|----------|
| 登录时 | 从登录 API 返回的 `user.companyId` 获取 |
| API 调用 | 使用 `getCompanyId(req)` 函数，优先级：请求头 > URL 参数 > Cookie > localStorage |
| 前端存储 | `localStorage.setItem('companyId', result.data.user.companyId)` |

### 3. 存储位置

| 位置 | 键名 | 说明 |
|------|------|------|
| localStorage | `companyId` | 主要存储键 |
| localStorage | `currentCompanyId` | 备用存储键（兼容） |
| Cookie | `companyId` | 服务端可访问 |
| 请求头 | `x-company-id` | API 调用时传递 |

## 关键代码

### config/tenant.ts

```typescript
// 统一获取 companyId 的函数
export function getCompanyId(req?: NextRequest): string {
  // 优先级：请求头 > URL 参数 > Cookie > localStorage > 默认值
  // ...
}
```

### 登录页面

```typescript
// 正确存储方式
localStorage.setItem('companyId', result.data?.user?.companyId || result.data?.user?.id);
```

### 人才创建 API

```typescript
import { getTenantId, getCompanyId } from '@/config/tenant';

export async function POST(req: NextRequest) {
  const tenantId = getTenantId(req);
  const companyId = getCompanyId(req);
  // ...
}
```

## 修复记录

### 2026-03-26

1. **登录页面**：修复存储 `user.id` 而非 `user.companyId` 的问题
   - `src/app/tenant/login/page.tsx`
   - `src/app/login/page.tsx`
   - `src/app/tenant/page.tsx`

2. **人才 API**：统一使用 `getCompanyId` 函数
   - `src/app/api/hr/talents/route.ts`
   - `src/app/api/hr/electronic-resumes/route.ts`

3. **面试/Offer API**：自动从人才记录获取正确的 companyId
   - `src/app/api/hr/interviews/route.ts`
   - `src/app/api/hr/offers/route.ts`

4. **数据库查询**：移除 LEFT JOIN 中多余的 companyId 匹配条件
   - `src/storage/database/hr/manager.ts`
   - `src/app/api/hr/todos/route.ts`

### 2026-03-26 (第二次修复)

**问题**：历史数据中 companyId 格式不一致，导致 GET 查询时过滤条件不匹配

**解决方案**：所有列表查询 API 改为使用 `tenantId` 进行数据隔离，不再依赖 `companyId`

**修复文件**：

| 文件 | 修改内容 |
|------|----------|
| `src/storage/database/hr/manager.ts` | 所有 `getListWithTalentInfo` 方法添加 tenantId 过滤，companyId 改为可选 |
| `src/app/api/hr/offers/route.ts` | GET 方法不再传递 companyId |
| `src/app/api/hr/talents/route.ts` | GET 方法不再传递 companyId |
| `src/app/api/hr/onboarding/route.ts` | GET 方法不再传递 companyId |
| `src/app/api/hr/probation/route.ts` | GET 方法不再传递 companyId |
| `src/app/api/hr/regularization/route.ts` | GET 方法不再传递 companyId |
| `src/app/api/hr/resignation/route.ts` | GET 方法不再传递 companyId |
| `src/app/api/hr/export/route.ts` | 导出接口不再传递 companyId |

## 数据迁移

现有数据中存在不同格式的 companyId，建议：

1. **新建数据**：自动使用 UUID 格式
2. **历史数据**：保持不变，LEFT JOIN 已支持跨格式关联
3. **后续优化**：可考虑数据迁移脚本统一格式