EQM v0.1.11-beta: Host Tools, Backups & Multibuy Export

EVE Quartermaster Update: Host Tools, Backups & Multibuy Export

This update introduces a new Host account role for installation owners, complete database-management tools, and a faster way to move shopping lists into EVE Online.

New Features

• Export the EQM database as a portable .eqmbackup file
• Restore a compatible database backup
• View database size, table count, and schema version
• Clear application data when a genuinely fresh start is required
• Existing primary administrators are automatically promoted to Host
• Database controls are visible and accessible only to Host accounts
• Copy shopping lists directly to the clipboard in EVE Online Multibuy format
• Export either missing items only or the complete shopping list, regardless of current asset coverage

Shopping-list exports use EVE’s simple item-and-quantity format:

Heavy Beam Laser II 5
Valkyrie II 5
Warrior II 10

Paste the result directly into EVE’s Multibuy window without removing prices, categories, or other formatting first.

Safety Measures

Database restoration verifies the backup format and schema version before proceeding and performs restoration transactionally. Database clearing requires both the Host password and an exact confirmation phrase.

The danger zone clearly identifies that clearing the database is irreversible. It removes synced ESI data, assets, industry history, analytics, notes, and other application records while retaining the current Host account and database structure.

Backups may contain private application data, encrypted ESI tokens, and account password hashes. Treat exported backup files as sensitive.

Additional Fixes

• Added PostgreSQL client compatibility handling for reliable restores
• Prevented internal migration metadata from conflicting during restoration
• Protected the final Host account from deletion or demotion
• Updated permissions throughout EQM to recognize the new Host role
• Improved shopping-list exports for both procurement and full-fit purchasing

The complete backup, clear, and restore process was tested through an isolated database rehearsal before release.

EQM v0.1.10-beta: "Cook It, then Log the Mats" Update

EQM v0.1.10-beta: “Cook It, Then Log the Mats”

EVE Quartermaster v0.1.10-beta is now available, introducing two new industry-focused modules alongside improvements to Analytics, Manufacturing, contract synchronization, and the interface.

Release: EQM v0.1.10-beta
Repository: EVE Quartermaster on GitHub

Mining Ledger

The new persistent, per-character Mining Ledger can:

• Synchronize personal mining history through ESI.
• Import detailed CSV or TSV ledger exports containing residue and valuation data.
• Track recovered volume, gross extraction, residue loss, estimated value, and measured efficiency.
• Compare ore composition, mining output over time, system extraction, and individual miner performance.
• Create named mining operations using a solar system, time window, selected miners, and fleet boosters.
• Record optional ship and mining-crystal information for operation participants.
• Preserve historical records after they disappear from ESI’s rolling history window.
• Safely clear an individual character’s ledger when an import is assigned incorrectly.

ESI supplies the ore type, quantity, date, and solar system for each mining record. Residue and exported valuation data are available only through detailed ledger imports.

Research Projects

Research Projects provides a dedicated view for:

• Material Efficiency and Time Efficiency research.
• Blueprint copying and invention.
• Character-owned and corporation-owned industry jobs.
• Installer attribution for corporation jobs.
• Sortable project columns and active research queues.
• Retained project history.
• Researcher and activity analytics.
• Corporation-role validation before corporate research synchronization begins.

Manufacturing and Analytics

• Manufacturing drafts can now be started directly from the ledger, automatically recording their start time and beginning the countdown.
• Manufacturing cards now identify the EQM user who submitted each job.
• Corporations can be excluded from Analytics independently.
• Hidden corporations are automatically excluded from summaries, trends, exports, duplicate-blueprint results, and subsequent snapshots.
• NPC corporations and affiliation-only corporations can also be excluded without being added as managed corporations.

Fixes and Refinements

• Fixed contract synchronization failures caused by player-owned structure IDs exceeding the size of the previous station field.
• Prevented shared contracts from being reassigned when another character or corporation synchronizes the same contract.
• Sync All now preserves and displays every individual task failure.
• Fixed an issue that prevented Mining Sync data from persisting correctly.
• Fixed transparent or incorrectly layered Jump Clone implant dogma cards.
• Characters without active ESI connections no longer appear in Mining Ledger character lists.
• Research Projects now uses a sortable table and validates corporation roles before synchronization.

Fittings Notice

The Fittings module remains an active work in progress and is now clearly marked as such in the navigation menu.

