阿里巴巴代码规约问题修改-5 20230115

src/main/java/com/jkcredit/invoice/credit/interserver/CustomerInterLowerService.java

@@ -5,38 +5,37 @@ import com.jkcredit.invoice.common.DataResult;
 public interface CustomerInterLowerService {
 
     /**
-     * @Description 自有车、无车 客户企业备案接口；
-     * @Author mashengyi
-     * @Date 2022/2/8 18:00
-     * @Param
-     * @Return
-     * @Exception
+     *  自有车、无车 客户企业备案接口；
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
      */
     DataResult customeInterRec(String appKey, String api, String data, String requestid);
 
     /**
-     * @Description //自有车、无车 客户企业查询接口；
-     * @Author mashengyi
-     * @Date 2022/2/8 18:00
-     * @Param
-     * @Return
-     * @Exception
+     * 自有车、无车 客户企业查询接口；
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
      */
     DataResult customeInterRecQuery(String appKey, String api, String data, String requestid);
 
     /**
-     * @Description //无车 自有车协议上传
-     * @Author mashengyi
-     * @Date 2022/2/8 18:00
-     * @Param
-     * @Return
-     * @Exception
+     * 无车 自有车协议上传
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
      */
     DataResult customeProtocolUpLoad(String appKey, String api, String data, String requestid);
 
     /**
      * 自有车 无车、协议上传状态查询
-     *
      * @param appKey
      * @param api
      * @param data

src/main/java/com/jkcredit/invoice/credit/interserver/NoCarInterService.java

@@ -4,36 +4,113 @@ import com.jkcredit.invoice.common.DataResult;
 
 public interface NoCarInterService {
 
-    //无车 车辆备案接口
+    /**
+     * 无车 车辆备案接口
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult customerCarRec(String appKey, String api, String data, String requestid);
 
-    //无车 车辆备案查询接口
+    /**
+     * 无车 车辆备案查询接口
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult customeRecUpperQuery(String appKey, String api, String data, String requestid);
 
-    //无车 实时运单开始指令
+    /**
+     * 无车 实时运单开始指令
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult noCarBillStart(String appKey, String api, String data, String requestid);
 
-    //无车 实时运单结束指令
+    /**
+     * 无车 实时运单结束指令
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult noCarBillEnd(String appKey, String api, String data, String requestid);
 
-    //无车 历史运单开始指令
+    /**
+     * 无车 历史运单开始指令
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult noCarHisWaybillStart(String appKey, String api, String data, String requestid);
 
-    //无车 历史运单结束指令
+    /**
+     * 无车 历史运单结束指令
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult noCarHisWaybillEnd(String appKey, String api, String data, String requestid);
 
-    //无车  运单号查询发票数据
+    /**
+     * 无车  运单号查询发票数据
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult noCarVoiceQuery(String appKey, String api, String data, String requestid);
 
-    //无车  获取未查询过发票的运单编号
+    /**
+     * 无车  获取未查询过发票的运单编号
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult noCarNoVoiceQuery(String appKey, String api, String data, String requestid);
 
-    //无车 账户余额查询接口
+    /**
+     * 无车 账户余额查询接口
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult balanceQuery(String appKey, String api, String data, String requestid);
 
-    //无车红冲发票查询接口
+    /**
+     * 无车红冲发票查询接口
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult redInkInvoiceQuery(String appKey, String api, String data, String requestid);
 
-    //无车  运单号查询发票数据 自己使用不对外
+    /**
+     * 无车  运单号查询发票数据 自己使用不对外
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult noCarVoiceOwnerQuery(String appKey, String api, String data, String requestid);
 }

src/main/java/com/jkcredit/invoice/credit/interserver/SelfCarInterService.java

@@ -4,42 +4,133 @@ import com.jkcredit.invoice.common.DataResult;
 
 public interface SelfCarInterService {
 
-    //自有车 用户卡列表查询接口；
+    /**
+     * 自有车 用户卡列表查询接口；
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult customeretcquery(String appKey, String api, String data, String requestid);
 
-    //自有车 卡信息查询接口
+    /**
+     * 自有车 卡信息查询接口
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult customerQueryEtcInfo(String appKey, String api, String data, String requestid);
 
-    //自有车下发短信通知接口
+    /**
+     * 自有车下发短信通知接口
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult customeretcrec(String appKey, String api, String data, String requestid);
 
-    //自有车 卡绑定接口 渠道调用此接口，上传用户收到的短信验证码
+    /**
+     * 自有车 卡绑定接口 渠道调用此接口，上传用户收到的短信验证码
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult customeretcrecvalid(String appKey, String api, String data, String requestid);
 
-    //自有车 交易查询接口 渠道通过此接口可以查询单张卡连续90天内的交易（待开票、开票中、已开票）
+    /**
+     * 自有车 交易查询接口 渠道通过此接口可以查询单张卡连续90天内的交易（待开票、开票中、已开票）
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult getTradeList(String appKey, String api, String data, String requestid);
 
-    //自有车 申请开票接口 渠道通过此接口可以对该公司绑定的单张卡连续90天内的交易进行开票。
+    /**
+     * 自有车 申请开票接口 渠道通过此接口可以对该公司绑定的单张卡连续90天内的交易进行开票。
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult applInvoice(String appKey, String api, String data, String requestid);
 
-    //自有车 已开发票查询接口 渠道通过此接口可以根据该公司绑定的单张卡查询此卡在某个月开具的发票。
+    /**
+     * 自有车 已开发票查询接口 渠道通过此接口可以根据该公司绑定的单张卡查询此卡在某个月开具的发票。
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult getSelfCarInvoicesByTime(String appKey, String api, String data, String requestid);
 
-    //自有车 已开发票查询接口 渠道通过此接口可以根据该公司的申请信息查询开票信息
+    /**
+     * 自有车 已开发票查询接口 渠道通过此接口可以根据该公司的申请信息查询开票信息
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult getSelfCarInvoicesByAppl(String appKey, String api, String data, String requestid);
 
-    //自有车 发票下载 渠道通过此接口可以下载某公司某个月份开具的发票。
+    /**
+     * 自有车 发票下载 渠道通过此接口可以下载某公司某个月份开具的发票。
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult getSelfCarInvoicePackage(String appKey, String api, String data, String requestid);
 
-    //自有车 卡解绑接口。
+    /**
+     * 自有车 卡解绑接口。
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult customerCarUnRec(String appKey, String api, String data, String requestid);
 
-    //自有车 卡换绑绑接口。
+    /**
+     * 自有车 卡换绑绑接口。
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult customerCardChange(String appKey, String api, String data, String requestid);
 
-    //自有车 卡换绑绑查询接口。
+    /**
+     * 自有车 卡换绑绑查询接口。
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult customerCardChangeQuery(String appKey, String api, String data, String requestid);
 
-    //自有车 按交易查申请接口。
+    /**
+     * 自有车 按交易查申请接口。
+     * @param appKey
+     * @param api
+     * @param data
+     * @param requestid
+     * @return
+     */
     DataResult tradeApplyQuery(String appKey, String api, String data, String requestid);
 }

