Skip to main content

Tax System module for AllianceAuth.

Release Licence Python Django pre-commit.ci status Code style: black Tests codecov Translation status Discord

ko-fi

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


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

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.4

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.4
File Size Uploaded
aa_taxsystem-5.0.4.tar.gz 1.1 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for aa-taxsystem 5.0.4
File Interpreter ABI Platform
aa_taxsystem-5.0.4-py3-none-any.whl Python 3 none any Details

Total release size: 2.3 MB

Release files / aa_taxsystem-5.0.4.tar.gz

Download URL aa_taxsystem-5.0.4.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
2e9c0b485a1caf635c0ae51ef25e505d2205bbb0101fe3dd6b903e782b50bca7
BLAKE2b-256 checksum
How to use checksums
66e59fd145696ec11bd3c5186e5908d92d00384e92ea9ccc3ea00335f84109ea
Upload date
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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.

Transparency log

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

Download URL aa_taxsystem-5.0.4-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
6e75a05ae116989377ab5d585d6cc1c71a23d5a690cc48426589bfb6888d7d39
BLAKE2b-256 checksum
How to use checksums
d05fad72377b737476eb9146dde09f72fdaad006e8af0db82eb24aa099ff8e36
Upload date
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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

5.0.4 This release

2 release files

5.0.3

2 release files

5.0.2

2 release files

5.0.1

2 release files

5.0.0

2 release files

4.0.2

2 release files

4.0.1

2 release files

4.0.0

2 release files

3.0.4

2 release files

3.0.3

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.0.2

2 release files

1.0.1

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.9

2 release files

0.5.8

2 release files

0.5.7

2 release files

0.5.6

2 release files

0.5.5

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page