allianceauth-corptools
This module is the core of the CorpTools Ecosystem
CorpTools
Lightweight Toolbox of Bits and bobs for todays Eve Group on the go!
This module is the core of the CorpTools Ecosystem, this includes;
- Invoices: Automatic tracking of payments made to a holding wallet.
- Moons: Moon Mining tracking and Tax system.
- Indy Dash: What Industrial structures have what rigs and where are they.
- Pinger: High performance pings from the notification endpoint, using the data avaialbe from character audit.
Included Bits and Bobs
:
-
Character Audit
-
Assets
- Roles
- Contacts
- Notifications
- Standings
- Markets
- Skills
- List
- Queue
- Audit/Export
- Wallet
- Activity Analysis
- History
-
Clones
- Implants
-
Corp Audit
-
Wallets
- Structures
-
Assets
-
Sec Group Filters
- Audit Fully Loaded
- Assets
- Location
- Type
- Group
- Skill List
- Corporate Roles
- Corporate Title
- Main time in corp
Active Devs:
Installation
- Install the Repo from git
pip install -U git+https://github.com/pvyParts/allianceauth-corp-tools.git
- Add
'corptools',
to yourINSTALLED_APPS
in your projectslocal.py
- run migrations, collectstatic and restart auth
- run the corp tools setup managemnt command
python manage.py ct_setup
- setup your perms as documented below
- add characters and corp tokens as required.
Set Corp Tools Name
Add the below lines to your local.py
settings file, Changing the contexts to yours.
You can optionally se the name of the app in the ui by setting this setting
## name for Corp Tools
CORPTOOLS_APP_NAME = "Character Audit"
Usage
Seting up automatic updates
This will show how to do daily updates.
Currently this is:
- 2 times an hour ( minute 15, and 45) 1/48th of the total character updates, for at worst 1 update per character per day
-
Corp update run on all corps hourly at minute 30
-
Got Audit Admin
- Click
Create or Update Periodic Tasks
- you can edit the schedules to work more inline with your group as required.
Permissions
There are some basic access perms
All permissions are filtered by main character, if a person has neutral alts loaded they will also be visible to someone who can see their main.
Character
Perm | Admin Site | Perm | Description |
---|---|---|---|
view_characteraudit | nill | Can view character audit. | Generic Access perm to show the Member Audit Menu item |
global_hr | nill | Can access other character's data for characters in any corp/alliance/state. | Superuser level access |
alliance_hr | nill | Can access other character's data for own alliance. | Alliance only level access |
corp_hr | nill | Can access other character's data for own corp. | Own Corp restricted level access |
Corporate
Perm | Admin Site | Perm | Description |
---|---|---|---|
global_corp_manager | nill | Can access other character's data for characters in any corp/alliance/state. | Superuser level access |
alliance_corp_manager | nill | Can access other character's data for own alliance. | Alliance only level access |
own_corp_manager | nill | Can access other character's data for own corp. | Own Corp restricted level access |
holding_corp_structures | nill | Can access configured holding corp structure data. | Holding Corp Structure data access |
holding_corp_wallets | nill | Can access configured holding corp wallet data. | Holding Corp Structure data access |
holding_corp_assets | nill | Can access configured holding corp asset data. | Holding Corp Structure data access |
Note: Configure the "Holding Corps" in the Corptools Configuration
Admin Model. via the auth admin interface.
Settings
Modules
Each section of the character audit can be enabled and disabled via settings in your local.py
True
Enables the moduleFalse
Disables the Module
You can also exclude section of hte updates from the "Active" metric, this is handy should you wish to add a module and not have everyone be marked as "Inactive" in the audit module. or if CCP is having issues with part of the ESI. Looks at Assets
True
Masks the section in the active calculationFalse
Enforces the section in the active calculation
To assist with auth related tasks we request publicData
on top of the configured set.
Module | Enable Setting (Default) | Active Setting (Default) | Description | Scopes Requested | Note |
---|---|---|---|---|---|
Assets | CT_CHAR_ASSETS_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_ASSETS_MODULE (False ) |
Character Assets | 'esi-assets.read_assets.v1' | Fully enabled with a Sec Group Filter |
Standings | CT_CHAR_STANDINGS_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_STANDINGS_MODULE (False ) |
Character NPC Standings | 'esi-characters.read_standings.v1' | Fully enabled |
Killmails | CT_CHAR_KILLMAILS_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_KILLMAILS_MODULE (False ) |
Character Killmails | 'esi-killmails.read_killmails.v1' | Future Version |
Fittings | CT_CHAR_FITTINGS_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_FITTINGS_MODULE (False ) |
Character Fittings | 'esi-fittings.read_fittings.v1' | Future Version |
Calendar | CT_CHAR_CALENDAR_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_CALENDAR_MODULE (False ) |
Character Killmails | 'esi-calendar.read_calendar_events.v1' | Future Version |
Contacts | CT_CHAR_CONTACTS_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_CONTACTS_MODULE (False ) |
Character Contacts | 'esi-characters.read_contacts.v1' | Fully enabled |
Notifications | CT_CHAR_NOTIFICATIONS_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_NOTIFICATIONS_MODULE (False ) |
Character Notifications | 'esi-characters.read_notifications.v1' | Fully enabled |
Roles | CT_CHAR_ROLES_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_ROLES_MODULE (False ) |
Character Roles and Titles | 'esi-characters.read_titles.v1', 'esi-characters.read_corporation_roles.v1' | Fully enabled with a Sec Group Filter |
Industry | CT_CHAR_INDUSTRY_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_INDUSTRY_MODULE (False ) |
Character Indy Jobs | 'esi-industry.read_character_jobs.v1' | Fully enabled |
Mining | CT_CHAR_MINING_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_MINING_MODULE (False ) |
Character Mining Ledgers | 'esi-industry.read_character_mining.v1' | Future Version |
Wallets/Markets/Contracts | CT_CHAR_WALLET_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_WALLET_MODULE (False ) |
Character Wallets, Contracts and Trading/Orders | 'esi-markets.read_character_orders.v1', 'esi-wallet.read_character_wallet.v1', 'esi-contracts.read_character_contracts.v1' | Fully Enabled |
Skills | CT_CHAR_SKILLS_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_SKILLS_MODULE (False ) |
Character Skills/Queues and Doctrine Tools | 'esi-skills.read_skillqueue.v1','esi-skills.read_skills.v1' | Fully Enabled with Sec Group Filters |
Clones | CT_CHAR_CLONES_MODULE (True ) |
CT_CHAR_ACTIVE_IGNORE_CLONES_MODULE (False ) |
Character Medical and Jump Clone Module | 'esi-clones.read_implants.v1', 'esi-clones.read_clones.v1' | Fully Enabled with a Sec Group Filter |
Fleet | CT_CHAR_FLEET_MODULE (True ) |
nill | Character Fleet Tools | 'esi-fleets.read_fleet.v1', 'esi-fleets.write_fleet.v1` | Future Version |
CT_CHAR_MAIL_MODULE (False ) |
CT_CHAR_ACTIVE_IGNORE_MAIL_MODULE (False ) |
Character Mail Views | 'esi-mail.read_mail.v1` | Fully Enabled | |
Helpers | CT_CHAR_HELPER_MODULE (False ) |
CT_CHAR_ACTIVE_IGNORE_HELPER_MODULE (False ) |
Character Helpers | 'esi-ui.open_window.v1','esi-ui.write_waypoint.v1' | Future Versions |
Opportunities | CT_CHAR_OPPORTUNITIES (False ) |
nill | Character Opportunities | 'esi-characters.read_opportunities.v1' | Future Versions |
Loyalty Points | CT_CHAR_LOYALTYPOINTS_MODULE (False ) |
CT_CHAR_ACTIVE_IGNORE_LOYALTYPOINTS_MODULE (True ) |
Character LP | 'esi-characters.read_loyalty.v1' | Fully Enabled |
Extra Scopes
If Assets
, Clones
, Wallets
or Minning
are enabled these extra spoces are requested:
- 'esi-universe.read_structures.v1'
- 'esi-search.search_structures.v1'
Other Settings
Setting | Default | Description |
---|---|---|
CORPTOOLS_APP_NAME |
"Character Audit" | Name on the menu for Character Audit |
CT_CHAR_MAX_INACTIVE_DAYS |
3 | Days till data is considered Stale |
CORPTOOLS_DISCORD_BOT_COGS |
["corptools.cogs.routes", "corptools.cogs.locate"] |
Discord bot cogs to enable/disable |
CT_PAGINATION_SIZE |
30000 | Max items per page of data in the UI |
CT_USERS_CAN_FORCE_REFRESH |
False | Set to True to force cache invalidation on a regular user requresting updates from the UI. Superusers will always cache invalidate on requesting an update. |
Contributing
Make sure you have signed the License Agreement by logging in at https://developers.eveonline.com before submitting any pull requests. All bug fixes or features must not include extra superfluous formatting changes.
No reviews yet...
Python Requirements
- allianceauth<5.0.0,>=3
- django-model-utils
- django-ninja<2.0.0,>=1.0.1
- networkx
- allianceauth-securegroups; extra == "test"
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 :: Celery
- Framework :: Django
- Framework :: Django :: 4.0
- Framework :: Django :: 4.2
- Intended Audience :: Developers
- License :: OSI Approved :: MIT License
- 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.8
- Programming Language :: Python :: 3.9
- Programming Language :: Python :: Implementation :: CPython
- Topic :: Internet :: WWW/HTTP
- Topic :: Internet :: WWW/HTTP :: Dynamic Content
Version
2.8.0
License
MIT License
Homepage
https://github.com/Solar-Helix-Independent-Transport/allianceauth-corp-tools
PyPI
https://pypi.org/project/allianceauth-corptools/
Last updated
1 month, 4 weeks ago
First published
3 years, 1 month ago
Category
Plugin Apps
Rating
-Authors
Aaron Kable
Maintainers
-
Please login to see more options.