aa-recruitment 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (112) hide show
  1. aa_recruitment-0.2.0/.gitignore +45 -0
  2. aa_recruitment-0.2.0/LICENSE +21 -0
  3. aa_recruitment-0.2.0/PKG-INFO +263 -0
  4. aa_recruitment-0.2.0/README.md +229 -0
  5. aa_recruitment-0.2.0/aa_recruitment/__init__.py +2 -0
  6. aa_recruitment-0.2.0/aa_recruitment/activity/__init__.py +1 -0
  7. aa_recruitment-0.2.0/aa_recruitment/activity/center.py +373 -0
  8. aa_recruitment-0.2.0/aa_recruitment/activity/compliance.py +132 -0
  9. aa_recruitment-0.2.0/aa_recruitment/activity/dashboard.py +358 -0
  10. aa_recruitment-0.2.0/aa_recruitment/activity/messages.py +296 -0
  11. aa_recruitment-0.2.0/aa_recruitment/activity/rules.py +127 -0
  12. aa_recruitment-0.2.0/aa_recruitment/activity/sync.py +445 -0
  13. aa_recruitment-0.2.0/aa_recruitment/admin.py +338 -0
  14. aa_recruitment-0.2.0/aa_recruitment/app_settings.py +12 -0
  15. aa_recruitment-0.2.0/aa_recruitment/apps.py +11 -0
  16. aa_recruitment-0.2.0/aa_recruitment/auth_hooks.py +104 -0
  17. aa_recruitment-0.2.0/aa_recruitment/discord_i18n.py +44 -0
  18. aa_recruitment-0.2.0/aa_recruitment/forms.py +346 -0
  19. aa_recruitment-0.2.0/aa_recruitment/locale/en/LC_MESSAGES/django.mo +0 -0
  20. aa_recruitment-0.2.0/aa_recruitment/locale/en/LC_MESSAGES/django.po +569 -0
  21. aa_recruitment-0.2.0/aa_recruitment/locale/nl/LC_MESSAGES/django.mo +0 -0
  22. aa_recruitment-0.2.0/aa_recruitment/locale/nl/LC_MESSAGES/django.po +656 -0
  23. aa_recruitment-0.2.0/aa_recruitment/migrations/0001_initial.py +556 -0
  24. aa_recruitment-0.2.0/aa_recruitment/migrations/0002_recruitmentconfig_portal_menu_title_and_more.py +32 -0
  25. aa_recruitment-0.2.0/aa_recruitment/migrations/0003_vettingreport_zkill_data.py +21 -0
  26. aa_recruitment-0.2.0/aa_recruitment/migrations/0004_vettingreport_corp_history.py +21 -0
  27. aa_recruitment-0.2.0/aa_recruitment/migrations/0005_discordintelchannel_and_more.py +128 -0
  28. aa_recruitment-0.2.0/aa_recruitment/migrations/0006_corpactivitysnapshot_corpcombatstats_and_more.py +113 -0
  29. aa_recruitment-0.2.0/aa_recruitment/migrations/0007_corpmemberactivity_isk_destroyed_120d_and_more.py +52 -0
  30. aa_recruitment-0.2.0/aa_recruitment/migrations/0008_discord_language.py +32 -0
  31. aa_recruitment-0.2.0/aa_recruitment/migrations/0009_member_activity_init_compliance.py +174 -0
  32. aa_recruitment-0.2.0/aa_recruitment/migrations/0010_vetting_parity.py +81 -0
  33. aa_recruitment-0.2.0/aa_recruitment/migrations/0011_activity_dashboard.py +77 -0
  34. aa_recruitment-0.2.0/aa_recruitment/migrations/0012_check_config.py +70 -0
  35. aa_recruitment-0.2.0/aa_recruitment/migrations/0013_activity_center.py +128 -0
  36. aa_recruitment-0.2.0/aa_recruitment/migrations/__init__.py +1 -0
  37. aa_recruitment-0.2.0/aa_recruitment/models.py +883 -0
  38. aa_recruitment-0.2.0/aa_recruitment/services/__init__.py +1 -0
  39. aa_recruitment-0.2.0/aa_recruitment/services/corp_trends.py +699 -0
  40. aa_recruitment-0.2.0/aa_recruitment/services/discord_intel.py +370 -0
  41. aa_recruitment-0.2.0/aa_recruitment/signals.py +3 -0
  42. aa_recruitment-0.2.0/aa_recruitment/sources/__init__.py +14 -0
  43. aa_recruitment-0.2.0/aa_recruitment/sources/audit.py +489 -0
  44. aa_recruitment-0.2.0/aa_recruitment/sources/audit_remote.py +444 -0
  45. aa_recruitment-0.2.0/aa_recruitment/sources/coalitions.py +88 -0
  46. aa_recruitment-0.2.0/aa_recruitment/sources/esi.py +167 -0
  47. aa_recruitment-0.2.0/aa_recruitment/sources/fats.py +92 -0
  48. aa_recruitment-0.2.0/aa_recruitment/sources/loa.py +32 -0
  49. aa_recruitment-0.2.0/aa_recruitment/static/aa_recruitment/js/activity_center.js +1984 -0
  50. aa_recruitment-0.2.0/aa_recruitment/tasks.py +230 -0
  51. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/activity_compliance.html +91 -0
  52. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/activity_dashboard.html +23 -0
  53. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/activity_member.html +127 -0
  54. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/application_detail.html +145 -0
  55. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/apply.html +67 -0
  56. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/base.html +62 -0
  57. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/corp_trends.html +985 -0
  58. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/discord_channel_edit.html +130 -0
  59. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/form_edit.html +113 -0
  60. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/includes/activity_styles.html +46 -0
  61. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/includes/activity_table.html +48 -0
  62. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/includes/audit_sections.html +36 -0
  63. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/includes/styles.html +358 -0
  64. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/includes/vetting_styles.html +123 -0
  65. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/index.html +189 -0
  66. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/manage_forms.html +545 -0
  67. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/manage_questions.html +119 -0
  68. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/my_applications.html +90 -0
  69. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/portal.html +109 -0
  70. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/portal_base.html +44 -0
  71. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/question_edit.html +103 -0
  72. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/recruiter_detail.html +830 -0
  73. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/recruiter_queue.html +141 -0
  74. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/vetting_datasources.html +72 -0
  75. aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/vetting_settings.html +177 -0
  76. aa_recruitment-0.2.0/aa_recruitment/templatetags/__init__.py +0 -0
  77. aa_recruitment-0.2.0/aa_recruitment/templatetags/aa_recruitment_version.py +24 -0
  78. aa_recruitment-0.2.0/aa_recruitment/tests/__init__.py +1 -0
  79. aa_recruitment-0.2.0/aa_recruitment/tests/test_activity.py +183 -0
  80. aa_recruitment-0.2.0/aa_recruitment/tests/test_activity_dashboard.py +266 -0
  81. aa_recruitment-0.2.0/aa_recruitment/tests/test_audit_remote.py +174 -0
  82. aa_recruitment-0.2.0/aa_recruitment/tests/test_corp_trends.py +315 -0
  83. aa_recruitment-0.2.0/aa_recruitment/tests/test_discord_intel.py +250 -0
  84. aa_recruitment-0.2.0/aa_recruitment/tests/test_discord_language.py +88 -0
  85. aa_recruitment-0.2.0/aa_recruitment/tests/test_models.py +103 -0
  86. aa_recruitment-0.2.0/aa_recruitment/tests/test_version.py +14 -0
  87. aa_recruitment-0.2.0/aa_recruitment/tests/test_vetting.py +119 -0
  88. aa_recruitment-0.2.0/aa_recruitment/tests/test_vetting_checks.py +323 -0
  89. aa_recruitment-0.2.0/aa_recruitment/tests/test_vetting_settings.py +141 -0
  90. aa_recruitment-0.2.0/aa_recruitment/tests/test_views.py +138 -0
  91. aa_recruitment-0.2.0/aa_recruitment/tests/urls.py +8 -0
  92. aa_recruitment-0.2.0/aa_recruitment/urls.py +166 -0
  93. aa_recruitment-0.2.0/aa_recruitment/vetting/__init__.py +5 -0
  94. aa_recruitment-0.2.0/aa_recruitment/vetting/altdetect.py +304 -0
  95. aa_recruitment-0.2.0/aa_recruitment/vetting/audit_checks.py +784 -0
  96. aa_recruitment-0.2.0/aa_recruitment/vetting/blacklist.py +97 -0
  97. aa_recruitment-0.2.0/aa_recruitment/vetting/common.py +135 -0
  98. aa_recruitment-0.2.0/aa_recruitment/vetting/consistency.py +318 -0
  99. aa_recruitment-0.2.0/aa_recruitment/vetting/constants.py +69 -0
  100. aa_recruitment-0.2.0/aa_recruitment/vetting/context.py +274 -0
  101. aa_recruitment-0.2.0/aa_recruitment/vetting/datasources.py +115 -0
  102. aa_recruitment-0.2.0/aa_recruitment/vetting/discord_intel.py +155 -0
  103. aa_recruitment-0.2.0/aa_recruitment/vetting/engine.py +275 -0
  104. aa_recruitment-0.2.0/aa_recruitment/vetting/evewho.py +326 -0
  105. aa_recruitment-0.2.0/aa_recruitment/vetting/external.py +158 -0
  106. aa_recruitment-0.2.0/aa_recruitment/vetting/killactivity.py +668 -0
  107. aa_recruitment-0.2.0/aa_recruitment/vetting/recommendation.py +229 -0
  108. aa_recruitment-0.2.0/aa_recruitment/vetting/registry.py +600 -0
  109. aa_recruitment-0.2.0/aa_recruitment/vetting/wallet.py +424 -0
  110. aa_recruitment-0.2.0/aa_recruitment/vetting/zkill.py +446 -0
  111. aa_recruitment-0.2.0/aa_recruitment/views.py +1644 -0
  112. aa_recruitment-0.2.0/pyproject.toml +67 -0
