antissoft / lvqianmeiye_ERP

- 在GetActivityStatistics方法中新增欠款金额统计
- 欠款金额来自lq_kd_kdjlb表的qk字段
- 支持门店ID过滤
- 更新输出DTO和相关接口文档

- 修复lq_kd_kdjlb表的门店字段从F_StoreId改为djmd
- 修复lq_xh_hyhk表的门店字段从F_StoreId改为md
- 修复lq_hytk_hytk表的门店字段从F_StoreId改为md
- 移除lq_khxx表的门店过滤（该表没有门店字段）
- lq_tkjlb表的F_StoreId字段保持不变（已验证存在）
- 解决所有门店过滤相关的SQL语法错误

- 在GetBusinessStatistics中新增开单目标业绩统计
- 目标业绩来自门店信息表的xsyj字段
- 完成业绩 = 开单总金额 - 退卡总金额
- 计算开单完成率（完成业绩 / 开单目标业绩 * 100）
- 支持门店ID过滤
- 更新输出DTO和相关接口文档

- 在GetBusinessStatistics方法中新增消耗目标业绩统计
- 目标业绩来自门店信息表的xhyj字段
- 计算消耗完成率（耗卡总金额 / 消耗目标业绩 * 100）
- 支持门店ID过滤
- 更新输出DTO和相关接口文档

- 新增GetTimeRange辅助方法，统一处理时间参数
- 更新所有日报服务方法的输入参数为StartTime和EndTime
- 未传入参数时默认统计本月数据
- 支持灵活指定任意时间范围进行统计
- 修复order关键字冲突问题，改为ord别名

涉及方法：
- GetStoreDailyStatistics: 门店每日运营统计
- GetStorePerformanceCompletion: 门店业绩完成情况
- GetBusinessUnitPerformanceCompletion: 事业部业绩完成情况
- GetTianwangGroupPerformanceCompletion: 天王团业绩完成情况
- GetManagerPerformanceCompletion: 经理业绩完成情况
- GetManagerSummaryPerformanceCompletion: 经理汇总业绩
- GetTechTeacherDailyStatistics: 科技部老师统计

主要变更：
1. 修复人次统计逻辑，改为使用客户ID和日期的组合去重（COUNT(DISTINCT CONCAT(hy, '-', DATE(hksj)))）
2. 新增员工业绩统计接口GetEmployeePerformanceStatistics，支持查询员工在指定月份的完整业绩数据
3. 修复品项统计的门店过滤问题，使用SqlFunc.Subqueryable避免别名冲突
4. 修复门店顾客详情SQL字段错误（F_Status改为yysj，F_CreateTime改为kdrq/hksj）
5. 新增员工业绩统计输入输出DTO类

功能特性：
- 支持查询员工的拓客、邀约、预约、开单、消耗、退卡、人头、人次等完整统计
- 所有SQL改为字符串拼接方式，确保参数正确传递
- 分步统计设计，便于维护和优化

- 修复lq_yaoyjl表中F_Status字段不存在的错误，改用yysj字段
- 修复耗卡统计中使用F_CreateTime的错误，改用hksj字段
- 修复开单统计中使用F_CreateTime的错误，改用kdrq字段
- 优化耗卡和开单统计的NULL值处理，添加COALESCE函数
- 测试验证SQL查询正常运行并返回完整数据

- 优化LqReportService.GetItemStatistics方法，采用分步查询策略避免复杂JOIN，提升查询性能至3秒内
- 新增LqPackageInfoService.GetActivityStatistics方法，支持营销活动开单和退卡统计
- 新增ActivityStatisticsInput和ActivityStatisticsOutput DTO类
- 支持按营销活动、时间范围、门店等维度进行统计分析
- 提供开单数量、开单金额、退卡数量、退卡金额、净开单数量、净开单金额、退卡率等完整统计指标

- Added refund performance and count fields to personal and store total performance statistics.
- Introduced actual performance calculations that account for refunds.
- Updated relevant DTOs and entity classes to include new fields.
- Improved front-end tables to display refund-related data in performance statistics views.

前端功能：
- 新增库存管理页面，包含库存列表、添加/编辑库存、库存详情等功能
- 新增库存使用记录管理，支持添加使用记录、查看使用记录列表等
- 新增学习班级管理页面，包含班级列表、创建班级、添加学员等功能
- 新增学习记录管理，支持添加学习记录、查看学员列表等
- 完善API接口调用和路由配置

后端功能：
- 完善LqInventoryService库存管理服务
- 完善LqInventoryUsageService库存使用记录服务
- 优化服务接口和业务逻辑

