AA Hostile Intel

AA Hostile Intel is an operational tactical intelligence, non-ESI structure tracking, fitting inspection, and combat threat analysis platform for Alliance Auth.

Designed specifically to eliminate cognitive friction and decision latency during live operations, it empowers fleet commanders (FCs), scouts, and intelligence officers to track hostile infrastructure, parse non-ESI fittings, calculate combat drop risks, monitor sovereignty vulnerability windows, and profile hostile alliance timezones.

Key Features

• ⚡ Tactical Command Center Dashboard:

  • Universal Fast-Triage Hero Deck: Omnisearch bar for instant client-side queries across pilots, systems, alliances, and timers; direct smart clipboard parser dropzone; and a Home Staging Anchor filter calculating live jump routing across all cards.
  • Temporal Urgency KPI Deck: Time-sensitive operational metrics (Timers <6h, Timers <24h, Active Sov Campaigns, Active Gate Camps, 7-Day Hotspots, Tracked Supers & Cynos).
  • Two-Column Operational Layout: Separates immediate tactical threats (urgent timers with live ticking countdowns and 1-click FC Discord pings, active gate camps with time-decay status badges, recent threat scans) from strategic landscape monitoring (hotspot activity rankings, active sovereignty battles, hostile staging hubs, and fleet doctrines).
  • Real-Time Live Intelligence Feed: Unified chronological ticker tracking sitreps, structure discoveries, timer updates, and threat scans with 60-second background auto-synchronization.

• 🛰️ Non-ESI Structure & Fitting Ingestion:

  • Smart Multi-Format Parser: Automatically classifies D-Scans, structure show-info copy-pastes, and EFT fitting blocks.
  • SDE Asset Identification: Resolves structure types, celestial locations, owner tickers, quantum core statuses, and fitted modules via eve_sde.
  • Interactive Module Inspection: Corptools-inspired High, Medium, Low, Rig, and Service slot modals with official CCP asset icons and 1-click Copy EFT to Clipboard export for Pyfa and EVE Online.

• ⚔️ Sovereignty Campaign & Contest Timers:

  • Dynamic Real-Time Polling: Tracks active and upcoming ADM sovereignty campaigns with 60-second change detection polling and live DOM updates.
  • Contest Score Donuts: Visual 60/40 circular donut charts, ongoing contest indicators, and defender/attacker score tracking.
  • Staging Proximity Routing: Real-time gate jump counts and jump drive light-year calculations from your home staging base.

• ⏱️ Structure Reinforcement Timers Board:

  • Dedicated timer board tracking hostile armor and hull vulnerability windows.

  • Live client-side ticking countdowns with multi-layer ambient tactical pulse glows for imminent timers.

  • One-click Fleet Commander (FC) Discord / broadcast ping generator formatted with target system, structure type, and time remaining.

  • Paste a reinforcement timer: in Add Timer, paste the timer copied from a reinforced structure (… Reinforced until 2026.11.03 19:13:30).

    • If the name matches a known structure, that structure is selected and the time and likely stage are filled in, so you just press Save.
    • For generic names like Mercenary Den, you pick from the matching known structures.
    • For unknown names, the structure fields are pre-filled (system from a <System> - <Name> prefix, type from a generic name), so the timer and the new structure are added together.

    Saving updates the structure's state in the registry (Armor / Hull / Reinforced). Pasting a timer that already exists doesn't add it twice.

• 🎯 Local Threat Scanner & Drop Risk Engine:

  • Asynchronous Pilot Intelligence Streaming: Non-blocking local chat paste ingestion that eliminates HTTP gateway timeouts by streaming pilot corporation, alliance, top flown ships, and loss data in the background.
  • Drop Probability Algorithms: Evaluates pilot combat histories, cyno loss records, and zKillboard tags to estimate real-time Black Ops (Blops) and Capital drop risks.
  • Grid Anchor & Ship Composition: Combines Local chat rosters with D-Scan items to classify grid composition and identify hostile FCs.

• 📡 Tactical Sitreps & Gate Camp Ingestion:

  • Time Seen & Freshness Tracking: UTC timestamps with 1-click "Now" and relative time offsets (-15m, -30m, -1h, -2h, -4h).
  • Interactive Threat Classification Tags: Preselectable pills (Gate Camp, Bubbles on Gate, Smartbomb Trap, Blops Hunter, Capital Fleet, Cyno Beacon, Roving Gang) with on-the-fly custom tag creation.
  • Integrated Local & D-Scan Scanner: Submitting camp sitreps allows optional Local chat and D-Scan pastes, generating linked LocalThreatScan records and auto-applying threat tags.
  • 1-Click FC Ping Generator: Instant Discord-formatted broadcast pings detailing system, freshness, threat level, bubble status, and linked threat analysis.

• 👤 Hostile Pilot Dossiers Registry:

  • Comprehensive database tracking hostile cyno alts, supercarrier/titan pilots, fleet commanders, and scouts.
  • Searchable across character names, corporations, alliances, alt associations, notes, and behavioral tags with multi-role category filtering.

• 🏛️ Alliances, Corporations & Coalitions Profiling:

  • Automated ESI and zKillboard tracking of hostile coalition hierarchies, sovereignty footprints, and member counts.
  • Primary operational timezone profiling (USTZ, EUTZ, AUTZ) derived from vulnerability distributions and 7x24 activity heatmaps.
  • Formup potential estimations for subcap, capital, and supercapital fleets.

