Home
Softono
bill

bill

Open source MIT Crystal
11
Stars
0
Forks
0
Issues
2
Watchers
1 month
Last Commit

About bill

Accounts Receivable automation for Lucky framework

Platforms

Web Self-hosted

Languages

Crystal

Links

Bill

Bill is an Accounts Receivable automation system for Lucky framework. It includes tools for creating and tracking invoices, credit notes, receipts and more.

Bill keeps an immutable ledger of transactions from which balances can be efficiently computed. Whenever a business event occurs, a record is kept in this ledger.

Bill is designed for use cases where a self-service application charges users for products or services, or for online marketplaces where businesses charge registered users for same.

Documentation

Find the complete documentation in the docs/ directory of this repository.

Todo

  • [x] Ledger
  • [x] Invoices
  • [ ] Taxes
  • [ ] Discounts
  • [x] Credit Notes
  • [x] Receipts
  • [ ] Businesses

Development

Create a .env file:

DATABASE_URL=postgres://postgres:password@localhost:5432/bill_spec

Update the file with your own details. Then run tests with crystal spec.

Contributing

  1. Fork it
  2. Switch to the master branch: git checkout master
  3. Create your feature branch: git checkout -b my-new-feature
  4. Make your changes, updating changelog and documentation as appropriate.
  5. Commit your changes: git commit
  6. Push to the branch: git push origin my-new-feature
  7. Submit a new Pull Request against the GrottoPress:master branch.