aa-captrack 1.0.0__tar.gz

aa_captrack-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stephen Swindlehurst
+
+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.

aa_captrack-1.0.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include LICENSE
+recursive-include images *.jpg *.png *.gif
+recursive-include captrack/templates *
+recursive-include captrack/static *
+recursive-include captrack/migrations *.py

aa_captrack-1.0.0/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: aa-captrack
+Version: 1.0.0
+Summary: Capital ship movement early warning plugin for AllianceAuth
+Home-page: https://github.com/SteveTh3Piirate/aa-captrack
+Author: Stephen Swindlehurst
+License: MIT
+Project-URL: Source, https://github.com/SteveTh3Piirate/aa-captrack
+Project-URL: Issues, https://github.com/SteveTh3Piirate/aa-captrack/issues
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: allianceauth>=4.0
+Requires-Dist: allianceauth-corptools>=2.15.2
+Requires-Dist: requests>=2.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# aa-captrack
+
+AllianceAuth plugin for tracking and alerting on capital ship activity
+
+Version: **v1.0.0**  
+Status: **Stable Baseline**
+
+## Overview
+
+`aa-captrack` is an AllianceAuth plugin designed to monitor capital ship activity across characters and accounts, providing:
+
+- Real-time dashboard visibility
+- Threshold-based alerting
+- Discord notifications
+- Per-pilot snoozing
+- Clear separation between tracked, alerting, and informational states
+
+The plugin prioritises operational clarity and avoids unnecessary alert noise.
+
+## Capital Tracking Logic
+
+| Ship Class | Behavior |
+|-----------|---------|
+| Titans | Always alerting |
+| Supercarriers | Always alerting |
+| Dreadnoughts | Alert when ≥ threshold (default: 5) under same main |
+| Lancer Dreads | Alert when ≥ threshold |
+| Carriers | Alert when ≥ threshold |
+| Force Auxiliaries | Alert when ≥ threshold |
+| Capital Industrials | Tracked only (no alerts) |
+
+Threshold logic is applied consistently across:
+- Dashboard
+- Discord alerts
+- Background tasks
+
+## Dashboard
+
+- Collapsible cards with rotating chevrons
+- Clear separation of:
+  - Critical
+  - Alerting
+  - Informational
+- Optional display of unclassified ships
+- Configurable refresh interval
+- Optional remembered collapse state per user
+
+## Discord Integration
+
+- Discord alerts include **only alerting ships**
+- Separate webhooks for:
+  - Critical alerts
+  - Standard alerts
+- Configurable ping behavior (roles / policy)
+- Optional inclusion of:
+  - System
+  - Region
+  - Dashboard link
+
+  ## Snoozing
+
+- Snoozing is **per pilot** (by design)
+- Supports multiple durations (e.g. 1h / 6h / 24h)
+- Snoozed pilots are excluded from:
+  - Dashboard alerts
+  - Discord notifications
+
+  ## Permissions
+
+| Permission | Description |
+|----------|-------------|
+| `captrack.basic_access` | View dashboard |
+| `captrack.admin_access` | Configure settings |
+
+## Installation
+
+1. Install the plugin:
+
+pip install aa-captrack
+
+2. Add to `INSTALLED_APPS`:
+
+1. INSTALLED_APPS += ["captrack"]
+
+3. Run migrations:
+
+python manage.py migrate captrack
+
+4. Collect static files:
+
+5. Restart AllianceAuth services.
+
+## Configuration
+
+Configuration is managed via the AllianceAuth Admin Panel:
+
+Admin → Captrack → CapTrack Settings
+
+Only **one settings row** is expected.
+
+### Configurable Options Include
+
+- Enabled / disabled state
+- Tracked group IDs
+- Industrial group IDs
+- Alert thresholds per ship class
+- Discord webhook URLs
+- Discord ping policy
+- Dashboard behavior options
+- Snooze durations
+- Display preferences
+
+## Data Model Notes
+
+- Capital activity is grouped by **main character**
+- Industrials are tracked but do not generate alerts
+- Alert logic is centralized in:
+  - `services.py`
+  - `views.py`
+  - `tasks.py`
+
+  ## Compatibility
+
+- AllianceAuth: 4.x
+- Django: 4.2
+- Database:
+  - MySQL / MariaDB (recommended)
+  - SQLite (development only)
+
+## Versioning Policy
+
+- **v1.0.0**: Stable baseline
+- Future versions will:
+  - Avoid destructive migrations
+  - Prefer additive schema changes
+  - Be tested against existing installs
+
+## Screenshots
+
+> Screenshots are placeholders and may change as the UI evolves.
+
+### Dashboard — Overview
+
+![Dashboard Overview](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/overview.jpg)
+
+Displays all tracked capital activity grouped by main character, with clear visual separation between critical, alerting, and informational states.
+
+---
+
+### Dashboard — Collapsed / Expanded States
+
+![Dashboard Collapsed](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/collapsed.jpg)
+
+Cards can be collapsed to reduce noise. Collapse state can optionally be remembered per user.
+
+---
+
+### Dashboard — Snoozed Pilots
+
+![Dashboard Snoozed](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/snoozed.jpg)
+
+Pilots can be snoozed individually to suppress alerts and notifications for a configurable duration.
+
+---
+
+### Admin — CapTrack Settings
+
+![Admin Settings](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/admin-settings.jpg)
+
+All configuration is managed through a single settings entry in the AllianceAuth admin panel.
+
+---
+
+### Discord — Critical Alert Example
+
+![Discord Critical Alert](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/discord-critical.jpg)
+
+Critical alerts (Titans, Supercarriers) are always sent immediately.
+
+
+## License
+
+MIT License

