Merge remote-tracking branch 'origin/main'

weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/external/package.info

@@ -0,0 +1 @@
+用来放外部服务类，如法大大、电子秤等

weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/finance/service/impl/FinanceBillServiceImpl.java

@@ -10,6 +10,13 @@ import com.wjbl.weightlosscamp.service.api.module.finance.service.FinanceBillSer
 /**
  * 账单服务实现类
  */
+
+/**
+ *##马玉川##
+ * 【账单支付状态】：待支付、支付中（仅存在于通过线上支付的支出账单）、已支付
+ * 【账单收支类型】：收入、支出
+ * 【流水状态】：待审核、审核成功、审核失败、已作废
+ */
 public class FinanceBillServiceImpl implements FinanceBillService {
     /**
      * 添加账单
@@ -22,7 +29,31 @@ public class FinanceBillServiceImpl implements FinanceBillService {
         // 添加账单信息
         // 添加流水信息
 
-        //
+        /**
+         *##马玉川##
+         * 【添加账单场景】：客户详情处可以添加、账单管理处可以添加
+         * 【添加位置】：工作端、管理后台
+         * 【注意事项】：
+         * 客户详情处添加账单需要不需要选择账单类别，默认添加客户账单，同时不需要选择添加添加哪个客户的账单，默认当前客户；
+         * 后台账单管理处添加账单，需要选择添加账单类别（客户类、运营类）。客户类需要搜索选择哪个客户；运营类需要搜索选择哪个组织。均支持模糊检索；
+         * 添加账单默认为待支付账单；
+         */
+
+        // 添加流水信息
+
+        /**
+         *##马玉川##
+         * 【添加流水场景】：流水不能直接添加，当账单从待支付状态变为已支付状态时，自动生成与账单关联的流水信息，账单与流水存在多对一、一对一的关系
+         * 【添加位置】：系统自动
+         * 【注意事项】：
+         * 当账单支付渠道为线上支付（通过系统三方支付接口收入或支付）时，账单与流水存在多对一的关系；非线上支付时，账单与流水为一对一的关系；
+         * 流水生成后默认为待审核状态。后台操作流水审核，审核结果可以是审核失败、审核成功；
+         * 流水处于审核成功状态时，流水关联的账单不允许取消核销；待审核和审核失败状态下的流水关联的账单可以取消核销，线上支付的场景下除外；
+         * 当流水关联的账单被取消核销后，流水同步变更为已作废状态；线上支付的账单不允许取消核销，所以线上支付账单对应的流水一旦生成，不会作废；
+         * 取消核销的账单再次核销后，重新生成流水；
+         */
+
+
         return null;
     }
 
