Metadata-Version: 2.1
Name: abrechnung
Version: 0.7.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** aims to be a versatile and user-centric payment, transaction and bookkeeping management tool for human groups and events.

You can find a demo instance [here](https://demo.abrechnung.sft.lol).

Basic features:

* Multitenant access
* Expense tracking
* Invoice handling + optional position specification
* Assignment (by fractions or counts) of positions and invoices
* Account balance compensation
* Clearing accounts

In other words, it's a tool to track *money*, *purchases* (and its items) and *entities* for:
* Holiday trips
* LAN parties
* Regular parties
* Cooking revelries
* Your Hackerspace
* Flat share roommates
* Accommodations with your friends
* Accommodations with your enemies
* Your family life
* Any event (even life itself)


## Documentation

[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)
IRC Chat         | [`libera.chat #sfttech`](https://web.libera.chat/#sfttech)
Money Sink       | [![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.

