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方法中健康师业绩LaborCost的计算，确保正确计算最终值（原始值+加班值）
- 保持与科技部老师业绩计算逻辑一致

- 移除多余的条件判断，统一使用加班系数进行计算
- 简化代码逻辑，提高可读性
- 更新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字段
- 更新文档以反映退卡业务关系的变更

- 优化LqCardTransferLogService代码
- 清理LqGzService冗余代码
- 优化LqStatisticsService代码

- 新增门店剩余权益统计接口(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
- 更新接口注释和相关文档

- 开单统计增加F_ActivityId条件过滤
- 只统计该营销活动关联的开单数据
- 退卡统计保持原逻辑（退卡表可能没有活动字段）

- 移除品项过滤逻辑，不再通过活动品项筛选
- 开单统计直接查询lq_kd_kdjlb主表
- 退卡统计直接查询lq_hytk_hytk主表，金额使用tkje字段
- 统计该活动时间段内的所有开单和退卡数据

- 开单统计改为直接从lq_kd_kdjlb主表查询
- 使用EXISTS子查询判断是否包含活动品项
- 开单金额使用sfyj字段（实付业绩），欠款金额使用qk字段
- 提高查询效率，避免JOIN导致的重复统计

- 在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组件以展示新增的品项明细信息