Tax System module for AllianceAuth.

Release Licence Python Django

A Tax System for Corporation to Monitor Payments like Renting Tax, etc.

Features
Upcoming
Screenshots
Installation
Documentation
Translations
Contributing

Features

Multi-Owner Support: Manage both Corporations and Alliances
Corporation & Alliance Tax System
- Statistics
  - Owner Information
  - Payments
  - Tax Accounts
  - Division Information
  - Update Status
- Member Tracking
  - Check Member is registered in Auth
  - Check Member is Alt Char
  - Report members as missing if they leave the corporation/alliance
- Payment System
  - Allocate User from Member Tracking
  - Automatic Payment Tracking
  - Automatic Payment Approval via Filters
  - Filtering Amount, Reason, Date
- Payments
  - Track Payments that meets filters
  - Manual approval workflow for unfiltered payments
- Log System
  - Logs Actions from Administration Section
  - Payment history tracking
- Notification
  - Discord Notification

Upcoming

Data export functionality

Screenshots

Image: administration Image: adminhistory Image: payments Image: filters Image: paymentdetails

Installation

Step 1 - Install the Package

Make sure you're in your virtual environment (venv) of your Alliance Auth then install the pakage.

pip install aa-taxsystem

Step 2 - Configure Alliance Auth

Configure your Alliance Auth settings (local.py) as follows:

Add 'taxsystem', to INSTALLED_APPS

Step 3 - Add the Scheduled Tasks

To set up the Scheduled Tasks add following code to your local.py

CELERYBEAT_SCHEDULE["AA Taxsystem :: Update All Tax System"] = {
    "task": "taxsystem.tasks.update_all_taxsytem",
    "schedule": 1800,
}
CELERYBEAT_SCHEDULE["AA Taxsystem :: Sent out Notification"] = {
    "task": "taxsystem.tasks.check_account_deposit",
    "schedule": crontab(minute="0", hour="12"),
}

Step 3.1 - (Optional) Add own Logger File

To set up the Logger add following code to your local.py Ensure that you have writing permission in logs folder.

LOGGING["handlers"]["taxsystem_file"] = {
    "level": "INFO",
    "class": "logging.handlers.RotatingFileHandler",
    "filename": os.path.join(BASE_DIR, "log/taxsystem.log"),
    "formatter": "verbose",
    "maxBytes": 1024 * 1024 * 5,
    "backupCount": 5,
}
LOGGING["loggers"]["extensions.taxsystem"] = {
    "handlers": ["taxsystem_file", "console", "extension_file"],
    "level": "DEBUG",
}

Step 4 - Migration to AA

python manage.py collectstatic
python manage.py migrate

Step 5 - Setting up Permissions

With the Following IDs you can set up the permissions for the Tax System

ID	Description
`basic_access`	Can access the Tax System module	All Members with the Permission can access the Tax System.
`create_access`	Can add Corporation/Alliance	Users with this permission can add corporations and alliances.
`manage_own_corp`	Can manage own Corporation	Users with this permission can manage own corporation.
`manage_corps`	Can manage all Corporations	Users with this permission can manage all corporations.
`manage_own_alliance`	Can manage own Alliance	Users with this permission can manage own alliance.
`manage_alliances`	Can manage all Alliances	Users with this permission can manage all alliances.

Step 6 - (Optional) Setting up Compatibilies

The Following Settings can be setting up in the local.py

TAXSYSTEM_APP_NAME: "YOURNAME" - Set the name of the APP
TAXSYSTEM_BULK_BATCH_SIZE: 500 - Maximum database batch size per operation. Reduce (e.g., 250) if encountering 'max_allowed_packet' errors, increase for better performance if MySQL is configured with higher limits Advanced Settings: Stale Status for Each Section
TAXSYSTEM_STALE_TYPES = { "wallet": 60, "divisions": 60, "division_names": 60, "members": 60, "payments": 60, "tax_accounts":60, "deadlines": 1440 } - Defines the stale status duration (in minutes) for each section.
TAXSYSTEM_NOTIFICATION_EXPIRATION_DAYS = 1 - The maximum number of days after which a notification expires and the system resends it.

Documentation

For detailed information on how to use the Tax System, please refer to our comprehensive User Manual.

The manual covers:

Getting started with the Tax System
Adding Corporations and Alliances
Payment System functionality
Filter configuration
Account management
Administration features
FAQ and troubleshooting

Translations

Help us translate this app into your language or improve existing translations. Join our team!"

Contributing

You want to improve the project? Please ensure you read the contribution guidelines

Metadata

Release files for aa-taxsystem 5.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aa-taxsystem 5.0.0
File	Size	Uploaded
aa_taxsystem-5.0.0.tar.gz	1.1 MB	Oct 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for aa-taxsystem 5.0.0
File	Interpreter	ABI	Platform	Reset
aa_taxsystem-5.0.0-py3-none-any.whl 1.2 MB Oct 8, 2026	Python 3	none	any	Details

Total release size: 2.3 MB

Release files / aa_taxsystem-5.0.0.tar.gz

Download URL	aa_taxsystem-5.0.0.tar.gz
Size	1.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`dcdd58beded86a8360230b5976c118818aa611f987d85d3686048af9ad4868bd`
BLAKE2b-256 checksum How to use checksums	`68376a2b2b3baafd0d0237e4f4e114a36c7e51cead18a2f8442237a4515bca09`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Geuthur/aa-taxsystem
Publishing commit: github.com/Geuthur/aa-taxsystem/tree/47547e69ea86244bb05639b6fdd0637187667a61

Workflow

Publishing configuration: github.com/Geuthur/aa-taxsystem/blob/47547e69ea86244bb05639b6fdd0637187667a61/.github/workflows/release.yml
Publishing logs: github.com/Geuthur/aa-taxsystem/actions/runs/37852998271/attempts/1

Artifact

Subject: aa_taxsystem-5.0.0.tar.gz
SHA-256 checksum: dcdd58beded86a8360230b5976c118818aa611f987d85d3686048af9ad4868bd Verifying attestations

Release files / aa_taxsystem-5.0.0-py3-none-any.whl

Download URL	aa_taxsystem-5.0.0-py3-none-any.whl
Size	1.2 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`b19d51d5d4559a4b33fa6b916daf8fe3be76cc1fc45d03a99f0fb6e120f71f24`
BLAKE2b-256 checksum How to use checksums	`4a0de799462bb7c71c0eb61762409b785951e9db960ba0e1f2e20583a866248f`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Geuthur/aa-taxsystem
Publishing commit: github.com/Geuthur/aa-taxsystem/tree/47547e69ea86244bb05639b6fdd0637187667a61

Workflow

Publishing configuration: github.com/Geuthur/aa-taxsystem/blob/47547e69ea86244bb05639b6fdd0637187667a61/.github/workflows/release.yml
Publishing logs: github.com/Geuthur/aa-taxsystem/actions/runs/37852998271/attempts/1

Artifact

Subject: aa_taxsystem-5.0.0-py3-none-any.whl
SHA-256 checksum: b19d51d5d4559a4b33fa6b916daf8fe3be76cc1fc45d03a99f0fb6e120f71f24 Verifying attestations