DjaoDjin-SaaS
djaodjin-saas is a Django application that implements the logic to support subscription-based Software-as-a-Service businesses.
Major Features:
- Separate billing profiles and authenticated users
- Double entry book keeping ledger
- Flexible security framework
This project contains bare bone templates which are compatible with Django and Jinja2 template engines. To see djaodjin-saas in action as part of a full-fledged subscription-based session proxy, take a look at djaoapp.
Full documentation for the project is available at Read-the-Docs
Development
After cloning the repository, create a virtualenv environment and install the prerequisites:
$ python -m venv .venv
$ source .venv/bin/activate
$ pip install -r testsite/requirements.txt
# Installs Javascript prerequisites to run in the browser
$ make vendor-assets-prerequisites
To use the testsite, you will need to add the payment processor keys (see Processor Backends) and Django secret key into a credentials file. Example with Stripe:
$ cat ./credentials
SECRET_KEY = "enough_random_data"
STRIPE_PUB_KEY = "your_stripe_public_api_key"
STRIPE_PRIV_KEY = "your_stripe_private_api_key"
It remains to create and populate the database with required objects.
$ python ./manage.py migrate --run-syncdb --noinput
$ python ./manage.py loaddata testsite/fixtures/initial_data.json
$ python ./manage.py createsuperuser
You can further generate a set of dummy data data to populate the site.
$ python ./manage.py load_test_transactions
Side note: If create your own fixtures file (ex: testsite/fixtures/test_data.json) and attempt to load them with a Django version before 2 while the Python executable was linked with a SQLite version after 3.25, you might stumble upon the well-known SQLite 3.26 breaks database migration ForeignKey constraint, leaving <table_name>__old in db schema bug. Your best bet is to use Django2+ or delete the migrations/ directory.
If all is well then, you are ready to run the server and browse the testsite.
$ python manage.py runserver
# Browse http://localhost:8000/
Implementation Notes
The latest versions of django-restframework (>=3.0) implement paginators
disconnected from parameters in views (i.e. no more paginate_by). You will
thus need to define PAGE_SIZE in your settings.py
$ diff testsite/settings.py
+REST_FRAMEWORK = {
+ 'PAGE_SIZE': 25,
+ 'DEFAULT_PAGINATION_CLASS':
+ 'rest_framework.pagination.PageNumberPagination',
+}
This Django App does not send notification e-mails itself. All major updates that would result in a e-mail sent trigger signals though. It is straightforward to send e-mails on a signal trigger in the main Django project. We provide sample e-mail templates here in the saas/templates/notification/ directory.
Release Notes
Tested with
- Python: 3.12, Django: 5.2 (LTS)
- Python: 3.14, Django: 6.0 (next)
- Python: 3.10, Django: 4.2 (legacy)
- Python: 3.9, Django: 3.2 (legacy)
1.3.1
- enables webpack builds on case-sensitive filesystems
- generates profile page form fields for JSON filed target keys automatically
- enables search/order all models based on a target key in a JSON field
- enables profile primary address to be an e-mail or e-mail domain
- adds search button in dashboard
- fixes re-send e-mail receipt
1 maintainer
Metadata
1 maintainer
Release files for djaodjin-saas 1.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| djaodjin_saas-1.3.1.tar.gz | 334.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| djaodjin_saas-1.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 819.1 kB
Release files / djaodjin_saas-1.3.1.tar.gz
| Download URL | djaodjin_saas-1.3.1.tar.gz |
|---|---|
| Size | 334.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4785b62fffaebbd12b31bb7538e8f3b784033f24e1137e5c5c29c3fe01617424
|
|
BLAKE2b-256 checksum How to use checksums |
0f74cc8536b25c24df9b16cab3df25db317c36e1c62090f7343b6ce1cf2ee6fd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.7
|
Release files / djaodjin_saas-1.3.1-py3-none-any.whl
| Download URL | djaodjin_saas-1.3.1-py3-none-any.whl |
|---|---|
| Size | 484.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
95b4802588edc752f16cfa4be940ba36e4f04e3f37236c0557c1464321346c7b
|
|
BLAKE2b-256 checksum How to use checksums |
3f1eddb77789c0ceec55983c68d4a591f38e6552ab04932776df74a139bd7b94
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.7
|
