Skip to content

A bookkeeping & financial analysis engine for the Django Framework. UNDER ACTIVE DEVELOPMENT & NOT STABLE YET.

License

Notifications You must be signed in to change notification settings

cdonca/django-ledger

 
 

Repository files navigation

django ledger logo

A Bookkeeping & Financial Analysis Engine for the Django Framework.

Django Ledger supports:

  • Chart of Accounts.
  • Financial Statements (Income Statement & Balance Sheets).
  • Automatic financial ratio & insight calculations.
  • Multi tenancy (multiple users/clients).
  • Hierarchical entity management (for consolidated financial statements - v0.9).
  • Self-contained Ledgers, Journal Entries & Transactions.
  • Basic OFX & QFX file import.
  • Bills & Invoices with optional accruable functionality.
  • Basic navigational templates.
  • Entity administration & entity manager support.
  • Items, lists & inventory management.
  • Bank Accounts.

WARNING: Currently this project is under active development, it is not stable and is not recommended for production environments. Due to its high complexity, breaking changes may occur in future releases and migration backwards compatibility may not be preserved until the first stable release. The author is actively working to provide a stable release as soon as possible and to incorporate the following functionality:

High Level Road Map

  • Cash flow statement.
  • Entity Nesting and Corporate Structures.
  • Tax line mapping.
  • Package documentation.
  • Collaborators & Permissions.
  • API Implementation.
  • Unit Tests & Behavior Driven Development Tests.
  • And a lot more stuff...

For more details please check our full v1.0 Roadmap.

Want to contribute?

This project is actively looking for contributors. Any financial and/or accounting experience is a big plus. If you have prior accounting experience and want to contribute, don't hesitate to contact me. See contribution guidelines.

Quick Start

Django Ledger comes with a default CoA ready to use or you could use your own. Make sure to select the appropriate option when creating new entities.

  • Install Django Ledger
pip install git+https://github.com/arrobalytics/django-ledger.git
  • Or with pipenv:
pipenv install git+https://github.com/arrobalytics/django-ledger.git
  • Add django_ledger to INSTALLED_APPS
INSTALLED_APPS = [
    ...,
    'django_ledger',
    ...,
]
  • Add URLs to your project:
from django.urls import include, path

urlpatterns = [
    ...,
    path('ledger/', include('django_ledger.urls', namespace='django_ledger')),
    ...,
]

Screenshots

django ledger entity dashboard django ledger balance sheet django ledger income statement django ledger bill django ledger invoice

About

A bookkeeping & financial analysis engine for the Django Framework. UNDER ACTIVE DEVELOPMENT & NOT STABLE YET.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 66.7%
  • HTML 30.9%
  • TypeScript 2.0%
  • Other 0.4%