antissoft / lvqianmeiye_ERP

  # 绿纤美业ERP系统 - 数据库说明
  

  ## 📋 目录
  - [数据库基本信息](#数据库基本信息)
  - [表关系图](#表关系图)
  - [核心业务表关系](#核心业务表关系)
  - [已弃用表变更记录](#已弃用表变更记录)
  - [重要业务规则](#重要业务规则)
  - [数据字典](#数据字典)
  - [开发注意事项](#开发注意事项)

  
  ---
  
  ## 数据库基本信息
  

  - **数据库类型**: MySQL
  - **数据库名称**: lqerp
  - **字符集**: utf8
  - **表总数**: 约100+张表
  - **命名规范**: 业务前缀 `lq_` + 功能名称

  
  ---
  

  ## 表关系图
  
  ### 核心业务流程图
  ```
  门店信息 (lq_mdxx)
      ↓
  用户信息 (BASE_USER) ← 人员资料 (lq_ryzl) [已弃用]
      ↓
  金三角设定 (lq_ycsd_jsj) ← 金三角用户绑定 (lq_jinsanjiao_user)
      ↓
  开单记录 (lq_kd_kdjlb) ← 预约记录 (lq_yyjl)
      ↓
  ├── 开单品项明细 (lq_kd_pxmx) ← 项目资料 (lq_xmzl)
  ├── 开单健康师业绩 (lq_kd_jksyj)
  ├── 开单科技部老师业绩 (lq_kd_kjbsyj)
  └── 业绩明细 (lq_yjmxb)
  
  耗卡业务
      ↓
  耗卡记录 (lq_xh_hyhk)
      ↓
  ├── 耗卡品项明细 (lq_xh_pxmx)
  ├── 耗卡健康师业绩 (lq_xh_jksyj)
  └── 耗卡科技部老师业绩 (lq_xh_kjbsyj)
  ```

  ---
  

  ## 核心业务表关系
  
  ### 1. 门店与人员关系
  - **门店信息表**: `lq_mdxx` (门店基础信息)
  - **人员信息**: `BASE_USER` (系统用户表，包含门店ID等扩展字段)
  - **关联字段**: `BASE_USER.F_MDID` ↔ `lq_mdxx.F_Id`
  
  ### 2. 金三角管理关系
  - **金三角设定**: `lq_ycsd_jsj` (金三角基础信息)
  - **金三角用户绑定**: `lq_jinsanjiao_user` (金三角与用户绑定关系)
  - **用户信息**: `BASE_USER` (系统用户表)
  - **关联字段**: 
    - `lq_ycsd_jsj.F_Id` ↔ `lq_jinsanjiao_user.jsj_id`
    - `lq_jinsanjiao_user.user_id` ↔ `BASE_USER.F_Id`
  
  ### 3. 开单业务关系
  - **开单记录**: `lq_kd_kdjlb` (核心业务表)
  - **开单品项明细**: `lq_kd_pxmx` (品项明细)
  - **开单健康师业绩**: `lq_kd_jksyj` (健康师业绩)
  - **开单科技部老师业绩**: `lq_kd_kjbsyj` (科技部老师业绩)
  - **项目资料**: `lq_xmzl` (项目基础信息)
  - **关联字段**:
    - `lq_kd_kdjlb.F_Id` ↔ `lq_kd_pxmx.glkdbh`
    - `lq_kd_kdjlb.F_Id` ↔ `lq_kd_jksyj.glkdbh`
    - `lq_kd_kdjlb.F_Id` ↔ `lq_kd_kjbsyj.glkdbh`
    - `lq_kd_pxmx.px` ↔ `lq_xmzl.F_Id`
    - `lq_kd_jksyj.F_kdpxid` ↔ `lq_kd_pxmx.F_Id`
    - `lq_kd_kjbsyj.F_kdpxid` ↔ `lq_kd_pxmx.F_Id`
  
  ### 4. 耗卡业务关系
  - **耗卡记录**: `lq_xh_hyhk` (耗卡记录表)
  - **耗卡品项明细**: `lq_xh_pxmx` (耗卡品项明细)
  - **耗卡健康师业绩**: `lq_xh_jksyj` (耗卡健康师业绩)
  - **耗卡科技部老师业绩**: `lq_xh_kjbsyj` (耗卡科技部老师业绩)
  - **关联字段**:
    - `lq_xh_hyhk.F_Id` ↔ `lq_xh_pxmx.glkdbh` (耗卡记录关联品项明细)
    - `lq_xh_hyhk.F_Id` ↔ `lq_xh_jksyj.glkdbh` (耗卡记录关联健康师业绩)
    - `lq_xh_hyhk.F_Id` ↔ `lq_xh_kjbsyj.glkdbh` (耗卡记录关联科技部老师业绩)
    - `lq_xh_jksyj.F_kdpxid` ↔ `lq_xh_pxmx.F_Id` (健康师业绩关联品项明细)
    - `lq_xh_kjbsyj.F_hkpxid` ↔ `lq_xh_pxmx.F_Id` (科技部老师业绩关联品项明细)
  

  ### 5. 退卡业务关系
  - **退卡记录**: `lq_hytk_hytk` (退卡记录表)
  - **退卡品项明细**: `lq_hytk_mx` (退卡品项明细)
  - **退卡健康师业绩**: `lq_hytk_jksyj` (退卡健康师业绩)
  - **退卡科技部老师业绩**: `lq_hytk_kjbsyj` (退卡科技部老师业绩)
  - **关联字段**:
    - `lq_hytk_hytk.F_Id` ↔ `lq_hytk_mx.F_RefundInfoId` (退卡记录关联品项明细)
    - `lq_hytk_hytk.F_Id` ↔ `lq_hytk_jksyj.gltkbh` (退卡记录关联健康师业绩)
    - `lq_hytk_hytk.F_Id` ↔ `lq_hytk_kjbsyj.gltkbh` (退卡记录关联科技部老师业绩)
    - `lq_hytk_mx.F_BillingItemId` ↔ `lq_kd_pxmx.F_Id` (退卡明细关联开单品项明细)
    - `lq_hytk_mx.F_MemberId` ↔ `lq_khxx.F_Id` (退卡明细关联会员，通过会员ID)
    - `lq_hytk_hytk.hy` ↔ `lq_khxx.F_Id` (退卡记录关联会员)
  
  ### 6. 业绩统计关系

  - **业绩明细**: `lq_yjmxb` (业绩统计表)
  - **关联字段**:
    - `lq_yjmxb.jks` ↔ `BASE_USER.F_REALNAME` (健康师姓名)
    - `lq_yjmxb.mdbh` ↔ `lq_mdxx.mdbm` (门店编号)
    - `lq_yjmxb.xmbh` ↔ `lq_xmzl.xmbh` (项目编号)

  ---
  

  ## 已弃用表变更记录
  
  ### ⚠️ 重要变更
  
  #### 1. 人员资料表弃用 (2024年)
  - **弃用表**: `lq_ryzl` (人员资料表)
  - **替代方案**: 使用系统用户表 `BASE_USER`
  - **迁移字段**:
    - `lq_ryzl.dm` → `BASE_USER.F_MDID` (门店ID)
    - `lq_ryzl.zw` → `BASE_USER.F_ZW` (职位)
    - `lq_ryzl.gwfl1` → `BASE_USER.F_GWFL` (岗位分类)
    - `lq_ryzl.xm` → `BASE_USER.F_REALNAME` (姓名)
    - `lq_ryzl.sjh` → `BASE_USER.F_MobilePhone` (手机号)
  - **业务影响**: 所有人员相关查询必须使用 `BASE_USER` 表
  
  #### 2. 门店归属表弃用 (2024年)
  - **弃用表**: `lq_mdxx_mdgs` (门店归属表)
  - **替代方案**: 归属信息整合到 `lq_mdxx` 表
  - **迁移字段**:
    - `syb` (事业部)
    - `jyb` (教育部)
    - `kjb` (科技部)
    - `dxmb` (大项目部)
    - `gsqssj` (归属起始时间)
    - `gszzsj` (归属终止时间)
    - `status` (状态)
  - **业务影响**: 门店归属信息现在直接在 `lq_mdxx` 表中管理
  
  #### 3. 门店目标设定表弃用 (2024年)
  - **弃用表**: `lq_ycsd_mdmbsd` (门店目标设定表)
  - **替代方案**: 目标信息整合到 `lq_mdxx` 表
  - **迁移字段**:
    - `xsyj` (目标-门店生命线)
    - `xhyj` (目标-消耗业绩)
    - `xms` (目标-项目数)
    - `rt1` (目标-人头1)
    - `rt2` (目标-人头2)
    - `rc` (目标-人次)
  
  ---
  
  ## 重要业务规则
  
  ### 1. 删除标记规则
  - **base_organize 表**: `DeleteMark` 为 `null` 表示未删除，为 `0` 或其他值表示已删除
  - **其他表**: 通常使用 `deletemark` 字段，`0` 表示未删除，`1` 表示已删除
  
  ### 2. ID生成规则
  - **主键字段**: 统一使用 `F_Id` (varchar类型)
  
  ### 3. 金额字段规则
  - **存储类型**: 所有金额字段使用 `varchar` 类型存储
  - **计算注意**: 查询时需要转换为 `decimal` 类型进行计算
  - **精度要求**: 金额计算保留2位小数
  
  ### 4. 时间字段规则
  - **存储类型**: 统一使用 `datetime` 类型
  - **时区处理**: 注意时区转换问题
  - **查询格式**: 使用 `yyyy-MM-dd HH:mm:ss` 格式

  
  ---
  
  ## 数据字典
  
  ### 门店状态 (lq_mdxx.zxzt)
  - 待补充具体枚举值
  

  ### 岗位分类 (BASE_USER.F_GWFL, F_GW)

  - 待补充具体枚举值
  

  ### 项目分类 (lq_xmzl.fl1, fl2, fl3, fl4)

  - 待补充具体枚举值
  

  ### 金三角状态 (lq_jinsanjiao_user.status)
  - `ACTIVE`: 活跃
  - `INACTIVE`: 非活跃
  
  ### 预约状态 (lq_yyjl.F_Status)

  - 待补充具体枚举值
  
  ---
  

  ## 开发注意事项

  ### 1. 查询优化
  - 所有列表查询必须支持分页
  - 关键字段建立索引
  - 避免 N+1 查询，使用 JOIN 优化

  ### 2. 数据一致性
  - 统计接口与列表接口使用相同的过滤条件
  - 所有数据查询必须添加园区权限过滤
  - DTO字段名称、大小写必须完全一致

  ### 3. 业务逻辑
  - 开单记录表是核心业务表，所有业务操作都围绕开单进行
  - 人员信息已迁移到系统用户表，查询时使用 `BASE_USER`
  - 门店归属信息现在直接在 `lq_mdxx` 表中管理

  ### 4. 字段映射
  - 数据库字段使用拼音首字母命名
  - 实体类字段使用驼峰命名
  - 查询时注意字段名映射关系

  ### 5. 权限控制
  - 所有数据查询必须添加园区权限过滤
  - 使用 `base_organize.DeleteMark` 过滤已删除数据
  - 接口必须校验 JWT Token

  
  ---
  

  ## 视图说明
  
  ### 业绩统计视图
  - `v_jsj_monthly_performance`: 金三角月度业绩统计
  - `v_jsj_monthly_summary`: 金三角月度业绩汇总
  - `v_personal_monthly_performance`: 个人业绩月度统计
  
  ### 开单相关视图
  - `v_order_detail_simple`: 开单详细记录视图
  
  ---