@@ -32,6 +63,14 @@ public class FinanceBillServiceImpl implements FinanceBillService {
      * @param dto
      * @return
      */
+
+    /**
+     *##马玉川##
+     * 【修改账单场景】：客户详情处可以修改、账单管理处可以修改
+     * 【修改位置】：管理后台
+     * 【注意事项】：
+     * 只有账单为“待支付”状态下，可以修改；支付中、已支付状态下不可以修改账单；
+     */
     @Override
     public ApiResult<Void> edit(FinanceBillDTO dto) {
         return null;
@@ -43,6 +82,13 @@ public class FinanceBillServiceImpl implements FinanceBillService {
      * @param param
      * @return
      */
+
+    /**
+     *##马玉川##
+     * 【删除账单场景】：功能上没有删除账单的功能。账单因为合同生成，当生成的合同作废后，自动生成的账单自动删除。
+     * 【修改位置】：系统
+     */
+
     @Override
     public ApiResult<Void> delete(IdParam param) {
         return null;
@@ -76,10 +122,17 @@ public class FinanceBillServiceImpl implements FinanceBillService {
      * @param param
      * @return
      */
+
+    /**
+     *##马玉川##
+     * 【作废账单场景】：客户详情处可以作废、账单管理处可以作废
+     * 【作废位置】：管理后台
+     * 【注意事项】：
+     * 只有账单为“待支付”状态下，可以作废；支付中、已支付状态下不可以作废；
+     */
+
     @Override
     public ApiResult<Void> cancel(IdParam param) {
-        // 作废账单
-        // 作废流水
         return null;
     }
 
@@ -100,6 +153,13 @@ public class FinanceBillServiceImpl implements FinanceBillService {
      * @param param
      * @return
      */
+
+    /**
+     *##马玉川##
+     * 【注意事项】：
+     * 账单备注列表存在按照操作时间排序的需求；
+     */
+
     @Override
     public ApiResult<Void> listRemark(IdParam param) {
         return null;
@@ -111,6 +171,13 @@ public class FinanceBillServiceImpl implements FinanceBillService {
      * @param param
      * @return
      */
+
+    /**
+     *##马玉川##
+     * 【账单核销场景】：客户详情处可以核销、账单管理处可以核销；只有待支付账单可以核销，核销后变为已支付状态。
+     * 【核销位置】：管理后台
+     */
+
     @Override
     public ApiResult<Void> writeOff(IdParam param) {
         return null;
@@ -122,6 +189,15 @@ public class FinanceBillServiceImpl implements FinanceBillService {
      * @param param
      * @return
      */
+
+    /**
+     *##马玉川##
+     * 【取消核销场景】：客户详情处可以取消核销、账单管理处可以取消核销
+     * 【取消核销位置】：管理后台
+     * 【注意事项】：
+     * 付款方式为线上支付的账单不允许不允许去取消核销；
+     * 账单关联的流水状态为审核成功的账单不允许取消核销，只有将关联流水从审核成功状态调整为待审核，才可以操作取消核销；
+     */
     @Override
     public ApiResult<Void> cancelWriteOff(IdParam param) {
         return null;
@@ -133,6 +209,16 @@ public class FinanceBillServiceImpl implements FinanceBillService {
      * @param param
      * @return
      */
+
+    /**
+     *##马玉川##
+     * 【发起支付场景】：只有收支类型为“支出”的账单，在账单管理处可以发起支付。这种支付方式默认为线上支付。需要添加收款的账户信息。
+     * 【发起支付位置】：管理后台
+     * 【注意事项】：
+     * 发起支付时，需要添加收款账户信息，包括必填字段银行卡号、开户人和开户人身份证件号；选填信息开户行、开户人手机号；
+     * 收款帐户信息在发起时需要通过三方支付接口校验开户信息。
+     */
+
     @Override
     public ApiResult<Void> pay(IdParam param) {
         return null;

weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/controller/SysMemberController.java

@@ -28,6 +28,11 @@ public class SysMemberController {
 
     private SysMemberService sysMemberService;
 
+    @Operation(summary = "成员登录")
+    @PostMapping("login")
+    public ApiResult<Void> login(@Valid @RequestBody MemberDTO dto) {
+        return sysMemberService.login(dto);
+    }
 
     @Operation(summary = "新增成员")
     @PostMapping("/add")

weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/controller/SysRoleController.java

@@ -35,7 +35,7 @@ public class SysRoleController {
     }
 
     @Operation(summary = "修改角色")
-    @PostMapping("/update")
+    @PostMapping("/edit")
     public ApiResult<Void> edit(@Valid @RequestBody RoleDTO dto) {
         return sysRoleService.edit(dto);
     }

weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/service/SysMemberService.java

@@ -23,4 +23,6 @@ public interface SysMemberService {
     ApiResult<Void> deleteCard(@Valid IdParam param);
 
     ApiResult<Page<MemberDTO>> cardList(@Valid PageParam<MemberDTO> param);
+
+    ApiResult<Void> login(@Valid MemberDTO dto);
 }

weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/service/SysMemberServiceImpl.java

@@ -46,4 +46,9 @@ public class SysMemberServiceImpl implements SysMemberService {
     public ApiResult<Page<MemberDTO>> cardList(PageParam<MemberDTO> param) {
         return null;
     }
+
+    @Override
+    public ApiResult<Void> login(MemberDTO dto) {
+        return null;
+    }
 }