12/15

src/main/java/com/yeqifu/bus/mapper/GoodsMapper.java

@@ -1,60 +1,60 @@
-package com.yeqifu.bus.mapper;
+package com.yeqifu.bus.mapper; // 包名
 
-import com.baomidou.mybatisplus.core.mapper.BaseMapper;
-import com.yeqifu.bus.entity.Goods;
-import org.apache.ibatis.annotations.Param;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper; // MyBatis-Plus核心Mapper类
+import com.yeqifu.bus.entity.Goods; // 商品实体类
+import org.apache.ibatis.annotations.Param; // MyBatis参数注解
 
-import java.util.List;
+import java.util.List; // Java集合类
 
 /**
  * <p>
- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`) Mapper 接口
+ * 商品Mapper接口，用于定义与商品相关的数据库操作
+ * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`)
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-06
  */
-public interface GoodsMapper extends BaseMapper<Goods> {
+public interface GoodsMapper extends BaseMapper<Goods> { // 继承MyBatis-Plus的BaseMapper类
 
     /**
-     * 根据商品id删除商品销售信息
-     * @param id1
+     * 根据商品ID删除商品销售信息
+     * @param id1 商品ID
      */
-    void deleteSaleByGoodsId(@Param("goodsid") Integer id1);
+    void deleteSaleByGoodsId(@Param("goodsid") Integer id1); // 自定义SQL方法，传入商品ID删除相关销售信息
 
     /**
-     * 根据商品id删除商品销售退货信息
-     * @param id1
+     * 根据商品ID删除商品销售退货信息
+     * @param id1 商品ID
      */
-    void deleteSaleBackByGoodsId(@Param("goodsid") Integer id1);
+    void deleteSaleBackByGoodsId(@Param("goodsid") Integer id1); // 自定义SQL方法，传入商品ID删除相关销售退货信息
 
     /**
-     * 根据商品id删除商品进货信息
-     * @param id
+     * 根据商品ID删除商品进货信息
+     * @param id 商品ID
      */
-    void deleteInportByGoodsId(@Param("goodsid") Integer id);
-
+    void deleteInportByGoodsId(@Param("goodsid") Integer id); // 自定义SQL方法，传入商品ID删除相关进货信息
 
     /**
-     * 根据商品id删除商品退货信息
-     * @param id
+     * 根据商品ID删除商品退货信息
+     * @param id 商品ID
      */
-    void deleteOutportByGoodsId(@Param("goodsid") Integer id);
+    void deleteOutportByGoodsId(@Param("goodsid") Integer id); // 自定义SQL方法，传入商品ID删除相关退货信息
 
     /**
-     * 根据客户id删除商品销售
-     * @param id    客户id
+     * 根据客户ID删除商品销售记录
+     * @param id 客户ID
      */
-    void deleteSaleByCustomerId(Integer id);
+    void deleteSaleByCustomerId(Integer id); // 自定义SQL方法，传入客户ID删除相关销售信息
 
     /**
-     * 根据客户id删除商品销售退货信息
-     * @param id    客户id
+     * 根据客户ID删除商品销售退货记录
+     * @param id 客户ID
      */
-    void deleteSaleBackByCustomerId(Integer id);
+    void deleteSaleBackByCustomerId(Integer id); // 自定义SQL方法，传入客户ID删除相关销售退货信息
 
     /**
      * 加载所有库存预警商品
+     * @return 商品列表，包含所有库存预警的商品信息
      */
-    List<Goods> loadAllWarning();
+    List<Goods> loadAllWarning(); // 自定义SQL方法，返回库存预警商品列表
 }

src/main/java/com/yeqifu/bus/mapper/InportMapper.java

@@ -1,16 +1,17 @@
-package com.yeqifu.bus.mapper;
+package com.yeqifu.bus.mapper; // 包名
 
-import com.yeqifu.bus.entity.Inport;
-import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.yeqifu.bus.entity.Inport; // 导入进货实体类
+import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入MyBatis-Plus核心BaseMapper接口
 
 /**
  * <p>
- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`); (`goo Mapper 接口
+ * 进货Mapper接口，提供对进货数据的数据库操作
+ * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`)
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-18
+ * @author luoyi-
  */
-public interface InportMapper extends BaseMapper<Inport> {
+public interface InportMapper extends BaseMapper<Inport> { // Mapper接口继承BaseMapper，自动实现通用数据操作
 
 }

src/main/java/com/yeqifu/bus/mapper/OutportMapper.java

@@ -1,16 +1,17 @@
-package com.yeqifu.bus.mapper;
+package com.yeqifu.bus.mapper; // 包名
 
-import com.yeqifu.bus.entity.Outport;
-import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.yeqifu.bus.entity.Outport; // 导入出货实体类
+import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入MyBatis-Plus核心BaseMapper接口
 
 /**
  * <p>
- * InnoDB free: 9216 kB Mapper 接口
+ * 出货Mapper接口，提供对出货数据的数据库操作
+ * InnoDB free: 9216 kB
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-19
+ * @author luoyi-
  */
-public interface OutportMapper extends BaseMapper<Outport> {
+public interface OutportMapper extends BaseMapper<Outport> { // Mapper接口继承BaseMapper，自动实现通用数据操作
 
 }

src/main/java/com/yeqifu/bus/mapper/ProviderMapper.java

@@ -1,36 +1,36 @@
-package com.yeqifu.bus.mapper;
+package com.yeqifu.bus.mapper; // 包名
 
-import com.yeqifu.bus.entity.Provider;
-import com.baomidou.mybatisplus.core.mapper.BaseMapper;
-import org.apache.ibatis.annotations.Param;
+import com.yeqifu.bus.entity.Provider; // 导入供应商实体类
+import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入MyBatis-Plus核心BaseMapper接口
+import org.apache.ibatis.annotations.Param; // 导入MyBatis的参数注解
 
 /**
  * <p>
- * InnoDB free: 9216 kB Mapper 接口
+ * 供应商Mapper接口，提供对供应商相关数据的数据库操作
+ * InnoDB free: 9216 kB
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-05
+ * @author luoyi-
  */
-public interface ProviderMapper extends BaseMapper<Provider> {
+public interface ProviderMapper extends BaseMapper<Provider> { // Mapper接口继承BaseMapper，自动实现通用数据操作
 
     /**
-     * 根据供应商id删除商品信息
-     * @param id
+     * 根据供应商ID删除商品信息
+     * @param id 供应商ID
      */
-    void deleteGoodsByProviderId(@Param("pid") Integer id);
+    void deleteGoodsByProviderId(@Param("pid") Integer id); // 自定义SQL方法，传入供应商ID删除相关商品信息
 
     /**
-     * 根据供应商id删除商品进货信息
-     * @param id
+     * 根据供应商ID删除商品进货信息
+     * @param id 供应商ID
      */
-    void deleteInportByProviderId(@Param("pid") Integer id);
+    void deleteInportByProviderId(@Param("pid") Integer id); // 自定义SQL方法，传入供应商ID删除相关进货信息
 
     /**
-     * 根据供应商id删除商品退货信息
-     * @param id
+     * 根据供应商ID删除商品退货信息
+     * @param id 供应商ID
      */
-    void deleteOutPortByProviderId(@Param("pid") Integer id);
-
+    void deleteOutPortByProviderId(@Param("pid") Integer id); // 自定义SQL方法，传入供应商ID删除相关退货信息
 
 }

src/main/java/com/yeqifu/bus/mapper/SalesMapper.java

@@ -1,16 +1,17 @@
-package com.yeqifu.bus.mapper;
+package com.yeqifu.bus.mapper; // 包名
 
-import com.yeqifu.bus.entity.Sales;
-import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.yeqifu.bus.entity.Sales; // 导入销售实体类
+import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入MyBatis-Plus核心BaseMapper接口
 
 /**
  * <p>
- * InnoDB free: 9216 kB Mapper 接口
+ * 销售Mapper接口，提供对销售数据的数据库操作
+ * InnoDB free: 9216 kB
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-21
+ * @author luoyi-
  */
-public interface SalesMapper extends BaseMapper<Sales> {
+public interface SalesMapper extends BaseMapper<Sales> { // Mapper接口继承BaseMapper，自动实现通用数据操作
 
 }

src/main/java/com/yeqifu/bus/mapper/SalesbackMapper.java

@@ -1,16 +1,17 @@
-package com.yeqifu.bus.mapper;
+package com.yeqifu.bus.mapper; // 包名
 
-import com.yeqifu.bus.entity.Salesback;
-import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.yeqifu.bus.entity.Salesback; // 导入销售退货实体类
+import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入MyBatis-Plus核心BaseMapper接口
 
 /**
  * <p>
- * InnoDB free: 9216 kB Mapper 接口
+ * 销售退货Mapper接口，提供对销售退货数据的数据库操作
+ * InnoDB free: 9216 kB
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-23
+ * @author luoyi-
  */
-public interface SalesbackMapper extends BaseMapper<Salesback> {
+public interface SalesbackMapper extends BaseMapper<Salesback> { // Mapper接口继承BaseMapper，自动实现通用数据操作
 
 }

src/main/java/com/yeqifu/bus/service/IGoodsService.java

@@ -1,29 +1,29 @@
-package com.yeqifu.bus.service;
+package com.yeqifu.bus.service; // 包名
 
-import com.baomidou.mybatisplus.extension.service.IService;
-import com.yeqifu.bus.entity.Goods;
-
-import java.util.List;
+import com.baomidou.mybatisplus.extension.service.IService; // 导入MyBatis-Plus服务层通用接口
+import com.yeqifu.bus.entity.Goods; // 导入商品实体类
+import java.util.List; // 导入Java集合List
 
 /**
  * <p>
- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`) 服务类
+ * 商品服务接口，定义商品相关业务操作
+ * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`)
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-06
+ * @author luoyi-
  */
-public interface IGoodsService extends IService<Goods> {
+public interface IGoodsService extends IService<Goods> { // IService 是 MyBatis-Plus 提供的通用服务层接口
 
     /**
-     * 根据商品id删除商品
-     * @param id
+     * 根据商品ID删除商品信息
+     * @param id 商品ID
      */
-    void deleteGoodsById(Integer id);
+    void deleteGoodsById(Integer id); // 自定义方法，用于根据商品ID删除商品信息
 
     /**
-     * 加载所有的库存预警商品
-     * @return
+     * 加载所有的库存预警商品列表
+     * @return 返回所有需要预警的商品信息列表
      */
-    List<Goods> loadAllWarning();
+    List<Goods> loadAllWarning(); // 自定义方法，用于获取所有库存预警商品列表
 }

src/main/java/com/yeqifu/bus/service/IInportService.java

@@ -1,16 +1,17 @@
-package com.yeqifu.bus.service;
+package com.yeqifu.bus.service; // 包名
 
-import com.yeqifu.bus.entity.Inport;
-import com.baomidou.mybatisplus.extension.service.IService;
+import com.yeqifu.bus.entity.Inport; // 导入进货实体类
+import com.baomidou.mybatisplus.extension.service.IService; // 导入MyBatis-Plus提供的通用服务接口
 
 /**
  * <p>
- * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`); (`goo 服务类
+ * 进货服务接口，提供对进货数据的业务操作
+ * InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`)
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-18
+ * @author luoyi-
  */
-public interface IInportService extends IService<Inport> {
+public interface IInportService extends IService<Inport> { // IService 是 MyBatis-Plus 提供的通用服务接口
 
 }

src/main/java/com/yeqifu/bus/service/IOutportService.java

@@ -1,23 +1,25 @@
-package com.yeqifu.bus.service;
+package com.yeqifu.bus.service; // 包名
 
-import com.yeqifu.bus.entity.Outport;
-import com.baomidou.mybatisplus.extension.service.IService;
+import com.yeqifu.bus.entity.Outport; // 导入退货实体类
+import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 提供的通用服务接口
 
 /**
  * <p>
- * InnoDB free: 9216 kB 服务类
+ * 出库退货服务接口，提供对退货相关数据的业务操作
+ * InnoDB free: 9216 kB
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-19
+ * @author luoyi-
  */
-public interface IOutportService extends IService<Outport> {
+public interface IOutportService extends IService<Outport> { // IService 是 MyBatis-Plus 提供的通用服务接口
 
     /**
      * 对商品进货进行退货处理
-     * @param id    进货单ID
-     * @param number    退货数量
-     * @param remark    备注
+     *
+     * @param id    进货单ID，用于标识进货数据
+     * @param number    退货数量，需要退回的商品数量
+     * @param remark    备注信息，用于记录退货原因或其他说明信息
      */
-    void addOutport(Integer id, Integer number, String remark);
+    void addOutport(Integer id, Integer number, String remark); // 自定义方法，处理退货操作
 }

src/main/java/com/yeqifu/bus/service/IProviderService.java

@@ -1,21 +1,23 @@
-package com.yeqifu.bus.service;
+package com.yeqifu.bus.service; // 包名
 
-import com.yeqifu.bus.entity.Provider;
-import com.baomidou.mybatisplus.extension.service.IService;
+import com.yeqifu.bus.entity.Provider; // 导入供应商实体类
+import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 提供的通用服务接口
 
 /**
  * <p>
- * InnoDB free: 9216 kB 服务类
+ * 供应商服务接口，定义与供应商相关的业务操作
+ * InnoDB free: 9216 kB
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-05
+ * @author luoyi-
  */
-public interface IProviderService extends IService<Provider> {
+public interface IProviderService extends IService<Provider> { // IService 是 MyBatis-Plus 提供的通用服务接口
 
     /**
-     * 根据供应商ID删除供应商
-     * @param id
+     * 根据供应商ID删除供应商信息
+     *
+     * @param id 供应商ID，用于唯一标识需要删除的供应商
      */
-    void deleteProviderById(Integer id);
+    void deleteProviderById(Integer id); // 自定义方法，处理删除操作
 }

src/main/java/com/yeqifu/bus/service/ISalesService.java

@@ -1,16 +1,18 @@
-package com.yeqifu.bus.service;
+package com.yeqifu.bus.service; // 包名，定义服务层的包路径
 
-import com.yeqifu.bus.entity.Sales;
-import com.baomidou.mybatisplus.extension.service.IService;
+import com.yeqifu.bus.entity.Sales; // 导入销售实体类
+import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 提供的通用服务接口
 
 /**
  * <p>
- * InnoDB free: 9216 kB 服务类
+ * 销售服务接口，定义与销售相关的业务操作
+ * InnoDB free: 9216 kB
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-21
+ * @author luoyi-
  */
-public interface ISalesService extends IService<Sales> {
+public interface ISalesService extends IService<Sales> { // IService 是 MyBatis-Plus 提供的通用服务接口
 
+    // 由于未定义自定义方法，这里继承 IService<Sales> 后可自动具备基本的 CRUD 功能
 }

src/main/java/com/yeqifu/bus/service/ISalesbackService.java

@@ -1,24 +1,25 @@
-package com.yeqifu.bus.service;
+package com.yeqifu.bus.service; // 包名
 
-import com.yeqifu.bus.entity.Salesback;
-import com.baomidou.mybatisplus.extension.service.IService;
+import com.yeqifu.bus.entity.Salesback; // 导入销售退货实体类
+import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 提供的通用服务接口
 
 /**
  * <p>
- * InnoDB free: 9216 kB 服务类
+ * 销售退货服务接口，提供对销售退货相关数据的业务操作
+ * InnoDB free: 9216 kB
  * </p>
  *
- * @author luoyi-
  * @since 2019-12-23
+ * @author luoyi-
  */
-public interface ISalesbackService extends IService<Salesback> {
+public interface ISalesbackService extends IService<Salesback> { // IService 是 MyBatis-Plus 提供的通用服务接口
 
     /**
      * 对商品销售进行退货处理
-     * @param id    销售单ID
-     * @param number    退货数量
-     * @param remark    备注
+     *
+     * @param id    销售单ID，标识需要退货的销售记录
+     * @param number    退货数量，表示退回的商品数量
+     * @param remark    备注信息，用于记录退货原因或其他补充信息
      */
-    void addSalesback(Integer id, Integer number, String remark);
-
+    void addSalesback(Integer id, Integer number, String remark); // 自定义退货处理方法
 }