Mifos小额信贷管理系统平台软件架构文档

1、Mifos平台软件架构文档1. 概要本文抓住了主要架构决策平台。文档的目的是为平台的总体结构提供一个向导;它适合在一个管理信息系统解决方案的整体背景及其内部贡献者可以更有效地了解他们正在考虑可以变化,这些变化的影响。这个报告的目标受众是系统集成商(谁将使用文档来了解平台的结构及其设计原理)和平台贡献者将使用文档来推断未来的变化和谁会随着系统的发展更新文档。2. 简介2.1. 理念Mifos是一个出于希望创建和部署技术,允许小额信贷行业的规模的想法。我们的目标是:l 产生一个黄金标准管理信息系统适合小额信贷业务l 作为小额信贷的基础平台l 开源的,拥有和由成员组织在社区l 使潜在的生态系统提供商

2、周边的小额信贷机构2.2. 历史l 2006: 项目始于Grameen基金会l 2011年底: Grameen基金会把全部责任移交给开源社区。l 2012:Mifos X平台开始。之前的项目成员以开源社区小额信贷(COSM / OpenMF)的名义聚在一起l 2013年:COSM / OpenMF正式更名Mifos倡议和接收美国税法条款501 c3。2.3. 项目相关项目URL 下载 下载统计 Download stats3. 系统概览如今金融体系通过各种各样的手段向客户提供服务。l 客户可以直接打电话到分支机构(出纳员模型)l 允许客户可以组织团体(或中心)的形式，与金融体系的员工在约定时间

3、和地点开会(传统的小额信贷)。l 金融体系可能有一个公开的门面信息门户网站,客户可以使用各种原因包括账户管理(网上银行)。l 金融体系集成到一个ATM / POS /卡服务网络,客户可以使用l 金融体系可能与移动支付运营商集成和支持移动货币服务客户(现在/未来小额信贷)。l 一个金融体系可能使用的第三方代理销售其他银行/金融体系的产品/服务如上面的图表所示,各利益相关者利用业务应用程序执行特定客户或金融体系相关操作。这些业务应用程序中包含的功能可以以任何方式捆绑打包。在图中,几个应用程序可以组合成一个应用程序或任何一块代表一个应用程序可以根据需要进一步分解。该平台是管理信息系统的核心引擎。它隐

4、藏了很多存在的复杂的金融体系中的管理信息系统所需的业务和技术领域背后的一个相对简单的API。这个API,使应用程序开发人员按金融体系他们需要的那样进行创新和开发一般或定制的应用程序。4. 功能概览作为平台的所有功能都通过一个API,该API文档是最好的地方来查看该平台是做什么的详细分解。看到网上API文档。/api-docs/apiLive.htm通过更高的级别上我们看到的功能分为以下几类:l 基础构件 规范 扩展数据表 报表l 用户管理 用户 角色 权限l 机构模型 机构 职员 货币l 产品配置 手续费 贷款产品 存款产品l 客户资料 了解你的客户

5、l 投资组合管理 贷款账户 存款帐户 顾客/团体l 总帐账户管理 会计科目表 总帐5. 技术 Java 7: JAX-RS 1.0: using Jersey (1.17.x) JSON using Google GSON Spring I/O Platform: http:/spring.io/platform o Spring Frameworko Spring Securityo Spring Data (JPA) backed by Hibernate MySQL: 5.1. 主要的技术5.1.1. RESTful API该平台通过practically-RESTful API公开其所

6、有功能,通信使用JSON。我们使用术语practically-RESTful为了使其清楚我们不是去依从完整的REST，但仍然保持重要的基于REST的属性:l 无状态:平台维护没有会话或基于会话的状态。这样做的结果是轻松扩展能力水平。l 面向资源:API是集中在一组资源通过使用HTTP的词汇和约定例如GET、PUT、POST、DELETE， HTTP状态代码。以达到为客户端提供一个简单的和一致的API。看到网上API文档的更多细节。/api-docs/apiLive.htm5.1.2. 多租户技术mifos平台开发支持多租户设计的核心。这意味着它是易于

