Skip to main content

Tax System module for Alliance Auth

Project description

Tax System module for AllianceAuth.

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

ko-fi

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


Features

  • Corporation Tax System
    • Member Tracking
      • Check Member is registred in Auth
      • Check Member is Alt Char
      • See Members as Missing when they leave the Corporation
    • Payment System
      • Allocate User from Member Tracking
      • Automatic Payment Tracking
      • Automatic Payment Approvment
      • Filtering Amount, Reason, Date
        • Support Hooks for Add more Filters
    • Payments
      • Track Payments that meets filters
    • Log System
    • Logs Actions from Administration Section

Upcoming

  • Notify via Discord each Month
  • Alliance level tax system

Screenshots

Administration View

Screenshot

Account User Payments History

Screenshot

Payments Details

Screenshot

Payments

Screenshot

Installation

[!NOTE] AA Tax System needs at least Alliance Auth v4.6.0 Please make sure to update your Alliance Auth before you install this APP

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 'allianceauth.corputils', to INSTALLED_APPS
  • Add 'eveuniverse', to INSTALLED_APPS
  • 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["taxsystem_update_all_taxsytem"] = {
    "task": "taxsystem.tasks.update_all_taxsytem",
    "schedule": crontab(minute="15,45"),
}

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 Users with this permission can add corporation.
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.

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

Advanced Settings: Stale Status for Each Section

  • LEDGER_STALE_TYPES = { "wallet": 60, "division": 60, "members": 60, "payments": 60, "payment_system": 60, "payment_payday": 1440 } - Defines the stale status duration (in minutes) for each section.

[!NOTE] Contributing You want to improve the project? Just Make a Pull Request with the Guidelines. We Using pre-commit

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aa_taxsystem-0.5.7.tar.gz (523.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aa_taxsystem-0.5.7-py3-none-any.whl (619.2 kB view details)

Uploaded Python 3

File details

Details for the file aa_taxsystem-0.5.7.tar.gz.

File metadata

  • Download URL: aa_taxsystem-0.5.7.tar.gz
  • Upload date:
  • Size: 523.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for aa_taxsystem-0.5.7.tar.gz
Algorithm Hash digest
SHA256 dac43d812bd6a12343d9ac468829d26c8f1aae609b0db156bff41f5afdede212
MD5 ce28085da14d90f7b67949ba30f43f12
BLAKE2b-256 fd541f5d9284479df731c5aed090fe76d487816c4f6de8bb258fcfaea65c4821

See more details on using hashes here.

File details

Details for the file aa_taxsystem-0.5.7-py3-none-any.whl.

File metadata

  • Download URL: aa_taxsystem-0.5.7-py3-none-any.whl
  • Upload date:
  • Size: 619.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for aa_taxsystem-0.5.7-py3-none-any.whl
Algorithm Hash digest
SHA256 54a39dd96c14e893267e25d0f9191ca2d6affe62fd94832b343858f484851834
MD5 c26e758d66aa48e5519f2dd5ffcab3a3
BLAKE2b-256 80d614a1ab6a40fcff33b83629659e2eb37caa20c74e9444fa0ffa5cd7ca2529

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page