https://github.com/cuba-platform/sample-akkount

A simple personal finance application (outdated, see https://github.com/cuba-platform/sample-akkount-cuba7 for the latest version)
https://github.com/cuba-platform/sample-akkount

cuba-sample

Last synced: about 1 month ago
JSON representation

A simple personal finance application (outdated, see https://github.com/cuba-platform/sample-akkount-cuba7 for the latest version)

• Host: GitHub
• URL: https://github.com/cuba-platform/sample-akkount
• Owner: cuba-platform
• Created: 2016-04-01T09:58:45.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2020-01-06T09:48:32.000Z (almost 5 years ago)
• Last Synced: 2024-04-15T02:04:37.424Z (9 months ago)
• Topics: cuba-sample
• Language: Java
• Homepage:
• Size: 806 KB
• Stars: 5
• Watchers: 6
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
**ATTENTION! This sample is built for outdated platform version. See [sample-akkount-cuba7](https://github.com/cuba-platform/sample-akkount-cuba7) for the latest version.**

Akkount

=======

This is a simple real-world application for managing personal finances. It contains some non-trivial code examples, such as customization of a visual component with client-side JavaScript code and an additional lightweight web UI for mobile devices.

Based on CUBA Platform 6.10.2

Features

--------

In short, the application solves two problems:

 1. It shows the current balance by all accounts: cash, credit cards, deposits, debts, etc.

 2. It can generate a report by expense and income categories that shows where the money came from and what they were spent on in some period of time.

Some details:

* There are _accounts_ that represent different kinds of money.

* There are _operations_: income to account, expense from account and transfer between accounts.

* A _category_ can be set for expense or income operations.

* The current balance is constantly displayed and is recalculated after each operation.

* Categories report shows the summary by two arbitrary periods of time to allow quick visual comparison. Any category can be excluded from the report. You can "drill down" into any row to see operations that comprise the row.

* The system consists of three web applications deployed onto one Tomcat instance:   

   

    - Middleware   

    - Full-functional CUBA Generic UI

    - Polymer UI for mobile devices. 

Usage

-----

- Open the project in Studio and execute **Run > Create database**, then **Run > Start application server**. 

- The application will start at `http://localhost:8080/app`. Use `admin` as both login and password to access the application. 

- You can generate test data in **Administration > JMX Console > app-core.akkount:type=SampleDataGenerator** bean. In order to create sample transactions, enter a number of days (e.g. 100) back from the current date into `generateSampleData()` method parameter and click **Invoke**. 

- After the method execution is finished, logout and login again. You will see the balance for sample accounts on the left panel.

## Issues

Please use https://www.cuba-platform.com/discuss for discussion, support, and reporting problems coressponding to this sample.