Dogma calculations, skills, implants, cargo, and derived fitting values should still be treated as preview functionality and independently verified before relying on them.

Feedback, testing reports, and suggestions are welcome.

EQM v0.1.9-beta - "Build A Battleship" Version

Changelog

All notable changes to EVE Quartermaster are tracked here.

This project is moving quickly during beta. Version sections are written as user-facing release notes first, with implementation detail included where it helps operators understand deployment or testing impact.

[0.1.9-beta] - 2026-07-15

Added

• Added Manufacturing analytics widgets for realized output quantity, actual and current input costs, savings, kept/sold disposition, sales revenue, and realized profit.
• Added a README feature-preview warning for the Fittings module while dogma, skill, implant, cargo, and module-derived simulation values remain under active rebuild.
• Added Manufacturing final-product market lookup with highlighted best buy and lowest sell opportunities across major trade hubs.
• Added Manufacturing output tracking for pending, sold, and kept products, including sale price, outcome notes, and sale-margin summary.
• Added Manufacturing line-item price-paid tracking so operators can compare current market value against actual spend and see savings from on-hand materials.
• Added Manufacturing ledger support for ME/TE research, copying, invention, and reaction job tracking with decryptor/datacore/reaction material inputs.

Changed

• Recolored the "EVE is Excel in a flight suit." tagline with the muted red interface accent on sign-in, invitation, and in-app views.
• Bumped the visible app, package, backend API, Android wrapper, and ESI user-agent versions to 0.1.9-beta.

[0.1.8-beta] - 2026-07-13

Added

• Added dogma-backed fitting Cargo cards that display current/maximum volume for cargo hold, drone bay, fighter hangar, fuel bay, fleet/ship maintenance bays, infrastructure bay, and specialized holds when the SDE exposes those capacities.
• Added item volume serialization for fitting cargo, drones, fighters, and bay contents so draft fits can estimate carried m3 before simulation.
• Stored EVE type cargo capacity from SDE and ESI metadata so ship cargo holds appear correctly in fitting simulation.
• Made pasted EFT fitting imports refresh public type metadata and return ship cargo capacity immediately to the draft workshop.
• Added a freighter base cargo-capacity fallback so draft fits show known cargo holds even before refreshed SDE/ESI capacity metadata is available.

Changed

• Recolored the "EVE is Excel in a flight suit." tagline with the muted red interface accent on sign-in, invitation, and in-app views.
• Consolidated fitting cargo, drones, and fighters into one bay-aware draft workflow with utilization meters and over-limit highlighting.
• Made fitting cargo-hold capacity skill/module-aware in simulation, including racial freighter skill bonuses and fitted cargo-capacity modifiers.
• Corrected Fenrir fallback cargo capacity and kept over-slot fitted modules from contributing simulation effects.
• Corrected cargo-expander math by treating SDE cargoCapacityMultiplier as a direct, unpenalized multiplier and cargoCapacityBonus as a percent bonus.
• Applied imported passive structure HP and max-velocity multipliers so Expanded Cargohold penalties affect fitting tank and movement stats.
• Restored fitting stat estimates for online modules so imported fittings apply module effects without requiring every item to be toggled active.
• Added a red fitting simulator development warning badge because dogma coverage is still incomplete and values may be inaccurate.
• Clamped fitted-slot quantities to one module per slot so draft quantity cannot create false slot overages.
• Improved EFT import slot inference so obvious low-slot modules are not placed in mids just because of sparse section spacing.
• Normalized fitting add/update requests so low-slot modules are not saved into mid slots unless deliberately carried as cargo.
• Hid empty zero-capacity bays from fitting Cargo cards while keeping over-limit checks for bays with contents.
• Bumped the visible app, package, backend API, Android wrapper, and ESI user-agent versions to 0.1.8-beta.

EQM v0.1.7-beta - "It Comes in Chunks Now!"

Changelog

All notable changes to EVE Quartermaster are tracked here.

This project is moving quickly during beta. Version sections are written as user-facing release notes first, with implementation detail included where it helps operators understand deployment or testing impact.

[0.1.7-beta] - 2026-07-13

Added

• Added a Characters-page Sync all eligible action that queues assets, skills, fittings, and contracts for every permitted non-opted-out character with matching ESI scopes and shows queue-badge progress.
• Added corporation hiding and tightened character/corporation lists so metadata-only CEOs and affiliation-only corporations do not appear as managed EQM entries.
• Expanded the README with detailed EVE developer application, ESI/SSO scope, SDE YAML download/import, and EQM section usage instructions.

