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.
- aa_recruitment-0.2.0/.gitignore +45 -0
- aa_recruitment-0.2.0/LICENSE +21 -0
- aa_recruitment-0.2.0/PKG-INFO +263 -0
- aa_recruitment-0.2.0/README.md +229 -0
- aa_recruitment-0.2.0/aa_recruitment/__init__.py +2 -0
- aa_recruitment-0.2.0/aa_recruitment/activity/__init__.py +1 -0
- aa_recruitment-0.2.0/aa_recruitment/activity/center.py +373 -0
- aa_recruitment-0.2.0/aa_recruitment/activity/compliance.py +132 -0
- aa_recruitment-0.2.0/aa_recruitment/activity/dashboard.py +358 -0
- aa_recruitment-0.2.0/aa_recruitment/activity/messages.py +296 -0
- aa_recruitment-0.2.0/aa_recruitment/activity/rules.py +127 -0
- aa_recruitment-0.2.0/aa_recruitment/activity/sync.py +445 -0
- aa_recruitment-0.2.0/aa_recruitment/admin.py +338 -0
- aa_recruitment-0.2.0/aa_recruitment/app_settings.py +12 -0
- aa_recruitment-0.2.0/aa_recruitment/apps.py +11 -0
- aa_recruitment-0.2.0/aa_recruitment/auth_hooks.py +104 -0
- aa_recruitment-0.2.0/aa_recruitment/discord_i18n.py +44 -0
- aa_recruitment-0.2.0/aa_recruitment/forms.py +346 -0
- aa_recruitment-0.2.0/aa_recruitment/locale/en/LC_MESSAGES/django.mo +0 -0
- aa_recruitment-0.2.0/aa_recruitment/locale/en/LC_MESSAGES/django.po +569 -0
- aa_recruitment-0.2.0/aa_recruitment/locale/nl/LC_MESSAGES/django.mo +0 -0
- aa_recruitment-0.2.0/aa_recruitment/locale/nl/LC_MESSAGES/django.po +656 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0001_initial.py +556 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0002_recruitmentconfig_portal_menu_title_and_more.py +32 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0003_vettingreport_zkill_data.py +21 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0004_vettingreport_corp_history.py +21 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0005_discordintelchannel_and_more.py +128 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0006_corpactivitysnapshot_corpcombatstats_and_more.py +113 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0007_corpmemberactivity_isk_destroyed_120d_and_more.py +52 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0008_discord_language.py +32 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0009_member_activity_init_compliance.py +174 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0010_vetting_parity.py +81 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0011_activity_dashboard.py +77 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0012_check_config.py +70 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/0013_activity_center.py +128 -0
- aa_recruitment-0.2.0/aa_recruitment/migrations/__init__.py +1 -0
- aa_recruitment-0.2.0/aa_recruitment/models.py +883 -0
- aa_recruitment-0.2.0/aa_recruitment/services/__init__.py +1 -0
- aa_recruitment-0.2.0/aa_recruitment/services/corp_trends.py +699 -0
- aa_recruitment-0.2.0/aa_recruitment/services/discord_intel.py +370 -0
- aa_recruitment-0.2.0/aa_recruitment/signals.py +3 -0
- aa_recruitment-0.2.0/aa_recruitment/sources/__init__.py +14 -0
- aa_recruitment-0.2.0/aa_recruitment/sources/audit.py +489 -0
- aa_recruitment-0.2.0/aa_recruitment/sources/audit_remote.py +444 -0
- aa_recruitment-0.2.0/aa_recruitment/sources/coalitions.py +88 -0
- aa_recruitment-0.2.0/aa_recruitment/sources/esi.py +167 -0
- aa_recruitment-0.2.0/aa_recruitment/sources/fats.py +92 -0
- aa_recruitment-0.2.0/aa_recruitment/sources/loa.py +32 -0
- aa_recruitment-0.2.0/aa_recruitment/static/aa_recruitment/js/activity_center.js +1984 -0
- aa_recruitment-0.2.0/aa_recruitment/tasks.py +230 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/activity_compliance.html +91 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/activity_dashboard.html +23 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/activity_member.html +127 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/application_detail.html +145 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/apply.html +67 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/base.html +62 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/corp_trends.html +985 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/discord_channel_edit.html +130 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/form_edit.html +113 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/includes/activity_styles.html +46 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/includes/activity_table.html +48 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/includes/audit_sections.html +36 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/includes/styles.html +358 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/includes/vetting_styles.html +123 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/index.html +189 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/manage_forms.html +545 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/manage_questions.html +119 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/my_applications.html +90 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/portal.html +109 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/portal_base.html +44 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/question_edit.html +103 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/recruiter_detail.html +830 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/recruiter_queue.html +141 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/vetting_datasources.html +72 -0
- aa_recruitment-0.2.0/aa_recruitment/templates/aa_recruitment/vetting_settings.html +177 -0
- aa_recruitment-0.2.0/aa_recruitment/templatetags/__init__.py +0 -0
- aa_recruitment-0.2.0/aa_recruitment/templatetags/aa_recruitment_version.py +24 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/__init__.py +1 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_activity.py +183 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_activity_dashboard.py +266 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_audit_remote.py +174 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_corp_trends.py +315 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_discord_intel.py +250 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_discord_language.py +88 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_models.py +103 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_version.py +14 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_vetting.py +119 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_vetting_checks.py +323 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_vetting_settings.py +141 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/test_views.py +138 -0
- aa_recruitment-0.2.0/aa_recruitment/tests/urls.py +8 -0
- aa_recruitment-0.2.0/aa_recruitment/urls.py +166 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/__init__.py +5 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/altdetect.py +304 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/audit_checks.py +784 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/blacklist.py +97 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/common.py +135 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/consistency.py +318 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/constants.py +69 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/context.py +274 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/datasources.py +115 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/discord_intel.py +155 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/engine.py +275 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/evewho.py +326 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/external.py +158 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/killactivity.py +668 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/recommendation.py +229 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/registry.py +600 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/wallet.py +424 -0
- aa_recruitment-0.2.0/aa_recruitment/vetting/zkill.py +446 -0
- aa_recruitment-0.2.0/aa_recruitment/views.py +1644 -0
- 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 @@
|
|
|
1
|
+
"""Member activity tracking and INIT compliance (FATs first, killboard second)."""
|