• 🚀 Hostile Staging Hubs & Fleet Doctrines:

  • Track forward deployment bases, lowsec staging hubs, and nullsec citadels outside target sovereignty.
  • Catalog fleet doctrines (Mainline Fleet, Skirmish / HACs, Capital / Super, Home Defense, Roaming) with example fittings, zKillboard killmail references, and interactive slot inspection.

• 🔒 Tiered Moderation & Audit Logging:

  • Role-based access control with granular permissions (basic_access, manage_intel, officer_access).
  • Immutable audit logs recording all operator creations, edits, and deletions.

Installation

1. Install Package

Install the package into your Alliance Auth virtual environment:

pip install aa-hostile-intel

2. Configure Alliance Auth Settings

In your local.py settings file, add hostile to INSTALLED_APPS:

INSTALLED_APPS += [
    "hostile",
]

3. Configure Periodic Celery Tasks

Run python manage.py hostile_setup_tasks to register all periodic tasks, or add them to CELERYBEAT_SCHEDULE in local.py yourself:

from celery.schedules import crontab

# Periodic ESI Sovereignty & Structure Map Synchronization (Every 2 Hours)
CELERYBEAT_SCHEDULE["hostile_update_sovereignty_intelligence"] = {
    "task": "hostile.tasks.update_sovereignty_intelligence",
    "schedule": crontab(minute="0", hour="*/2"),
}

# Periodic Active Sovereignty Campaign Synchronization (Every 15 Minutes)
CELERYBEAT_SCHEDULE["hostile_update_sovereignty_campaigns"] = {
    "task": "hostile.tasks.update_sovereignty_campaigns",
    "schedule": crontab(minute="*/15"),
}

# Periodic zKillboard Entity Statistics & Member Counts (Every 6 Hours)
CELERYBEAT_SCHEDULE["hostile_update_all_zkill_stats"] = {
    "task": "hostile.tasks.update_all_zkill_stats",
    "schedule": crontab(minute="30", hour="*/6"),
}

# Two-way sync with aa-structuretimers / Timerboard (Every 15 Minutes)
CELERYBEAT_SCHEDULE["hostile_sync_timerboard_timers"] = {
    "task": "hostile.tasks.sync_timerboard_timers",
    "schedule": crontab(minute="*/15"),
}

# Friendly timers from corptools structure notifications (Every 5 Minutes, optional)
CELERYBEAT_SCHEDULE["hostile_import_corptools_notification_timers"] = {
    "task": "hostile.tasks.import_corptools_notification_timers",
    "schedule": crontab(minute="*/5"),
}

4. Run Migrations & Collect Static Files

python manage.py migrate
python manage.py collectstatic --noinput

5. Restart Services

Restart your Alliance Auth supervisor or systemd services:

supervisorctl restart all

Configuration Settings

You can customize app behavior by adding the following optional settings to your local.py:

Friendly Timers from Corptools Notifications

If allianceauth-corptools is installed and pulls character notifications (esi-characters.read_notifications.v1) for your directors / station managers, Hostile Intel turns structure notifications into friendly timers. No aa-structures is needed:

Timers are posted to aa-structuretimers only. They are friendly structure timers, so they are never copied to the Alliance Auth Timerboard, which is for fleet operations. Only notifications from the last HOSTILE_CORPTOOLS_NOTIFICATION_LOOKBACK_HOURS (24h) are read, and timers that have already passed are ignored.

Several checks stop a timer from being posted twice:

1. A notification that was already handled is skipped. This also covers several directors receiving the same notification.
2. If Hostile Intel already has the same timer (same structure or system, same type, within HOSTILE_NOTIFICATION_TIMER_TOLERANCE_MINUTES), that timer is reused. A timer is only treated as different if it is clearly on another structure (different structure ID, type or real name) or belongs to a known hostile owner.
3. If aa-structuretimers already has an equivalent timer (same system, same type, within the tolerance; Hull and Final count as the same; not a Hostile-objective timer), it is linked instead of reposted. Two timers are only treated as different when both have a real structure name and the names differ. Anything ambiguous counts as a duplicate.
4. A linked timer belongs to whoever posted it (e.g. aa-structures). Hostile Intel never writes to it, even during reconciliation. If that timer is edited on aa-structuretimers, the change is pulled into Hostile Intel.
5. Every push to aa-structuretimers, including the periodic reconciliation, links to an equivalent existing timer instead of creating a new one.
6. Only one import runs at a time.

To check what the import does with the notifications corptools currently has, run:

python manage.py hostile_notification_timers --dry-run

It lists every structure notification from the lookback window, says whether it would create, link or skip a timer (and why), and changes nothing. Without --dry-run it runs the import once.

Each notification also updates the structure registry. It creates the structure if needed, then fills in the structure ID, the in-game name from corptools, the type, and the planet. It sets the owner ticker and links the owner alliance/corporation if they're already in the registry; it never creates them or changes their friendly flag. It sets the state to Armor, Hull, Reinforced, Anchoring or Unanchoring. An older notification never overwrites a newer state.

Sovereignty notifications are skipped because they're already covered by the ESI campaign sync. In general, friendly timers are no longer copied to the Timerboard. Hostile timers still sync to both boards, and timers that were already linked keep updating.

Permissions

AA Hostile Intel provides three granular permission levels:

Changelog

See CHANGELOG.md for details on changes in each release.

License

This project is licensed under the GNU General Public License v3.0 (GPLv3). See the LICENSE file for details.