Browse Apps

AA Tax System

Tax System module for Alliance Auth


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.

<hr />

Features

  • Corporation Tax System
  • Member Tracking
    • Check Member is registred in Auth
    • Check Member is Alt Char
  • 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=0, hour="*/1"),
}

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
  • TAXSYSTEM_LOGGER_USE: True / False - Set to use own Logger File
  • TAXSYSTEM_CORP_MEMBERS_SKIP_DATE: 1 - Set Skip Task Time in Hours
  • TAXSYSTEM_CORP_WALLET_SKIP_DATE: 1 - Set Skip Task Time in Hours
  • TAXSYSTEM_CORP_PAYMENTS_SKIP_DATE: 1 - Set Skip Task Time in Hours
  • TAXSYSTEM_CORP_PAYMENT_SYSTEM_SKIP_DATE: 1 - Set Skip Task Time in Hours

If you set up TAXSYSTEM_LOGGER_USE to True you need to add the following code below and ensure you have permission on logs folder:

LOGGING_TAXSYSTEM = {
    "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,
        },
    },
    "loggers": {
        "taxsystem": {
            "handlers": ["taxsystem_file", "console"],
            "level": "INFO",
        },
    },
}
LOGGING["handlers"].update(LOGGING_TAXSYSTEM["handlers"])
LOGGING["loggers"].update(LOGGING_TAXSYSTEM["loggers"])

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

No reviews yet...

Python Requirements

Required Python packages to be installed and other Python requirement.

App Dependencies


Required apps:

Used by apps:

    -

Dependencies to other apps registered in this app directory.

Classifiers

  • Environment :: Web Environment
  • Framework :: Django
  • Framework :: Django :: 4.2
  • Intended Audience :: Developers
  • License :: OSI Approved :: GNU General Public License v3 (GPLv3)
  • Operating System :: OS Independent
  • Programming Language :: Python
  • Programming Language :: Python :: 3 :: Only
  • Programming Language :: Python :: 3.10
  • Programming Language :: Python :: 3.11
  • Programming Language :: Python :: 3.12
  • Programming Language :: Python :: 3.13
  • Topic :: Internet :: WWW/HTTP
  • Topic :: Internet :: WWW/HTTP :: Dynamic Content

Version

0.5.4.1

License

GPLv3

Homepage

  https://github.com/Geuthur/aa-taxsystem

PyPI

  https://pypi.org/project/aa-taxsystem/

Last updated

1 month, 1 week ago

First published

1 month, 3 weeks ago

Category

Plugin Apps

Rating

-

Authors

Geuthur

Maintainers

Geuthur Geuthur

Please login to see more options.