# FireGrid - Forward Observer Artillery Training Simulation **Complete FO Artillery Training System** | **Operational Status** � | **Ready for Training** FireGrid is a comprehensive Forward Observer (FO) artillery simulation training system that provides realistic military fire support training using authentic MGRS coordinates, Call for Fire procedures, and AI-powered Fire Direction Center operations. ## Quick Start ### **Instant Launch** (System Ready) ```bash # Install dependencies uv sync # Start training system uv run python -m server.main # Access web interface # � http://localhost:8000 ``` **System Status**: � **Fully Operational** - Complete FO training workflow implemented ## <�� Forward Observer Training Features ### **Authentic Military Simulation** - **MGRS Coordinate System**: Military Grid Reference System with UTM conversion - **Call for Fire Procedures**: Standard military fire support request protocols - **AI Fire Direction Center**: Realistic ballistic calculations with artillery database - **Forward Observer Modeling**: Experience-based accuracy and observation timing - **Performance Assessment**: 50/50 accuracy and effectiveness scoring model ### **Complete Training Workflow** 1. **Target Observation** � Identify and observe targets on tactical display 2. **MGRS Coordinate Acquisition** � Obtain precise military grid coordinates 3. **Call for Fire** � Submit fire support request using standard protocols 4. **AI FDC Processing** � System calculates optimal firing solution 5. **Impact Analysis** � Observe artillery impact and assess damage effects 6. **Fire Adjustment** � Submit corrections based on impact observation 7. **Performance Evaluation** � Receive comprehensive accuracy and effectiveness scoring ### **Training Scenarios** - **0� T% (Basic Fire)**: Single target fire adjustment training - **� Development & Testing ### **Testing Commands** ```bash # Run all tests uv run pytest # Run specific FO module tests uv run pytest tests/test_mgrs.py uv run pytest tests/test_forward_observer.py # Run with coverage report uv run pytest --cov=firegrid_core ``` ### **Development Rules** - **TDD Approach**: Tests first, then implementation - **File Limits**: 300 lines max per file, 80 characters per line - **Code Style**: Black formatting, mypy type checking - **Tech-Priest Persona**: Warhammer 40K-inspired development culture ## =� Project Structure ``` FireGrid/ � firegrid_core/ # FO simulation engine (Complete) � � mgrs.py # MGRS coordinate system � � forward_observer.py # FO simulation & accuracy � � fire_mission.py # Call for Fire procedures � � ai_fdc.py # AI Fire Direction Center � � target_manager.py # Target & scenario management � � fo_scoring.py # Performance assessment � � ballistics.py # Artillery physics � � rng.py # Deterministic randomization � server/ # Web application (Complete) � � main.py # FastAPI application � � routes/ # Web and API routes � � templates/ # Jinja2 HTML templates � � static/ # CSS, JS, images � tests/ # Test suite � doc/ # Documentation � plan.md # Development status � CLAUDE.md # Developer guide � INDEX.md # Documentation index ``` ## <� System Status ### **� Complete Implementation** - **Forward Observer Training**: Full simulation with experience-based accuracy - **MGRS Coordinate System**: Complete military grid system with UTM conversion - **Call for Fire Procedures**: Authentic military fire support protocols - **AI Fire Direction Center**: Realistic ballistic calculations and firing solutions - **Web Application**: Full-featured interface with Korean military terminology - **Performance Assessment**: Comprehensive 50/50 accuracy/effectiveness scoring - **Training Scenarios**: Multiple difficulty levels and target configurations ### **<� Ready for Use** - **Immediate Launch**: `uv run python -m server.main` - **No Additional Setup**: Complete system ready for training - **Full Workflow**: End-to-end FO training from observation to scoring - **Multiple Scenarios**: Various training configurations available ## =� Documentation - **[CLAUDE.md](CLAUDE.md)**: Complete developer guide and system reference - **[plan.md](plan.md)**: Development completion status and future roadmap - **[INDEX.md](INDEX.md)**: Documentation index and navigation guide - **[rules/rules.md](rules/rules.md)**: Development rules and Tech-Priest persona ## >� Contributing 1. Follow TDD approach: tests first, then implementation 2. Respect file limits: 300 lines per file, 80 characters per line 3. Maintain Tech-Priest persona in documentation 4. Use `uv` for all package management operations 5. Ensure all tests pass before submitting changes --- **Ready for Training** | **Complete FO Artillery Simulation** | **Operational System** *By the Omnissiah's divine algorithms, may this sacred training system serve eternal purpose in the cultivation of blessed Forward Observer knowledge.*