antissoft / lvqianmeiye_ERP

- 移除9个薪酬服务列表查询方法中的自动计算工资逻辑
- 列表查询现在只负责查询已存在的工资数据
- 工资计算功能需要单独调用计算接口
- 新增健康师工资核算规则说明文档
- 新增员工门店归属变更问题分析与解决方案文档
- 新增员工门店归属快照表方案详细设计文档

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

- 修复CalculateStoreCommission方法返回值访问方式，使用Item1和Item2替代.Amount和.Detail
- 为所有工资表添加员工确认字段SQL脚本（9个工资表）
- 创建安全版SQL脚本，支持检查字段是否存在后再添加

- 优化卡片视图样式：调整字体大小匹配卡片尺寸，确保最小字体12px
- 改进卡片布局：调整间距和内边距，保持毛玻璃效果
- 修复会员沉睡天数计算：更新消费记录时正确更新LastConsumeTime
- 默认视图模式：客户页面进入时默认显示列表视图
- 添加会员沉睡天数数据修复SQL脚本

- 新增事业部驾驶舱后端服务（LqBusinessUnitDashboardService）
- 实现15个事业部驾驶舱API接口（统计、趋势、排行榜等）
- 新增集团驾驶舱移动端页面（dashboard.vue）
- 集成图表功能（Canvas绘制趋势图）
- 优化页面样式设计（现代化UI、玻璃拟态效果）
- 完善KPI指标展示、会员统计、排行榜等功能
- 添加API模块（report.js）用于集团驾驶舱数据接口

- 创建docs文件夹，移动39个需求相关的md文档
- 创建scripts/sh文件夹，移动18个shell测试脚本
- 创建scripts/py文件夹，移动4个Python脚本
- 将3个SQL文件移动到sql文件夹
- 保留README.md和PROJECT_RULES.md在根目录

- 完善字段映射逻辑，使用字典统一管理前端字段名到数据库字段名的映射
- 修复'Unknown column id in order clause'错误
- 处理sort参数为空的情况，默认使用desc
- 支持更多字段的排序映射（id, khmc, sjh, dah, xb, zcsj等）

- 修改退款明细列表查询逻辑，从退款健康师业绩表查询（而非开单健康师业绩表）
- 支持一个退款明细显示多个健康师，格式：姓名(业绩)、姓名(业绩)
- 新增实际退款金额字段，显示所有健康师业绩之和
- 优化前端显示，健康师列显示每个健康师及其业绩
- 添加测试脚本test_refund_detail.sh

- 新增ExportOptimized接口，使用批量查询优化性能
- 创建LqKhxxExportOutput导出专用DTO类
- 支持23个固定字段导出，包括客户目前归属名称等
- 文件保存到ExportFiles目录
- 新增Python脚本控制台工具script_runner.py
- 新增测试脚本test_customer_export_optimized.sh

- 修复门店驾驶舱页面布局对齐问题
- 删除每日运营数据（当月）图表
- 退款明细列表接口添加健康师和业绩字段
- 退款明细列表页面显示健康师和业绩信息

- 为所有表格列添加前端排序功能
- 实现数字、增长率等自定义排序方法
- 修复列表数据重复问题（从54条减少到30条）
- 使用GroupBy确保门店唯一性

- 将开单明细、耗卡明细、储扣列表三个接口的StoreIds参数从List<string>改为string类型（逗号分隔）
- 修改后端解析逻辑，支持解析逗号分隔的门店ID字符串
- 解决GET请求中List<string>类型参数无法正确绑定的问题

- 修复UpdateForNoDelete方法中升单字段赋值错误（升医美和升生美字段错位）
- 新增历史开单记录服务（LqOrderRecordsService），支持通过会员编号或手机号查询
- 更新集团驾驶舱及相关子页面标题为更专业的名称

- 新增退卡明细查询接口
  - 支持多门店、会员、时间范围、品项、业绩类型、科美类型、来源类型、品项分类等筛选
  - 返回字段：门店、会员信息、退卡时间、品项信息、金额、类型等
  - 支持分页和排序

- 新增退卡明细导出接口
  - 导出Excel文件，包含所有筛选条件
  - 文件保存到项目根目录ExportFiles文件夹

- 优化退卡穿透统计接口
  - 所有金额字段改为使用实退金额（F_ActualRefundAmount）
  - 包括门店分布、总计、转卡总计、金额最大/次数最多的人等统计

- 优化客户资料导出接口
  - 添加消费等级、开单总金额、剩余权益总金额字段
  - 添加首次到店时间、最后到店时间、到店天数、沉睡天数字段
  - 消费等级显示为名称（D/C/B/A/A+/A++）

- 修复库存扣减逻辑：只有已领取状态才扣减库存
  - 修改LqInventoryService、LqProductService、LqInventoryUsageService中所有计算已使用数量的地方
  - 只统计IsReceived=1的使用记录，确保库存扣减准确
  - 添加System.Collections.Generic命名空间引用