aa_captrack-1.0.0/README.md

@@ -0,0 +1,183 @@
+# aa-captrack
+
+AllianceAuth plugin for tracking and alerting on capital ship activity
+
+Version: **v1.0.0**  
+Status: **Stable Baseline**
+
+## Overview
+
+`aa-captrack` is an AllianceAuth plugin designed to monitor capital ship activity across characters and accounts, providing:
+
+- Real-time dashboard visibility
+- Threshold-based alerting
+- Discord notifications
+- Per-pilot snoozing
+- Clear separation between tracked, alerting, and informational states
+
+The plugin prioritises operational clarity and avoids unnecessary alert noise.
+
+## Capital Tracking Logic
+
+| Ship Class | Behavior |
+|-----------|---------|
+| Titans | Always alerting |
+| Supercarriers | Always alerting |
+| Dreadnoughts | Alert when ≥ threshold (default: 5) under same main |
+| Lancer Dreads | Alert when ≥ threshold |
+| Carriers | Alert when ≥ threshold |
+| Force Auxiliaries | Alert when ≥ threshold |
+| Capital Industrials | Tracked only (no alerts) |
+
+Threshold logic is applied consistently across:
+- Dashboard
+- Discord alerts
+- Background tasks
+
+## Dashboard
+
+- Collapsible cards with rotating chevrons
+- Clear separation of:
+  - Critical
+  - Alerting
+  - Informational
+- Optional display of unclassified ships
+- Configurable refresh interval
+- Optional remembered collapse state per user
+
+## Discord Integration
+
+- Discord alerts include **only alerting ships**
+- Separate webhooks for:
+  - Critical alerts
+  - Standard alerts
+- Configurable ping behavior (roles / policy)
+- Optional inclusion of:
+  - System
+  - Region
+  - Dashboard link
+
+  ## Snoozing
+
+- Snoozing is **per pilot** (by design)
+- Supports multiple durations (e.g. 1h / 6h / 24h)
+- Snoozed pilots are excluded from:
+  - Dashboard alerts
+  - Discord notifications
+
+  ## Permissions
+
+| Permission | Description |
+|----------|-------------|
+| `captrack.basic_access` | View dashboard |
+| `captrack.admin_access` | Configure settings |
+
+## Installation
+
+1. Install the plugin:
+
+pip install aa-captrack
+
+2. Add to `INSTALLED_APPS`:
+
+1. INSTALLED_APPS += ["captrack"]
+
+3. Run migrations:
+
+python manage.py migrate captrack
+
+4. Collect static files:
+
+5. Restart AllianceAuth services.
+
+## Configuration
+
+Configuration is managed via the AllianceAuth Admin Panel:
+
+Admin → Captrack → CapTrack Settings
+
+Only **one settings row** is expected.
+
+### Configurable Options Include
+
+- Enabled / disabled state
+- Tracked group IDs
+- Industrial group IDs
+- Alert thresholds per ship class
+- Discord webhook URLs
+- Discord ping policy
+- Dashboard behavior options
+- Snooze durations
+- Display preferences
+
+## Data Model Notes
+
+- Capital activity is grouped by **main character**
+- Industrials are tracked but do not generate alerts
+- Alert logic is centralized in:
+  - `services.py`
+  - `views.py`
+  - `tasks.py`
+
+  ## Compatibility
+
+- AllianceAuth: 4.x
+- Django: 4.2
+- Database:
+  - MySQL / MariaDB (recommended)
+  - SQLite (development only)
+
+## Versioning Policy
+
+- **v1.0.0**: Stable baseline
+- Future versions will:
+  - Avoid destructive migrations
+  - Prefer additive schema changes
+  - Be tested against existing installs
+
+## Screenshots
+
+> Screenshots are placeholders and may change as the UI evolves.
+
+### Dashboard — Overview
+
+![Dashboard Overview](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/overview.jpg)
+
+Displays all tracked capital activity grouped by main character, with clear visual separation between critical, alerting, and informational states.
+
+---
+
+### Dashboard — Collapsed / Expanded States
+
+![Dashboard Collapsed](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/collapsed.jpg)
+
+Cards can be collapsed to reduce noise. Collapse state can optionally be remembered per user.
+
+---
+
+### Dashboard — Snoozed Pilots
+
+![Dashboard Snoozed](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/snoozed.jpg)
+
+Pilots can be snoozed individually to suppress alerts and notifications for a configurable duration.
+
+---
+
+### Admin — CapTrack Settings
+
+![Admin Settings](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/admin-settings.jpg)
+
+All configuration is managed through a single settings entry in the AllianceAuth admin panel.
+
+---
+
+### Discord — Critical Alert Example
+
+![Discord Critical Alert](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/discord-critical.jpg)
+
+Critical alerts (Titans, Supercarriers) are always sent immediately.
+
+
+## License
+
+MIT License

