{"id":9430,"library":"aa-memberaudit","title":"AA Member Audit","description":"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.","status":"active","version":"4.3.1","language":"en","source_language":"en","source_url":"https://github.com/pvyParts/aa-memberaudit","tags":["django","alliance-auth","eve-online","character-auditing"],"install":[{"cmd":"pip install aa-memberaudit","lang":"bash","label":"Install library"}],"dependencies":[{"reason":"This is a Django app for Alliance Auth and requires an existing Alliance Auth v4.0.0+ installation.","package":"Alliance Auth","optional":false}],"imports":[{"note":"Common import for programmatic interaction with character data.","symbol":"Character","correct":"from memberaudit.models import Character"},{"note":"Common import for programmatic interaction with audit logs.","symbol":"AuditLog","correct":"from memberaudit.models import AuditLog"},{"note":"The admin class was renamed to 'MemberAuditAdmin' (capital A) in v4.0.0.","wrong":"from memberaudit.admin import MemberauditAdmin","symbol":"MemberAuditAdmin","correct":"from memberaudit.admin import MemberAuditAdmin"}],"quickstart":{"code":"# 1. Install the package: pip install aa-memberaudit\n\n# 2. Add 'memberaudit' to your Alliance Auth project's INSTALLED_APPS in local.py\n# local.py\nINSTALLED_APPS += [\n    'memberaudit',\n]\n\n# 3. Add memberaudit URLs to your Alliance Auth project's urls.py\n# urls.py\nfrom django.urls import path, include\n\nurlpatterns = [\n    # ... existing paths ...\n    path('memberaudit/', include('memberaudit.urls')),\n    # ...\n]\n\n# 4. Run migrations and initialize permissions\n# (Execute these commands in your Alliance Auth virtual environment)\n# python manage.py migrate\n# python manage.py memberaudit_add_default_roles\n# python manage.py memberaudit_init_permissions","lang":"python","description":"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."},"warnings":[{"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.","message":"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.","severity":"breaking","affected_versions":">=4.0.0"},{"fix":"Update all references to `MemberauditAdmin` to `MemberAuditAdmin` in your custom admin configurations or extensions.","message":"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.","severity":"breaking","affected_versions":">=4.0.0"},{"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.","message":"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.","severity":"breaking","affected_versions":">=4.0.0"},{"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.","message":"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.","severity":"deprecated","affected_versions":">=4.0.0"}],"env_vars":null,"last_verified":"2026-04-17T00:00:00.000Z","next_check":"2026-07-16T00:00:00.000Z","problems":[{"fix":"Ensure `pip install aa-memberaudit` has been run and `memberaudit` is present in your `INSTALLED_APPS` list in `local.py`.","cause":"The `aa-memberaudit` package is not installed or not added to `INSTALLED_APPS` in your Alliance Auth project.","error":"ModuleNotFoundError: No module named 'memberaudit'"},{"fix":"Run `python manage.py migrate` in your Alliance Auth environment to create the necessary database tables.","cause":"Database migrations have not been applied for the `memberaudit` app after installation or upgrade.","error":"django.db.utils.ProgrammingError: relation \"memberaudit_character\" does not exist"},{"fix":"Change all references from `MemberauditAdmin` to `MemberAuditAdmin` (note the capital 'A') in your custom admin configurations.","cause":"You are attempting to use or subclass the old `MemberauditAdmin` class which was renamed in v4.0.0.","error":"TypeError: 'MemberauditAdmin' object is not callable (or similar admin-related error)"},{"fix":"Ensure your Alliance Auth is v4.0.0+ and run `python manage.py migrate` after upgrading `aa-memberaudit`.","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.","error":"django.db.utils.OperationalError: no such column: memberaudit_corporation.auto_load_chars"}]}