绿纤美业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 (门店基础信息)
  • longitude (DECIMAL): 经度
  • latitude (DECIMAL): 纬度
  • fence_polygons (JSON): 电子围栏多边形坐标，格式 [[{lng,lat},...]]
• 人员信息: 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_reimbursement_application
• 流程配置表: lq_reimbursement_workflow_config
• 关联字段: lq_reimbursement_application.F_WorkflowConfigId ↔ lq_reimbursement_workflow_config.F_Id（可选，用于返回流程名称 workflowName）

7. 业绩统计关系

• 业绩明细: 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: 开单详细记录视图

---