Changed

• Updated installer next-step guidance to point operators at EVE developer credentials, YAML SDE setup, and README setup details.
• Bumped the visible app, package, backend API, Android wrapper, and ESI user-agent versions to 0.1.7-beta.

[0.1.6-beta] - 2026-07-10

Added

• Added wardec indicators to route, capital jump, and character killmail displays so hostile intel can distinguish war-target losses from ordinary ganks.
• Started frontend segmentation by moving the app version, killmail data shapes, and wardec badge into purpose-built modules.
• Split market appraisal data shapes, pricing helpers, and reusable market widgets out of the large frontend entry module.
• Split navigation route, jump plotter, and threat/intel widgets out of the large frontend entry module.
• Split fitting shared types, simulation helpers, and fit-context widgets out of the large frontend entry module.
• Split fitting sync, import, and saved-fitting list panels out of the large frontend entry module.
• Moved the remaining Fittings page container out of the large frontend entry module.
• Split the Analytics Platform page and analytics data shapes out of the large frontend entry module.
• Split the Alliance Roster page and roster data shapes out of the large frontend entry module.
• Split the Character Skills page and skill sync data shapes out of the large frontend entry module.
• Split the Characters page, persistent character hover card, and character dossier data shapes out of the large frontend entry module.
• Split the Profile page and profile/mail/message data shapes out of the large frontend entry module.
• Split the Settings page, section switch controls, SDE import panel, and permission data shapes out of the large frontend entry module.
• Split the ESI Sync page and ESI contact-sync data shapes out of the large frontend entry module.
• Split the profile user administration pane out of the large frontend entry module.
• Split the Contracts page and contract data shapes out of the large frontend entry module.
• Split the Corporations page and corporation sync data shapes out of the large frontend entry module.
• Extracted the shared frontend API client and inventory classification/types helpers out of the large frontend entry module.
• Added SDE-backed category and subtype filters for Assets and Blueprint Library views, including ship hull classes, ammunition/charge groups, rig groups, and capital-construction blueprint chain filtering.
• Added a Missing BPOs pane at the bottom of the Blueprint Library, grouped by product category from the SDE manufacturing catalog.
• Added fitting ammo/script groups so multiple launchers, turrets, or scripted modules can share charge assignment from one group control.
• Added reusable pilot security-status badges for character cards, local threat pilots, route killmail rows, and jump-planner killmail rows.
• Added a Skills-page sync-all action that queues backend skill refreshes for every eligible character, skips opted-out characters, and shows progress with the queue badge.
• Added prompted prerequisite bootstrapping to the Windows and Linux installer scripts for Git, WSL2, Docker Desktop, Docker Engine, and Docker Compose support.

Fixed

• Made character hover cards persist until closed with the new X button or Escape so zKill links and card actions remain reachable.
• Widened the character picker pane so persistent character hover cards show their close button without horizontal scrolling.
• Raised Skills-page character hover cards above neighboring skill profile rows so persistent character summaries stay readable while open.
• Restored character dossier blueprint-product fallback logic so character pages no longer 500 when loading visible characters.
• Converted undecryptable ESI refresh tokens into a clear reauthorization-needed sync error instead of a 500 during asset sync.
• Backfilled blueprint product classification from SDE industry activities so blueprint category/subtype filters populate correctly, including Drones/Fighters.
• Kept final capital, freighter, and jump freighter hull BPOs out of the Capital construction blueprint filter while retaining supporting chain inputs/components.
• Split RAM and reaction formulas into their own blueprint filter categories and kept them out of capital-construction-only blueprint views.
• Excluded invention-produced Tech II blueprint copies from the Missing BPOs catalog so copy-only blueprints are not listed as missing originals.
• Applied strategic cruiser subsystem slot/resource dogma before fitting simulation readiness checks so T3C CPU, powergrid, slot capacities, probe launcher CPU, covert cloak CPU, and medium weapon required-skill fitting reductions are not evaluated from bare hull/module values only.
• Stored ESI character security status during public character imports and SSO sync so pilot identity surfaces can display current security information when available.

Changed

