Bloctree

$ npm install -g bloctree
$ bloctree new newBlock
$ cd newBlock
$ bloctree about

(Bloctree : org administration) AS (Docker : app environment)

Bloctree = containerization of project administration. Just like you would run git init or rails new when starting a new codebase, you can run bloctree new to create a project administration folder.

The folder represents the (project|company|organization|division) and contains all of its administrative data (books, accounts, legal documents, ideology, processes, etc.). The Bloctree software is your interface between the data.

All files are human-readable. This is for both transparency and to make it easier to track changes over time.

Updating

To migrate your Bloctree to a new version, after updating the Bloctree software, run bloctree migrate. Adding -v 0.0.0 will specify the version to migrate to.

Accounting books

# New account:
$ bloctree new:account [name] [category]
$ bloctree new:account receivables assets/current

# Record a transaction:
$ bloctree record [transaction] [amount]
$ bloctree record expense 155.12 -m "Wireless keyboard"
$ bloctree record sale 120 -m "2 billable hours"

# Record separate entries:
$ bloctree new:entry [account] [--debit <amt>] [--credit <amt>]
$ bloctree new:entry receivable -d 800 -m "Rent payment"
$ bloctree new:entry sales -c 800 -m "Rent payment"

# Build a balance sheet:
$ bloctree get:balance

Double-entry bookkeeping

Each transaction must debit an account and credit another account in an equal amount.

| | Debit | Credit | |-------------|-----------|------------| | Asset | Increase | Decrease | | Liability | Decrease | Increase | | Revenue | Decrease | Increase | | Expense | Increase | Decrease | | Equity | Decrease | Increase |

Folder structure

books
├── assets
│   ├── 100-cash.tsv
│   └── 101-accounts_receivable.tsv
├── liabilities
│   ├── 200-accounts_payable.tsv
│   └── 201-credit.tsv
├── equity
│   ├── 300-contributed_capital.tsv
│   ├── revenues
│   │   └── 400-revenues.tsv
│   └── expenses
│       └── 600-expenses.tsv
└── config.json

Account numbers

| Range | Type of Account | |---------|---------------------| | 100-199 | Assets | | 200-299 | Liabilities | | 300-399 | Owner's Equity | | 400-499 | Revenues | | 500-599 | Costs of Goods Sold | | 600-699 | Expenses |