aa-fitting-mastery 0.1.0__py3-none-any.whl

aa_fitting_mastery-0.1.0.dist-info/METADATA

@@ -0,0 +1,304 @@
+Metadata-Version: 2.4
+Name: aa-fitting-mastery
+Version: 0.1.0
+Summary: Fitting Mastery and Skill Plan generator.
+Author-email: Jay <jays.gaming.contact@gmail.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.2
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+License-File: LICENSE
+Requires-Dist: aa-memberaudit>=4.3.1
+Requires-Dist: fittings>=2.3.0
+Requires-Dist: allianceauth-app-utils>=1.18
+Requires-Dist: allianceauth>=4,<5
+Requires-Dist: django-esi>=8.3.1
+Requires-Dist: django-eveonline-sde>=0.0.1b2
+Project-URL: Changelog, https://github.com/hermesdj/aa-fitting-mastery/-/blob/master/CHANGELOG.md
+Project-URL: Homepage, https://github.com/hermesdj/aa-fitting-mastery
+Project-URL: Source, https://github.com/hermesdj/aa-fitting-mastery
+Project-URL: Tracker, https://github.com/hermesdj/aa-fitting-mastery/-/issues
+
+# Fitting Mastery Plugin for Alliance Auth
+
+`aa-fitting-mastery` is an [Alliance Auth](https://allianceauth.readthedocs.io/) plugin that turns doctrine fittings into actionable skill plans.
+
+It connects your configured doctrines and fittings from the `fittings` plugin with character and skill data from `aa-memberaudit`, then provides:
+
+- pilot readiness views for accessible doctrine fittings,
+- missing required and recommended skills,
+- exportable in-game skill plans,
+- configurable required and recommended skill plans per fitting,
+- leadership summary views for doctrine coverage.
+
+[![release](https://img.shields.io/pypi/v/aa-fitting-mastery?label=release)](https://pypi.org/project/aa-fitting-mastery/)
+[![python](https://img.shields.io/pypi/pyversions/aa-fitting-mastery)](https://pypi.org/project/aa-fitting-mastery/)
+[![django](https://img.shields.io/pypi/djversions/aa-fitting-mastery?label=django)](https://pypi.org/project/aa-fitting-mastery/)
+[![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+## Contents
+
+- [Overview](#overview)
+- [Requirements](#requirements)
+- [Main features](#main-features)
+- [Screenshots](#screenshots)
+- [Installation](#installation)
+- [Updating](#updating)
+- [Configuration](#configuration)
+- [Permissions](#permissions)
+- [How it works](#how-it-works)
+- [Settings](#settings)
+
+## Overview
+
+Fitting Mastery is designed for organizations that already manage doctrine ships in `fittings` and track character skills in `aa-memberaudit`.
+
+The plugin adds two complementary workflows:
+
+1. **Pilot workflow**
+   - members can see which of their characters can fly a doctrine fitting,
+   - inspect missing required / recommended skills,
+   - export missing skills in a format suitable for EVE skill plan import.
+
+2. **Leadership workflow**
+   - doctrine managers can configure fitting skill plans,
+   - review suggestions to blacklist or restore skills,
+   - define summary groups across corporations and alliances,
+   - view doctrine coverage for a selected audience.
+
+Access to doctrines and fittings follows the visibility rules from the `fittings` plugin so that category restrictions are respected consistently.
+
+## Requirements
+
+This plugin depends on the following components:
+
+- `fittings` — required
+- `aa-memberaudit` — required
+- `django-eveonline-sde` / `eve_sde` — required for ship mastery and dogma data
+- Alliance Auth 4.x
+
+> **Important**
+> This plugin does **not** replace `fittings` or `aa-memberaudit`.
+> It builds on top of both. You need both plugins installed and working before enabling `mastery`.
+
+## Main features
+
+- Generate fitting skill plans from doctrine ships and their modules
+- Merge **required** fitting skills with **recommended** ship mastery skills
+- Add manual skills, blacklist skills, or override recommended levels per fitting
+- Detect and suggest skills that can be removed from a plan
+- Export missing skills in dependency-safe order for in-game EVE import
+- Support multiple export languages for skill names
+- Show member-facing doctrine readiness based on accessible fittings only
+- Show leadership doctrine coverage across configurable corp/alliance audience groups
+- Keep fitting access aligned with the access rules configured in the `fittings` plugin
+
+## Screenshots
+
+### Character progress
+
+![Character progress](https://raw.githubusercontent.com/hermesdj/aa-fitting-mastery/main/docs/view-character-progress.png)
+
+### Fitting skill plan management
+
+![Fitting skill plans](https://raw.githubusercontent.com/hermesdj/aa-fitting-mastery/main/docs/edit-fitting-skill-plans.png)
+
+## Installation
+
+### 1 - Install prerequisites
+
+Make sure your Alliance Auth installation already has these apps installed and configured:
+
+- `fittings`
+- `memberaudit`
+- `eve_sde`
+
+### 2 - Install the package
+
+Install the plugin into your Alliance Auth virtual environment:
+
+```bash
+pip install aa-fitting-mastery
+```
+
+### 3 - Add the app to Alliance Auth
+
+Add `mastery` to `INSTALLED_APPS` in your `local.py`:
+
+```python
+INSTALLED_APPS += [
+    "mastery",
+]
+```
+
+### 4 - Configure the scheduled SDE mastery update task
+
+Add the periodic task to your `CELERYBEAT_SCHEDULE` (every day at midnight):
+
+```python
+from celery.schedules import crontab
+
+CELERYBEAT_SCHEDULE["update_sde_masteries"] = {
+    "task": "mastery.tasks.update_sde_masteries",
+    "schedule": crontab(minute="0", hour="0"),
+}
+```
+
+### 5 - Run migrations and collect static files
+
+```bash
+python manage.py migrate
+python manage.py collectstatic
+```
+
+### 6 - Import mastery data
+
+Import ship mastery and certificate data from the EVE SDE:
+
+```bash
+python manage.py import_sde_masteries
+```
+
+For a test run without writing to the database:
+
+```bash
+python manage.py import_sde_masteries --dry-run
+```
+
+### 7 - Restart your services
+
+Restart your web and Celery services so the plugin and beat task are loaded.
+
+## Updating
+
+To update an existing installation:
+
+```bash
+pip install -U aa-fitting-mastery
+python manage.py migrate
+python manage.py collectstatic
+```
+
+Then restart your web and Celery services.
+
+## Configuration
+
+After installation, the usual setup flow is:
+
+1. **Ensure your doctrines and fittings already exist in the `fittings` plugin**
+2. Open **Manage Skill Plans** in Fitting Mastery
+3. Generate or sync doctrine skill plans
+4. Review each fitting and adjust:
+   - mastery level,
+   - manual skills,
+   - blacklisted skills,
+   - recommended level overrides,
+   - skill suggestions
+5. If you want doctrine leadership views, create audience groups in **Summary Group Settings**
+6. Assign the appropriate permissions to members, doctrine managers and leadership roles
+
+### Access model
+
+For pilot-facing views, Fitting Mastery uses the same fittings visibility rules as the `fittings` plugin.
+
+That means:
+
+- users must have access to `fittings` itself,
+- category restrictions remain effective,
+- doctrines and fittings that are hidden in `fittings` will not be exposed by Fitting Mastery.
+
+## Permissions
+
+The plugin defines the following permissions:
+
+| Code | Description |
+| --- | --- |
+| `basic_access` | Can access the pilot-facing Fitting Mastery pages |
+| `manage_fittings` | Can manage doctrine/fitting skill plans |
+| `doctrine_summary` | Can view leadership doctrine summary pages |
+| `manage_summary_groups` | Can create and manage summary audience groups |
+
+### Recommended usage
+
+- **Members**: `basic_access`
+- **Doctrine / fitting managers**: `basic_access`, `manage_fittings`
+- **Leadership / FC / HR reviewers**: `basic_access`, `doctrine_summary`
+- **Admins managing summary scopes**: `manage_summary_groups`
+
+In practice, pilot-facing access is usually granted together with fitting visibility from the `fittings` plugin.
+
+You will typically also want matching access in the `fittings` plugin, especially `fittings.access_fittings` or `fittings.manage`.
+
+## How it works
+
+At a high level the plugin works like this:
+
+1. It reads the ship and module requirements from fitting dogma data
+2. It reads ship mastery recommendations from imported SDE mastery data
+3. It combines both into a per-fitting skill plan
+4. It lets managers refine that plan with blacklists, manual additions and level overrides
+5. It compares those plans against character skills from `aa-memberaudit`
+6. It presents the result in pilot and leadership views
+
+### Required vs Recommended
+
+- **Required** skills come from fitting / module requirements and their recursive prerequisites
+- **Recommended** skills come from ship mastery data, plus any manual adjustments you configure
+
+### Summary groups
+
+Doctrine summary views can be scoped to configurable audience groups.
+
+Each summary group can combine:
+
+- corporations,
+- alliances,
+- mixed corporation/alliance audiences.
+
+This makes it possible to review doctrine coverage for a coalition, SIG, alliance wing or any other relevant operational scope.
+
+### Exported skill plans
+
+When exporting missing skills for a pilot, the plugin:
+
+- includes all missing intermediate levels,
+- adds missing prerequisites recursively,
+- orders skills so prerequisites appear first,
+- supports multiple languages for skill labels.
+
+## Settings
+
+The following setting can be added to your Alliance Auth `local.py`:
+
+| Name | Description | Default |
+| --- | --- | --- |
+| `MASTERY_PLAN_ESTIMATE_SP_PER_HOUR` | Training speed used to estimate plan duration in fitting previews | `1800` |
+
+Example:
+
+```python
+MASTERY_PLAN_ESTIMATE_SP_PER_HOUR = 1800
+```
+
+## Notes
+
+- If you change doctrine skill plan configuration, regenerate or sync the affected doctrine/fitting so changes are reflected in the active skill set.
+- If leadership summaries are enabled, remember to configure at least one summary audience group.
+- If no mastery data has been imported yet, recommended ship skills will be incomplete until `import_sde_masteries` has been run.
+- Fitting Mastery respects fitting visibility from the `fittings` plugin and will not intentionally expose restricted doctrines or fittings outside that access model.
+

aa_fitting_mastery-0.1.0.dist-info/RECORD

@@ -0,0 +1,80 @@
+mastery/__init__.py,sha256=zoqT0a5XHAA49Ejh87JnO4zuDvKp6z6jAqfKnMwRPaA,208
+mastery/app_settings.py,sha256=efQlmIlVIXHXChICmwDl71mKr8Q5WREVPZjq24T06CA,272
+mastery/apps.py,sha256=eWzHG0Eyb3lIpvcstAXZkyvgO-g3wXjQ2azpl2nhV9U,155
+mastery/auth_hooks.py,sha256=cs_uYeDHYzEwjqZOfRMZGYZz9SIvd9QjhU9l4Vs1TfE,723
+mastery/tasks.py,sha256=AmzcqPUvNwQ4XmSyti5xox1lbrPvG2cWQA0VRi4vG6U,1041
+mastery/urls.py,sha256=WXNmUZ0f529aR9-UJI4YisnBv8NEO-NIYf8pDO_gNuQ,2973
+mastery/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mastery/management/commands/import_sde_masteries.py,sha256=5cnpspLhXagnypJeGfAZZYskq1FX8e8-cNVQioWVSec,2267
+mastery/migrations/0001_initial.py,sha256=TjWdErcIuHX7m8QZPwxNnigbUKYVZsSF65yXi_VFj8g,7727
+mastery/migrations/0002_doctrineskillsetgroupmap_default_mastery_level_and_more.py,sha256=f0g6ZFFYN2iGgiyLnI9_XyN-0Cq8YC4VSXY0bLz9oPw,659
+mastery/migrations/0003_make_fitting_mastery_override_nullable.py,sha256=8pat3ZSgWUjCvlHle42PLfk7nLTIBSZqhgm9OLpRTJc,794
+mastery/migrations/0004_fittingskillcontrol_recommended_level_override.py,sha256=j8P3VjkBJje9q4BCPAznObB5kyRzC8ZzMsOQZSuh5pE,513
+mastery/migrations/0005_fittingskillsetmap_last_synced_at.py,sha256=7L0dpxfl0giFH5EG5HoQo6DmZWbfGtuGbXL_shJ_Ej0,427
+mastery/migrations/0006_fittingskillcontrol_is_manual.py,sha256=2ZX5fJg0E3s7UxPnDcuDNETX1XVDJk1SBu-AY4ctawo,396
+mastery/migrations/0007_general.py,sha256=uQAP8fWM3GWl1sFuCYaVVfc3UyC_dsTuABB7t2gHNBg,685
+mastery/migrations/0008_summary_audience_groups.py,sha256=cJLPcEpHwOIwRVcAPHRRFmgemPmAIYBsO7v0voKdOB4,2375
+mastery/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mastery/models/__init__.py,sha256=iAp0RCWO3yEzIbeQp8tO_bXcoq_kPI-J2mamkHiNGLI,372
+mastery/models/certificate_skill.py,sha256=iuMnXcM2UMP3QtLC0_Jpf53dY77ott6srtu0BI1wMhU,744
+mastery/models/doctrine_skill_snapshot.py,sha256=8GdjltTYeK66PrscvgPSM4WjXTDIvoYfF_tLFcdDGgg,1728
+mastery/models/doctrine_skillsetgroup_map.py,sha256=hVVcNXUSMmT9oYIlAV6LzEJW5_uoSdd2bm1pd0c9Bjk,824
+mastery/models/fitting_skill_control.py,sha256=HRxzxCTHZijbWH2J88k3IccDJZmiNUxw4iFHDAIf8cQ,1446
+mastery/models/fitting_skill_override.py,sha256=_kl3Owce3-e_nKmSLjlRQf9ROUdswqhWv1mfKdvBEHc,766
+mastery/models/fitting_skillset_map.py,sha256=qahUrh0F0CeTcwmOxmhG6XENgQ8Cv2YsKLuB3T8o-x4,1186
+mastery/models/general.py,sha256=GaCZjR-ZYy5IBTQaJQuLJGlfXetDBmm2Rdqz0s5TjNo,681
+mastery/models/sde_version.py,sha256=osK4dD_qHNucKhSDN-Jagan8k3kjhKARkPUZqBdNzc8,327
+mastery/models/ship_mastery.py,sha256=qwTXkJhVzrkoeUBw-M4x7DiTgD6HDMALKd5QXGMnba4,312
+mastery/models/ship_mastery_certificate.py,sha256=8nrnMO6BbWUmxe5Pqx1CPZXWxdMFoDIlwA-9KNOeNtw,478
+mastery/models/summary_group.py,sha256=5Fr8T9UOEEHnbADn0d467PBgs6G47HQ-6rQz336fjEk,1702
+mastery/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mastery/services/doctrine/__init__.py,sha256=42XnJ10t_7RS_a5SPYS7VJGdOyPFrshRTHXaxulxG7k,36
+mastery/services/doctrine/doctrine_map_service.py,sha256=AtJBurZJSR74_jtXxy-kAbrmFfJACLJVCKYL0pFRRXg,1658
+mastery/services/doctrine/doctrine_skill_service.py,sha256=cjLk-HWO0qy10ZoLMy2WCSTE-O1G1qKCXShFFV1pcbI,7114
+mastery/services/fittings/__init__.py,sha256=MjN6sOywL_infwb2_6tuPgCky5U6azWaRzJ3epW6Z0s,65
+mastery/services/fittings/fitting_map_service.py,sha256=uSPO1HQhEzxuJh6-6TGIK1_Fx1NW0pWSWlBC8QUi2bE,1109
+mastery/services/fittings/skill_extractor.py,sha256=bNlbt8p7D-QMoVY1DWJ-IwROhqrQHplwEW-ktp_2-B8,4355
+mastery/services/pilots/__init__.py,sha256=Z81y83hee4RxB9qyQD2lVYZA9bX37NvjYdfJyZH3_eY,169
+mastery/services/pilots/pilot_access_service.py,sha256=FdbVFSzWkl9onZbixfxnsEOwRd2fuzV-B4pVZp79s0c,2322
+mastery/services/pilots/pilot_progress_service.py,sha256=SQ0ARoOxiI1D75Y2hB2HRzjYuQQEByQ8g_3G9eXgE1I,42169
+mastery/services/sde/__init__.py,sha256=aBKB0gE6lnU6m3D6w0bGmBQ9u6q_ZGr7rw51P-ytAY0,85
+mastery/services/sde/importer.py,sha256=MO6asR41SMpqy_bRjHcze5vw19ACa1NtFOpLD9NrHCs,3830
+mastery/services/sde/mastery_service.py,sha256=IZ0j-S2pnj-Kmm50p-EkvUXSkFDnH6ONy3yvtd8hJMY,1388
+mastery/services/sde/version_service.py,sha256=gUpqwhNgx1WV3YKAUpjV63_TGxKxJF2pCc_PLFc6rMg,1187
+mastery/services/skills/__init__.py,sha256=If6nCdT4B3qG-yYx1_OBUSAJ8f8xYgHRQMypwoDC8DQ,104
+mastery/services/skills/skill_control_service.py,sha256=quKIO0qnucDeIJxBt39J651zs-vMn1A-92htGccHvOU,4397
+mastery/services/skills/skillcheck_service.py,sha256=kYux3_holCDqCYmtoGy5Si65ubmGFGH9hrZXOmq166A,1848
+mastery/services/skills/suggestion_service.py,sha256=sVdKzBX-g43H97qU5aagJwjI0cPAkUhxB4mChhRNqfI,5221
+mastery/templates/mastery/base.html,sha256=vKK4VawAzknAFtcgLCtR6ZRVbObCvqkXylrBskcuSOg,1530
+mastery/templates/mastery/doctrine_detail.html,sha256=dFzMOHAeVK07KwYQYYK-qw8m8AcESXqboTBS2g3JENM,8664
+mastery/templates/mastery/doctrine_list.html,sha256=XyfrV6a2zqlWVJ8Ea8XRAffwKA71onizS___KUseh78,5474
+mastery/templates/mastery/fitting_skills.html,sha256=7WGX7whtD5UeZfH7jYcjHky9dKRGpYz362bvyPJzAWs,9438
+mastery/templates/mastery/index.html,sha256=ZVpjyEuoh30dOgDktUMP-jGsvScrCMkiYvmoNug1roU,14969
+mastery/templates/mastery/pilot_fitting_detail.html,sha256=SsaodqvhM-cPDm8xoBEZXjw4qtfAtVbL6SpKK9eX6Dk,42810
+mastery/templates/mastery/summary_doctrine_detail.html,sha256=Gp5bFiNnsbFu45S4OVQXQBZA_coEG8dx40iH9QFtbyk,5827
+mastery/templates/mastery/summary_fitting_detail.html,sha256=YsqxIUF238XLLK2Xx9z_MzPlVYFhlLGmHUfpHtw1tMI,12821
+mastery/templates/mastery/summary_list_view.html,sha256=JP3koYysmiiAw0PdNm7IIT2BrJH-1nS9tAJYmG7xIps,6934
+mastery/templates/mastery/summary_settings.html,sha256=D-Tm7NPjbQEEeNcNl8hemshTSdSi02jf4Ptl4yRx8Xg,10392
+mastery/templates/mastery/partials/ajax_messages.html,sha256=hQUl2VDCnjeHQ88s3a8fxoEhnX6Myjgstin1q8Eaz1Y,291
+mastery/templates/mastery/partials/fitting_skill_preview.html,sha256=S4-xA8ZV48JVi_FRPcs_flyDHhYhsJFD_XCTNgZpXiQ,4171
+mastery/templates/mastery/partials/fitting_skills_editor.html,sha256=YHJrxIv1uhfOErLqiS2Hv2iFneJh3kd6TJHMJZhCV14,21766
+mastery/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mastery/templatetags/skill_render.py,sha256=zw2uWmwyg_DmIgbSsK0jFyFcZAreLkSph9SoMZIqd94,1809
+mastery/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mastery/tests/test_auth_hooks.py,sha256=mLzlV0rWW17mseOLY-TsoQwUJa4BQLlATsYMXEnTEI0,777
+mastery/tests/test_pilot_progress_service.py,sha256=Msmo8uOV_L8kn3u8q1vDH_8ObZefUmLWzTvwYjzClrg,6535
+mastery/tests/test_services.py,sha256=M6DUvGf7i_d87rPiCg4EpHTYh5spytEsasqyEEBmPcw,27692
+mastery/tests/test_tasks.py,sha256=bsB_BgbnsWB2sqts3Fdx3KrrUVsNNxtr4-Owz68MOE4,2444
+mastery/tests/test_views.py,sha256=yvKjAfzCW1Pq-08YyOsTJK98V73cwzaRJpABHqgNS4w,56487
+mastery/views/__init__.py,sha256=YDZVj0sXxtmkhG4iSwQfoxVJAJfuWR4X-CFGYAH9ejM,1932
+mastery/views/common.py,sha256=1YOytDT6OQ3NPeOcRflLK1qUCnYIZV77wojeoSOpojc,19696
+mastery/views/deps.py,sha256=9wfa7tUSSqjCAnEwaKTkfM7AEYaMBCdNyUyLV6u78Ls,1390
+mastery/views/doctrine.py,sha256=_-EzmEH_VXdMUzGczyn7XWzm-QsHj2nzJUUpdYRnh3A,5554
+mastery/views/fitting.py,sha256=9eSGu5AhFrkVb4T_aYjPEYSYKaI2zXo-e4gKkXnf5tQ,17414
+mastery/views/pilot.py,sha256=I5A_WEeFGdfAmGlZSAwU8BIekSAoubwpHrgRt15F3iI,12982
+mastery/views/summary.py,sha256=ae0dkzvHgdsVsAR8n_-Bliso2_ANkLdpUdtSRxo5CHM,11470
+mastery/views/summary_helpers.py,sha256=LsI-hvVa5V_EB-yP2dYjabOMF4O-t_AugK5WdwObcvs,18684
+aa_fitting_mastery-0.1.0.dist-info/licenses/LICENSE,sha256=kM9zGC-yCxQyVxHjoM3Pu_Yb8mSa1fa-Kx0ZgL13CKY,1062
+aa_fitting_mastery-0.1.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+aa_fitting_mastery-0.1.0.dist-info/METADATA,sha256=lNFH3wGfnpG1KQE1BiB12kGxGaMXwFNvoi8gpV43raY,10786
+aa_fitting_mastery-0.1.0.dist-info/RECORD,,

aa_fitting_mastery-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.12.0
+Root-Is-Purelib: true
+Tag: py3-none-any

aa_fitting_mastery-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jay's
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mastery/__init__.py

@@ -0,0 +1,7 @@
+"""Fitting Mastery and Skill Plan generator."""
+
+default_app_config = "mastery.apps.MasteryConfig"  # pylint: disable=invalid-name
+
+__appname__ = "mastery"
+__version__ = "0.1.0"
+__title__ = "Fitting Mastery"

mastery/app_settings.py

@@ -0,0 +1,8 @@
+"""Settings for Fitting Mastery."""
+
+from app_utils.app_settings import clean_setting
+
+MASTERY_PLAN_ESTIMATE_SP_PER_HOUR = clean_setting(
+    "MASTERY_PLAN_ESTIMATE_SP_PER_HOUR", 1800, min_value=1
+)
+"""Training speed used to estimate plan duration in fitting previews."""

mastery/apps.py

@@ -0,0 +1,7 @@
+from django.apps import AppConfig
+
+
+class MasteryConfig(AppConfig):
+    name = "mastery"
+    label = "mastery"
+    verbose_name = "Fitting Mastery Plugin"

mastery/auth_hooks.py

@@ -0,0 +1,29 @@
+from allianceauth import hooks
+from allianceauth.services.hooks import UrlHook, MenuItemHook
+
+from . import urls
+
+class MasteryMenu(MenuItemHook):
+    def __init__(self):
+        MenuItemHook.__init__(
+            self,
+            "Skill Planner",
+            "fas fa-chart-bar",
+            "mastery:pilot_index",
+            navactive=["mastery:"],
+        )
+
+    def render(self, request):
+        if request.user.has_perm("mastery.basic_access"):
+            return MenuItemHook.render(self, request)
+        return ""
+
+
+@hooks.register("menu_item_hook")
+def register_menu():
+    return MasteryMenu()
+
+
+@hooks.register("url_hook")
+def register_urls():
+    return UrlHook(urls, "fitting-mastery", r"^fitting-mastery/")

mastery/management/commands/import_sde_masteries.py

@@ -0,0 +1,69 @@
+"""Management command to import SDE masteries and certificates."""
+
+import time
+
+from django.core.management import BaseCommand
+
+from mastery.services.sde.importer import SdeMasteryImporter
+from mastery.services.sde.version_service import SdeVersionService
+
+
+class Command(BaseCommand):
+    """Import SDE mastery data into local mastery models."""
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "--force",
+            action="store_true",
+            help="Force import even if SDE version is up to date",
+        )
+        parser.add_argument(
+            "--dry-run",
+            action="store_true",
+            help="Perform a dry run without making any changes",
+        )
+
+    def handle(self, *args, **options):
+        start = time.time()
+        version_service = SdeVersionService()
+
+        latest = version_service.fetch_latest()
+        current = version_service.get_current()
+
+        if current:
+            self.stdout.write(f"Current SDE version: {current.build_number}")
+        else:
+            self.stdout.write("No SDE imported yet")
+
+        self.stdout.write(f"Latest SDE version: {latest['build_number']}")
+
+        if (
+                current
+                and current.build_number == latest["build_number"]
+                and not options["force"]
+        ):
+            self.stdout.write(self.style.SUCCESS("SDE is up to date, skipping import"))
+            return
+
+        dry_run = options["dry_run"]
+
+        if dry_run:
+            self.stdout.write(self.style.WARNING("Running in DRY-RUN mode"))
+
+        # IMPORT
+        importer = SdeMasteryImporter()
+        zip_file = importer.download()
+
+        masteries = importer.extract_yaml(zip_file, "masteries.yaml")
+        self.stdout.write(f"Masteries loaded: {len(masteries)} ships")
+
+        certificates = importer.extract_yaml(zip_file, "certificates.yaml")
+        self.stdout.write(f"Certificates loaded: {len(certificates)} entries")
+
+        if dry_run:
+            self.stdout.write(self.style.WARNING("Dry-run: skipping DB import"))
+            return
+
+        importer.exec_import(latest, masteries, certificates, dry_run=dry_run)
+
+        self.stdout.write(self.style.SUCCESS(f"SDE import complete, done in {time.time() - start:.2f}s"))