aa_captrack-1.0.0/aa_captrack.egg-info/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: aa-captrack
+Version: 1.0.0
+Summary: Capital ship movement early warning plugin for AllianceAuth
+Home-page: https://github.com/SteveTh3Piirate/aa-captrack
+Author: Stephen Swindlehurst
+License: MIT
+Project-URL: Source, https://github.com/SteveTh3Piirate/aa-captrack
+Project-URL: Issues, https://github.com/SteveTh3Piirate/aa-captrack/issues
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: allianceauth>=4.0
+Requires-Dist: allianceauth-corptools>=2.15.2
+Requires-Dist: requests>=2.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# aa-captrack
+
+AllianceAuth plugin for tracking and alerting on capital ship activity
+
+Version: **v1.0.0**  
+Status: **Stable Baseline**
+
+## Overview
+
+`aa-captrack` is an AllianceAuth plugin designed to monitor capital ship activity across characters and accounts, providing:
+
+- Real-time dashboard visibility
+- Threshold-based alerting
+- Discord notifications
+- Per-pilot snoozing
+- Clear separation between tracked, alerting, and informational states
+
+The plugin prioritises operational clarity and avoids unnecessary alert noise.
+
+## Capital Tracking Logic
+
+| Ship Class | Behavior |
+|-----------|---------|
+| Titans | Always alerting |
+| Supercarriers | Always alerting |
+| Dreadnoughts | Alert when ≥ threshold (default: 5) under same main |
+| Lancer Dreads | Alert when ≥ threshold |
+| Carriers | Alert when ≥ threshold |
+| Force Auxiliaries | Alert when ≥ threshold |
+| Capital Industrials | Tracked only (no alerts) |
+
+Threshold logic is applied consistently across:
+- Dashboard
+- Discord alerts
+- Background tasks
+
+## Dashboard
+
+- Collapsible cards with rotating chevrons
+- Clear separation of:
+  - Critical
+  - Alerting
+  - Informational
+- Optional display of unclassified ships
+- Configurable refresh interval
+- Optional remembered collapse state per user
+
+## Discord Integration
+
+- Discord alerts include **only alerting ships**
+- Separate webhooks for:
+  - Critical alerts
+  - Standard alerts
+- Configurable ping behavior (roles / policy)
+- Optional inclusion of:
+  - System
+  - Region
+  - Dashboard link
+
+  ## Snoozing
+
+- Snoozing is **per pilot** (by design)
+- Supports multiple durations (e.g. 1h / 6h / 24h)
+- Snoozed pilots are excluded from:
+  - Dashboard alerts
+  - Discord notifications
+
+  ## Permissions
+
+| Permission | Description |
+|----------|-------------|
+| `captrack.basic_access` | View dashboard |
+| `captrack.admin_access` | Configure settings |
+
+## Installation
+
+1. Install the plugin:
+
+pip install aa-captrack
+
+2. Add to `INSTALLED_APPS`:
+
+1. INSTALLED_APPS += ["captrack"]
+
+3. Run migrations:
+
+python manage.py migrate captrack
+
+4. Collect static files:
+
+5. Restart AllianceAuth services.
+
+## Configuration
+
+Configuration is managed via the AllianceAuth Admin Panel:
+
+Admin → Captrack → CapTrack Settings
+
+Only **one settings row** is expected.
+
+### Configurable Options Include
+
+- Enabled / disabled state
+- Tracked group IDs
+- Industrial group IDs
+- Alert thresholds per ship class
+- Discord webhook URLs
+- Discord ping policy
+- Dashboard behavior options
+- Snooze durations
+- Display preferences
+
+## Data Model Notes
+
+- Capital activity is grouped by **main character**
+- Industrials are tracked but do not generate alerts
+- Alert logic is centralized in:
+  - `services.py`
+  - `views.py`
+  - `tasks.py`
+
+  ## Compatibility
+
+- AllianceAuth: 4.x
+- Django: 4.2
+- Database:
+  - MySQL / MariaDB (recommended)
+  - SQLite (development only)
+
+## Versioning Policy
+
+- **v1.0.0**: Stable baseline
+- Future versions will:
+  - Avoid destructive migrations
+  - Prefer additive schema changes
+  - Be tested against existing installs
+
+## Screenshots
+
+> Screenshots are placeholders and may change as the UI evolves.
+
+### Dashboard — Overview
+
+![Dashboard Overview](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/overview.jpg)
+
+Displays all tracked capital activity grouped by main character, with clear visual separation between critical, alerting, and informational states.
+
+---
+
+### Dashboard — Collapsed / Expanded States
+
+![Dashboard Collapsed](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/collapsed.jpg)
+
+Cards can be collapsed to reduce noise. Collapse state can optionally be remembered per user.
+
+---
+
+### Dashboard — Snoozed Pilots
+
+![Dashboard Snoozed](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/snoozed.jpg)
+
+Pilots can be snoozed individually to suppress alerts and notifications for a configurable duration.
+
+---
+
+### Admin — CapTrack Settings
+
+![Admin Settings](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/admin-settings.jpg)
+
+All configuration is managed through a single settings entry in the AllianceAuth admin panel.
+
+---
+
+### Discord — Critical Alert Example
+
+![Discord Critical Alert](https://raw.githubusercontent.com/SteveTh3Piirate/aa-captrack/refs/heads/master/images/discord-critical.jpg)
+
+Critical alerts (Titans, Supercarriers) are always sent immediately.
+
+
+## License
+
+MIT License

aa_captrack-1.0.0/aa_captrack.egg-info/SOURCES.txt

@@ -0,0 +1,47 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+aa_captrack.egg-info/PKG-INFO
+aa_captrack.egg-info/SOURCES.txt
+aa_captrack.egg-info/dependency_links.txt
+aa_captrack.egg-info/requires.txt
+aa_captrack.egg-info/top_level.txt
+captrack/__init__.py
+captrack/admin.py
+captrack/apps.py
+captrack/constants.py
+captrack/helpers.py
+captrack/hooks.py
+captrack/models.py
+captrack/services.py
+captrack/tasks.py
+captrack/urls.py
+captrack/views.py
+captrack/migrations/0001_initial.py
+captrack/migrations/0002_alter_captracksettings_options.py
+captrack/migrations/0003_alter_captracksettings_options.py
+captrack/migrations/0004_update_basic_access_permission_name.py
+captrack/migrations/0005_capwatchlist_alert_snoozed_until_and_more.py
+captrack/migrations/__init__.py
+captrack/templates/captrack/dashboard .bak
+captrack/templates/captrack/dashboard.html
+captrack/utils/__init__.py
+captrack/utils/discord.py
+images/admin-settings.jpg
+images/admin.jpg
+images/collapsed.jpg
+images/discord-critical.jpg
+images/overview.jpg
+images/snoozed.jpg
+testproj/__init__.py
+testproj/apps.py
+testproj/manage.py
+testproj/models-mock.py
+testproj/settings.py
+testproj/testproj/__init__.py
+testproj/testproj/asgi.py
+testproj/testproj/settings.py
+testproj/testproj/urls.py
+testproj/testproj/wsgi.py

aa_captrack-1.0.0/aa_captrack.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aa_captrack-1.0.0/aa_captrack.egg-info/requires.txt

@@ -0,0 +1,3 @@
+allianceauth>=4.0
+allianceauth-corptools>=2.15.2
+requests>=2.0

aa_captrack-1.0.0/aa_captrack.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+captrack
+testproj

aa_captrack-1.0.0/captrack/__init__.py

@@ -0,0 +1 @@
+default_app_config = "captrack.apps.CapTrackConfig"