antissoft / lvqianmeiye_ERP

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

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

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

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

- 将开单明细、耗卡明细、储扣列表三个接口的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字段同步更新逻辑
   - 更新相关文档说明

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

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

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

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

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

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

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

- 在LqInventoryUsageApplicationListOutput中添加approverIds字段，返回当前节点的审批人ID列表
- 修改BatchCreate接口，创建申请记录时同时创建审批记录
- 修改GetApplicationList接口，正确填充approverIds和currentApprovers字段
- 添加测试接口AddApprovalRecordForTest，用于为现有申请记录添加审批记录
- 添加科技部老师统计接口的DTO类

- 新增大项目部老师工资计算功能（LqMajorProjectTeacherSalaryService）
- 新增事业部总经理/经理工资计算功能（LqBusinessUnitManagerSalaryService）
- 修复健康师额外数据导入功能，支持列数不足的情况
- 新增OSS URL迁移功能，支持将旧OSS地址替换为新OSS地址
- 优化库存使用申请列表查询，添加审批状态和是否已领取字段
- 优化文件上传服务，统一返回OSS路径

- 添加阿里云OSS配置（AccessKeyId、AccessKeySecret、Endpoint、Region、CustomDomain）
- 修改FileService.cs，支持annexpic类型文件上传到阿里云OSS
- 上传成功后返回OSS完整访问地址（支持自定义域名）
- 完善库存使用相关功能（价格计算、总价保存）
- 修复购买记录筛选功能
- 添加相关SQL脚本

- Updated VUE_APP_BASE_API in the development environment to point to localhost for local testing.
- Added a new endpoint to export approved reimbursement details for the current month, including associated purchase records.
- Enhanced SQL queries for better performance and clarity in the reimbursement statistics service.
- Improved documentation and comments for better understanding of the code logic.

- 新增合同表(lq_contract)和月租明细表(lq_contract_rent_detail)
- 实现合同CRUD功能（创建、更新、删除、查询）
- 实现自动生成月租明细功能
- 实现计算下次应交时间功能（匿名方法）
- 实现标记明细已缴费功能
- 实现统计门店合同费用功能（支持按分类统计）
- 新增合同管理相关DTO类
- 新增合同管理服务类(LqContractService)
- 更新前端调用说明文档

- 添加采购入库相关字段（入库类型、采购单号、采购单价、采购总金额、产品最终金额）
- 实现采购单号自动生成逻辑，当单据规则不存在时使用时间戳fallback
- 完善采购入库的创建和更新逻辑，支持采购金额计算和验证
- 更新查询接口，返回所有采购金额相关字段

- 修复SQL JOIN错误：使用JoinQueryInfos和SqlFunc.ToString确保类型匹配
- 修复类型转换错误：将返回类型改为Task<dynamic>以匹配SqlSugarPageResult的返回类型
- 接口/api/Extend/lqsalaryextracalculation/list现在可以正常返回分页数据

- 更新健康师工资输出DTO字段
- 优化工资计算服务逻辑
- 完善工资额外计算服务功能

- 创建健康师工资额外计算表(lq_salary_extra_calculation)，包含基础奖励业绩、合作奖励业绩、新客业绩、新客成交率、升单业绩、升单成交率、升单人头数、其他业绩加、其他业绩减等字段
- 在健康师工资表中添加：基础奖励业绩、合作奖励业绩、升单人头数、新客业绩提成金额、升单业绩提成金额、其他业绩加、其他业绩减、实际基础业绩、实际合作业绩
- 创建健康师工资额外计算服务，包含列表查询和Excel导入功能
- 添加为新店健康师生成模拟数据的方法
- 添加相关SQL脚本用于创建表和添加字段

- 在开单品项表、健康师业绩表、科技老师业绩表、消耗品项表、业绩表等10个表中添加F_PerformanceType字段
- 修复转卡时健康师和科技部老师业绩计算逻辑，按原业绩比例计算而非直接复制
- 修复退卡明细表F_SourceType字段赋值错误（使用品项分类而非开单类型）
- 添加SQL脚本用于添加业绩类型字段和更新历史数据
- 业绩类型根据品项表(lq_xmzl)的fl3字段设置