Adicionar README.md

This commit is contained in:
2026-05-22 13:27:52 +00:00
parent b155f312bd
commit e0852e1ee1
+152
View File
@@ -0,0 +1,152 @@
# <div align="center">BBF11 – Military Fire Support & Tactical Reporting Workbook</div>
---
## <div align="center">Overview</div>
BBF11 is an Excel VBA-enabled workbook designed to support military fire support calculations, coordinate conversion and operational reporting.
The workbook includes tactical forms, artillery-related worksheets, coordinate tools and standardized military report templates.
---
# <div align="center">Main Features</div>
| Feature | Description |
|:---:|:---:|
| Coordinate Conversion | Rectangular and polar coordinate conversion tools |
| Fire Support Calculations | Support for firing requests and correction data |
| Tactical Reports | Predefined military report templates |
| VBA Automation | Macro-enabled workflow and navigation |
| Initial Panel | Hidden dashboard/panel used for workbook initialization |
---
# <div align="center">Workbook Sheets</div>
| Sheet | Purpose |
|:---:|:---:|
| `ITTM` | Initial tactical/fire support data |
| `Coordenadas Rectangulares` | Rectangular coordinate conversion |
| `Desvios de PR` | Reference point deviation calculations |
| `Coordenadas Polares` | Polar coordinate calculations |
| `TTN` | Tactical calculation/support sheet |
| `A - FU STATUS REPORT` | Fire Unit Status Report |
| `B - FO REPORT` | Forward Observer Report |
| `SITREP` | Situation Report |
| `"10-liner" UXO_IED REPORT` | UXO/IED spot report |
| `MEDEVAC 9-LINER` | Medical evacuation report |
| `INCIDENT REPORT` | Incident reporting form |
| `CFF` | Call for Fire support sheet |
| `RCBT - frente` | Front page of tactical report |
| `RCBT - verso` | Back page of tactical report |
| `BD` | Database/support data |
| `Painel Inicial` | Hidden initial panel |
---
# <div align="center">VBA Automation</div>
The workbook contains VBA macros used to automate workbook navigation, data preparation and operational workflows.
Detected VBA-related functionality includes:
| Macro / Feature | Description |
|:---:|:---:|
| `DadosIniciais` | Initializes or loads initial workbook data |
| Button Actions | Macro-linked interface buttons |
| Workbook Save Logic | Automatic workbook saving routines |
| Sheet Navigation | Assisted navigation between tactical forms |
| Report Support | Automation support for report preparation |
---
# <div align="center">Operational Report Templates</div>
The workbook includes multiple standardized military report formats:
| Report | Description |
|:---:|:---:|
| FU Status Report | Fire Unit readiness and ammunition status |
| FO Report | Forward Observer operational report |
| SITREP | Situation report |
| UXO/IED 10-Liner | Explosive ordnance incident report |
| MEDEVAC 9-Liner | Medical evacuation request format |
| Incident Report | General incident reporting |
| CFF | Call for Fire |
---
# <div align="center">Technologies Used</div>
| Technology | Purpose |
|:---:|:---:|
| Microsoft Excel | Main platform |
| VBA | Automation and workbook logic |
| Excel Formulas | Calculation logic |
| Macro Buttons | User interaction |
| Structured Worksheets | Tactical and operational templates |
---
# <div align="center">Requirements</div>
| Requirement | Description |
|:---:|:---:|
| Microsoft Excel | Required to open the workbook |
| VBA Macros Enabled | Required for automation |
| Windows OS | Recommended environment |
| Trusted Location | Recommended for macro execution |
---
# <div align="center">How to Use</div>
1. Open the workbook in Microsoft Excel.
2. Enable macros.
3. Start from the initial panel or relevant tactical worksheet.
4. Use coordinate conversion sheets when required.
5. Fill in operational or report-specific fields.
6. Use predefined report sheets for tactical communication.
7. Save/export the completed forms as needed.
---
# <div align="center">Security Notes</div>
This workbook contains VBA macros.
Before using it:
- Confirm the file source is trusted
- Enable macros only in a secure environment
- Validate calculated outputs before operational use
- Review all reports before distribution
---
# <div align="center">Future Improvements</div>
- Improve VBA error handling
- Add user authentication
- Add PDF export automation
- Add automatic report validation
- Create a modern dashboard interface
- Add database integration
- Add version control for generated reports
---
# <div align="center">Disclaimer</div>
This project is intended for training, operational support and reporting automation purposes.
All tactical data, calculations and reports must be validated by qualified personnel before official use.
---
# <div align="center">Author</div>
José Garcia
Data Scientist
Process Digitalization & Automation