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

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.7
File Size Uploaded Provenance
aa_taxsystem-5.0.7.tar.gz 1.1 MB With provenance Details

Built distribution (wheel)

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

Total release size: 2.3 MB

Release files / aa_taxsystem-5.0.7.tar.gz

Download URL aa_taxsystem-5.0.7.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
a18a5186baffbdfec0329b1988211e43ee15cb38a3a3f22d08605058bc4743f9
BLAKE2b-256 checksum
How to use checksums
0e4d5bb87f809fe87b9741a46a3a25544a5d85195ea1f7bff7c7cbe92555a070
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 19, 2026.

Transparency log

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

Download URL aa_taxsystem-5.0.7-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
51a6ba1f1836d0591a074e82eb24ab94f2a1aa7096890e142d758ca4a0448098
BLAKE2b-256 checksum
How to use checksums
4eaa79d94ddab7b7dead6fd5344d551ce68005916028fa407aadf5026ca8b9c0
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 19, 2026.

Transparency log

Security for aa-taxsystem 5.0.7

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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aa_taxsystem-5.0.7.tar.gz

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 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

5.0.7 This release

2 release files Full provenance

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