@@ -0,0 +1,45 @@
1
+ *.py[cod]
2
+ __pycache__/
3
+ *.so
4
+ .Python
5
+ env/
6
+ build/
7
+ develop-eggs/
8
+ dist/
9
+ downloads/
10
+ eggs/
11
+ .eggs/
12
+ lib/
13
+ lib64/
14
+ parts/
15
+ sdist/
16
+ var/
17
+ wheels/
18
+ *.egg-info/
19
+ .installed.cfg
20
+ *.egg
21
+
22
+ # Unit test / coverage
23
+ .coverage
24
+ .coverage.*
25
+ .pytest_cache/
26
+ nosetests.xml
27
+ coverage.xml
28
+ *.cover
29
+ .hypothesis/
30
+
31
+ # Translations
32
+ *.pot
33
+
34
+ # Django
35
+ *.log
36
+ local_settings.py
37
+ db.sqlite3
38
+ db.sqlite3-journal
39
+
40
+ # IDEs
41
+ .idea/
42
+ .vscode/
43
+ *.swp
44
+ *.swo
45
+ dump.rdb
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Machiel Broekman
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,263 @@
1
+ Metadata-Version: 2.5
2
+ Name: aa-recruitment
3
+ Version: 0.2.0
4
+ Summary: Recruitment and Application Management Plugin for Alliance Auth
5
+ Author-email: Maddog Broekman <maddogbroekman@gmail.com>
6
+ License: MIT
7
+ License-File: LICENSE
8
+ Keywords: allianceauth,eveonline,hr,recruitment
9
+ Classifier: Environment :: Web Environment
10
+ Classifier: Framework :: Django
11
+ Classifier: Framework :: Django :: 4.2
12
+ Classifier: Framework :: Django :: 5.0
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Operating System :: OS Independent
16
+ Classifier: Programming Language :: Python
17
+ Classifier: Programming Language :: Python :: 3 :: Only
18
+ Classifier: Programming Language :: Python :: 3.10
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Topic :: Internet :: WWW/HTTP
22
+ Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
23
+ Requires-Python: <3.14,>=3.10
24
+ Requires-Dist: allianceauth>=3.6.0
25
+ Requires-Dist: pypdf>=4.0
26
+ Requires-Dist: requests>=2.28.0
27
+ Provides-Extra: dev
28
+ Requires-Dist: build>=1.0.0; extra == 'dev'
29
+ Requires-Dist: ruff>=0.3.0; extra == 'dev'
30
+ Provides-Extra: test
31
+ Requires-Dist: pytest-django>=4.5; extra == 'test'
32
+ Requires-Dist: pytest>=7.0; extra == 'test'
33
+ Description-Content-Type: text/markdown
34
+
35
+ # AA Recruitment
36
+
37
+ Recruitment and Application Management Plugin for **Alliance Auth**.
38
+
39
+ Manage corporation and alliance recruitment workflows directly within Alliance Auth: customizable application forms, dynamic questionnaires, applicant dossiers, multi-stage status reviews, and Discord alerts.
40
+
41
+ ---
42
+
43
+ ## Features
44
+
45
+ - **Custom Application Forms:** Create corporation or division-specific recruitment postings with custom requirements and guidelines.
46
+ - **Dynamic Questionnaires:** Configure question types (short text, multi-line text, dropdown choices, checkboxes, numbers) with custom ordering.
47
+ - **Applicant Dashboard:** Users can submit applications, monitor their status, view recruiter feedback, and respond to inquiries.
48
+ - **Recruiter Workflow:**
49
+ - Dedicated review queue with status and form filters.
50
+ - Candidate dossier displaying Auth profile, linked characters, and submitted answers.
51
+ - Reviewer assignment and status transitions (`Pending Review` → `Under Review` → `Accepted` / `Rejected`).
52
+ - Internal recruiter notes (hidden from applicants) alongside public applicant feedback.
53
+ - **Audit Log:** Complete history of status changes, reviewer assignments, and actions.
54
+ - **Discord & In-App Alerts:** Webhook embed notifications for new applications and status updates, plus Alliance Auth native notifications.
55
+
56
+ ---
57
+
58
+ ## Installation
59
+
60
+ ### 1. Install the package
61
+ In your Alliance Auth virtual environment:
62
+
63
+ ```bash
64
+ pip install -e /path/to/plugins/aa-recruitment
65
+ ```
66
+
67
+ ### 2. Configure Alliance Auth
68
+ Add `'aa_recruitment'` to `INSTALLED_APPS` in your `local.py`:
69
+
70
+ ```python
71
+ INSTALLED_APPS += [
72
+ "aa_recruitment",
73
+ ]
74
+ ```
75
+
76
+ ### 3. Run Migrations & Collect Static
77
+ ```bash
78
+ python manage.py migrate
79
+ python manage.py collectstatic --noinput
80
+ ```
81
+
82
+ ### 4. Restart Services
83
+ ```bash
84
+ sudo supervisorctl restart all
85
+ ```
86
+
87
+ ---
88
+
89
+ ## Language of Discord messages
90
+
91
+ Discord messages don't follow the language of the recruiter who triggers them. Webhook posts use the language set per application form, or else in **Recruitment Forms & Settings -> Discord Messages**; when neither is set, the installation default applies. Notifications and direct messages to applicants use the applicant's own Alliance Auth language. Set the default in `myauth/settings/local.py` (it falls back to `LANGUAGE_CODE`):
92
+
93
+ ```python
94
+ DISCORD_MESSAGE_LANGUAGE = "en" # or e.g. "nl-nl"
95
+ ```
96
+
97
+ ## Vetting checks
98
+
99
+ Every application is vetted automatically. Next to the INIT blacklist, EVEWho corp history and zKillboard profile, the
100
+ plugin checks the applicant's **Character Audit** data (corptools; memberaudit for the wallet only):
101
+
102
+ | Check | What it looks for |
103
+ |---|---|
104
+ | Wallet | Large inbound transfers vs. the balance; donations with characters that are not declared alts; income sources; a corp-wallet withdrawal within 14 days before leaving that corp (the corp-theft signature); PLEX/extractor patterns; a wallet that came back to life just before applying |
105
+ | Alt detection | Donations and trades, low/zero-price contracts, watched or high-standing contacts and overlapping corp history with characters outside the applicant's Auth account; linked characters checked against the INIT blacklist |
106
+ | Character status | Current corp/alliance and coalition, unaffiliated, not logged in recently, an old character with very few logins |
107
+ | Skills | Focus areas by SP, cyno/capital/covert context, tutorial rewards near character creation |
108
+ | Assets | Items in hostile sovereign space (live ESI sovereignty), ships the visible skills cannot fly |
109
+ | Contracts | RMT wording, contracts far above the balance, repeated contracts with the same outsider, failed contracts |
110
+ | Mail | Serious keywords (CCP warnings, bans) and softer ones in 1-to-1 mails; only subjects go into the report |
111
+ | Mining | Ledger entries and systems |
112
+ | Killboard per corp stay | Active days, sessions (fleets), breaks, a burst after joining, quiet before leaving; heatmap from 6 months of killmails |
113
+ | Application | Risk language in the answers, the "all characters added?" answer, claimed playstyle vs. skills, ledger, bounties and kills |
114
+ | EVE forums, transcripts | Forum search for all characters; search of recruitment transcripts (upload PDFs in Django admin → Recruitment Transcripts) |
115
+
116
+ Transfers with your own corporation and alliance (SRP, buyback, payouts) never raise a finding. Set them with:
117
+
118
+ ```python
119
+ AA_RECRUITMENT_TRUSTED_CORPORATION_IDS = [98000001] # the Activity Settings corporation is added automatically
120
+ AA_RECRUITMENT_TRUSTED_ALLIANCE_IDS = [1900696668] # its alliance is added automatically
121
+ AA_RECRUITMENT_TRUSTED_CHARACTER_NAMES = ["Buyback Service"]
122
+ AA_RECRUITMENT_HOSTILE_TERMS = [...] # optional: replaces the built-in hostile list
123
+ AA_RECRUITMENT_FRIENDLY_TERMS = [...]
124
+ ```
125
+
126
+ Hostile terms match whole words only ("pl" no longer matches "Exploration"). All results are listed per check in the
127
+ dossier's **Audit Details** tab.
128
+
129
+ ### Vetting settings and data sources
130
+
131
+ **Recruitment → Vetting Settings** lists every check: what it looks at, where the data comes from, its parameters
132
+ (thresholds and word lists) and every finding it can raise with its severity. Recruiters with `manage_recruitment`
133
+ can read it; `admin_recruitment` can switch a check off, change a parameter, give a finding another severity or hide
134
+ it, and reset a check to its defaults. Only values that differ from the code are stored (model `CheckConfig`).
135
+ Changes apply to the next vetting run (**Re-Run Audit** on a dossier). The hostile and friendly term lists set here
136
+ win over `AA_RECRUITMENT_HOSTILE_TERMS` / `AA_RECRUITMENT_FRIENDLY_TERMS`.
137
+
138
+ **Data sources** (button on the settings page and in every dossier) reads each Character Audit data type for one
139
+ applicant, the same way the vetting does, and shows the rows, the time and the exact error when a read fails, plus
140
+ which Auth characters are in Character Audit and how many rows each holds. Every report also gets a **Data sources**
141
+ section; characters that are not in Character Audit at all are a medium finding. `AA_RECRUITMENT_AUDIT_BACKEND`
142
+ (`corptools` or `memberaudit`) forces the audit app when both are installed.
143
+
144
+ **Character Audit site** (top of Vetting Settings) sets where the Character Audit data comes from and where the
145
+ dossier's **Character Audit** button points. Empty, or this Auth's own address: the local database is read. Another
146
+ Auth (for example Prod while testing on Dev): its corptools API is read (`/audit/api/account/<id>/...`) with the
147
+ session cookie of a user there who can see the applicant (`corptools.view_characteraudit` plus `guest_hr` for
148
+ applicants, or `global_hr`). **Test connection** checks it. Through the API, mail bodies are not available and mining
149
+ is grouped per day and ore. `AA_RECRUITMENT_AUDIT_SITE_URL` and `AA_RECRUITMENT_AUDIT_SESSION` in local.py override the
150
+ fields and keep the cookie out of the database. When moving to Prod, clear the field (or set it to Prod's own address)
151
+ and remove the cookie.
152
+
153
+ In the dossier, findings are listed most severe first, can be filtered by severity, and open to show the evidence,
154
+ the question to ask and the recruiter action; **Show the details** jumps to the data behind a finding.
155
+
156
+ ## Member activity (Activity Center)
157
+
158
+ **Recruitment → Member Activity** is the 3Gods userscript's Activity Center, inside Auth, for everyone with
159
+ `view_member_activity`. The page runs the userscript's own dashboard code (`static/aa_recruitment/js/activity_center.js`)
160
+ on data from the plugin (`activity/data.json`), so it looks and works the same:
161
+
162
+ - Fleet participation (FATs): tiles, INIT compliance (VIP limit, 6-month rule, dropping below soon), FATs per month,
163
+ FAT minimum per month, members by status, Top 10 per period (FATs, kills, ISK destroyed).
164
+ - Killboard: tiles, kills / losses / ISK destroyed / ISK lost per month, participation per month, status per update,
165
+ weekday x hour heatmap of the last 90 days.
166
+ - Members: Leave of Absence list, last 30 / 90 days or a calendar month, status chips and special filters, search,
167
+ tiles for the view, sortable table with tags and month bars, CSV export of the view.
168
+ - Member drawer: tiles, FAT history with chart, LoA, other activity, per calendar month, kills/losses and ISK charts,
169
+ history over updates, characters, recent killmails and **Contact member** (the friendly check-in message).
170
+ - Export menu: members (latest / every update), 3Gods (every update / per month), characters per month, killmails.
171
+
172
+ The data is collected by the Celery task `aa_recruitment.tasks.update_member_activity` (run it daily); recruitment
173
+ admins can start it with **Run update** and change the status rules and VIPs with **Settings**. Without a FAT source
174
+ or LoA provider configured on the server, the page reads Auth's FAT analysis (`/fatanalysis/`) and LoA HR dashboard
175
+ (`/loa/hr/`) in the browser, exactly like the userscript. **Open ticket form** copies the message to the clipboard;
176
+ with the userscript installed the kanban form is filled in as before.
177
+
178
+ `AA_RECRUITMENT_TICKET_URL` (default `/kanban/tickets/create/`) and `AA_RECRUITMENT_LOA_URL` set the links used by the
179
+ member page.
180
+
181
+ ## Member activity & INIT compliance
182
+
183
+ **Recruitment → INIT Compliance** shows, for the members of one corporation (mains whose main character is in it):
184
+
185
+ - **VIP limit (INIT rule 1):** VIPs against the allowance (3 up to 50 mains, otherwise 5% of mains rounded up).
186
+ - **Long-term inactive (INIT rule 3):** fewer than 15 FATs over the last 6 full months. VIPs are left out; a leave of absence does not exempt anyone. Members who joined during those 6 months are not judged yet.
187
+ - **Dropping below soon:** still compliant, but below the 6-month minimum by the end of this month or next month if they join no more fleets.
188
+ - **Below INIT 90 days:** fewer than 15 FATs over the last 3 full months (new members and members on leave left out).
189
+ - Per member a small bar chart of FATs per month (6 full months plus the running month, shown lighter) and an outlook: *below now*, *below from end <month>*, *safe 6+ months* or *not 6 months yet*.
190
+
191
+ Only full months are judged. INIT rule 2 (Discord, Mumble and ghost compliance) is not checked.
192
+
193
+ ### Setup
194
+
195
+ 1. In Django admin → **Activity Settings**, set the **corporation ID** to track. The FAT minimums (5 per month, 15 per 90 days, 15 per 6 months) and the "new member" window (35 days) can be changed there.
196
+ 2. Add VIPs in Django admin → **VIP Members**.
197
+ 3. Give the people who should see the page the permission `aa_recruitment.view_member_activity`.
198
+ 4. Schedule the daily update in `local.py`:
199
+
200
+ ```python
201
+ CELERYBEAT_SCHEDULE["aa_recruitment_update_member_activity"] = {
202
+ "task": "aa_recruitment.tasks.update_member_activity",
203
+ "schedule": crontab(minute=17, hour=3),
204
+ }
205
+ ```
206
+
207
+ Recruitment administrators can also start an update from the page.
208
+
209
+ ### Where the data comes from
210
+
211
+ | Data | Source |
212
+ |---|---|
213
+ | FATs | aFAT or Alliance Auth's fleet activity tracking, found automatically. Any other FAT app: set `AA_RECRUITMENT_FAT_PROVIDER` (below). |
214
+ | Kills and losses per month | zKillboard stats endpoint, all characters of the member. Turn off with `AA_RECRUITMENT_ACTIVITY_KILLBOARD = False`; pause between calls `AA_RECRUITMENT_ZKILL_PAUSE` (default 1 second). |
215
+ | Join date | ESI corporation history of the main character. |
216
+ | Leave of absence | Optional: `AA_RECRUITMENT_LOA_PROVIDER` (below). |
217
+
218
+ Custom FAT or LoA source, for apps the plugin does not know:
219
+
220
+ ```python
221
+ # myapp/recruitment.py
222
+ def fats(users, since):
223
+ """users: QuerySet of User; since: date. Return {user_id: {date(2026, 10, 1): 17, ...}}"""
224
+
225
+
226
+ def leaves(users, today):
227
+ """Return {user_id: {"start": date, "end": date or None, "reason": str}} for active leaves."""
228
+
229
+
230
+ # local.py
231
+ AA_RECRUITMENT_FAT_PROVIDER = "myapp.recruitment.fats"
232
+ AA_RECRUITMENT_LOA_PROVIDER = "myapp.recruitment.leaves"
233
+ ```
234
+
235
+ ### Character audit apps
236
+
237
+ Alt detection reads wallet transfers from **corptools** (Character Audit) or **memberaudit**, whichever is installed (`aa_recruitment/sources/audit.py`). Contract and contact checks still need memberaudit.
238
+
239
+ ---
240
+
241
+ ## Permissions
242
+
243
+ | Permission | Codename | Description |
244
+ | :--- | :--- | :--- |
245
+ | **Basic Access** | `aa_recruitment.basic_access` | View recruitment forms, submit applications, and track own status. |
246
+ | **Recruitment Officer** | `aa_recruitment.manage_recruitment` | Access review queue, manage applications, add comments, assign reviewers, update status. |
247
+ | **Recruitment Administrator** | `aa_recruitment.admin_recruitment` | Create and edit application forms, questions, and global plugin configuration. |
248
+ | **Activity Viewer** | `aa_recruitment.view_member_activity` | View member activity and the INIT compliance page. |
249
+
250
+ ---
251
+
252
+ ## Celery Tasks
253
+
254
+ Add periodic tasks to `CELERYBEAT_SCHEDULE` if using scheduled maintenance (optional):
255
+
256
+ ```python
257
+ # Optional periodic cleanup or reminder tasks
258
+ ```
259
+
260
+ ---
261
+
262
+ ## License
263
+ MIT License.
@@ -0,0 +1,229 @@
1
+ # AA Recruitment
2
+
3
+ Recruitment and Application Management Plugin for **Alliance Auth**.
4
+
5
+ Manage corporation and alliance recruitment workflows directly within Alliance Auth: customizable application forms, dynamic questionnaires, applicant dossiers, multi-stage status reviews, and Discord alerts.
6
+
7
+ ---
8
+
9
+ ## Features
10
+
11
+ - **Custom Application Forms:** Create corporation or division-specific recruitment postings with custom requirements and guidelines.
12
+ - **Dynamic Questionnaires:** Configure question types (short text, multi-line text, dropdown choices, checkboxes, numbers) with custom ordering.
13
+ - **Applicant Dashboard:** Users can submit applications, monitor their status, view recruiter feedback, and respond to inquiries.
14
+ - **Recruiter Workflow:**
15
+ - Dedicated review queue with status and form filters.
16
+ - Candidate dossier displaying Auth profile, linked characters, and submitted answers.
17
+ - Reviewer assignment and status transitions (`Pending Review` → `Under Review` → `Accepted` / `Rejected`).
18
+ - Internal recruiter notes (hidden from applicants) alongside public applicant feedback.
19
+ - **Audit Log:** Complete history of status changes, reviewer assignments, and actions.
20
+ - **Discord & In-App Alerts:** Webhook embed notifications for new applications and status updates, plus Alliance Auth native notifications.
21
+
22
+ ---
23
+
24
+ ## Installation
25
+
26
+ ### 1. Install the package
27
+ In your Alliance Auth virtual environment:
28
+
29
+ ```bash
30
+ pip install -e /path/to/plugins/aa-recruitment
31
+ ```
32
+
33
+ ### 2. Configure Alliance Auth
34
+ Add `'aa_recruitment'` to `INSTALLED_APPS` in your `local.py`:
35
+
36
+ ```python
37
+ INSTALLED_APPS += [
38
+ "aa_recruitment",
39
+ ]
40
+ ```
41
+
42
+ ### 3. Run Migrations & Collect Static
43
+ ```bash
44
+ python manage.py migrate
45
+ python manage.py collectstatic --noinput
46
+ ```
47
+
48
+ ### 4. Restart Services
49
+ ```bash
50
+ sudo supervisorctl restart all
51
+ ```
52
+
53
+ ---
54
+
55
+ ## Language of Discord messages
56
+
57
+ Discord messages don't follow the language of the recruiter who triggers them. Webhook posts use the language set per application form, or else in **Recruitment Forms & Settings -> Discord Messages**; when neither is set, the installation default applies. Notifications and direct messages to applicants use the applicant's own Alliance Auth language. Set the default in `myauth/settings/local.py` (it falls back to `LANGUAGE_CODE`):
58
+
59
+ ```python
60
+ DISCORD_MESSAGE_LANGUAGE = "en" # or e.g. "nl-nl"
61
+ ```
62
+
63
+ ## Vetting checks
64
+
65
+ Every application is vetted automatically. Next to the INIT blacklist, EVEWho corp history and zKillboard profile, the
66
+ plugin checks the applicant's **Character Audit** data (corptools; memberaudit for the wallet only):
67
+
68
+ | Check | What it looks for |
69
+ |---|---|
70
+ | Wallet | Large inbound transfers vs. the balance; donations with characters that are not declared alts; income sources; a corp-wallet withdrawal within 14 days before leaving that corp (the corp-theft signature); PLEX/extractor patterns; a wallet that came back to life just before applying |
71
+ | Alt detection | Donations and trades, low/zero-price contracts, watched or high-standing contacts and overlapping corp history with characters outside the applicant's Auth account; linked characters checked against the INIT blacklist |
72
+ | Character status | Current corp/alliance and coalition, unaffiliated, not logged in recently, an old character with very few logins |
73
+ | Skills | Focus areas by SP, cyno/capital/covert context, tutorial rewards near character creation |
74
+ | Assets | Items in hostile sovereign space (live ESI sovereignty), ships the visible skills cannot fly |
75
+ | Contracts | RMT wording, contracts far above the balance, repeated contracts with the same outsider, failed contracts |
76
+ | Mail | Serious keywords (CCP warnings, bans) and softer ones in 1-to-1 mails; only subjects go into the report |
77
+ | Mining | Ledger entries and systems |
78
+ | Killboard per corp stay | Active days, sessions (fleets), breaks, a burst after joining, quiet before leaving; heatmap from 6 months of killmails |
79
+ | Application | Risk language in the answers, the "all characters added?" answer, claimed playstyle vs. skills, ledger, bounties and kills |
80
+ | EVE forums, transcripts | Forum search for all characters; search of recruitment transcripts (upload PDFs in Django admin → Recruitment Transcripts) |
81
+
82
+ Transfers with your own corporation and alliance (SRP, buyback, payouts) never raise a finding. Set them with:
83
+
84
+ ```python
85
+ AA_RECRUITMENT_TRUSTED_CORPORATION_IDS = [98000001] # the Activity Settings corporation is added automatically
86
+ AA_RECRUITMENT_TRUSTED_ALLIANCE_IDS = [1900696668] # its alliance is added automatically
87
+ AA_RECRUITMENT_TRUSTED_CHARACTER_NAMES = ["Buyback Service"]
88
+ AA_RECRUITMENT_HOSTILE_TERMS = [...] # optional: replaces the built-in hostile list
89
+ AA_RECRUITMENT_FRIENDLY_TERMS = [...]
90
+ ```
91
+
92
+ Hostile terms match whole words only ("pl" no longer matches "Exploration"). All results are listed per check in the
93
+ dossier's **Audit Details** tab.
94
+
95
+ ### Vetting settings and data sources
96
+
97
+ **Recruitment → Vetting Settings** lists every check: what it looks at, where the data comes from, its parameters
98
+ (thresholds and word lists) and every finding it can raise with its severity. Recruiters with `manage_recruitment`
99
+ can read it; `admin_recruitment` can switch a check off, change a parameter, give a finding another severity or hide
100
+ it, and reset a check to its defaults. Only values that differ from the code are stored (model `CheckConfig`).
101
+ Changes apply to the next vetting run (**Re-Run Audit** on a dossier). The hostile and friendly term lists set here
102
+ win over `AA_RECRUITMENT_HOSTILE_TERMS` / `AA_RECRUITMENT_FRIENDLY_TERMS`.
103
+
104
+ **Data sources** (button on the settings page and in every dossier) reads each Character Audit data type for one
105
+ applicant, the same way the vetting does, and shows the rows, the time and the exact error when a read fails, plus
106
+ which Auth characters are in Character Audit and how many rows each holds. Every report also gets a **Data sources**
107
+ section; characters that are not in Character Audit at all are a medium finding. `AA_RECRUITMENT_AUDIT_BACKEND`
108
+ (`corptools` or `memberaudit`) forces the audit app when both are installed.
109
+
110
+ **Character Audit site** (top of Vetting Settings) sets where the Character Audit data comes from and where the
111
+ dossier's **Character Audit** button points. Empty, or this Auth's own address: the local database is read. Another
112
+ Auth (for example Prod while testing on Dev): its corptools API is read (`/audit/api/account/<id>/...`) with the
113
+ session cookie of a user there who can see the applicant (`corptools.view_characteraudit` plus `guest_hr` for
114
+ applicants, or `global_hr`). **Test connection** checks it. Through the API, mail bodies are not available and mining
115
+ is grouped per day and ore. `AA_RECRUITMENT_AUDIT_SITE_URL` and `AA_RECRUITMENT_AUDIT_SESSION` in local.py override the
116
+ fields and keep the cookie out of the database. When moving to Prod, clear the field (or set it to Prod's own address)
117
+ and remove the cookie.
118
+
119
+ In the dossier, findings are listed most severe first, can be filtered by severity, and open to show the evidence,
120
+ the question to ask and the recruiter action; **Show the details** jumps to the data behind a finding.
121
+
122
+ ## Member activity (Activity Center)
123
+
124
+ **Recruitment → Member Activity** is the 3Gods userscript's Activity Center, inside Auth, for everyone with
125
+ `view_member_activity`. The page runs the userscript's own dashboard code (`static/aa_recruitment/js/activity_center.js`)
126
+ on data from the plugin (`activity/data.json`), so it looks and works the same:
127
+
128
+ - Fleet participation (FATs): tiles, INIT compliance (VIP limit, 6-month rule, dropping below soon), FATs per month,
129
+ FAT minimum per month, members by status, Top 10 per period (FATs, kills, ISK destroyed).
130
+ - Killboard: tiles, kills / losses / ISK destroyed / ISK lost per month, participation per month, status per update,
131
+ weekday x hour heatmap of the last 90 days.
132
+ - Members: Leave of Absence list, last 30 / 90 days or a calendar month, status chips and special filters, search,
133
+ tiles for the view, sortable table with tags and month bars, CSV export of the view.
134
+ - Member drawer: tiles, FAT history with chart, LoA, other activity, per calendar month, kills/losses and ISK charts,
135
+ history over updates, characters, recent killmails and **Contact member** (the friendly check-in message).
136
+ - Export menu: members (latest / every update), 3Gods (every update / per month), characters per month, killmails.
137
+
138
+ The data is collected by the Celery task `aa_recruitment.tasks.update_member_activity` (run it daily); recruitment
139
+ admins can start it with **Run update** and change the status rules and VIPs with **Settings**. Without a FAT source
140
+ or LoA provider configured on the server, the page reads Auth's FAT analysis (`/fatanalysis/`) and LoA HR dashboard
141
+ (`/loa/hr/`) in the browser, exactly like the userscript. **Open ticket form** copies the message to the clipboard;
142
+ with the userscript installed the kanban form is filled in as before.
143
+
144
+ `AA_RECRUITMENT_TICKET_URL` (default `/kanban/tickets/create/`) and `AA_RECRUITMENT_LOA_URL` set the links used by the
145
+ member page.
146
+
147
+ ## Member activity & INIT compliance
148
+
149
+ **Recruitment → INIT Compliance** shows, for the members of one corporation (mains whose main character is in it):
150
+
151
+ - **VIP limit (INIT rule 1):** VIPs against the allowance (3 up to 50 mains, otherwise 5% of mains rounded up).
152
+ - **Long-term inactive (INIT rule 3):** fewer than 15 FATs over the last 6 full months. VIPs are left out; a leave of absence does not exempt anyone. Members who joined during those 6 months are not judged yet.
153
+ - **Dropping below soon:** still compliant, but below the 6-month minimum by the end of this month or next month if they join no more fleets.
154
+ - **Below INIT 90 days:** fewer than 15 FATs over the last 3 full months (new members and members on leave left out).
155
+ - Per member a small bar chart of FATs per month (6 full months plus the running month, shown lighter) and an outlook: *below now*, *below from end <month>*, *safe 6+ months* or *not 6 months yet*.
156
+
157
+ Only full months are judged. INIT rule 2 (Discord, Mumble and ghost compliance) is not checked.
158
+
159
+ ### Setup
160
+
161
+ 1. In Django admin → **Activity Settings**, set the **corporation ID** to track. The FAT minimums (5 per month, 15 per 90 days, 15 per 6 months) and the "new member" window (35 days) can be changed there.
162
+ 2. Add VIPs in Django admin → **VIP Members**.
163
+ 3. Give the people who should see the page the permission `aa_recruitment.view_member_activity`.
164
+ 4. Schedule the daily update in `local.py`:
165
+
166
+ ```python
167
+ CELERYBEAT_SCHEDULE["aa_recruitment_update_member_activity"] = {
168
+ "task": "aa_recruitment.tasks.update_member_activity",
169
+ "schedule": crontab(minute=17, hour=3),
170
+ }
171
+ ```
172
+
173
+ Recruitment administrators can also start an update from the page.
174
+
175
+ ### Where the data comes from
176
+
177
+ | Data | Source |
178
+ |---|---|
179
+ | FATs | aFAT or Alliance Auth's fleet activity tracking, found automatically. Any other FAT app: set `AA_RECRUITMENT_FAT_PROVIDER` (below). |
180
+ | Kills and losses per month | zKillboard stats endpoint, all characters of the member. Turn off with `AA_RECRUITMENT_ACTIVITY_KILLBOARD = False`; pause between calls `AA_RECRUITMENT_ZKILL_PAUSE` (default 1 second). |
181
+ | Join date | ESI corporation history of the main character. |
182
+ | Leave of absence | Optional: `AA_RECRUITMENT_LOA_PROVIDER` (below). |
183
+
184
+ Custom FAT or LoA source, for apps the plugin does not know:
185
+
186
+ ```python
187
+ # myapp/recruitment.py
188
+ def fats(users, since):
189
+ """users: QuerySet of User; since: date. Return {user_id: {date(2026, 10, 1): 17, ...}}"""
190
+
191
+
192
+ def leaves(users, today):
193
+ """Return {user_id: {"start": date, "end": date or None, "reason": str}} for active leaves."""
194
+
195
+
196
+ # local.py
197
+ AA_RECRUITMENT_FAT_PROVIDER = "myapp.recruitment.fats"
198
+ AA_RECRUITMENT_LOA_PROVIDER = "myapp.recruitment.leaves"
199
+ ```
200
+
201
+ ### Character audit apps
202
+
203
+ Alt detection reads wallet transfers from **corptools** (Character Audit) or **memberaudit**, whichever is installed (`aa_recruitment/sources/audit.py`). Contract and contact checks still need memberaudit.
204
+
205
+ ---
206
+
207
+ ## Permissions
208
+
209
+ | Permission | Codename | Description |
210
+ | :--- | :--- | :--- |
211
+ | **Basic Access** | `aa_recruitment.basic_access` | View recruitment forms, submit applications, and track own status. |
212
+ | **Recruitment Officer** | `aa_recruitment.manage_recruitment` | Access review queue, manage applications, add comments, assign reviewers, update status. |
213
+ | **Recruitment Administrator** | `aa_recruitment.admin_recruitment` | Create and edit application forms, questions, and global plugin configuration. |
214
+ | **Activity Viewer** | `aa_recruitment.view_member_activity` | View member activity and the INIT compliance page. |
215
+
216
+ ---
217
+
218
+ ## Celery Tasks
219
+
220
+ Add periodic tasks to `CELERYBEAT_SCHEDULE` if using scheduled maintenance (optional):
221
+
222
+ ```python
223
+ # Optional periodic cleanup or reminder tasks
224
+ ```
225
+
226
+ ---
227
+
228
+ ## License
229
+ MIT License.
@@ -0,0 +1,2 @@
1
+ default_app_config = "aa_recruitment.apps.AaRecruitmentConfig"
2
+ __version__ = "0.2.0"
@@ -0,0 +1 @@
1
+ """Member activity tracking and INIT compliance (FATs first, killboard second)."""