Metadata-Version: 2.4
Name: allianceauth-auth-stats
Version: 0.1.1
Summary: Configurable Report Framework for corporate level aggregation of any data
Keywords: allianceauth,eveonline
Author-email: AaronKable <aaronkable@gmail.com>
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Classifier: Environment :: Web Environment
Classifier: Framework :: Celery
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.0
Classifier: Framework :: Django :: 4.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
License-File: LICENSE
Requires-Dist: allianceauth<5,>=3
Requires-Dist: django-esi>=8.2
Requires-Dist: django-ninja>=1.0.1,<2
Requires-Dist: django-solo>=2.1
Project-URL: Homepage, https://github.com/Solar-Helix-Independent-Transport/allianceauth-auth-reports
Project-URL: Source, https://github.com/Solar-Helix-Independent-Transport/allianceauth-auth-reports
Project-URL: Tracker, https://github.com/Solar-Helix-Independent-Transport/allianceauth-auth-reports/issues

# Auth Reports

### Auth Data in report form, in Auth, fully configurable

AKA Corp Stats 3.0

- Configurable Report Framework for corporate level aggregation of any data
- each "field" is a smart filter similar to secure groups ( can use secure groups filters too ) or a "field only" filter provided by any application in the alliance auth ecosystem.
  - These filters MUST be the more "modern" kind with either a `process_field` or `audit_filter` methods. Legacy filters using only `process_filter` will not show any data. [Please see this link for more info](https://github.com/Solar-Helix-Independent-Transport/allianceauth-secure-groups/blob/main/THRID_PARTY.md)
- Data Exportable to CSV for external manipulation.

## What it needs:

- require corporate member tokens to build the corp groups to see people not known to auth, to make a report for that too. these can be added with the plus button in the menubar

## The General Road Map

if you want some features, please create an issue.

- state level report that shows all members of a state
- group reports for group leaders
- overview screen with passing/failing per corp per "report" ( maybe have this as optional aka "show_on_global_overview_report" )
- more things...

## Filters/stats provided by this app

- show all alts for a main, with option to only show in corp alts

## Other Apps with filters

- [Corptools](https://github.com/Solar-Helix-Independent-Transport/allianceauth-corp-tools?tab=readme-ov-file#corptools)
- [Member Audit Smart Filters](https://github.com/ppfeufer/aa-ma-securegroups)
- [Secure Groups](https://github.com/Solar-Helix-Independent-Transport/allianceauth-secure-groups)
- [Secret Santa](https://gitlab.com/tactical-supremacy/aa-secret-santa)
- [Discord Multiverse](https://github.com/Solar-Helix-Independent-Transport/allianceauth-discord-multiverse)
- [Invoices](https://github.com/Solar-Helix-Independent-Transport/allianceauth-invoice-manager)

... more send a PR in with updates

## Installation

### Bare Metal

1. `pip install -U allianceauth-auth-stats`
1. add `'authstats',` to your local.py
1. migrate `python manage.py migrate`
1. collectstatic `python manage.py collectstatic --noinput`
1. sync commands `python manage.py reports_sync_filters`
1. create your first report `python manage.py reports_bootstrap_report`
1. restart auth
1. continue to the common section

### Docker

1. add `allianceauth-auth-stats==0.0.1` (update version number as required) to your requirements.txt file and rebuild your containers `docker compose build --no-cache`
1. add `'authstats',` to your local.py
1. recreate you docker stack `docker compose up -d`
1. enter your auth container and run migrations and collect static and sync filters `docker compose exec alliancauth_gunicorn bash`

- `auth collectstatic`
- `auth migrate`
- `auth reports_sync_filters`
- `auth reports_bootstrap_report`

1. continue to the common section

### Common setup steps

1. In the auth admin site edit `Auth Reports Configuration` to your liking.
1. set your states to include in reports as a minimum.
1. add permissions to the parties you wish to be able to use reports. permisions are defined below.

## Screenshots

![Imgur](https://i.imgur.com/FhCpfMC.png)

![Imgur](https://i.imgur.com/MCV0zWX.png)

## 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.

| Perm               | Admin Site | Perm                                        | Description                                                          |
| ------------------ | ---------- | ------------------------------------------- | -------------------------------------------------------------------- |
| basic_access       | nill       | Can access reports module                   | Shows the Auth Reports module in the menu and gives access to the UI |
| own_corp           | nill       | Can access own corporations reports.        |                                                                      |
| own_alliance       | nill       | Can access own alliances reports.           |                                                                      |
| own_state          | nill       | Can access own states reports.              |                                                                      |
| restricted_reports | nill       | Can access restricted reports.              | Allows access to any report with restricted enabled                  |
| holding_corps      | nill       | Can access configured holding corp reports. | Allows access to holding corporation reports                         |

Note: Configure the "Holding Corps" in the `Auth Reports Configuration` Admin Model. via the auth admin interface.

## Contributing

Make sure you have signed the [License Agreement](https://developers.eveonline.com/resource/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.