7、使用的软件即服务(SaaS)的平台型产品,因为它是为本地安装。平台使用一个方法隔离金融体系数据库/数据/模式(见单独的数据库和共享数据库,单独的模式5.1.3. 可扩展同时每个租户将有一组核心表,表平台可以扩展以不同的方式为每个租户通过使用数据表的功能。5.1.4. 读写分离我们分离写命令(修改数据)和查询(读取数据)。为什么?有很多原因选择这种方法,目前不是一个尝试全面的CQRS。目前的主要优点是:l 状态改变命令持续提供审计的状态改变。l 用于支持maker-checker的一般方法。l 状态改变命令使用面向对象模式(因此ORM)，而查询可以保持为数据模式。5.1.5. 四眼原则也称为四眼

8、原则。使应用程序能够支持maker-checker风格工作流过程。命令,通过验证将被持久化。Maker-checker在细粒度级别可以启用/禁用任何状态变化的API。5.1.6. 良好的权限控制细粒度的权限与每个API。管理员有细粒度的控制权什么角色或用户访问权。6. 代码打包意图是使平台代码以垂直切分的方式(而不是层)打包。源代码在这里 mifosng-provider/src/main/java/org/mifosplatformorg.mifosplatform. accounting useradministration infrastructure portfolio o charg

9、eo cliento fundo loanaccount accounting在每一个垂直部分是一些常见的包装结构:org.mifosplatform.useradministration. api - XXXApiResource.java - REST api实现文件 handler - XXXCommandHandler.java -具体处理程序调用 service -包含读+写服务功能区 domain - OO概念功能区域 data - 数据区域的概念 serialization -为功能区域转换API JSON 7. 设计概览注意:通过实现平台的代码来处理命令处理程序同时支持make

10、r-checker和授权检查目前有点复杂的,一个领域类针对性进行清理,让新平台的开发人员更容易入门。同时以下内容用于解释其工作原理。考虑上图所示的例子为用户资源。1. 查询:GET /用户2. HTTPS API: retrieveAll 方法 org.mifosplatform.useradministration.api.UsersApiResource调用3. UsersApiResource.retrieveAll：检查用户访问该资源的权限数据4. UsersApiResource.retrieveAll: 使用read service来获取所有用户数据(read service执行简

11、单的SQL使用JDBC查询数据库)5. UsersApiResource.retrieveAll: 返回的数据转换成JSON响应命令:POST /users (注:数据在请求body中)HTTPS API: create方法在org.mifosplatform.useradministration.api.UsersApiResource中被调用POSTConsumes( MediaType.APPLICATION_JSON )Produces( MediaType.APPLICATION_JSON )public String create(final String apiRequestBo

12、dyAsJson) final CommandWrapper commandRequest = new CommandWrapperBuilder() / .createUser() / .withJson(apiRequestBodyAsJson) / .build(); final CommandProcessingResult result = mandsSourceWritePlatformService.logCommandSource(commandRequest); return this.toApiJsonSerializer.serialize(result);描述:创建一个

13、CommandWrapper对象表示这个create user命令和JSON请求主体。交给PortfolioCommandSourceWritePlatformService.logCommandSource进行处理。Overridepublic CommandProcessingResult logCommandSource(final CommandWrapper wrapper) boolean isApprovedByChecker = false; / check if is update of own account details if (wrapper.isUpdateOfOw

14、nUserDetails(this.context.authenticatedUser().getId() / then allow this operation to proceed. / maker checker doesnt mean anything here. isApprovedByChecker = true; / set to true in case permissions have / been maker-checker enabled by / accident. else / if not user changing their own details - chec

15、k user has / permission to perform specific task. this.context.authenticatedUser().validateHasPermissionTo(wrapper.getTaskPermissionName(); validateIsUpdateAllowed(); final String json = wrapper.getJson(); CommandProcessingResult result = null; try final JsonElement parsedCommand = this.fromApiJsonH

16、elper.parse(json); final JsonCommand command = JsonCommand.from(json, parsedCommand, this.fromApiJsonHelper, wrapper.getEntityName(), wrapper.getEntityId(), wrapper.getSubentityId(), wrapper.getGroupId(), wrapper.getClientId(), wrapper.getLoanId(), wrapper.getSavingsId(), wrapper.getCodeId(), wrappe

17、r.getSupportedEntityType(), wrapper.getSupportedEntityId(), wrapper.getTransactionId(), wrapper.getHref(), wrapper.getProductId(); result = cessAndLogCommandScessAndLogCommand(wrapper, command, isApprovedByChecker); catch (final RollbackTransactionAsCommandIsNotApprovedByCheckerExc

18、eption e) result = cessAndLogCommandService.logCommand(e.getCommandSourceResult(); return result;描述:检查用户允许此操作。如果好,)解析json请求的身体,b)创建一个JsonCommand对象包装命令细节,c)使用CommandProcessingService处理命令。注意:如果出现RollbackTransactionAsCommandIsNotApprovedByCheckerException。最初的事务将被打掉,我们只有日志条目的命令审计表中设置其状态为“等待”。Tra

19、nsactionalOverridepublic CommandProcessingResult processAndLogCommand(final CommandWrapper wrapper, final JsonCommand command, final boolean isApprovedByChecker) final boolean rollbackTransaction = this.configurationDomainService.isMakerCheckerEnabledForTask(wrapper.taskPermissionName() & !isApprove

20、dByChecker; final NewCommandSourceHandler handler = findCommandHandler(wrapper); final CommandProcessingResult result = cessCommand(command); final AppUser maker = this.context.authenticatedUser(); CommandSource commandSourceResult = null; if (mandId() != null) commandSourceResult = mandS

21、ourceRepository.findOne(mandId(); commandSourceResult.markAsChecked(maker, DateTime.now(); else commandSourceResult = CommandSource.fullEntryFrom(wrapper, command, maker); commandSourceResult.updateResourceId(result.resourceId(); commandSourceResult.updateForAudit(result.getOfficeId(), result.getGroupId(), result.getClientId(), result.getLoanId(), result.getSavingsId(), result.getProductId(); String changesOnlyJson = null; if (result.hasChanges() chan