• Renamed Capital Jump Plotter to Jump Capable Ship Plotter and added Black Ops battleships to the jump-capable ship list.
• Reorganized the sidebar navigation into overview/navigation, character functions, inventory and industry tools, and account/admin groups.
• Tuned the frontend typography hierarchy to reduce over-bold repeated labels, table values, filter chips, badges, and utility buttons so dense operational pages are easier to scan.
• Replaced the Overview Blueprint Library panel with a lightweight blueprint preview so dashboard loads do not initialize the full blueprint tooling or Missing BPO pane.
• Bumped the visible app and package version to 0.1.6-beta.

[0.1.5-beta] - 2026-07-08

Added

• Added a Prefer Safer Route option to Route Checker so gate routes can favor highsec travel even when the route becomes longer.
• Added Route Checker avoid-list controls matching the Capital Jump Plotter flow, including per-system avoid buttons and a clearable avoid list.

EQM v0.1.4-beta - Context At a Glance Update

Changelog

All notable changes to EVE Quartermaster are tracked here.

This project is moving quickly during beta. Version sections are written as user-facing release notes first, with implementation detail included where it helps operators understand deployment or testing impact.

[0.1.4-beta] - 2026-07-06

Changed

• Bumped the visible app, README, Android wrapper, backend API, and ESI client user-agent versions for the latest beta polish pass.

[0.1.3-beta] - 2026-07-05

Added

• Added cross-section context links: fittings now show owned hull/modules/cargo/drones and can price missing or full fits; market appraisal lines show owned quantities with asset/fitting jumps; assets can jump to pricing or fittings; recipes and blueprints show owned outputs/material coverage with market handoffs.
• Added the Market Appraisal module for Janice-style pasted item lists with flexible quantity parsing, multi-hub buy/sell/split comparisons, Dudreda support, and unmatched-item warnings.
• Added market usability signals: best instant-sale highlighting, cheapest acquisition highlighting, best split estimate highlighting, order-depth health badges, and top buy-here/sell-there margin hints.
• Added Contracts support for syncing current character contracts and eligible corporation contracts, with status filtering and sortable contract headers.
• Added fitting clipboard import so EFT-style fits can be pasted into EQM as editable draft fittings.
• Added fitting editor improvements: drag/drop part picker, module removal, charge/script assignment for valid fitted modules, cleaner cargo/drone/fighter rows, cargo hold display, and EVE-style copy/export behavior.
• Added deeper fitting simulation surfaces for readiness, resources, offense, tank, capacitor, movement, module state cycling, hot/overheated module states, charge-aware weapon estimates, and fitting-derived skill plan copy text.
• Added Capital Jump Plotter refinements: capital ship selection, NPC-station-only routing text, green-station filtering, industrial/all-kill selection, station/cyno guidance display, route avoid-list controls, and per-waypoint observed activity intel from cached hourly ESI jump observations.

Changed

• Renamed the character standing sync area to Character Contacts Sync to match the actual writable ESI mechanic.
• Kept market appraisal freight-cost estimates out of the first implementation because player hauling, Red Frog Freight, PushX, and private logistics pricing need a more explicit model.
• Improved public-facing README documentation and screenshot ordering for tester onboarding.

Fixed

• Market appraisal opportunity cards now only show profitable station-to-station trades; no-profit appraisals show a neutral no-current-profit badge instead of a negative trade suggestion.
• Corporation sync flows now continue past corporations where the linked character lacks the required corporation roles instead of stopping the whole batch.
• Improved station display plumbing for jump planning so NPC station names can be shown separately from station type/cyno-risk guidance when SDE data is available.

[0.1.2-beta] - 2026-07-05

Baseline

• First tracked beta baseline for the public-testing README badge and in-app version badge.
• Included account login, EVE SSO linking, asset and corporation syncs, blueprint/SDE import, analytics foundations, navigation tooling, local threat scanning, permissions, audit visibility, messaging, Android wrapper support, and initial fitting tools.

v0.1.2-beta

EVE Quartermaster

EVE is Excel in a flight suit.

EVE Quartermaster is a containerized, database-first EVE Online quartermaster and alliance operations tool. It tracks characters, corporations, assets, blueprints, recipes, skills, standings/contact sync, wallet snapshots, permissions, audit events, and long-term analytics from EVE ESI plus imported SDE data.

This is an early beta candidate for private/public testing. It is already useful, but the data model and API surface are still moving quickly.

Current Capabilities

