flow/treasuredb
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

added README.md file

Browse Source
This commit is contained in:
Florian "flowdy" Heß 2016-05-22 15:13:55 +02:00
parent 4ad8e8d528
commit 48d4eea2d9
1 changed files with 33 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
README.md
View File

@ -2,9 +2,8 @@ README
====== ======
TreasureDB is a plain SQLite database application to observe and trace the finances of a TreasureDB is a plain SQLite database application to observe and trace the finances of a
non-profit registered society or club. In Germany, such clubs may not accumulate reserves. non-profit registered society or club. The ideal state of balance is zero both in debit
Therefore, the ideal state of balance is zero both in debit and in credit because they even and in credit because they even out. In Germany, such clubs may not accumulate reserves.
out.
How does it work? How does it work?
----------------- -----------------
@ -16,9 +15,10 @@ another table that stores more information about the account owner, and the IBAN
bank transfers. bank transfers.
The Credit table stores bank transfers from the member to the club, and also the target The Credit table stores bank transfers from the member to the club, and also the target
records of internal transfers to the club and other members performing services for it. records of internal transfers to the club and other members performing commercial services for
The value of the former sort is initially >0 and normally not altered afterwards. The latter's the club. The value of the former sort is initially >0 and normally not altered afterwards.
value always starts at 0 and is increased by transfers linked to it. The latter's value always starts at 0 and is increased automatically by transfers linked to the
according debts.
The Debit table stores the receipts documenting a debt, their link to the credit record of the The Debit table stores the receipts documenting a debt, their link to the credit record of the
respective recipient as well as to the account from which it is paid. respective recipient as well as to the account from which it is paid.
@ -26,7 +26,8 @@ respective recipient as well as to the account from which it is paid.
The Transfer stores when which amount is transferred from which credit record to settle which debt. The Transfer stores when which amount is transferred from which credit record to settle which debt.
So, a debt can be associated with n source credits, and a souce credit can settle multiple debts. So, a debt can be associated with n source credits, and a souce credit can settle multiple debts.
Transfers cannot be altered once inserted, they need to be revoked and re-entered. This is due to Transfers cannot be altered once inserted, they need to be revoked and re-entered. This is due to
triggers that have to rerun. triggers that have to rebalance the involved accounts. Whenever the view Balance contains positive
values for both credit and debt in a line, this indicates transfers yet to be entered.
Installation Installation
@ -36,7 +37,29 @@ As it is a SQLite3 database with all consistency and calculatory logic built in,
need the `sqlite3` binary or any sqlite3 GUI software to run it. need the `sqlite3` binary or any sqlite3 GUI software to run it.
1. Ensure sqlite3 is installed 1. Ensure sqlite3 is installed
1. Run the test suite: `bash schema.t.sh` (on Linux and unix systems)
1. Setup the database: `sqlite3 treasure.db < schema.sql`
1. Study the files to learn how to work with the system: `less schema.*`
1. Run the test suite: `bash schema.t.sh` (on Linux and unix systems)
# Or go by foot and test manually a little bit further
treasuredb $ sqlite3
SQLite version 3.8.7.1 2014-10-29 13:59:56
Enter ".help" for usage hints.
Connected to a transient in-memory database.
Use ".open FILENAME" to reopen on a persistent database.
sqlite> .read schema.sql
sqlite> .read schema.t.sql
...
1. Setup the database: `sqlite3 treasure.db < schema.sql`
1. Study the files to learn how to work with the system: `less schema.sql schema.t.???`
License
-------
Copyright (c) 2016, Florian Heß
All rights reserved.
(cf. file LICENSE that contains the BSD 3-clause revised license.)