# 工资条确认功能完整方案

## 需求确认

### 业务流程
1. **系统自动计算工资** → 生成工资数据
2. **导出Excel** → 进行线下梳理处理
3. **导入Excel** → 覆盖现有数据（包含调整后的数据）
4. **形成工资条** → 给员工查看
5. **员工确认工资条** → 确认后工资数据不可再修改

### 关键逻辑

#### 1. 计算工资（CalculateSalary）
- ✅ **已锁定（IsLocked = 1）的记录**：跳过，不重新计算
- ✅ **已确认（EmployeeConfirmStatus = 1）的记录**：跳过，不重新计算
- ✅ **未锁定且未确认的记录**：可以重新计算并更新

#### 2. 导入工资（Import）
- ✅ **Excel第一列是ID（主键）**：通过ID判断是更新还是新增
- ✅ **导入逻辑**：
  - Excel有ID且数据库中存在该ID → 更新（覆盖）
  - Excel有ID但数据库中不存在 → 新增（使用Excel中的ID）
  - Excel无ID（空值） → 新增（自动生成新ID）
- ✅ **保护机制**：
  - **已锁定（IsLocked = 1）的记录**：跳过，不能导入覆盖
  - **已确认（EmployeeConfirmStatus = 1）的记录**：跳过，不能导入覆盖（无论是否锁定）
  - **未锁定且未确认的记录**：可以导入覆盖

#### 3. 员工确认（Confirm）
- ✅ 只能确认自己的工资条
- ✅ **只能确认已锁定的工资条**（IsLocked = 1 且 EmployeeConfirmStatus = 0）
- ✅ **工作流程**：管理员先锁定工资 → 员工确认 → 发工资
- ✅ 确认后设置 EmployeeConfirmStatus = 1（IsLocked 保持为 1，因为本来就是管理员锁定的）
- ✅ 确认后不能重复确认

---

## 数据库字段

为所有9个工资表添加以下字段：

```sql
F_EmployeeConfirmStatus INT NOT NULL DEFAULT 0 COMMENT '员工确认状态（0=未确认，1=已确认）',
F_EmployeeConfirmTime DATETIME NULL COMMENT '员工确认时间',
F_EmployeeConfirmRemark VARCHAR(500) NULL COMMENT '员工确认备注'
```

---

## 实现方案

### 1. 计算工资方法修改

**逻辑**：
```csharp
// 查询当月已存在的记录
var existingRecords = await _db.Queryable<SalaryEntity>()
    .Where(x => x.StatisticsMonth == monthStr)
    .ToListAsync();

// 遍历计算出的工资数据
foreach (var salary in calculatedSalaries)
{
    if (existingRecords.ContainsKey(salary.EmployeeId))
    {
        var existing = existingRecords[salary.EmployeeId];
        
        // 如果已锁定或已确认，跳过
        if (existing.IsLocked == 1 || existing.EmployeeConfirmStatus == 1)
        {
            skippedCount++;
            continue; // 跳过，不更新
        }
        
        // 更新现有记录（保留确认状态相关字段）
        salary.Id = existing.Id;
        salary.EmployeeConfirmStatus = existing.EmployeeConfirmStatus;
        salary.EmployeeConfirmTime = existing.EmployeeConfirmTime;
        salary.EmployeeConfirmRemark = existing.EmployeeConfirmRemark;
        salary.IsLocked = existing.IsLocked; // 保留锁定状态
        recordsToUpdate.Add(salary);
    }
    else
    {
        // 新记录，正常插入
        recordsToInsert.Add(salary);
    }
}
```

### 2. 导入方法修改

**Excel结构**：
- 第一列（A列）：ID（主键，F_Id）
- 第二列（B列）开始：业务字段