• Account login, first-admin bootstrap, role management, one-time invite links, and per-section permissions.
• EVE SSO linking for characters, with linked-character ownership, unlinking, scope checks, and privacy controls.
• Character asset sync, corporation asset sync, corporation blueprint sync, corporation wallet division sync, and skill sync.
• Asset ledger with sortable columns, fast dropdown filters, partial search, click-to-filter cells, CSV export, and Janice-friendly copy output.
• Blueprint and recipe views powered by SDE import, with BPO/BPC filters, ME/TE badges, owner filters, sortable blueprint lists, and recipe detail modals.
• Corporation page with enrolled corporations, CEO/member metadata where available, sync status, wallet divisions, and eligible sync characters.
• Roster page for corporation-grouped character display.
• Contact/standing propagation tools using writable ESI character contacts.
• Notifications, private messages, and admin audit log for sync transparency.
• Historical analytics foundation with snapshot runs, metric metadata/versioning, baseline-aware deltas, exports, and composable widgets.
• Navigation suite with SDE-backed route planning, gatecheck summaries, operational starmap rendering, and security-status color coding.
• Hauling intelligence widgets for industrial kill heat, PvP system intel, smartbomb indicators, and Local Threat analysis with background queue progress for large systems.
• Jump Freighter plotter with JDC/JFC fuel math, station/cyno guidance, nearby operational map context, and 24-hour industrial kill visibility per jump.
• Sideloadable Android WebView wrapper build script that outputs EQM.apk.

Screenshots

A quick tour of the current beta surface, ordered roughly the way a new Quartermaster operator would encounter the tool.

Command Center

Overview	Analytics Platform

Assets, Industry, And Corporations

Asset Ledger	Blueprint And Recipe Library

Corporation Sync	ESI Sync And Character Contacts

Character Skills

Navigation And Hauling Intel

Navigation Hub	Route Checker

Industrial System Threat	PvP Intel Report

Local Threat Analysis	Jump Freighter Plotter

Operational Jump Freighter Map

Account, Settings, And Audit

Profile And Messages	Audit Log

Settings And SDE Import	Permissions And Privacy

Additional Settings

Stack

• Frontend: React, TypeScript, Vite, lucide-react.
• Backend: FastAPI, SQLAlchemy, Alembic.
• Database: PostgreSQL.
• Worker/cache: Redis-backed worker placeholder for longer-running sync work.
• Runtime: Docker Compose.
• External data: EVE ESI/SSO and EVE Static Data Export.
• Mobile: Minimal Android WebView shell for sideload testing.

Run Locally

Prerequisites

• Docker Desktop with Docker Compose support enabled.
• Git for cloning the repository.
• An EVE developer application if you want ESI/SSO sync locally.
• Optional: Android Studio or Android SDK command-line tools if you want to build EQM.apk.

Scripted Setup

For a quick evaluator install from a fresh clone, use the installer script for your platform:

.\install-eqm.bat

chmod +x install-eqm.sh rebuild-eqm.sh update-eqm.sh
./install-eqm.sh

The installer checks for Docker Compose, creates .env from .env.example when needed, generates local auth/encryption secrets, creates the sde/ folder, builds the containers, and starts EQM at http://localhost:5173.

For day-to-day local rebuilds without pulling new code:

.\rebuild-eqm.bat

./rebuild-eqm.sh

To update from the current GitHub branch and rebuild containers:

.\update-eqm.bat

./update-eqm.sh

The update scripts use a fast-forward-only pull so they stop instead of trampling local edits.

First Run

From PowerShell in the repository root:

copy .env.example .env
docker compose up --build

Then open:

• Frontend: http://localhost:5173
• Backend health: http://localhost:8000/api/health
• OpenAPI docs: http://localhost:8000/docs
• Schema metadata: http://localhost:8000/api/metadata/schema

On first launch, create the administrator account from the bootstrap screen. After that, use the admin account to create invites, configure permissions, import SDE data, and link EVE characters through SSO.

If the frontend loads but data panels are empty or offline, check the containers:

docker compose ps
docker compose logs backend

To reset all local container data during early testing, stop the stack and remove volumes:

docker compose down -v

That deletes the local PostgreSQL and Redis volumes, so only use it when you intentionally want a fresh database.

EVE SSO Configuration

Local EVE SSO settings live in .env, which is intentionally ignored by source control:

