Please join the miningtaxes thread in the Community Creations section on the Alliance Auth Discord Server for giveaways and support for this plugin!

Mining Taxes

An Alliance Auth app for tracking mining activities and charging taxes.

Credit to AA's memberaudit and buyback plugins which formed the foundation for this plugin.

Screenshots

Features

• Monthly leaderboards to show top miners.
• Supports multiple corps under one system (Add one character with the accountant role per corp in the admin setup)
• Supports corp moon mining tracking.
• Able to track when unrecognized characters are mining your corp's private moons.
• Tax credit system to offset, zero, or award tax credits to a given user.
• Supports separate tax rates for Regular Ore, Mercoxit, Gas, Ice, R64, R32, R16, R8, and R4.
• Tracks tax payments into the corp master wallet filtering with a user defined phrase.
• Set a monthly interest rate that penalizes for unpaid tax balances.
• Automatic monthly notifications and monthly interest applied with unpaid balance.
• Supports Fuzzworks and Janice for daily price updates.
• Supports refined price calculation versus raw ore prices (the higher price will be the taxed price).
• Supports multiple mining characters under one user.
• Monthly statistics and detailed tax calculations available to each user and auditor.
• Provides a current Ore price chart that is updated each day with the latest prices.
• Export tax information in CSV format.
• Supports whitelisting and blacklisting of systems, and turning taxing on and off by security status.

Installation instructions

• If you would like to use Janice for pricing information, obtain an API key by following the instructions at the top of the Swagger documentation and FAQ.
• Install using pip: pip install aa-miningtaxes
• Add miningtaxes and django_celery_results to INSTALLED_APPS in myauth/settings/local.py
• Run migrations: python manage.py migrate
• Collect and deploy static assets: python manage.py collectstatic
• Preload pricing information python manage.py miningtaxes_preload_prices
• Set local settings

  CELERY_RESULT_BACKEND = 'django-db'
  CELERY_CACHE_BACKEND = 'django-cache'
  
  MININGTAXES_PRICE_JANICE_API_KEY = "XXXX"
  MININGTAXES_PRICE_METHOD = "Janice"
  
  CELERYBEAT_SCHEDULE['miningtaxes_update_daily'] = {
      'task': 'miningtaxes.tasks.update_daily',
      'schedule':  crontab(minute=0, hour='1'),
  }
  
  # Notifiy everyone of their current taxes on the second day of every month.
  CELERYBEAT_SCHEDULE['miningtaxes_notifications'] = {
      'task': 'miningtaxes.tasks.notify_taxes_due',
      'schedule': crontab(0, 0, day_of_month='2'),
  }
  
  # Charge interest and notify everyone on the 15th of every month.
  CELERYBEAT_SCHEDULE['miningtaxes_apply_interest'] = {
      'task': 'miningtaxes.tasks.apply_interest',
      'schedule': crontab(0, 0, day_of_month='15'),
  }

• Navigate to the admin panel and setup the accountants (1 per corp)

Post-Setup instructions

• After you have setup your accountants (1 per corp) in the Admin Setup panel, invite all the members of your corp to add their characters.
• If you enable MININGTAXES_TAX_ONLY_CORP_MOONS, remember that only moon mining of your corp moons will be taxes and other moons will be ignored.
• After everyone in the corp has added their characters, consider running to the miningtaxes_zero_all command to zero out everyone's taxes to prevent mining activity from the past from being taxed.
• When a new user joins your corp and adds their character to the plugin, also consider going into the audit tables and providing a tax credit so that it will zero out their past mining activity.

Local settings

Whitelisting and Blacklisting

The logic around whitelisting and blacklisting is a bit complex so I will describe the implementation here.

If any systems are entered into MININGTAXES_WHITELIST then taxes are collected in these systems regardless of what the other settings say. Basically MININGTAXES_BLACKLIST, MININGTAXES_TAX_HISEC, MININGTAXES_TAX_LOSEC, MININGTAXES_TAX_NULLSEC, MININGTAXES_TAX_JSPACE, MININGTAXES_TAX_POCHVEN are completely ignored.

If there NO systems entered into MININGTAXES_WHITELIST (the default state), then the system will look at whether they fall into the exclusion rules and tax accordingly.

Permissions

Commands

No reviews yet...

Python Requirements

No information about requirements

Required Python packages to be installed and other Python requirement.

App Dependencies

No information about requirements

Dependencies to other apps registered in this app directory.

Classifiers

• Environment :: Web Environment
• Framework :: Django
• Framework :: Django :: 3.2
• Intended Audience :: Developers
• License :: OSI Approved :: MIT License
• Operating System :: OS Independent
• Programming Language :: Python
• Programming Language :: Python :: 3.7
• Programming Language :: Python :: 3.8
• Programming Language :: Python :: 3.9
• Topic :: Internet :: WWW/HTTP
• Topic :: Internet :: WWW/HTTP :: Dynamic Content