- 优化报销导出功能
  - 添加购买门店字段（purchaseStoreId、purchaseStoreName）
  - 区分申请门店和购买门店两个字段
  - 修复文件路径问题：使用项目根目录下的ExportFiles文件夹
  - 修复FromQuery参数导致的BadImageFormatException错误

- 修复编译错误
  - 添加System.IO命名空间引用
  - 修复List<dynamic>类型转换问题

- 拓客明细页面：是否邀约、是否预约、是否消耗、是否开卡字段使用el-tag样式，绿色表示是，灰色表示否
- 多门店筛选接口：
  * 会员品项接口：BillingStoreId改为支持BillingStoreIds数组
  * 开单明细接口：StoreId改为支持StoreIds数组
  * 耗卡明细接口：StoreId改为支持StoreIds数组
  * 会员升单统计接口：新增StoreIds多门店筛选
  * 储扣列表接口：StoreId改为支持StoreIds数组（已存在，优化逻辑）
  * 门店整体统计接口：StoreId改为支持StoreIds数组
- 门店日报统计接口：添加EmployeeCount在职人数字段，从lq_mdxx.zzrs获取

- 创建单独的门店基础信息接口(get-store-base-info)，支持单独获取门店基础信息和归属信息
- 修复门店数据结构分析接口的类型转换问题
- 优化前端调用逻辑，支持分步骤获取数据
- 添加门店归属信息显示（事业部、科技部、教育部、大项目部）
- 添加性能优化相关的SQL索引脚本

- 新增门店数据结构分析弹窗，支持门店业绩和运营数据分析
- 更新门店业绩统计逻辑，使用实退金额计算退款业绩
- 优化数据查询接口，支持实时查询和数据完整性
- 增加到店频次会员列表接口，提供详细会员信息和统计数据
- 更新前端展示，提升用户交互体验

- 更新会员画像服务，增强数据展示和分析能力
- 优化统计接口，确保返回完整字段并提升查询性能
- 新增门店数据页面设计方案，梳理数据维度和接口
- 更新多个静态资源文件，确保前端展示一致性

- 新增会员画像服务，包含基础信息、消费行为、趋势分析等
- 优化KPI数据穿透功能，新增多个分析组件
- 修复消费行为统计数据查询问题
- 调整会员画像弹窗布局，基础信息独立显示
- 权益明细单独作为选项卡展示

- 新增kpi-drill-dialog组件，支持科技感弹窗展示数据穿透
- 实现本月成交总额穿透功能，包含：
  * 每日开单金额和人数趋势图
  * 开单金额最高会员、开单次数最多会员统计
  * 品项类型雷达图、业绩类型占比饼图、科美类型业绩柱状图
  * 本月成交明细列表（支持真实后端分页和筛选）
- 新增get-billing-drill-statistics接口，提供整月统计数据
- 优化billing-item-detail-list接口，支持业绩类型和科美类型字段
- 修复LqHytkHytkService时间参数解析问题
- 科美类型统计只显示有设置的数据，过滤未设置项

1. 线索池客户统计接口：新增归属门店、电话、拓客人员字段
2. 会员信息接口：确保列表和单个查询返回所有字段（包括isEffective）
3. 修改开单信息接口：重命名为UpdateBillingInfo，支持修改备注和简介
4. 金三角开卡业绩统计：改为实时统计，优化查询性能
5. 科技部开单业绩统计：改为实时统计，优化查询性能
6. 门店耗卡业绩统计：改为实时统计，优化查询性能
7. 部门消耗业绩统计：改为实时统计，优化查询性能，支持健康师和科技部老师两种类型
8. 女神卡会员列表接口：新增门店筛选功能

- 储扣列表接口增加门店筛选、时间筛选、品项分类筛选功能
- 统计查询改为单独查询，避免复杂JOIN导致的问题
- 返回结果包含总记录数、总金额、总项目数统计信息
- 优化查询性能，先获取符合条件的开单记录ID，再筛选储扣记录

- 修复营收与服务产出趋势分析的时间参数传递
- 修复业务统计数据接口的时间参数格式
- 确保时间参数正确传递到后端，避免时区转换问题

- 新增接口：GetManagedStores，根据年月、组织类型、部门ID查询管理的门店列表
- 新增接口：UpdateFile，根据开单ID修改scwj和F_FIleUrl字段
- 支持的组织类型：事业部、科技部、教育部、大项目部
- 包含完整的参数验证和错误处理

1. 库存管理接口优化：
   - 门店领取统计接口改为返回明细数据，支持产品和仓库筛选
   - 新增仓库待领取清单接口，按仓库和门店分组，用于生成送货清单

