System Overview
The Logistics & Campaign Management System is a comprehensive enterprise solution for planning, tracking, and optimizing high-altitude balloon operations. It integrates seamlessly with the HAB simulation platform to provide end-to-end mission management capabilities.
Mission Planning
Plan single missions or multi-mission campaigns with full cost analysis and resource allocation
Inventory Management
Track balloons, gases, payloads, and consumables with real-time quantity updates
Cost Tracking
Multi-currency support with exchange rates, vendor management, and comprehensive cost breakdowns
Campaign Validation
Progressive validation workflow: simulate → validate → adjust → re-simulate
Analytics & Reports
Generate detailed cost breakdowns, resource utilization reports, and campaign analytics
Database Management
Inline editing, import/export capabilities, and comprehensive data management tools
Logistics Management
Database Management
Complete CRUD operations for all logistics resources with inline editing capabilities:
- Balloon types with manufacturer specs and pricing
- Gas suppliers with high-purity helium and hydrogen options
- Payload models including IMAGERY, MMTI, SIGINT, and EW capabilities
- Vendor management with lead times and payment terms
- Operations costs (personnel, vehicles, travel, services)
- Exchange rates with automatic updates
Quick Calculator Tools
Helium Calculator: Calculate required gas volume based on balloon mass, payload weight, and target ascent rate
Recovery Calculator: Estimate landing location and recovery costs based on wind conditions
Mission Cost Estimator: Generate comprehensive cost breakdowns including all resources
Supported Resources
Balloons
- Kaymont (KCI series)
- Hwoyee (HY series)
- Totex (TA series)
- Zero-pressure balloons
Gases
- High-purity Helium (99.9%)
- High-purity Hydrogen (99.999%)
- K-size and T-size cylinders
- Hazmat tracking and requirements
Payloads
- Imagery systems
- SIGINT equipment
- MMTI sensors
- EW (EA/ES) capabilities
Campaign Planning & Management
Campaign Workflow
Step 1: Campaign Creation
Define campaign objectives, timeline, and initial mission parameters
Step 2: Mission Planning
Add multiple missions with specific launch sites, payloads, and objectives
Step 3: Simulation
Run forward or reverse trajectory simulations for each mission
Step 4: Validation
Validate individual missions, adjust parameters, and re-simulate as needed
Step 5: Resource Allocation
Allocate inventory, assign personnel, and schedule resources
Step 6: Execution
Track campaign progress, update mission status, and generate reports
Campaign Features
- Multi-mission coordination with timeline visualization
- Progressive validation with simulation integration
- Resource conflict detection and resolution
- NOTAM tracking and regulatory compliance
- Campaign checklist generation with required documents
- Real-time status tracking (Planning → Ready → Complete)
Advanced Capabilities
Forward Simulation
Predict trajectory from launch to landing with weather integration
Reverse Planning
Calculate launch parameters from desired landing zone
Multi-Currency Support
Handle international operations with automatic exchange rate conversion
Inventory Management System
Key Features
- NEW Add items via form with condition and location tracking
- NEW Inline quantity editing with +/- buttons and direct input
- NEW Quick Add (+5) functionality for rapid inventory updates
- Real-time stock level indicators (High/Normal/Low)
- Allocation tracking for campaign resources
- Serial number and batch tracking
- Location-based inventory management
- Automatic reorder point notifications
Inventory Categories
Categories:
- Balloons (weather, zero-pressure, reusable)
- Gases (helium, hydrogen with purity tracking)
- Payloads (imagery, SIGINT, MMTI, EW, scientific)
- Consumables (parachutes, rigging, batteries, etc.)
Inventory Operations
Add New Items: Click "Add Item" → Select type → Choose item → Set quantity and details → Submit
Update Quantities: Use inline +/- buttons or enter directly in quantity field
Quick Add: Click "Quick +5" to rapidly increase stock
Create Orders: Generate purchase orders when stock is low
API Reference
Logistics Endpoints
GET
/logistics/api/balloons
Retrieve all balloon types with specifications and pricing
GET
/logistics/api/gases
Get gas types with purity, container specs, and hazmat info
GET
/logistics/api/payloads
List payload models with capabilities and specifications
GET
/logistics/api/vendors
Retrieve vendor information including lead times and FSR rates
GET
/logistics/api/inventory
Get categorized inventory with current stock levels
POST
/logistics/api/inventory/add
Add new items to inventory
PUT
/logistics/api/inventory/update
Update inventory quantities
POST
/logistics/api/quick-calc/helium
Calculate helium requirements for mission
GET
/logistics/api/reports/cost-breakdown
Generate comprehensive cost analysis reports
Campaign Endpoints
GET
/campaign/api/campaigns
List all campaigns with status and progress
POST
/campaign/api/campaigns
Create new campaign with objectives and timeline
GET
/campaign/api/campaigns/{id}/missions
Get all missions for a specific campaign
POST
/campaign/api/campaigns/{id}/validate
Run validation workflow for campaign
POST
/campaign/api/missions/{id}/simulate
Run trajectory simulation for mission
Integration with HAB Simulation
Mission Control Integration
The logistics system integrates seamlessly with the HAB simulation platform:
- Check "Include Logistics" in Mission Control to add cost analysis to simulations
- Simulation results automatically link to logistics database via simulation_id
- Campaign missions can launch simulations directly from the planning interface
- Reverse planning calculates optimal launch parameters from desired landing zones
Database Architecture
Database: PostgreSQL (separate from main simulation DB)
Schema: Shared user authentication with main platform
Models: SQLAlchemy ORM with comprehensive relationships
Auto-init: Schema created automatically on first run
Seed Data: Run scripts/init_logistics_db.py for initial data
Security & Compliance
- ITAR compliance tracking for controlled payloads
- Security classification support (UNCLASSIFIED to TS)
- Role-based access control (currently global editing)
- Audit trail for all database modifications
- Encrypted storage for sensitive payload specifications
Enterprise HAB Simulation Platform - Logistics & Campaign Management
Version 2.0 | Last Updated: 2024