Metadata-Version: 2.1
Name: abrechnung
Version: 0.9.0
Summary: Abrechnung - feature complete payment management and bookkeeping.
Author-email: Michael Loipführer <milo@sft.lol>, Jonas Jelten <jj@sft.lol>, Michael Enßlin <mic@sft.lol>
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Development Status :: 5 - Production/Stable
Requires-Dist: aiohttp~=3.8
Requires-Dist: aiohttp-cors~=0.7
Requires-Dist: asyncpg~=0.24
Requires-Dist: bcrypt~=3.2
Requires-Dist: pyjwt~=2.2
Requires-Dist: PyYAML~=5.3
Requires-Dist: marshmallow~=3.14
Requires-Dist: schema
Requires-Dist: email-validator~=1.1
Requires-Dist: apispec
Requires-Dist: webargs
Requires-Dist: black ; extra == "dev"
Requires-Dist: mypy~=0.930 ; extra == "dev"
Requires-Dist: types-PyYAML~=5.4 ; extra == "dev"
Requires-Dist: pylint~=2.12 ; extra == "dev"
Requires-Dist: sphinx ; extra == "docs"
Requires-Dist: sphinx-autobuild ; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints ; extra == "docs"
Requires-Dist: aiosmtpd~=1.4 ; extra == "test"
Requires-Dist: pytest ; extra == "test"
Requires-Dist: pytest-cov ; extra == "test"
Project-URL: Documentation, https://abrechnung.readthedocs.io
Project-URL: Source, https://github.com/SFTtech/abrechung
Provides-Extra: dev
Provides-Extra: docs
Provides-Extra: test

# Abrechnung

[![GitHub Actions Status](https://github.com/SFTtech/abrechnung/actions/workflows/ci_testing.yaml/badge.svg)](https://github.com/SFTtech/abrechnung/actions/workflows/ci_testing.yaml)

The *Abrechnung* (German for *reckoning*, *settlement*, *revenge*) aims to be a versatile and user-centric **payment**, **transaction** and **bookkeeping** management tool for human groups and events.

>>> You can simply **try** our [**demo instance**](https://demo.abrechnung.sft.lol)!


Abrechnung is a tool to track *money*, *purchases* (and its items) and *debtors* for:

Group life | Events | Travelling
-|-|-
Flat share roommates | Cooking revelries | Holiday trips
Your Hackerspace | LAN parties | Business trips
Family life | Regular parties | Adventures
... | ... | ...


---

All this is possible through the **basic blocks**:

* Purchase & transaction tracking
* Accounts with balance compensation
* Invoice handling + optional position specification
* Assignment (by fractions or counts) of positions and invoices
* Clearing accounts for merging transactions
* Multitenant access


## Documentation

To help you set up your instance or understand the inner workings:

**[Read the documentation!](https://abrechnung.readthedocs.io)**


## Technical foundation

Technology        | Component
------------------|----------
**Python**        | Backend logic
**React**         | Web UI framework
**PostgresSQL**   | Database
**Homo Sapiens**  | Magic sauce


## Contributing

If there is **that feature** you really want to see implemented, you found a **bug** or would like to help in some other way, the project of course benefits from your contributions!

* [Contribution guide](https://abrechnung.readthedocs.io/en/latest/development/contributing.html)
* [Issue tracker](https://github.com/SFTtech/abrechnung/issues)
* [Code contributions](https://github.com/SFTtech/abrechnung/pulls)
* [Development roadmap](https://github.com/SFTtech/abrechnung/projects)


## Contact

To directly reach developers and other users, we have chat rooms.
For questions, suggestions, problem support, please join and just ask!

Contact          | Where?
-----------------|-------
Issue Tracker    | [SFTtech/abrechnung](https://github.com/SFTtech/abrechnung/issues)
Matrix Chat      | [`#sfttech:matrix.org`](https://app.element.io/#/room/#sfttech:matrix.org)
Support us       | [![money sink](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/SFTtech)


## License

Released under the **GNU Affero General Public License** version 3 or later, see [COPYING](COPYING)
and [LICENSE](LICENSE) for details.

