1、背景
1.2 业务重组与合并
随着需求不断迭代,转转消费分期整体出现了一些调整,并提出了新的产品方向,在此背景下,对于经历了久经沧桑的历史服务,已经逐渐不适合未来的产品规划。面对新的业务整合和重组,急需新的架构和思想来承载未来的业务。
1.2 解决技术债务
现阶段存在的主要问题:
- 代码模块之间边界感不强,需要通过模块拆分、服务拆分来区分业务边界。
- 代码实现缺少层次感,设计模式单一,一层到底的冗长代码。
此前,微服务拆分原则是按消费分期、合作方分期产品等维度进行整体拆分的,优点是明确了项目职责,简单的从需求维度进行服务拆分,确实是一种行之有效的方式,缺点是没有对基础功能进行剥离,以至于很多场景需要维护重复的代码,增加了项目的维护成本。
1.3 影响开发效率
即使我们接手项目已经有一段时间,并对项目足够了解时,但排查问题起来依然费力费时,而且系统内部代码错综复杂,调用链路交错,难以正常维护,从长远的开发效率考虑,尽快提出新型方案来代替现有结构。
1.4 监控体系不够完善
线上异常机制不够敏感,缺少关键业务指标的告警看板,作为一个业务开发,应保持对核心指标数据的敏感性。
2、重构目标
- 不影响业务的正常运转和迭代;
- 改善现有代码结构设计,让代码易于扩展,提升开发效率;
- 采用新工程逐步替代原有接口,旧工程逐渐废弃。
3、设计
3.1 调研
开始重构之前,调研了互联网消金通用的架构解决方案:
通用方案
由于是外部调研的通用架构设计,所以并非完全契合转转消费分期产品,但可以借鉴其分层架构设计的思想,在代码设计阶段,可以先对核心模块进行拆解和规划。
3.2 规划
前端页面与后端重构计划分两次迭代进行,分阶段进行,可以有效分摊并降低项目上线风险,第一次迭代围绕后端主要模块进行剥离重新设计并上线;第二次重构目的是解决产品需求,对接前端新页面。
3.3 修缮者模式
作为一个一线的业务开发,需要开展重构工作的同时还得保证产品需求的正常迭代,修缮者模式无疑是最佳选择。 第一次迭代历程,对于历史工程边缘逻辑保留并隔离,只对核心代码进行重构后转移到到新工程,新工程逐步接手老旧逻辑,并对老工程提供RPC接口,逐渐取代。此方案整体风险最低,同时能兼顾到正常的需求迭代。
第二次迭代历程,经历了第一次迭代后,新系统运行稳定,同时也具备接手新产品的能力,新工程开始与前端对接、联调,在此之后,V2版本也正式上线。
3.4 领域设计(横向拆分)
模块拆分
- 聚合业务:涵盖了消费分期主要业务,根据其各自产品需求特点,作为上层业务代码,对前端、收银台提供聚合接口。
- 基础服务:用户信贷所产生的数据、或依托合作方数据,围绕金融分期服务提供的数据支持。
- 三方对接:基于转转标准API下的逻辑实现,同时具备灵活接入合作方接口的能力。
3.5 模块设计(纵向拆分)
基于以往项目存在的问题,再结合消费分期的特点,我们对分期购买到账单还款结清的整个流程进行拆解:用户主动填写申请信息,提交授信申请并获额,挑选商品分期下单,生成还款计划,提供绑卡、账单还款等功能。以上就是一个简单的分期购物流程,基于以上流程,我们把消费分期所包含的公共模块,如授信前获额、用信、账单还款,这些富有金融服务属性的功能进行剥离。消费分期作为转转的产品原型,在聚合层中各自维护,互不影响。
设计原则:在不改变原有代码逻辑的情况下,根据单一职责和依赖倒置原则的思想:对系统进行模块拆分与合并,以明确项目职责降低耦合度;对包进行重新规划,划分包与包之间的边界,进一步减少代码间的耦合。
3.6 代码设计
好的代码重构一定离不开设计模式,基于原有单一的策略模式,我们把合作方对接模块与基础服务模块进行了拆解,采用双层模板、策略、工厂模式的组合,分别对授信、用信、贷后几个模块单独设计接口,维护好对合作方通用标准API接口,同时具备灵活接入的特点,举个例子,以下为授信模块主要代码类图:
第一层作为基础服务的策略模式;
第二层作为合作方对接的策略模式。
主要类图设计:
在定义接口与实现类后,形成了对合作方对接层依赖,同时对订单、用信、授信等核心数据进行落地,对消费分期提供数据支撑,举个例子,以下为授信模块主要代码:
- 基础服务接口定义
/**
* 授信接口定义
**/
public interface ICreditService {
/**
* appId,资方定义的一个唯一ID
*/
String getAppId();
/**
* app名称
*
* @return zz or zlj
*/
String getAppName();
/**
* 获取授信结果
*
* @return result
*/
CreditResult creditResult(String logStr, Long uid);
}
- 标准流程抽象
/**
* 标准API对接实现
*
**/
public abstract class AbstractCreditService implements ICreditService {
/**
* 标准API对接
*
* @return IBaseApiService
*/
protected abstract IBaseApiService getApiThirdService();
@Override
public AppConfig getPartner() {
return commonConfigUtil.getAppConfig(getAppId());
}
@Override
public CreditResult creditResult(String logStr, Long uid) {
CreditResultInput input = new CreditResultInput();
input.setUid(uid);
ResponseProtocol<CreditResultOutput> output = getApiThirdService().creditResult(logStr, input);
String creditStatus = TransformUtil.approvalStatusTransform(output.getData());
return CreditResult.builder().result(creditStatus).build();
}
}
/**
* 合作方差异化接入
*/
@Service
@Slf4j
public class ZZABCCreditServiceImpl extends AbstractABCCreditService {
@Resource
ZZABCThirdServiceImpl abcThirdService;
@Override
public String getAppId() {
return PartnerEnum.ABC_ZZ_API.getAppId();
}
@Override
public String getAppName() {
return AppNameEnum.ZZ.getValue();
}
@Override
protected IABCThirdService getABCThirdService() {
return abcThirdService;
}
}
- 标准API对接
/**
* 标准API对接
*
* @author Rouse
* @date 2022/4/24 13:57
*/
public interface IBaseApiService {
/**
* 标准API,获取appId
*
* @return appId
*/
String getAppId();
/**
* 获取授信结果
*/
ResponseProtocol<CreditResultOutput> creditResult(CreditResultInput input);
}
- 内部标准API实现
/**
* 合作方,标准API对接实现
*
* @author Rouse
* @date 2022/4/24 14:04
*/
@Slf4j
public abstract class AbstractBaseApiService implements IBaseApiService {
@Override
public ResponseProtocol<CreditResultOutput> creditResult(CreditResultInput input) {
// 通用加解密
return getDataResponse(logStr, getAppConf().getUrl4CreditResult(), input, CreditResultOutput.class);
}
}
- 差异化合作方接入
/**
* ABC合作方接口封装
**/
public interface IABCThirdService extends IBaseApiService {
/**
* 标准API,获取appId
*
* @return appId
*/
String getAppId();
/**
* 获取授信结果
*/
ResponseProtocol<ABCCreditResultOutput> creditResult(ABCCreditResultInput input);
}
/**
* 合作方抽象方法封装
**/
@Slf4j
public abstract class AbstractABCThirdService extends AbstractBaseApiService implements IABCThirdService {
@Override
public ResponseProtocol<ABCCreditResultOutput> creditResult(ABCCreditResultInput input) {
// 加解密差异化实现
return getDataResponse(logStr, getAppConf().getUrl4CreditResult(), input, ABCCreditResultOutput.class);
}
}
/**
* ABC合作方对接
*
*/
@Service
@Slf4j
public class ZZABCThirdServiceImpl extends AbstractABCThirdService{
@Override
public String getAppId() {
return PartnerEnum.ABC_API_ZZ.getAppId();
}
@Override
public String getAppName() {
return AppNameEnum.ZZ.getValue();
}
}
4、上线过程
对于老系统的重构,新系统上线过度期也至关重要,因为采用了新的表结构进行重新设计,涉及到数据的同步,我们采用单向数据同步,逐渐弃用老系统数据,如果灰度期间需要回滚,首先对数据进行回滚,优先保证线上服务稳定。
以下是经历两次重构迭代的过程:
5、监控
- 项目重构监控先行,这次我们采用了转转告警机制和Prometheus线上监控,另外搭建了一套线上看板,及时发现各个模块的潜在隐患。
- 日志,一个完美的系统离不开合理的日志,日志往往是定位问题最便捷的工具。
6、总结
通过此次技术重构,我们不仅解决了过去存在的技术债务问题,还提升了服务的稳定性和用户体验,也提升产品交付效率。
技术重构并非一蹴而就,但只要我们有坚定的信念和不懈的努力,终将取得成功。引用一句名言:”不要因为懒惰而拒绝重构,不要因为无暇重构而成为你拖延的理由 。” 是的,重构是持续优化代码质量和可维护性的过程,需要我们时刻关注并付诸行动。
我认为,重构的另一种价值:一个重构好的系统、往往具备通用性,可移植性。简单说就是我们重构后的系统以最小的改动且能在同行中快速复用,因为你创造了一个稳定可靠的“轮子”,如果做到这点,无非你是这个行业技术解决方案的专家。
关于作者
罗思,金融技术部后端研发工程师。转转消费分期业务开发。