**导入逻辑**：
```csharp
// 使用ExcelImportHelper读取Excel文件（第一行为标题行）
var dataTable = ExcelImportHelper.ToDataTable(tempFilePath, 0, 0);

// 从第1行开始读取数据（跳过标题行）
for (int i = 1; i < dataTable.Rows.Count; i++)
{
    var row = dataTable.Rows[i];
    
    // 第一列是ID
    var id = row[0]?.ToString()?.Trim();
    // 第二列开始是业务字段
    var storeName = row[1]?.ToString()?.Trim();
    var employeeName = row[2]?.ToString()?.Trim();
    // ... 其他字段
    
    if (string.IsNullOrWhiteSpace(id))
    {
        // Excel中没有ID → 新增记录（自动生成ID）
        var newRecord = new SalaryEntity
        {
            Id = YitIdHelper.NextId().ToString(),
            StoreName = storeName,
            EmployeeName = employeeName,
            // ... 其他字段
            EmployeeConfirmStatus = 0,
            IsLocked = 0
        };
        recordsToInsert.Add(newRecord);
    }
    else
    {
        // Excel中有ID → 查找现有记录
        var existing = await _db.Queryable<SalaryEntity>()
            .Where(x => x.Id == id)
            .FirstAsync();
        
        if (existing != null)
        {
            // 记录存在 → 检查是否可以更新
            // 如果已锁定，跳过导入
            if (existing.IsLocked == 1)
            {
                skippedCount++;
                errorMessages.Add($"员工 {existing.EmployeeName} (ID: {id}) 的工资已锁定，不能导入覆盖");
                continue;
            }
            
            // 如果已确认，跳过导入
            if (existing.EmployeeConfirmStatus == 1)
            {
                skippedCount++;
                errorMessages.Add($"员工 {existing.EmployeeName} (ID: {id}) 的工资已确认，不能导入覆盖");
                continue;
            }
            
            // 可以更新 → 覆盖现有记录
            existing.StoreName = storeName;
            existing.EmployeeName = employeeName;
            // ... 更新所有字段
            existing.EmployeeConfirmStatus = 0; // 导入后重置确认状态
            existing.EmployeeConfirmTime = null;
            existing.EmployeeConfirmRemark = null;
            recordsToUpdate.Add(existing);
        }
        else
        {
            // Excel中有ID，但数据库中不存在 → 新增记录（使用Excel中的ID）
            var newRecord = new SalaryEntity
            {
                Id = id,
                StoreName = storeName,
                EmployeeName = employeeName,
                // ... 其他字段
                EmployeeConfirmStatus = 0,
                IsLocked = 0
            };
            recordsToInsert.Add(newRecord);
        }
    }
}
```

**导出功能修改**：
- 确保导出时，第一列是ID（主键）
- 字段顺序：ID、门店名称、员工姓名、岗位、... 其他业务字段

### 3. 员工确认接口

**工作流程**：
1. 管理员锁定工资（IsLocked = 1）
2. 员工查看工资条
3. 员工确认工资条（只能确认已锁定的）
4. 确认后发工资

**逻辑**：
```csharp
[HttpPost("confirm")]
public async Task<string> ConfirmSalary(SalaryConfirmInput input)
{
    // 1. 验证参数
    if (string.IsNullOrWhiteSpace(input.Id))
        throw NCCException.Oh("工资记录ID不能为空");
    if (string.IsNullOrWhiteSpace(input.EmployeeId))
        throw NCCException.Oh("员工ID不能为空");
    
    // 2. 查询工资记录
    var salary = await _db.Queryable<SalaryEntity>()
        .Where(s => s.Id == input.Id && s.EmployeeId == input.EmployeeId)
        .FirstAsync();
    
    // 3. 验证记录是否存在
    if (salary == null)
        throw NCCException.Oh("工资记录不存在或不属于该员工");
    
    // 4. 验证是否已确认
    if (salary.EmployeeConfirmStatus == 1)
        throw NCCException.Oh("该工资条已确认，不能重复确认");
    
    // 5. 验证是否已锁定（员工只能确认已锁定的工资条）
    if (salary.IsLocked != 1)
        throw NCCException.Oh("该工资条尚未锁定，请等待管理员锁定后再确认");
    
    // 6. 更新确认状态
    salary.EmployeeConfirmStatus = 1;
    salary.EmployeeConfirmTime = DateTime.Now;
    salary.EmployeeConfirmRemark = input.Remark;
    // 注意：IsLocked 保持为 1（因为本来就是管理员锁定的）
    
    await _db.Updateable(salary).ExecuteCommandAsync();
    
    return "确认成功";
}
```

