Services middleware
===================

[project] | [code] | [tracker] | *snippets*

A middleware application for managing private, account-based services,
including resource management and user-facing registration. Tailored for
*Purist services* as offered by Purism SPC, but ready to be modified and
deployed anywhere, by anyone.

[project]: https://code.puri.sm/purist/middleware
[code]: https://code.puri.sm/purist/middleware
[tracker]: https://code.puri.sm/purist/middleware/issues
[snippets]: https://code.puri.sm/purist/snippets/src/master/middleware

Installation
------------

Follows an opinionated installation process (specifically expecting
one-instance-per-server), but includes a number of configuration
options.

See [SETUP.md](SETUP.md) for prerequisites and instructions.

Usage
-----

* Start Django site as a system service, or with `./manage.py runserver`
* Visit <https://example.com> and follow the login or registration
  links.
  * If registration is closed, you will have to create LDAP credentials
    another way.
* Manage user profile at <https://example.com/accounts/profile/>

Models
------

![Database diagram generated by graph_models](models.png)

(Generated with `./manage.py graph_models --all-applications --group-models --verbose-name --output models.png`)

Sharing and contributions
-------------------------

Services middleware <br />
<https://code.puri.sm/purist/middleware> <br />
Copyright 2017-2018 Purism SPC and contributors <br />
SPDX-License-Identifier: AGPL-3.0+

Shared under AGPLv3-or-later, see [COPYING.AGPL.md](COPYING.AGPL.md)
for details. We adhere to the Contributor Covenant 1.4 without
modification, see [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for details.
Contributions under the same terms are welcome.

Contributions and license notices from other sources are listed in
[COPYING.md](COPYING.md)