Apache Fineract
Clone or download
ShruthiRajaram Merge pull request #454 from MexinaD/FINERACT-623
FINERACT-623 - Restriction of product mix fix
Latest commit b71ed1c Sep 26, 2018
Permalink
Failed to load latest commit information.
api-docs Two-Factor Authentication Sep 22, 2017
config Modify file contents Feb 1, 2016
docs/system-architecture Adding license text in 404.css Jun 8, 2017
fineract-db Adding Apache License Headers to sql files in fineract-db directory Jul 6, 2016
fineract-provider FINERACT-623 - Restrict of product mix fix Aug 28, 2018
licenses Added Notification Module Aug 20, 2017
.gitignore FINERACT-371 - Make gradle callable from the top level directory. Feb 16, 2017
APACHE_LICENSETEXT.md Renaming LICENSE.md to APACHE_LICENSETEXT.md Jan 6, 2017
CHANGELOG.md Updating release notes for 0.4.0-incubating Oct 17, 2016
LICENSE_RELEASE Added Notification Module Aug 20, 2017
LICENSE_SOURCE Making License & Notice with 80Col and updating build.gradle to copy … Jan 6, 2017
NOTICE_RELEASE Making License & Notice with 80Col and updating build.gradle to copy … Jan 6, 2017
NOTICE_SOURCE Sperating source and binary licenses Jan 6, 2017
README.md FINERACT-374-Add Gradle wrapper download location in readme file Feb 23, 2017
build-cloudbees.sh Adding License, Notice, Apache license to sql, sh, bat files Jun 29, 2016
build.sh Adding License, Notice, Apache license to sql, sh, bat files Jun 29, 2016
gradlew gradlew executable on linux Feb 22, 2017
gradlew.bat FINERACT-371 - Make gradle callable from the top level directory. Feb 16, 2017
release.sh Adding License, Notice, Apache license to sql, sh, bat files Jun 29, 2016
settings.gradle FINERACT-371 - Make gradle callable from the top level directory. Feb 16, 2017
travis_build.sh Adding License, Notice, Apache license to sql, sh, bat files Jun 29, 2016

README.md

Apache Fineract: A Platform for Microfinance

The next evolution of Apache Fineract focuses on being faster, lighter and cheaper to change (than the existing Mifos) so that it is more responsive to the needs of Microfinance Institutions and Integrators.

Requirements

  • Java >= 1.8 (Oracle JVMS have been tested)
  • gradle-wrapper.jar version 2.10
  • MySQL 5.5

Instructions to download gradle wrapper

By running following command, it will download the gradle wrapper from Fineract git repository and puts under fineract-provider/gradle/wrapper

wget --no-check-certificate -P fineract-provider/gradle/wrapper https://github.com/apache/incubator-fineract/raw/develop/fineract-provider/gradle/wrapper/gradle-wrapper.jar (or) curl --insecure -L https://github.com/apache/incubator-fineract/raw/develop/fineract-provider/gradle/wrapper/gradle-wrapper.jar > fineract-provider/gradle/wrapper/gradle-wrapper.jar

Instructions to run Apache RAT (Release Audit Tool)

  1. Extract the archive file to your local directory.
  2. Download gradle-wrapper.jar version 2.10 and place it in the fineract-provider/gradle/wrapper folder. See 'Instructions to download gradle wrapper' above.
  3. Run ./gradlew rat. Report will be generated under build/reports/rat/rat-report.txt

Instructions to build war file

  1. Extract the archive file to your local directory.
  2. Download gradle-wrapper.jar version 2.10 and place it in the fineract-provider/gradle/wrapper folder. See 'Instructions to download gradle wrapper' above.
  3. Run ./gradlew clean war or ./gradlew build to build deployable war file which will be created at build/libs directory.

Instructions to execute Integration tests

  1. Login to mysql DB using mysql -u root -pmysql
  2. Create the mifosplatform-tenants database using CREATE DATABASE mifosplatform-tenants.
  3. Create the default tenant database using CREATE DATABASE mifostenant-default.
  4. Download gradle-wrapper.jar version 2.10 and place it in the fineract-provider/gradle/wrapper folder. See 'Instructions to download gradle wrapper' above.
  5. Run the following commands:
    1. ./gradlew migrateTenantListDB -PdbName=mifosplatform-tenants
    2. ./gradlew migrateTenantDB -PdbName=mifostenant-default
  6. Run ./gradlew clean integrationTest

Version

The latest stable release can be viewed on the develop branch: Latest Release on Develop, View change log

License

This project is licensed under Apache License Version 2.0. See https://github.com/apache/incubator-fineract/blob/develop/LICENSE.md.

Apache Fineract Platform API

The API for the Fineract-platform (project named 'Apache Fineract') is documented in the API-docs under Full API Matrix and can be viewed here.

Online Demos

Developers

Please see https://cwiki.apache.org/confluence/display/FINERACT/Contributor%27s+Zone for the developers wiki page.

Please see https://cwiki.apache.org/confluence/display/FINERACT/How-to+articles for technical details to get started.

Roadmap

Project Release Roadmap on JIRA (Detailed View)

Video Demonstration

Apache Fineract / Mifos X Demo (November 2016) - https://www.youtube.com/watch?v=h61g9TptMBo

More Information

More details of the project can be found at https://cwiki.apache.org/confluence/display/FINERACT.