Ledgers

Banking Booking System kept simple!

Features

Deposit Account Implementation

Simple implementation of a deposit account that supports:

Account management
- Creating a banking deposit account
- List transactions
Initiating and executing payments
- Single payment
- Future dated payments
- Periodic payments (scheduller pending)
- Bulk payments (batch and non batch)
Cash deposit (Still pending)
Statement and Balances
- Account Statement
- Trial Balances
String Customer Authentication
- Authorizing payment initiation
- Authorizing transactions listings
- Support for multiple SCA Methods
  - 1:n E-Mails
  - 1:n mobile phones

Double Entry Accounting : Ledgers Posting

This is simple implementation of the double entry accounting with some additional features like:

Classical functionality of an accounting module
- Journaling of Transactions
- Account Balance Inquiry
- Account Statement Reporting
Some innovative accounting functionalities
- Read only journal entries
- No down time for time based closing operations (day, month, year)
- Asynchronous balance computation for parallel processing of journal entries
- Detaching processing time and entry effective time, allowing the storage of future and/or passt transactions
Some technical innovations
- Securing integrity of entries using hash chains
- Spring based JPA module embedding for transactional integrity
- Allowing the horizontal partitioning of the module using eventual consistency techniques
- Allowing the vertical partitioning (time based) of entries to increase the throughput of parallel write operations

Configuration

The deposit account module needs a chart of account. You can find a sample chart of account at: Sample Chart Of Accounts

Dumy SCA and User Management

We provide a sample SCA and user management application no to be used in a productive environment.

Middleware Module

This is a sort of online banking application exposes the deposit account functionality to an online environment enabling the following workflow:

Create deposit accounts
Create banking users
Initiate Payments
Check balances
Read payment transactions

This is a sample test data file for the deposit account Sample Test Data

Who we are

adorsys is a company who works ever since the very beginning of PSD2 with its requirements and implicit tasks. We help banks to be PSD2 complaint (technical and legal terms). To speed up the process we provide this open source XS2A interface, specified by Berlin Group, that can be connected to your middleware system. You can check your readiness for PSD2 Compliance and other information via our Web-site.

Getting Started

See below for a short technical introduction of the module. More to find in These instructions. The instruction below will surely get you a copy of the project up and running on your local machine for development and testing purposes.

Dependencies

Ledgers is heavily dependents on spring for now. We are still working on a more inclusive dependency management.

Building and Running

    > git clone https://github.com/adorsys/ledgers.git
    > cd ledgers
    > mvn clean install
    > cd ledgers-app
    > mvn spring-boot:run -Dspring.profiles.active=h2

This will start the ledgers app with the embedded h2 database.

Visiting the API

http://localhost:8088/swagger-ui.html

Visiting the Database

when started with the h2 profile, you can use the web browser to visit database tables on the url http://localhost:8088/h2-console/ . make sure you use the following connection properties:

Driver Class : org.h2.Driver JDBC URL: jdbc:h2:mem:ledgers User Name: sa Password: sa

Press Connect button and you can explore the data model.

Module structure

We user Spring dependencies to assemble module. Each module contains following dependency management artefact.

The ledgers application is built to be fully extensible and embeddable into other JPA applixations.

Artifact	Description
`@EnableModuleName`	Annotation used to select an implementation module among alternatives. This will generally be dropped on a Spring Application class.
`@ModuleNameConfiguration`	Main spring configuration class for the module. Might include other modules, scan entities, initialize resources.
`@ModuleNameBasePackage`	Marker class used to document package scanning for a module. We will generally me stuff like: `@ComponentScan(basePackageClasses = DepositAccountServiceBasePackage.class)`. The package of this call must allow for scanning of all spring components in the module.

You can easily use features by adding following annotations to your spring @Configuration class:

Annotation	Description
`@EnableDepositAccountService`	Enables the deposit account service module.
`@EnableLedgersMiddlewareRest`	Enables the the Ledger middleware rest application.
`@EnableLedgersMiddlewareService`	Enables the Ledger middleware service.
`@EnablePostingService`	Enables the postings service module.
`@EnableSCAService`	Enables The SCA service module
`@EnableUserManagementService`	Enables the a user management service

Following JPA module are automatically included in the corresponding service modules so they generally do not need to be considered while assembling modules.

Annotation	Description
`@EnableDepositAccountRepository`	Enables the deposit account JPA module.
`@EnablePostingsReporitory`	Enables the ledgers posting repository module.
`@EnableSCARepository`	Enables the sca repository module
`@EnableUserManagmentRepository`	Enables a user management module.

Brief architecture documentation

Available in the documentation

Deployment

Dockerfiles will be provided to allow to put the build artifacts into a docker images. Not available for now.

More details see in instruction

Built With

Java, version 17 - The main language of implementation
Maven, version 3.0 - Dependency Management
Spring Boot - Spring boot as core Java framework

Development and contributing

Please read CONTRIBUTING for details on our code of conduct, and the process for submitting pull requests to us.

Release notes

Release notes

Roadmap

Roadmap - The up-to-date project's roadmap

Authors

Francis Pouatcha - Initial work - adorsys

See also the list of contributors who participated in this project.

adorsys / ledgers

readme