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

  • TAXSYSTEM_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.6.0.tar.gz (640.6 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.6.0-py3-none-any.whl (739.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aa_taxsystem-0.6.0.tar.gz
  • Upload date:
  • Size: 640.6 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.6.0.tar.gz
Algorithm Hash digest
SHA256 1b9688c3af573ed6103ae47e3713c38a4aa9e7240ba8e2d816ca58a4c5c903ea
MD5 c02cfd2fdc1a270fc3b0a58526dc4be8
BLAKE2b-256 f4e7c7f1b04f95f0df628918ff9a1e68587aea503195b02217fcd5a96e3283c5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aa_taxsystem-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 739.5 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.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 de676648d05a6ac54fa8a982412f0965f12593a3d407da28aaa184d32cb943bc
MD5 1b1aaf71ca3ac95c16ffffb3dfb23baf
BLAKE2b-256 5a28d8de4165f29d8159942e8c73c69db42f0106f57945bc2f92fbbb6126b515

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