src/main/java/com/jkcredit/invoice/mapper/binvoce/HcInvoiceMapper.java

@@ -12,8 +12,7 @@ import java.util.List;
 @Repository
 public interface HcInvoiceMapper extends BaseMapper<HcInvoice> {
     /**
-     * 插入红冲发票
-     *
+     *  插入红冲发票
      * @param hcInvoice
      * @return
      */
@@ -21,14 +20,23 @@ public interface HcInvoiceMapper extends BaseMapper<HcInvoice> {
 
     /**
      * 根据月份删除
-     *
      * @param yearMonth
      * @return
      */
     int deleteByMounth(String yearMonth);
 
-
+    /**
+     * 查询红充发票列表
+     * @param hcInvoice
+     * @return
+     */
     List<HcInvoice> selectInvoiceByCondition(HcInvoice hcInvoice);
 
+    /**
+     * 分页查询红充发票列表
+     * @param page
+     * @param hcInvoice
+     * @return
+     */
     IPage<HcInvoice> selectAllByPage(Page page, @Param("hcInvoice") HcInvoice hcInvoice);
 }

src/main/java/com/jkcredit/invoice/mapper/binvoce/SelfCarApplMapper.java

@@ -11,10 +11,26 @@ import java.util.List;
 
 @Repository
 public interface SelfCarApplMapper extends BaseMapper<SelfCarAppl> {
+
+    /**
+     * 分页查询自有车 运单列表
+     * @param page
+     * @param selfCarAppl
+     * @return
+     */
     IPage<List<SelfCarAppl>> selectAllByPage(Page page, @Param("selfCarAppl") SelfCarAppl selfCarAppl);
 
+    /**
+     * 查询自有车所有运单列表
+     * @return
+     */
     List<SelfCarAppl> selectAllNoRec();
 
+    /**
+     * 插入自有车运单申请列表
+     * @param record
+     * @return
+     */
     @Override
     int insert(SelfCarAppl record);
 }

src/main/java/com/jkcredit/invoice/mapper/binvoce/SelfCarInvoiceMapper.java

@@ -12,20 +12,63 @@ import java.util.List;
 
 @Repository
 public interface SelfCarInvoiceMapper extends BaseMapper<SelfCarInvoice> {
+
+    /**
+     * 分页查询自有车发票列表
+     * @param page
+     * @param selfCarInvoice
+     * @return
+     */
     IPage<List<SelfCarInvoice>> selectAllByPage(Page page, @Param("selfCarInvoice") SelfCarInvoice selfCarInvoice);
 
+    /**
+     * 插入自有车发票
+     * @param record
+     * @return
+     */
     @Override
     int insert(SelfCarInvoice record);
 
+    /**
+     * 更新自有车发票
+     * @param record
+     * @return
+     */
     int updateByPrimaryKey(SelfCarInvoice record);
 
+    /**
+     * 根据交易查询自有车发票列表
+     * @param tradeId
+     * @return
+     */
     List<SelfCarInvoice> selectByTrade(String tradeId);
 
+    /**
+     * 根据etc卡号查询自有车发票列表
+     * @param cardId
+     * @return
+     */
     List<SelfCarInvoice> selectByCardId(String cardId);
 
+    /**
+     * 根据查询时间 查询自有车发票列表
+     * @param record
+     * @return
+     */
     List<SelfCarInvoice> selectByTradeAndInvoiceMakeTime(SelfCarInvoice record);
 
+    /**
+     * 根据发票号码和发票代码查询自有车发票列表
+     * @param record
+     * @return
+     */
+
     List<SelfCarInvoice> selectByCodeAndNum(SelfCarInvoice record);
 
+    /**
+     * 根据公司信息更新自有车发票列表
+     * @param companyVo
+     * @return
+     */
     int upDateCompany(CompanyVo companyVo);
 }

src/main/java/com/jkcredit/invoice/mapper/calculateinfor/MounthAccMapper.java

@@ -7,9 +7,23 @@ import java.util.List;
 
 @Repository
 public interface MounthAccMapper {
+
+    /**
+     * 插入月账单
+     * @param mounthAcc
+     * @return
+     */
     int insert(MounthAcc mounthAcc);
 
+    /**
+     * 删除所有月账单
+     * @return
+     */
     int deleteAll();
 
+    /**
+     * 查询月账单列表
+     * @return
+     */
     List<MounthAcc> selectAllMounthAcc();
 }

src/main/java/com/jkcredit/invoice/mapper/calculateinfor/NoCarCalculateInforMapper.java

@@ -13,14 +13,41 @@ import java.util.Map;
 
 @Repository
 public interface NoCarCalculateInforMapper extends BaseMapper<NoCarCalculateInfor> {
+
+    /**
+     * 分页查询 无车计费信息
+     * @param page
+     * @param calculateInfor
+     * @return
+     */
     IPage<List<NoCarCalculateInfor>> selectAllByPage(Page page, @Param("calculateInfor") NoCarCalculateInfor calculateInfor);
 
+    /**
+     * 插入无车 计费信息
+     * @param record
+     * @return
+     */
     @Override
     int insert(NoCarCalculateInfor record);
 
+    /**
+     * 根据交易id查询无车 计费信息
+     * @param tradeId
+     * @return
+     */
     NoCarCalculateInfor selectByTradeId(String tradeId);
 
+    /**
+     * 无车计费信息统计查询
+     * @param record
+     * @return
+     */
     List<Map<String, String>> selectforStatis(@Param("calculateInfor") NoCarCalculateInfor record);
 
+    /**
+     * 根据企业信息 更新无车计费信息
+     * @param companyVo
+     * @return
+     */
     int upDateCompany(CompanyVo companyVo);
 }

src/main/java/com/jkcredit/invoice/mapper/calculateinfor/SelfCarCalculateInforMapper.java

@@ -13,14 +13,41 @@ import java.util.Map;
 
 @Repository
 public interface SelfCarCalculateInforMapper extends BaseMapper<SelfCarCalculateInfor> {
+
+    /**
+     * 分页查询自有车计费列表
+     * @param page
+     * @param calculateInfor
+     * @return
+     */
     IPage<List<SelfCarCalculateInfor>> selectAllByPage(Page page, @Param("calculateInfor") SelfCarCalculateInfor calculateInfor);
 
+    /**
+     * 插入自有车计费列表
+     * @param record
+     * @return
+     */
     @Override
     int insert(SelfCarCalculateInfor record);
 
+    /**
+     * 根据etc卡号和时间查询自有车计费信息
+     * @param selfCarCalculateInfor
+     * @return
+     */
     SelfCarCalculateInfor selectByEtcAndTime(SelfCarCalculateInfor selfCarCalculateInfor);
 
+    /**
+     * 查询自有车计费统计信息
+     * @param selfCarCalculateInfor
+     * @return
+     */
     List<Map<String, String>> findSelfcarCalculateInfoSta(SelfCarCalculateInfor selfCarCalculateInfor);
 
+    /**
+     * 根据公司名称更新自有车计费信息
+     * @param companyVo
+     * @return
+     */
     int upDateCompany(CompanyVo companyVo);
 }

src/main/java/com/jkcredit/invoice/mapper/customer/CustomerChangeInfoMapper.java

@@ -12,11 +12,31 @@ import java.util.Map;
 
 @Repository
 public interface CustomerChangeInfoMapper extends BaseMapper<CustomerEtcChangeInfo> {
+    /**
+     * 客户换绑数据插入
+     * @param custometEtcChangeInfo
+     */
     void insertCardChangeInfo(CustomerEtcChangeInfo custometEtcChangeInfo);
 
+    /**
+     * 客户换绑记录按照请求ID和卡号插入
+     * @param applyId
+     * @param cardId
+     */
     void insertChangeCard(@Param("applyId") String applyId, @Param("cardId") String cardId);
 
+    /**
+     * 查询换绑记录
+     * @param applyId
+     * @return
+     */
     List<Map<String, String>> selectChangeCards(String applyId);
 
+    /**
+     * 分页查询换绑记录
+     * @param page
+     * @param custometEtcChangeInfo
+     * @return
+     */
     IPage<List<CustomerEtcChangeInfo>> selectAllByPage(Page page, @Param("custometEtcChangeInfo") CustomerEtcChangeInfo custometEtcChangeInfo);
 }

src/main/java/com/jkcredit/invoice/mapper/customer/CustomerMapper.java

@@ -11,29 +11,94 @@ import java.util.List;
 
 @Repository
 public interface CustomerMapper extends BaseMapper<Customer> {
+
+    /**
+     * 按照id删除客户信息
+     * @param id
+     * @return
+     */
     int deleteByPrimaryKey(Integer id);
 
+    /**
+     * 插入客户信息
+     * @param record
+     * @return
+     */
     @Override
     int insert(Customer record);
 
+    /**
+     * 按照提交插入客户信息
+     * @param record
+     * @return
+     */
     int insertSelective(Customer record);
 
+    /**
+     * 按照客户id查询客户信息
+     * @param id
+     * @return
+     */
     Customer selectByPrimaryKey(Integer id);
 
+    /**
+     * 按照客户名称查询客户信息
+     * @param customerName
+     * @return
+     */
     Customer selectByCustomerName(String customerName);
 
+    /**
+     * 按照客户名称查询客户信息 增加锁
+     * @param customerName
+     * @return
+     */
     Customer selectByCustomerNameForLock(String customerName);
 
+    /**
+     * 更新客户信息
+     * @param record
+     * @return
+     */
     int updateByPrimaryKeySelective(Customer record);
 
+    /**
+     * 按照id更新客户信息
+     * @param record
+     * @return
+     */
     int updateByPrimaryKey(Customer record);
 
+    /**
+     * 分页查询客户信息
+     * @param page
+     * @param customer
+     * @return
+     */
     IPage<List<Customer>> selectAllByPage(Page page, @Param("customer") Customer customer);
 
+    /**
+     * 分页查询正常客户的客户信息
+     * @param page
+     * @param customer
+     * @return
+     */
     IPage<List<Customer>> selectAllByPageForNoMoney(Page page, @Param("customer") Customer customer);
 
+    /**
+     * 分页查询正常客户的客户信息
+     * @param page
+     * @param customer
+     * @return
+     */
     IPage<List<Customer>> selectAllByPageForNoMoneyByZero(Page page, @Param("customer") Customer customer);
 
 
+    /**
+     * 根据客户名称和appSecret 查询客户信息
+     * @param customerName
+     * @param appSecret
+     * @return
+     */
     Customer selectByAppKeyAndAppSecret(String customerName, String appSecret);
 }

src/main/java/com/jkcredit/invoice/mapper/customer/CustomerOperMapper.java

@@ -11,9 +11,19 @@ import java.util.List;
 
 @Repository
 public interface CustomerOperMapper extends BaseMapper<CustomerOper> {
-
+    /**
+     * 分页查询运单批次号信息
+     * @param page
+     * @param customerOper
+     * @return
+     */
     IPage<List<CustomerOper>> selectAllByPage(Page page, @Param("customerOper") CustomerOper customerOper);
 
+    /**
+     * 插入运单批次号信息
+     * @param record
+     * @return
+     */
     @Override
     int insert(CustomerOper record);
 }

src/main/java/com/jkcredit/invoice/mapper/customer/CustomerRecMapper.java

@@ -11,64 +11,197 @@ import java.util.List;
 
 @Repository
 public interface CustomerRecMapper extends BaseMapper<CustomerRec> {
+
+    /**
+     * 根据id删除企业备案信息
+     * @param id
+     * @return
+     */
     int deleteByPrimaryKey(Integer id);
 
+    /**
+     * 插入企业备案信息
+     * @param record
+     * @return
+     */
     @Override
     int insert(CustomerRec record);
 
+    /**
+     * 更新企业备案信息
+     * @param customerRec
+     * @return
+     */
     int updateByCompany(CustomerRec customerRec);
 
+    /**
+     * 按照条件插入企业备案信息
+     * @param record
+     * @return
+     */
     int insertSelective(CustomerRec record);
 
+    /**
+     * 按照id查询企业备案信息
+     * @param id
+     * @return
+     */
     CustomerRec selectByPrimaryKey(String id);
 
+    /**
+     * 按照id查询企业备案信息 包含base64流
+     * @param id
+     * @return
+     */
     CustomerRec selectByPrimaryKeyHasBase64(Integer id);
 
+    /**
+     * 按照id查询企业备案信息 不包含base64流
+     * @param id
+     * @return
+     */
     CustomerRec selectByPrimaryKeyHasNoLocalBase64(Integer id);
 
+    /**
+     * 根据customerName 查询企业备案列表 返回成功的
+     * @param customerName
+     * @return
+     */
     List<CustomerRec> selectByCustomerName(String customerName);
 
+    /**
+     * 根据customerName 查询企业备案列表 返回所有
+     * @param customerName
+     * @return
+     */
     List<CustomerRec> selectByCustomerNameAll(String customerName);
 
+    /**
+     * 跟前客户名称模糊查询企业备案列表
+     * @param record
+     * @return
+     */
     List<CustomerRec> selectByCustomerNameCpAll(@Param("customerRec") CustomerRec record);
 
+    /**
+     * 根据客户名称和公司名称 查询企业备案信息
+     * @param record
+     * @return
+     */
     CustomerRec selectByCustomerNameAndCompany(CustomerRec record);
 
+    /**
+     * 根据客户名称和企业联系人 查询企业备案信息
+     * @param record
+     * @return
+     */
     CustomerRec selectByCustomerNameAndCompanyConcat(CustomerRec record);
 
+    /**
+     * 根据客户名称 和企业税号查询 企业备案信息，只查询成功的
+     * @param record
+     * @return
+     */
     CustomerRec selectByCustomerNameAndCompanyReference(CustomerRec record);
 
+    /**
+     * 根据客户名称 和企业税号查询 企业备案信息，查询所有
+     * @param record
+     * @return
+     */
     CustomerRec selectByCustomerNameAndCompanyReferenceAll(CustomerRec record);
 
+    /**
+     * 根据企业税号查询企业备案列表
+     * @param companyReference
+     * @return
+     */
     List<CustomerRec> selectByCompanyReference(String companyReference);
 
-    List<CustomerRec> selectByCompanyName(String comapanyName);
-
-    //根据客户名称和 企业编码查询唯一数据
+    /**
+     * 根据公司名称查询企业备案列表
+     * @param companyName
+     * @return
+     */
+    List<CustomerRec> selectByCompanyName(String companyName);
+
+    /**
+     * 根据客户名称和 企业编码查询唯一数据
+     * @param record
+     * @return
+     */
     CustomerRec selectByCustomerNameAndCompanyNum(CustomerRec record);
 
 
-    //根据客户名称和 企业编码查询唯一数据
+    /**
+     * 根据客户名称和 企业编码查询唯一税号
+     * @param record
+     * @return
+     */
     int selectContractStatusByCustomerNameAndCompanyNum(CustomerRec record);
 
-
+    /**
+     * 根据企业编码查询企业备案列表
+     * @param record
+     * @return
+     */
     List<CustomerRec> selectByCompanyNum(CustomerRec record);
 
+    /**
+     * 更新企业备案信息 按照条件
+     * @param record
+     * @return
+     */
     int updateByPrimaryKeySelective(CustomerRec record);
 
+    /**
+     * 按照id更新企业备案信息
+     * @param record
+     * @return
+     */
     int updateByPrimaryKeySelectiveUpload(CustomerRec record);
 
+    /**
+     * 更新企业备案信息
+     * @param record
+     * @return
+     */
     int updateByPrimaryKey(CustomerRec record);
 
+    /**
+     * 分页查询下企业备案信息
+     * @param page
+     * @param customerRec
+     * @return
+     */
     IPage<List<CustomerRec>> selectAllByPage(Page page, @Param("customerRec") CustomerRec customerRec);
 
 
+    /**
+     * 分页查询企业备案信息，结束时间不为空
+     * @param page
+     * @param customerRec
+     * @return
+     */
     IPage<List<CustomerRec>> selectAllByPageWarning(Page page, @Param("customerRec") CustomerRec customerRec);
 
-
+    /**
+     * 查询企业备案信息 导出使用
+     * @param customerRec
+     * @return
+     */
     List<CustomerRec> selectAllByPageExport(@Param("customerRec") CustomerRec customerRec);
 
+    /**
+     * 查询所有无车 企业的企业备案信息
+     * @return
+     */
     List<CustomerRec> selectAllNoCarComapany();
 
+    /**
+     * 根据id和协议上传状态更新企业备案信息
+     * @param customerRec
+     * @return
+     */
     int updateContractStatus(CustomerRec customerRec);
 }

src/main/java/com/jkcredit/invoice/mapper/customer/CustomerRechargeMapper.java

@@ -12,21 +12,64 @@ import java.util.List;
 @Repository
 public interface CustomerRechargeMapper extends BaseMapper<CustomerRecharge> {
 
+
+    /**
+     * 分页查询 客户缴费记录信息
+     * @param page
+     * @param customer
+     * @return
+     */
     IPage<List<CustomerRecharge>> selectAllByPage(Page page, @Param("customerRecharge") CustomerRecharge customer);
 
+    /**
+     * 分页查询客户缴费记录 余额>=0 的客户信息
+     * @param page
+     * @param customer
+     * @return
+     */
     IPage<List<CustomerRecharge>> selectAllByPageMoney(Page page, @Param("customerRecharge") CustomerRecharge customer);
 
+    /**
+     * 根据id删除客户缴费记录信息
+     * @param id
+     * @return
+     */
     int deleteByPrimaryKey(Integer id);
 
+    /**
+     * 插入客户缴费记录信息
+     * @param record
+     * @return
+     */
     @Override
     int insert(CustomerRecharge record);
 
+    /**
+     * 按照条件插入客户缴费记录信息
+     * @param record
+     * @return
+     */
     int insertSelective(CustomerRecharge record);
 
+    /**
+     * 按照id查询客户缴费记录信息
+     * @param id
+     * @return
+     */
     CustomerRecharge selectByPrimaryKey(Integer id);
 
+    /**
+     * 按照条件更新客户缴费记录信息
+     * @param record
+     * @return
+     */
     int updateByPrimaryKeySelective(CustomerRecharge record);
 
+    /**
+     * 更新客户缴费记录信息
+     * @param record
+     * @return
+     */
     int updateByPrimaryKey(CustomerRecharge record);
 
 }

src/main/java/com/jkcredit/invoice/mapper/waybill/NoCarWaybillImprtMapper.java

@@ -13,21 +13,68 @@ import java.util.List;
 @Repository
 public interface NoCarWaybillImprtMapper extends BaseMapper<NoCarWayBill> {
 
+    /**
+     * 查询导入运单列表
+     * @param page
+     * @param noCarWayBill
+     * @return
+     */
     IPage<List<NoCarWayBill>> selectAllByPage(Page page, @Param("noCarWayBill") NoCarWayBill noCarWayBill);
 
+    /**
+     * 查询导入运单列表 导入失败的
+     * @param page
+     * @param noCarWayBill
+     * @return
+     */
     IPage<List<NoCarWayBill>> selectAllByPageException(Page page, @Param("noCarWayBill") NoCarWayBill noCarWayBill);
 
+    /**
+     * 插入导入运单列表
+     * @param record
+     * @return
+     */
     int insertImport(NoCarWayBill record);
 
+    /**
+     * 更新导入运单列表
+     * @param record
+     * @return
+     */
     int updateByPrimaryKey(NoCarWayBill record);
 
+    /**
+     * 根据运单号更新导入运单列表
+     * @param record
+     * @return
+     */
     int updateByBillNum(NoCarWayBill record);
 
+    /**
+     * 根据运单好查询导入运单列表
+     * @param wayBillNum
+     * @return
+     */
     NoCarWayBill selectByBillNum(String wayBillNum);
 
+    /**
+     * 查询导入运单列表
+     * @param noCarWayBill
+     * @return
+     */
     List<NoCarWayBill> selectByHisFlagAndBillStatus(NoCarWayBill noCarWayBill);
 
+    /**
+     * 根据公司信息更新导入运单列表
+     * @param companyVo
+     * @return
+     */
     int upDateCompany(CompanyVo companyVo);
 
+    /**
+     * 根据公司名称查询导入运单列表
+     * @param customerName
+     * @return
+     */
     List<NoCarWayBill> getNoCarNoVoiceQuery(String customerName);
 }

src/main/java/com/jkcredit/invoice/mapper/waybill/NoCarWaybillMapper.java

@@ -13,30 +13,96 @@ import java.util.List;
 @Repository
 public interface NoCarWaybillMapper extends BaseMapper<NoCarWayBill> {
 
+    /**
+     * 查询运单信息分页
+     * @param page
+     * @param noCarWayBill
+     * @return
+     */
     IPage<List<NoCarWayBill>> selectAllByPage(Page page, @Param("noCarWayBill") NoCarWayBill noCarWayBill);
 
+    /**
+     * 分页查询 失败运单信息
+     * @param page
+     * @param noCarWayBill
+     * @return
+     */
     IPage<List<NoCarWayBill>> selectAllByPageException(Page page, @Param("noCarWayBill") NoCarWayBill noCarWayBill);
 
+    /**
+     * 插入 运单信息
+     * @param record
+     * @return
+     */
     @Override
     int insert(NoCarWayBill record);
 
+    /**
+     * 更新运单信息
+     * @param record
+     * @return
+     */
     int updateByPrimaryKey(NoCarWayBill record);
 
+    /**
+     * 根据运单号更新运单信息
+     * @param record
+     * @return
+     */
     int updateByBillNum(NoCarWayBill record);
 
+    /**
+     * 根据运单号更新运单是否失败信息
+     * @param record
+     * @return
+     */
     int updateByBillNumTimeRes(NoCarWayBill record);
 
+    /**
+     * 根据运单号查询运单信息
+     * @param wayBillNum
+     * @return
+     */
     NoCarWayBill selectByBillNum(String wayBillNum);
 
+    /**
+     * 根据运单号查询运单列表
+     * @param wayBillNum
+     * @return
+     */
     List<NoCarWayBill> selectByBillNumForRe(String wayBillNum);
 
+    /**
+     * 根据运单号查询运单信息 行锁
+     * @param wayBillNum
+     * @return
+     */
     NoCarWayBill selectByBillNumforLock(String wayBillNum);
 
+    /**
+     * 根据运单号删除运单信息
+     * @param wayBillNum
+     */
     void deleteNotRightWayBill(String wayBillNum);
 
+    /**
+     * 根据运单号查询运单列表
+     * @param noCarWayBill
+     * @return
+     */
     List<NoCarWayBill> selectByHisFlagAndBillStatus(NoCarWayBill noCarWayBill);
 
+    /**
+     * 根据公司信息更新运单信息
+     * @param companyVo
+     * @return
+     */
     int upDateCompany(CompanyVo companyVo);
 
+    /**
+     * 根据公司名称查询运单列表
+     * @param customerName
+     * @return
+     */
     List<NoCarWayBill> getNoCarNoVoiceQuery(String customerName);
 }

src/main/java/com/jkcredit/invoice/mapper/waybill/SellCarTradeMapper.java

@@ -12,23 +12,71 @@ import java.util.List;
 
 @Repository
 public interface SellCarTradeMapper extends BaseMapper<SelfCarTrade> {
+
+    /**
+     * 分页查询自有车交易
+     * @param page
+     * @param sellCarTrade
+     * @return
+     */
     IPage<List<SelfCarTrade>> selectAllByPage(Page page, @Param("sellCarTrade") SelfCarTrade sellCarTrade);
 
+    /**
+     * 插入自有车交易
+     * @param record
+     * @return
+     */
     @Override
     int insert(SelfCarTrade record);
 
+    /**
+     * 更新自有车交易
+     * @param record
+     * @return
+     */
     int updateByPrimaryKey(SelfCarTrade record);
 
+    /**
+     * 根据交易id更新自有车交易
+     * @param record
+     * @return
+     */
     int updateByTradeId(SelfCarTrade record);
 
+    /**
+     * 根据交易id查询自有车交易列表
+     * @param tradeId
+     * @return
+     */
     List<SelfCarTrade> selectByTradeId(String tradeId);
 
+    /**
+     * 根据交易信息查询自有车交易列表
+     * @param record
+     * @return
+     */
     List<SelfCarTrade> selectByCardIdByStatus(SelfCarTrade record);
 
+    /**
+     * 根据卡号查询自有车交易列表
+     * @param cardId
+     * @return
+     */
     List<SelfCarTrade> selectByCardId(String cardId);
 
+    /**
+     * 根据状态，公司名称查询自有车交易列表
+     * @param status
+     * @param company
+     * @return
+     */
     List<SelfCarTrade> selectByStatus(@Param("status") String status, @Param("company") String company);
 
+    /**
+     * 根据公司信息更新自有车交易列表
+     * @param companyVo
+     * @return
+     */
     int upDateCompany(CompanyVo companyVo);
 
 }

src/main/java/com/jkcredit/invoice/service/customer/CustomerChangeInfoService.java

@@ -9,7 +9,18 @@ import java.util.Map;
 
 public interface CustomerChangeInfoService {
 
+    /**
+     * 分页查询换绑记录
+     * @param page
+     * @param custometEtcChangeInfo
+     * @return
+     */
     IPage findAllCustomerChangeInfo(Page page, CustomerEtcChangeInfo custometEtcChangeInfo);
 
+    /**
+     * 按照请求id 查询换绑记录
+     * @param applyId
+     * @return
+     */
     List<Map<String, String>> selectChangeCards(String applyId);
 }

src/main/java/com/jkcredit/invoice/service/lowerservice/NoCarService.java

@@ -39,28 +39,28 @@ public interface NoCarService {
 
     /**
      * 运单指令开始
-     *
+     * @param noCarWayBill
      * @return
      */
     RespR noCarWaybillStart(NoCarWayBill noCarWayBill);
 
     /**
      * 运单指令结束
-     *
+     * @param noCarWayBill
      * @return
      */
     RespR noCarWaybillEnd(NoCarWayBill noCarWayBill);
 
     /**
      * 历史运单指令开始
-     *
+     * @param noCarWayBill
      * @return
      */
     RespR noCarHisWaybillStart(NoCarWayBill noCarWayBill);
 
     /**
      * 历史运单指令结束
-     *
+     * @param noCarWayBill
      * @return
      */
     RespR noCarHisWaybillEnd(NoCarWayBill noCarWayBill);

src/main/java/com/jkcredit/invoice/service/lowerservice/SelfCarServiceL.java

@@ -34,16 +34,25 @@ public interface SelfCarServiceL {
     RespR<String> applInvoice(InvoiceApplVo invoiceApplVo);
 
     /**
-     * 按申请id取发票
+     *  按申请id取发票
+     * @param applQueryInvVo
+     * @return
      */
     RespR<List<B2BInvoiceQueryByApplyModel>> getSelfCarInvoicesByApplyIds(ApplQueryInvVo applQueryInvVo);
 
     /**
      * 已开发票查询接口
+     * @param selfCarDueQueryVo
+     * @param customerRec
+     * @return
      */
     RespR<List<B2BInvoiceListModel>> getSelfCarInvoicesByTime(SelfCarDueQueryVo selfCarDueQueryVo, CustomerRec customerRec);
 
-
+    /**
+     * 发票打包下载
+     * @param invoicePackageVo
+     * @return
+     */
     RespR<List<B2bInvoicePackageModel>> getInvoicePackge(InvoicePackageVo invoicePackageVo);
 
     /**
@@ -63,46 +72,55 @@ public interface SelfCarServiceL {
     RespR queryEtcInfo(EtcBindVo etcBindVo);
 
     /**
-     * ETC备案
-     *
-     * @param
+     *  ETC备案
+     * @param etcBindVo
      * @return
      */
     RespR customerEtcRec(EtcBindVo etcBindVo);
 
 
     /**
-     * ETC校验
-     *
-     * @param
+     *  ETC校验
+     * @param etcValidVo
      * @return
      */
     RespR customerEtcRecValid(EtcValidVo etcValidVo);
 
     /**
      * 车辆解绑
-     *
      * @param customerCarRec
      * @return
      */
     RespR customerCarUnRec(List<CustomerCarRec> customerCarRec);
 
 
-    //自有车 卡换绑绑接口。
+    /**
+     * 自有车 卡换绑绑接口
+     * @param cardChangeDto
+     * @return
+     */
     RespR customerCardChange(CardChangeDto cardChangeDto);
 
 
-    //自有车 卡换绑绑查询接口。
+    /**
+     * 自有车 卡换绑绑查询接口。
+     * @param cardChangeQueryDto
+     * @return
+     */
     RespR customerCardChangeQuery(CardChangeQueryDto cardChangeQueryDto);
 
 
     /**
-     * 5.6按交易查申请 接口使用
+     *  5.6按交易查申请 接口使用
+     * @param tradeApplyQueryInvVo
+     * @return
      */
     RespR getApplyQueryByTradeId(TradeApplyQueryInvVo tradeApplyQueryInvVo);
 
     /**
      * 5.6按交易查申请 平台使用
+     * @param tradeApplyQueryInvVos
+     * @return
      */
     RespR getApplyQueryByTradeIds(List<TradeApplyQueryInvVo> tradeApplyQueryInvVos);
 }

src/main/java/com/jkcredit/invoice/service/nocar/NoCarBillWayService.java

@@ -28,24 +28,24 @@ public interface NoCarBillWayService {
 
     /**
      * 批量导入运单数据
-     *
      * @param noCarWayBills
+     * @param customerName
      * @return
      */
     RespR batchBillWayStart(List<NoCarWayBill> noCarWayBills, String customerName);
 
     /**
      * 批量结束运单数据
-     *
      * @param noCarWayBills
+     * @param customerName
      * @return
      */
     RespR batchBillWayEnd(List<NoCarWayBill> noCarWayBills, String customerName);
 
     /**
-     * 批量历史运单数据操作
-     *
+     *  批量历史运单数据操作
      * @param noCarWayBills
+     * @param customerName
      * @return
      */
     RespR batchHsitoryBillWay(List<NoCarWayBill> noCarWayBills, String customerName);

src/main/java/com/jkcredit/invoice/service/selfcar/SelfCarApplyService.java

@@ -7,5 +7,12 @@ import com.jkcredit.invoice.model.entity.invoice.SelfCarAppl;
 import java.util.List;
 
 public interface SelfCarApplyService {
+
+    /**
+     * 分页查询自有车运单列表
+     * @param page
+     * @param selfCarInvoice
+     * @return
+     */
     IPage<List<SelfCarAppl>> findByPageAndInvoice(Page page, SelfCarAppl selfCarInvoice);
 }

src/main/java/com/jkcredit/invoice/service/selfcar/SelfCarService.java

@@ -12,14 +12,13 @@ public interface SelfCarService {
 
     /**
      * 自有车解绑操作
-     *
+     * @param cardId
      * @return
      */
     RespR selfCarUnBind(String cardId);
 
     /**
      * 根据车牌号查询ETC信息
-     *
      * @param carNum
      * @return
      */