From 2a75fb761f35477b26c72172f19101f52d82fd6b Mon Sep 17 00:00:00 2001 From: Kevin-Laptop Date: Sat, 19 Apr 2025 16:29:32 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E8=A7=92=E8=89=B2=E5=88=97=E8=A1=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../service/api/module/sys/controller/SysRoleController.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/controller/SysRoleController.java b/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/controller/SysRoleController.java index cb597bd..cd7bfa0 100644 --- a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/controller/SysRoleController.java +++ b/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 edit(@Valid @RequestBody RoleDTO dto) { return sysRoleService.edit(dto); } From d11c76f96940b56a2e6156feebd42de33dc51e57 Mon Sep 17 00:00:00 2001 From: Kevin-Laptop Date: Sat, 19 Apr 2025 17:26:17 +0800 Subject: [PATCH 2/2] =?UTF-8?q?=E8=A7=92=E8=89=B2=E5=88=97=E8=A1=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../service/api/module/external/package.info | 1 + .../service/impl/FinanceBillServiceImpl.java | 94 ++++++++++++++++++- .../sys/controller/SysMemberController.java | 5 + .../module/sys/service/SysMemberService.java | 2 + .../sys/service/SysMemberServiceImpl.java | 5 + 5 files changed, 103 insertions(+), 4 deletions(-) create mode 100644 weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/external/package.info diff --git a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/external/package.info b/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/external/package.info new file mode 100644 index 0000000..a6707ec --- /dev/null +++ b/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/external/package.info @@ -0,0 +1 @@ +用来放外部服务类,如法大大、电子秤等 \ No newline at end of file diff --git a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/finance/service/impl/FinanceBillServiceImpl.java b/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/finance/service/impl/FinanceBillServiceImpl.java index 179a72c..f9e14f2 100644 --- a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/finance/service/impl/FinanceBillServiceImpl.java +++ b/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 edit(FinanceBillDTO dto) { return null; @@ -43,6 +82,13 @@ public class FinanceBillServiceImpl implements FinanceBillService { * @param param * @return */ + + /** + *##马玉川## + * 【删除账单场景】:功能上没有删除账单的功能。账单因为合同生成,当生成的合同作废后,自动生成的账单自动删除。 + * 【修改位置】:系统 + */ + @Override public ApiResult delete(IdParam param) { return null; @@ -76,10 +122,17 @@ public class FinanceBillServiceImpl implements FinanceBillService { * @param param * @return */ + + /** + *##马玉川## + * 【作废账单场景】:客户详情处可以作废、账单管理处可以作废 + * 【作废位置】:管理后台 + * 【注意事项】: + * 只有账单为“待支付”状态下,可以作废;支付中、已支付状态下不可以作废; + */ + @Override public ApiResult cancel(IdParam param) { - // 作废账单 - // 作废流水 return null; } @@ -100,6 +153,13 @@ public class FinanceBillServiceImpl implements FinanceBillService { * @param param * @return */ + + /** + *##马玉川## + * 【注意事项】: + * 账单备注列表存在按照操作时间排序的需求; + */ + @Override public ApiResult listRemark(IdParam param) { return null; @@ -111,6 +171,13 @@ public class FinanceBillServiceImpl implements FinanceBillService { * @param param * @return */ + + /** + *##马玉川## + * 【账单核销场景】:客户详情处可以核销、账单管理处可以核销;只有待支付账单可以核销,核销后变为已支付状态。 + * 【核销位置】:管理后台 + */ + @Override public ApiResult writeOff(IdParam param) { return null; @@ -122,6 +189,15 @@ public class FinanceBillServiceImpl implements FinanceBillService { * @param param * @return */ + + /** + *##马玉川## + * 【取消核销场景】:客户详情处可以取消核销、账单管理处可以取消核销 + * 【取消核销位置】:管理后台 + * 【注意事项】: + * 付款方式为线上支付的账单不允许不允许去取消核销; + * 账单关联的流水状态为审核成功的账单不允许取消核销,只有将关联流水从审核成功状态调整为待审核,才可以操作取消核销; + */ @Override public ApiResult cancelWriteOff(IdParam param) { return null; @@ -133,6 +209,16 @@ public class FinanceBillServiceImpl implements FinanceBillService { * @param param * @return */ + + /** + *##马玉川## + * 【发起支付场景】:只有收支类型为“支出”的账单,在账单管理处可以发起支付。这种支付方式默认为线上支付。需要添加收款的账户信息。 + * 【发起支付位置】:管理后台 + * 【注意事项】: + * 发起支付时,需要添加收款账户信息,包括必填字段银行卡号、开户人和开户人身份证件号;选填信息开户行、开户人手机号; + * 收款帐户信息在发起时需要通过三方支付接口校验开户信息。 + */ + @Override public ApiResult pay(IdParam param) { return null; @@ -148,4 +234,4 @@ public class FinanceBillServiceImpl implements FinanceBillService { public ApiResult payCallback(IdParam param) { return null; } -} +} \ No newline at end of file diff --git a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/controller/SysMemberController.java b/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/controller/SysMemberController.java index cefc73a..83b18ac 100644 --- a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/controller/SysMemberController.java +++ b/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 login(@Valid @RequestBody MemberDTO dto) { + return sysMemberService.login(dto); + } @Operation(summary = "新增成员") @PostMapping("/add") diff --git a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/service/SysMemberService.java b/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/service/SysMemberService.java index dee24e5..b784d9a 100644 --- a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/service/SysMemberService.java +++ b/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 deleteCard(@Valid IdParam param); ApiResult> cardList(@Valid PageParam param); + + ApiResult login(@Valid MemberDTO dto); } diff --git a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/service/SysMemberServiceImpl.java b/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/service/SysMemberServiceImpl.java index 816eaea..ce388b5 100644 --- a/weight-loss-camp-service-api/src/main/java/com/wjbl/weightlosscamp/service/api/module/sys/service/SysMemberServiceImpl.java +++ b/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> cardList(PageParam param) { return null; } + + @Override + public ApiResult login(MemberDTO dto) { + return null; + } }