antissoft / lvqianmeiye_ERP

- 创建门店目标表(lq_md_target)及完整的CRUD功能
  - 实体类、DTO、Service、IService
  - 支持批量创建、同步上月数据等功能

- 创建标准化总经理门店生命线设置表(lq_md_general_manager_lifeline)
  - 实体类、DTO、Service、IService
  - 支持从门店目标表批量创建生命线设置
  - 支持复制上月设置功能

- 更新相关实体和DTO
  - 健康师业绩表添加陪同相关字段
  - 项目资料表添加手工费字段和允许陪同字段

- 添加SQL脚本

- 项目资料表(lq_xmzl)添加四个手工费字段：
  * F_MedicalBeautyLaborCost - 医美手工费
  * F_TechBeautyLaborCost - 科美手工费
  * F_LifeBeautyLaborCost - 生美手工费
  * F_HealthCoachLaborCost - 健康师手工费
  * F_IsAllowAccompanied - 是否允许陪同

- 耗卡健康师业绩表(lq_xh_jksyj)添加陪同字段：
  * F_AccompaniedProjectNumber - 陪同项目数
  * F_IsAccompanied - 是否陪同

- 耗卡品项明细表(lq_xh_pxmx)添加字段：
  * F_IsNeedAccompanied - 是否需要陪同

- 更新相关实体类和DTO，支持新字段

- 添加AddUserToJsj接口，支持将用户添加到金三角
- 实现完整的业务规则验证：
  * 参数验证（金三角ID、用户ID、用户姓名）
  * 金三角和用户存在性验证
  * 防止用户在同一个月份加入多个金三角
  * 防止重复添加用户到同一金三角
  * 多人战队必须有顾问的规则验证
- 自动计算排序号（如果未指定）
- 支持恢复已删除或非活跃的绑定关系
- 使用事务确保数据一致性
- 整理代码库：将SQL文件移动到sql目录，清理无用文件

- 移除多余的条件判断，统一使用加班系数进行计算
- 简化代码逻辑，提高可读性
- 更新Create和Update方法中的加班计算逻辑

- 为lq_hytk_mx表添加会员ID字段(F_MemberId)
- 为消耗功能添加加班相关字段：
  - lq_xh_hyhk: 加班系数、原始手工费、加班手工费
  - lq_xh_pxmx: 原始项目次数、加班项目次数
  - lq_xh_jksyj: 原始耗卡品项次数、加班耗卡品项次数、原始手工费、加班手工费
  - lq_xh_kjbsyj: 原始耗卡品相次数、加班耗卡品相次数、原始手工费、加班手工费
- 更新相关实体类和DTO类
- 将lq_xh_pxmx和lq_hytk_mx表的项目次数字段改为DECIMAL类型
- 添加消耗功能加班需求分析文档和SQL脚本

- 新增退卡记录、退卡品项明细、退卡健康师业绩和退卡科技部老师业绩的数据库表和字段
- 更新LqHytkHytkService和LqKdKdjlbService以支持退卡业务逻辑
- 在LqHytkMxEntity中添加会员ID字段
- 更新文档以反映退卡业务关系的变更

- 新增门店剩余权益统计接口(GetStoreRemainingRights)
- 新增客户到店次数统计接口(GetCustomerVisitFrequency)
- 新增健康师排行榜接口(GetHealthCoachBillingRanking等)
- 新增门店项目指标统计接口(GetStoreItemStatistics)
- 优化GetStoreRemainingRights查询性能（分批查询、并行执行）
- 修复GetItemStatistics门店筛选问题
- 修复GetTechTeacherDailyStatistics教师姓名查询
- 修改DeleteJsjUserRelation支持按ID删除并更新状态
- 新增拓客统计接口(GetTkStatistics)
- 新增开单项目数、消耗项目数统计
- 新增数据库索引优化SQL和视图创建SQL

- 新增ActualConsumePerformance字段到StorePerformanceComparisonOutput
- SQL查询关联lq_xh_hyhk表统计消耗业绩
- 统计指定时间范围内的消耗总金额
- 更新API注释，添加ActualConsumePerformance字段说明

- GetBillingProjectCount改为统计开单项目次数总和
- GetConsumeProjectCount改为统计消耗项目次数总和
- 使用F_ProjectNumber字段求和而非项目编号去重
- 更新注释说明项目数为项目次数总和

- 新增BillingProjectCount和ConsumeProjectCount字段到EmployeePerformanceStatisticsOutput
- 新增GetBillingProjectCount方法统计开单项目数
- 新增GetConsumeProjectCount方法统计消耗项目数
- 通过项目编号(px)去重统计项目数
- 更新API注释，添加新字段说明

- 新增GetTkStatistics方法，统计拓客相关数据
- 统计指标：拓客人数、邀约人头、预约人头、到店人头、开单人头、开单金额、消费人头、消费金额
- 支持开始时间、结束时间、活动ID过滤（均为可选）
- 采用分步统计提高性能
- 创建TkStatisticsInput和TkStatisticsOutput DTO
- 更新ILqTkjlbService接口

- 将Total字段改回BillingCount保持命名一致性
- 更新相关注释和输出

- 移除所有退卡相关统计和输出字段
- 输出改为分页列表，包含开单详情
- 新增Total、BillingList字段，返回开单列表
- 开单列表包含：开单ID、日期、客户信息、门店信息、金额、欠款
- 支持分页参数：pageIndex、pageSize
- 更新接口注释和相关文档

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

- 在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改为字符串拼接方式，确保参数正确传递
- 分步统计设计，便于维护和优化

- 优化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地址配置，切换为localhost
- 在多个DTO类中新增isEffective字段，表示是否有效
- 更新LqKdKdjlbListQueryInput和TransferCardInput类，调整字段类型以支持decimal数据类型
- 优化代码格式，移除多余空行

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

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

- 在LqYyjlCrInput类中移除多余空行，优化代码格式
- 在LqTkjlbEntity类中新增MemberId字段，表示会员ID，增强数据模型

- 删除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方法，提取公共逻辑
- 完善作废开单记录的业务逻辑和错误提示

- 调整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倍
- 优化内存使用和事务处理

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

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