Key Design Principles


Mifos X Software Platform (simply “the Platform”) is built around a multitenant, service oriented, and tiered architecture, and can be deployed in a SaaS (Software as a Service) model or on-premises.

All design decisions should follow these principles:

  • Keep it simple and stupid.
  • Make it for a reason.
  • Make it to last.
  • Make it sustainable. Downtime is key to productivity.
  • Enable others.  I'm expendable and vulnerable.

The foundation forms a robust but flexible data model which is ready-made for extensions and customizations. An API provides access to all basic functions grouped in modules.

Because the Platform needs to be accessible to users at remote locations, a browser-based solution was essential.

Java was selected as a suitable high level language allowing the rapid customization of code required for each individual circumstance yet has a large number of powerful libraries available.

On this page:

Mifos X Financial Service Engine

The Mifos X Financial Service Engine (simply “the Engine”) is a scalable and extensible framework written in Java, and licensed under the Mozilla Public License 2.0.

The main design principle of the Engine is CQRS (Command Query Responsibility Segregation), a pattern that separates commands and queries into different models and services. This approach has multiple benefits: 1) State changes (commands) are persisted, providing an audit of all changes, 2) fine grained control and extension of state changes, and 3) scalability based on consumer behavior and real system load.

Based on a tiered architecture the Engine provides multiple layers to separate concerns and allow reusability.

API Layer

The API Layer is built entirely as a RESTful Webservice, using JSON to transmit data, and utilizes standard HTTP Methods for interactions.

The main components of this layer are:

  • Resources
    • Every module is exposed via an URI (Unique Resource Identifier).
  • Access Control
    • Early exit if a consumer lacks authorization for a queried Resource.
  • Data marshalling
    • Any data transmitted to and from the API is de-/serialized using JSON.

The API is exposed via HTTPS to encrypt all data and secure the communication. OAuth2 is used for authorization.

Stateless by nature the API Layer can be scaled based on the actual load and even used in high availability scenarios.

Service Layer

The Service Layer provides module specific business logic and rules, role based access control and a xBRL compliant reporting engine. Transaction awareness and data validity is encapsulated, and extension points (i.e. A basic rule for building modular software systems) are available to enhance built-in workflows.

Cross concerns like Security or Transactions are part of the core framework and provided via AOP (Aspect Oriented Programming).
The Service Layer has horizontal and vertical layers.

Services, command, and event handlers form horizontal layers; functional modules form vertical layers.

Data Layer

The Data Layer provides module specific access to data stores. Data integrity is reached by using the ACID principal and well defined data relations. Write and read operations are encapsulated in different repositories to define a clean responsibility separation. 

The Data Layer uses two cache strategies to cache data efficiently; database and 2nd level caching.

  • Database caching stores records on the database level and is useful for reporting, batch jobs, and low level SQL queries.
  • 2nd Level caching stores data objects on the application level and keeps database turnarounds on a very low level allowing fast in-memory access of frequent data.


The Engine’s architecture was designed with a focus on modern, scalable and extensible technologies ready to run in the cloud. All components where selected based on their maturity, proven reliability and cost efficiency.

It is our goal to provide a software that is deployable with effectively no cost that can grow with the customer need over time using well known best practices and support from a wide range of communities.
The basic Mifos X Financial Service Engine architecture is as follows:

Operating SystemLinux , Windows, Mac OSAmazon AWS image and Debian package available
RuntimeJava 7.x
Application ServerTomcat 7.xEmbedded Tomcat for development environments
DatabaseMySQL 5.xEmbedded MariaDB for development environments
Application FrameworkSpring Framework 4.x
Persistence FrameworkHibernate 4.x
Reporting EnginePentaho Reporting Engine 3.x
Test FrameworkJUnit 4.x 
Mockito 1.x
REST-assured 2.x

Mifos X Community App

Mifos X Community App (simply “the Community App”) is a browser based Single Page Application (SPA) built entirely with HTML, JavaScript and CSS. Resources are loaded dynamically and added to the page as necessary.

All user interactions,  workflows, and application logic is taking place in the browser and does not create load on the Engine. Ajax is used to send data to and receive data from the Engine asynchronous, and bidirectional model binding update views automatically.

Based on AngularJS the Community App is built on the MVC (Model-View-Controller) pattern and uses templates to render dynamic content. To provide a responsive and modern look and feel Bootstrap is part of the application stack.

The basic Mifos X Community App components are as follows:

Application FrameworkAngularJS 1.x
Dependency ManagementBower 1.x
Module ManagementRequireJS 2.x
Chart LibraryD3 3.x
Look and FeelBootstrap 3.x
Test FrameworkJasmine 1.x