技术特点：
- 使用Vue 2 + Element UI构建现代化管理界面
- 支持分页查询、条件筛选、批量操作等功能
- 响应式设计，适配不同屏幕尺寸
- 统一的错误处理和用户提示

- 修复金三角用户查询中的First()方法错误，使用ToListAsync() + FirstOrDefault()避免异常
- 添加空值检查，当健康师在金三角团队中不存在时提供友好错误信息
- 完善转卡记录字段，添加门店名称、门店编号、会员账号、顾客类型、退卡时间等字段
- 完善开单记录字段，添加开单日期、顾客类型、总业绩等字段
- 修复金三角用户查询条件，使用正确的用户账号字段(jkszh)而不是用户ID(jks)
- 提高转卡操作的健壮性和错误处理能力

- 新增转卡接口，支持会员品项转移
- 转卡操作同时处理退卡和开卡记录
- 支持健康师和科技部老师业绩数据处理
- 新增库存管理和库存使用记录功能
- 新增学习班级和学习记录管理功能
- 删除CommonStatus枚举，统一使用StatusEnum
- 完善转卡接口的XML文档和示例

- 新增 BillingRecordSummaryQueryInput 查询参数类
- 新增 LqKdKdjlbUpdateAmountInput 修改金额输入类
- 完善 GetBillingRecordSummaryByStoreId 方法，支持按来源类型分类品项明细
- 优化 LqXmzlService 字段去重查询功能
- 完善 LqPackageInfoService 营销活动品项详情查询
- 更新相关实体和DTO字段映射

- 新增GetFunnelStatistics接口：获取按门店分组的漏斗统计数据
- 新增GetOverallFunnelStatistics接口：获取总体漏斗统计数据
- 新增GetStoreCustomerDetails接口：获取门店顾客详情（不分页）
- 新增GetStoreCustomerDetailsPaged接口：获取门店顾客详情（分页）
- 修正SQL字段名：将yy.F_AppointmentTime改为yy.yysj
- 支持拓客数量、预约人数、耗卡人数、耗卡金额统计
- 支持预约转化率和耗卡转化率计算
- 支持按拓客时间倒序排列

- 在LqAttendanceSummaryService中新增DeleteByMonth方法，支持根据年份和月份清空考勤汇总数据
- 添加相应的API注释，明确参数和返回信息
- 优化代码结构，确保功能的清晰性和可维护性

- 删除LqKqhzbService及相关DTO、Mapper和接口，移除考勤汇总表的所有功能
- 在LqKdKdjlbService中添加补缴开单ID的处理逻辑，更新已缴欠款的计算
- 修改DTO字段命名为小写，以保持一致性
- 新增根据开单ID获取当前开单欠款信息的接口
- 优化异常处理，提供更详细的错误信息

- 在LqHytkHytkService中添加cancelRemark字段，支持作废备注
- 更新VoidRefundCardInfo方法，增加remarks参数以传递作废备注
- 在LqMdxxService中新增StoreCategory和StoreType字段，支持门店类别和类型
- 添加获取门店类别和类型的接口，返回相应的枚举数据
- 更新相关DTO和实体类，确保数据结构一致性
- 优化错误处理，提供更详细的异常信息

- 新增StoreTypeEnum门店类别枚举(200平门店、旗舰店)
- 新增耗卡反馈功能(lq_xh_feedback表及相关实体、DTO、Service)
- 优化开单记录和耗卡记录列表，增加品项明细返回
- 完善会员开单记录查询接口，支持分页和时间筛选
- 优化耗卡记录作废功能，增加备注参数
- 修复排序规则冲突问题
- 完善各种实体和DTO的字段定义

- 在LqKdKdjlbService中添加逻辑以批量查询开单记录的品项明细
- 为每个开单记录分配对应的品项明细，确保数据完整性
- 更新LqKdKdjlbListOutput DTO以包含品项明细列表
- 优化前端Vue组件以展示新增的品项明细信息

- 在批量删除和单条删除方法中添加对消耗记录和储扣记录的检查，防止删除已消耗或有储扣的开单记录
- 引入新的实体类以支持检查逻辑，确保数据一致性和完整性

- 删除LqXhmxb相关的所有后端代码（Service、Entity、DTO、Interface、Mapper）
- 删除LqXhmxb相关的前端Vue组件文件
- 删除LqKdQkbj（欠款补缴）相关代码
- 优化LqXhHyhkService.GetMemberCardUsageRecord方法，支持分页和性能优化
- 修复LqXhHyhkService.GetJksyjList方法，添加分页和时间过滤
- 更新LqKdKdjlbService.GetDebtRecordByStoreId方法，支持分页和已缴欠款逻辑
- 完善LqHytkHytkService.VoidRefundCardInfo方法，添加事务处理
- 修复LqKdKdjlbStringGenerator中健康师名称显示问题
- 更新多个Entity文件以匹配数据库结构
- 添加新的DTO类支持分页查询功能