• EVE_SSO_CLIENT_ID
• EVE_SSO_CLIENT_SECRET
• EVE_SSO_CALLBACK_URL
• TOKEN_ENCRYPTION_KEY
• FRONTEND_URL

The configured callback must exactly match the callback in the EVE developer portal. For local-only development, the callback is usually:

http://localhost:8000/api/esi/auth/callback

For a hosted test instance, set both the EVE developer callback and EVE_SSO_CALLBACK_URL to the hosted backend callback, and set FRONTEND_URL to the hosted frontend URL so SSO returns users to the application instead of raw API JSON.

When scopes are added or changed, linked characters need to run EVE SSO again before new permissions are available to sync workers.

SDE Import

The app can import EVE Static Data Export files from a local read-only mount. Put an extracted SDE folder or SDE zip under ./sde, or set SDE_HOST_PATH in .env to another host folder. Inside containers this is mounted as /sde by default.

Accepted layouts include modern SDE root files:

• categories.yaml
• groups.yaml
• types.yaml
• blueprints.yaml

Older FSD layouts are also accepted:

• fsd/categoryIDs.yaml
• fsd/groupIDs.yaml
• fsd/typeIDs.yaml
• fsd/blueprints.yaml

Admins can run the import from Settings -> SDE Import. Navigation, route maps, recipes, blueprint activity, station guidance, and skill grouping all get better as SDE coverage improves.

Android APK

The repository includes a small Android wrapper in android-eqm/. It builds a sideloadable WebView APK named EQM.apk.

From PowerShell in the repository root:

.\build-eqm-apk.bat

Override the default app URL for a test build:

$env:EQM_URL = "http://192.168.0.20:5173/"
.\build-eqm-apk.bat

If Gradle dependencies need to be downloaded:

$env:EQM_ONLINE = "1"
.\build-eqm-apk.bat

The current wrapper is intended for sideload testing, not Play Store distribution.

Testing Ch...

EQM - EVE Quartermaster 0.1.1-beta

EVE Quartermaster

EVE is Excel in a flight suit.

EVE Quartermaster is a containerized, database-first EVE Online quartermaster and alliance operations tool. It tracks characters, corporations, assets, blueprints, recipes, skills, standings/contact sync, wallet snapshots, permissions, audit events, and long-term analytics from EVE ESI plus imported SDE data.

This is an early beta candidate for private/public testing. It is already useful, but the data model and API surface are still moving quickly.

Current Capabilities

• Account login, first-admin bootstrap, role management, one-time invite links, and per-section permissions.
• EVE SSO linking for characters, with linked-character ownership, unlinking, scope checks, and privacy controls.
• Character asset sync, corporation asset sync, corporation blueprint sync, corporation wallet division sync, and skill sync.
• Asset ledger with sortable columns, fast dropdown filters, partial search, click-to-filter cells, CSV export, and Janice-friendly copy output.
• Blueprint and recipe views powered by SDE import, with BPO/BPC filters, ME/TE badges, owner filters, sortable blueprint lists, and recipe detail modals.
• Corporation page with enrolled corporations, CEO/member metadata where available, sync status, wallet divisions, and eligible sync characters.
• Roster page for corporation-grouped character display.
• Contact/standing propagation tools using writable ESI character contacts.
• Notifications, private messages, and admin audit log for sync transparency.
• Historical analytics foundation with snapshot runs, metric metadata/versioning, baseline-aware deltas, exports, and composable widgets.
• Navigation suite with SDE-backed route planning, gatecheck summaries, operational starmap rendering, and security-status color coding.
• Hauling intelligence widgets for industrial kill heat, PvP system intel, smartbomb indicators, and Local Threat analysis with background queue progress for large systems.
• Jump Freighter plotter with JDC/JFC fuel math, station/cyno guidance, nearby operational map context, and 24-hour industrial kill visibility per jump.
• Sideloadable Android WebView wrapper build script that outputs EQM.apk.

Screenshots

A quick tour of the current beta surface, ordered roughly the way a new Quartermaster operator would encounter the tool.

Command Center

Overview	Analytics Platform

Assets, Industry, And Corporations

Asset Ledger	Blueprint And Recipe Library

Corporation Sync	ESI Sync And Character Contacts

Character Skills

Navigation And Hauling Intel

Navigation Hub	Route Checker

Industrial System Threat	PvP Intel Report