2. 报销申请功能增强：
   - 添加完成时间字段（最后一个审批人通过的时间）
   - 支持完成时间的查询和筛选

3. 门店信息功能扩展：
   - 添加在职人数字段（zzrs），支持添加、编辑、查询、列表

4. 工资计算规则调整：
   - 店助提成规则调整：0-100%部分（整个生命线）按0.4%，100%以上按0.6%
   - 主任提成规则说明更新：明确提成基数使用毛利，分段计算

- 修复GetStoreReceiveStatistics接口：将表别名从usage改为u（usage是MySQL保留关键字）
- 修复店长工资计算：根据门店分类（A/B/C）正确计算老店提成比例
- 开单品项明细接口：返回支付医院和合作机构中文名称
- 修改开单金额接口：支持修改品项备注
- 报销申请接口：返回完成时间并支持按完成时间筛选
- 店内支出导入：使用门店名称匹配并存储门店ID

- 科技部老师工资：提成改为阶梯式（整个业绩按对应比例），业绩必须>1万才有提成
- 清洗流水：GetDifferenceList和GetInfo接口返回SendTime和ReturnTime字段
- 主任工资：合作成本查询使用monthStr（YYYYMM格式）匹配Month字段
- 更新科技部老师工资计算规则文档

- 健康师额外工资导入：添加清理导入月份数据参数，默认true
- 合作成本导入：添加清理导入月份数据参数，默认true，支持多成本类型和多笔记录
- 合作成本导入返回结果：添加成本类型字段到successRecords
- 移除合作成本导入的重复检查，支持同一门店同一月份多笔记录

1. 健康师薪酬计算优化：
   - 修复升单提点计算规则（>=10:12%, >=7:10%, >=4:7%, <4:0%）
   - 修复升单业绩提成计算（需要乘以0.95）
   - 修复顾问提成规则（按战队人数区分：3人及以上按3人规则，2人按2人规则，1人无顾问）
   - 修复健康师筛选逻辑（只统计岗位为'健康师'的员工）
   - 修复新店健康师底薪计算说明

2. 店助薪酬计算优化：
   - 修复门店目标缺失时的处理逻辑（默认值为0，不抛异常）

3. 合同成本统计接口优化：
   - 年份和月份参数改为可选
   - 优化时间范围过滤逻辑

4. 合作成本表功能增强：
   - 添加成本类型字段（F_CostType）
   - 导入功能优化（支持通过门店名称查找门店ID）
   - 更新Excel模板

5. 清洗流水管理接口优化：
   - 创建送出记录接口：支持传入sendTime参数（可选）
   - 创建送回记录接口：支持传入returnTime参数（可选）
   - 修改接口：支持修改sendTime和returnTime

6. 开单品项明细列表接口优化：
   - 添加paymentMethod字段（付款方式，来源于开单记录表的fkfs字段）

7. 其他优化：
   - 修复开单记录表PerformanceType字段同步更新逻辑
   - 更新相关文档说明

- 更新店助主任底薪的来源描述，确保准确性。
- 优化数据库查询条件，合并条件以提高可读性和性能。
- 在多个SQL文件中添加空行以提升可读性。

- 新增多个消耗业绩字段，包括生美、科美、医美、合作、产品及其他消耗业绩。
- 修改主营收入计算逻辑，改为不扣减退款。
- 更新其他收入和成本计算逻辑，确保准确反映退款差额。
- 优化库存使用申请相关的成本计算，确保数据准确性。

- 新增按月生成成本记录的功能，支持自动生成和更新合同的月度成本。
- 添加获取合同成本列表和按月统计的接口，便于查询和管理合同相关的财务数据。
- 优化合同更新逻辑，确保在修改合同信息时同步更新相关的成本记录。
- 增强错误处理，确保在获取和更新数据时提供清晰的错误信息。

1. 主任工资计算改为基于毛利
   - 新增毛利相关字段（销售业绩、产品物料、合作项目成本、店内支出、洗毛巾费用、毛利）
   - 提成计算基于毛利而非销售业绩
   - 业绩完成率和业绩达标判断基于毛利

2. 店助工资计算优化
   - 底薪按在店天数比例计算
   - 提成按在店天数比例计算
   - 手机管理费按在店天数比例计算
   - 阶段奖励按在店天数比例计算

3. 主任工资计算优化
   - 底薪按在店天数比例计算
   - 提成按在店天数比例计算

4. 新增工资计算功能
   - 大项目主管工资计算
   - 科技部总经理工资计算

- 新增修改库存使用申请记录接口，支持添加、删除、修改产品领用
- 修改后自动重新计算申请总金额，检查库存是否充足
- 允许修改待审批、审批中、已退回状态的申请
- 修复GetBatchInfo接口查询时未过滤无效记录导致重复数据的问题
- 添加LqInventoryUsageApplicationUpdateInput DTO类