- 更新修改开单记录的注释，去除冗余信息
- 清理代码中的多余空行，提升可读性

- 改进Cancel方法的异常处理，提供更详细的错误信息
- 添加CancelRefRemarks字段支持，允许传入作废备注
- 增加空值检查和UpdateTime更新
- 重构CheckBillingCanCancelAsync方法，提取公共逻辑
- 完善作废开单记录的业务逻辑和错误提示

- 将TotalDeduct的计算从x.Amount更改为x.ProjectNumber
- 更新LqTkjlbService中的Dah字段格式，增加毫秒部分以确保唯一性

- 修复LqZjlMdsmxszService.GetPageList接口的排序规则冲突
- 修复LqStatisticsService中工资统计相关的排序规则冲突
- 在涉及lq_kd_kdjlb表的JOIN操作中添加COLLATE子句
- 更新UpdateSalaryStatisticsFromOtherTables方法中的COLLATE子句
- 创建修复排序规则冲突的精简版SQL脚本

- 调整LqJdqdService.cs中的代码格式，确保一致性
- 修改LqKdDeductinfo相关DTO中的DeductType字段类型，从int?改为string
- 优化LqKdKdjlbStringGenerator.cs中的字符串拼接格式

- 新增lq_kd_qkbj表相关实体和DTO文件
- 完善LqKdDeductinfoEntity字段同步
- 优化LqKdKdjlbService中的状态管理
- 使用StatusEnum统一状态值管理
- 修复SqlSugar更新语法问题
- 完善开单创建和作废逻辑

主要更新：
1. 优化ImportHistoryMemberRights方法效率，使用批量插入替代逐条插入，每批1000条记录
2. 在LqKhxxService中添加ImportCustomersFromCleanup方法，从清理跨店的重复表导入客户信息
3. 完善开单记录功能，增加会员类型自动判断（散客/会员）和储扣信息处理
4. 修复历史会员权益数据导入中的价格计算逻辑
5. 完善事件管理相关功能
6. 优化拓客记录和业绩统计功能

性能提升：
- 批量导入效率提升10-50倍
- 减少数据库交互次数1000倍
- 优化内存使用和事务处理

- 修改.env.development文件，将VUE_APP_BASE_API的值更改为'http://localhost:2011'以适应本地开发环境
- 在LqKhxxService中新增ImportCustomersFromCleanup方法，支持从"清理跨店的重复"表导入客户信息，包含详细的导入规则和字段映射说明
- 优化客户导入逻辑，避免重复导入并处理错误信息

- 在LqKdKdjlbService中实现ImportHistoryMemberRights方法，支持将历史会员权益数据导入到开单记录表和开单品项明细表
- 添加详细的导入规则和字段映射说明
- 优化LqEventService，新增eventCoordinatorName字段以显示活动负责人姓名
- 更新LqKhxx相关DTO，移除不必要的字段，简化数据结构

- 修复MainHealthUser和SubHealthUser字段为空时导致的查询错误
- 添加空值检查，避免在字段为空时执行数据库查询
- 使用安全的方式查询用户姓名，处理用户不存在的情况
- 确保所有用户姓名字段都有默认值，避免null引用异常

- 重构为分步查询方式，避免子查询返回null导致的类型转换错误
- 使用SqlFunc.AggregateSum确保聚合函数返回0而不是null
- 在内存中使用FirstOrDefault和??操作符安全处理null值
- 确保ConsumedCount和RefundedCount始终为decimal类型
- 修复了会员剩余品项查询时的Index was outside the bounds of the array错误

- 修复LqKhxxService.cs中UserEntity类型未找到的错误
- 添加正确的using语句解决命名空间问题
- 优化开单记录表和拓客管理的导出功能
- 修复Excel导出中的数组越界错误
- 完善前端拓客管理页面的显示和交互
- 项目现在可以正常编译和运行

- 新增 TkjlbExportModel DTO 类，将导出模型从服务层分离到 DTO 层
- 修复拓客管理导出功能的下载地址500错误
- 优化拓客管理列表页面：
  * 将活动编号搜索改为下拉框选择
  * 调整列宽度，拓客编号列加宽，备注列移除宽度限制
  * 移除编辑、删除、批量删除按钮
  * 优化表格样式和用户体验
- 简化导出功能，固定导出字段，支持活动编号和截止时间筛选
- 修复开单记录表导出功能，添加中文名称显示
- 创建临时文件目录以支持文件导出功能