---

## 涉及的服务和表

### 9个工资服务
1. `LqSalaryService` - 健康师
2. `LqTechTeacherSalaryService` - 科技部老师
3. `LqAssistantSalaryService` - 店助/店助主任
4. `LqStoreManagerSalaryService` - 店长
5. `LqDirectorSalaryService` - 主任
6. `LqMajorProjectTeacherSalaryService` - 大项目部老师
7. `LqMajorProjectDirectorSalaryService` - 大项目主管
8. `LqTechGeneralManagerSalaryService` - 科技部总经理
9. `LqBusinessUnitManagerSalaryService` - 事业部总经理/经理

### 对应的9个工资表
1. `lq_salary_statistics`
2. `lq_tech_teacher_salary_statistics`
3. `lq_assistant_salary_statistics`
4. `lq_store_manager_salary_statistics`
5. `lq_director_salary_statistics`
6. `lq_major_project_teacher_salary_statistics`
7. `lq_major_project_director_salary_statistics`
8. `lq_tech_general_manager_salary_statistics`
9. `lq_business_unit_manager_salary_statistics`

---

## 已确认的逻辑

1. **导入时已确认的记录**：
   - ✅ **不能导入覆盖**（无论是否锁定）
   - ✅ **已锁定的记录也不能导入覆盖**
   - ✅ **只有未锁定且未确认的记录才能导入覆盖**

2. **导出Excel格式**：
   - ✅ 第一列必须是ID（主键）
   - ✅ 后续列是业务字段（门店名称、员工姓名、岗位等）
   - ✅ 包含确认状态字段（方便线下查看）

3. **导入Excel格式**：
   - ✅ 第一列是ID（主键）
   - ✅ 通过ID判断是更新还是新增
   - ✅ 如果Excel有ID但数据库不存在 → 新增（使用Excel中的ID）
   - ✅ 如果Excel无ID → 新增（自动生成新ID）

---

## 实施步骤

1. ✅ 创建SQL脚本为所有9个工资表添加确认字段
2. ✅ 修改9个工资实体类，添加确认字段属性
3. ⏳ 修改9个服务的计算工资方法：已锁定或已确认的跳过
4. ⏳ 修改9个服务的导入方法（如果存在）：已锁定的跳过，未锁定的覆盖
5. ⏳ 为所有9个服务类添加员工确认接口

---

## 工作流程

### 完整流程
1. **系统自动计算工资** → 生成工资数据（IsLocked = 0, EmployeeConfirmStatus = 0）
2. **导出Excel** → 进行线下梳理处理
3. **导入Excel** → 覆盖现有数据（已锁定或已确认的记录不能覆盖）
4. **管理员锁定工资** → 设置 IsLocked = 1（准备让员工确认）
5. **员工查看工资条** → 查看已锁定的工资条
6. **员工确认工资条** → 设置 EmployeeConfirmStatus = 1（只能确认已锁定的）
7. **发工资** → 确认后才会去发工资

---

## 请确认

请确认以上方案是否符合需求，特别是：
- ✅ 计算工资：已锁定或已确认的跳过
- ✅ 导入：已锁定或已确认的跳过，不能覆盖
- ✅ 员工确认：只能确认已锁定的工资条（IsLocked = 1 且 EmployeeConfirmStatus = 0）
- ✅ 工作流程：管理员锁定 → 员工确认 → 发工资

确认后我将继续完成所有9个服务的代码修改。