Local Threat Analysis	Jump Freighter Plotter

Operational Jump Freighter Map

Account, Settings, And Audit

Profile And Messages	Audit Log

Settings And SDE Import	Permissions And Privacy

Additional Settings

Stack

• Frontend: React, TypeScript, Vite, lucide-react.
• Backend: FastAPI, SQLAlchemy, Alembic.
• Database: PostgreSQL.
• Worker/cache: Redis-backed worker placeholder for longer-running sync work.
• Runtime: Docker Compose.
• External data: EVE ESI/SSO and EVE Static Data Export.
• Mobile: Minimal Android WebView shell for sideload testing.

Run Locally

Prerequisites

• Docker Desktop with Docker Compose support enabled.
• Git for cloning the repository.
• An EVE developer application if you want ESI/SSO sync locally.
• Optional: Android Studio or Android SDK command-line tools if you want to build EQM.apk.

First Run

From PowerShell in the repository root:

copy .env.example .env
docker compose up --build

Then open:

• Frontend: http://localhost:5173
• Backend health: http://localhost:8000/api/health
• OpenAPI docs: http://localhost:8000/docs
• Schema metadata: http://localhost:8000/api/metadata/schema

On first launch, create the administrator account from the bootstrap screen. After that, use the admin account to create invites, configure permissions, import SDE data, and link EVE characters through SSO.

If the frontend loads but data panels are empty or offline, check the containers:

docker compose ps
docker compose logs backend

To reset all local container data during early testing, stop the stack and remove volumes:

docker compose down -v

That deletes the local PostgreSQL and Redis volumes, so only use it when you intentionally want a fresh database.

EVE SSO Configuration

Local EVE SSO settings live in .env, which is intentionally ignored by source control:

• EVE_SSO_CLIENT_ID
• EVE_SSO_CLIENT_SECRET
• EVE_SSO_CALLBACK_URL
• TOKEN_ENCRYPTION_KEY
• FRONTEND_URL

The configured callback must exactly match the callback in the EVE developer portal. For local-only development, the callback is usually:

http://localhost:8000/api/esi/auth/callback

For a hosted test instance, set both the EVE developer callback and EVE_SSO_CALLBACK_URL to the hosted backend callback, and set FRONTEND_URL to the hosted frontend URL so SSO returns users to the application instead of raw API JSON.

When scopes are added or changed, linked characters need to run EVE SSO again before new permissions are available to sync workers.

SDE Import

The app can import EVE Static Data Export files from a local read-only mount. Put an extracted SDE folder or SDE zip under ./sde, or set SDE_HOST_PATH in .env to another host folder. Inside containers this is mounted as /sde by default.

Accepted layouts include modern SDE root files:

• categories.yaml
• groups.yaml
• types.yaml
• blueprints.yaml

Older FSD layouts are also accepted:

• fsd/categoryIDs.yaml
• fsd/groupIDs.yaml
• fsd/typeIDs.yaml
• fsd/blueprints.yaml

Admins can run the import from Settings -> SDE Import. Navigation, route maps, recipes, blueprint activity, station guidance, and skill grouping all get better as SDE coverage improves.

Android APK

The repository includes a small Android wrapper in android-eqm/. It builds a sideloadable WebView APK named EQM.apk.

From PowerShell in the repository root:

.\build-eqm-apk.bat

Override the default app URL for a test build:

$env:EQM_URL = "http://192.168.0.20:5173/"
.\build-eqm-apk.bat

If Gradle dependencies need to be downloaded:

$env:EQM_ONLINE = "1"
.\build-eqm-apk.bat

The current wrapper is intended for sideload testing, not Play Store distribution.

Testing Checklist

After docker compose up --build, confirm:

1. The frontend loads and shows API status ok.
2. First admin bootstrap or normal login works.
3. EVE SSO can link a character and returns to the frontend.
4. Asset sync populates readable item/location/owner data.
5. Asset filters, CSV export, and Janice copy respect the current filter.
6. Corporation sync pulls eligible corporation assets, blueprints, member metadata, and wallet divisions where scopes allow.
7. Skill sync completes, skills group under real categories, and category SP totals display.
8. SDE import completes and recipes are browsable.
9. Analytics snapshots show totals immediately, but first-observation baselines do not inflate gain widgets.
10. Navigation route planning works from SDE data, and gatecheck details open for route systems.
11. Jump Frei...