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

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

Built distribution (wheel)

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

Total release size: 2.3 MB

Release files / aa_taxsystem-5.0.6.tar.gz

Download URL aa_taxsystem-5.0.6.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
b24f1ad0c2c9f005b93f58eaa6803c2bb4c5f01dda0db5f970dd6b343dd621c8
BLAKE2b-256 checksum
How to use checksums
02de706db910d3ea3ee766febbcd8e5c9a265aba8842dbfd493f969091beb023
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 18, 2026.

Transparency log

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

Download URL aa_taxsystem-5.0.6-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
182144c5b0a43250abbb68973f0d4b7bd20d7501763bfc19b75a5dbbea566ec2
BLAKE2b-256 checksum
How to use checksums
3e4f9645d3349aace45ecd08cba4b20237b85794897cb3d28848a9b00e747f98
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 18, 2026.

Transparency log

Security for aa-taxsystem 5.0.6

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.6.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 18, 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.6 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