AA Member Audit

4.3.1 · active · verified Fri Apr 17

aa-memberaudit is an Alliance Auth app designed to provide comprehensive access to Eve Online character data for alliance and corporation management. It enables auditing of character assets, skills, mail, and other details within the Alliance Auth framework. The current version is 4.3.1 and it receives updates as needed, often in conjunction with major Alliance Auth releases.

Common errors

```
ModuleNotFoundError: No module named 'memberaudit'
```
cause The `aa-memberaudit` package is not installed or not added to `INSTALLED_APPS` in your Alliance Auth project.

fix Ensure `pip install aa-memberaudit` has been run and `memberaudit` is present in your `INSTALLED_APPS` list in `local.py`.
```
django.db.utils.ProgrammingError: relation "memberaudit_character" does not exist
```
cause Database migrations have not been applied for the `memberaudit` app after installation or upgrade.

fix Run `python manage.py migrate` in your Alliance Auth environment to create the necessary database tables.
```
TypeError: 'MemberauditAdmin' object is not callable (or similar admin-related error)
```
cause You are attempting to use or subclass the old `MemberauditAdmin` class which was renamed in v4.0.0.

fix Change all references from `MemberauditAdmin` to `MemberAuditAdmin` (note the capital 'A') in your custom admin configurations.
```
django.db.utils.OperationalError: no such column: memberaudit_corporation.auto_load_chars
```
cause This error typically indicates that your Alliance Auth instance is too old for the installed `aa-memberaudit` version, or migrations were not run correctly after an upgrade.

fix Ensure your Alliance Auth is v4.0.0+ and run `python manage.py migrate` after upgrading `aa-memberaudit`.

Warnings

breaking AA Member Audit v4.0.0+ requires Alliance Auth v4.0.0 or higher. Attempting to install or upgrade on an older Alliance Auth version will lead to compatibility errors.
Fix: Upgrade your Alliance Auth instance to v4.0.0+ before upgrading or installing aa-memberaudit v4.0.0+. Consult the Alliance Auth upgrade guide.
breaking The primary admin class was renamed from `MemberauditAdmin` to `MemberAuditAdmin` (capital 'A') in v4.0.0. Any custom overrides or references to the old class will break.
Fix: Update all references to `MemberauditAdmin` to `MemberAuditAdmin` in your custom admin configurations or extensions.
breaking The permissions system underwent major changes in v4.0.0. Existing custom permissions or role assignments may need to be re-evaluated and re-configured. The `memberaudit_init_permissions` command is crucial.
Fix: After upgrading, run `python manage.py memberaudit_init_permissions` to apply the new default permissions. Review and adjust custom roles/permissions via the Alliance Auth admin panel if necessary.
deprecated Several settings were removed in v4.0.0, including `AA_MEMBERAUDIT_ALLOW_PRIVATE_MAIL` and `AA_MEMBERAUDIT_AUTO_LOAD_ALL_CORPORATIONS`. Using them will no longer have an effect and may raise warnings.
Fix: Remove these settings from your `local.py` or other Alliance Auth settings files. Functionality related to these settings may have been removed or changed.

Install

pip install aa-memberaudit Install library

Imports

Character
```
from memberaudit.models import Character
```
Common import for programmatic interaction with character data.
AuditLog
```
from memberaudit.models import AuditLog
```
Common import for programmatic interaction with audit logs.
MemberAuditAdmin
wrong:
```
from memberaudit.admin import MemberauditAdmin
```
correct:
```
from memberaudit.admin import MemberAuditAdmin
```
The admin class was renamed to 'MemberAuditAdmin' (capital A) in v4.0.0.

Quickstart

To quickly integrate AA Member Audit into an Alliance Auth project, install the package, add it to your `INSTALLED_APPS` and `urlpatterns`, then run the necessary Django management commands to apply migrations and set up initial permissions.

# 1. Install the package: pip install aa-memberaudit

# 2. Add 'memberaudit' to your Alliance Auth project's INSTALLED_APPS in local.py
# local.py
INSTALLED_APPS += [
    'memberaudit',
]

# 3. Add memberaudit URLs to your Alliance Auth project's urls.py
# urls.py
from django.urls import path, include

urlpatterns = [
    # ... existing paths ...
    path('memberaudit/', include('memberaudit.urls')),
    # ...
]

# 4. Run migrations and initialize permissions
# (Execute these commands in your Alliance Auth virtual environment)
# python manage.py migrate
# python manage.py memberaudit_add_default_roles
# python manage.py memberaudit_init_permissions

view raw JSON →