★ ACADEMIC USE · MIL-EDU PROJECT ★

C-27J SPARTAN · TACTICAL WX OPS

Sistem suport-decizie meteo pentru misiuni transport aerian tactic

Author: Ioana Diaconu  ·  Codename: SPARTAN-MET  ·  Status: OPERATIONAL

🎯 Mission

Platformă de generare și distribuție scenarii meteo dinamice pentru simulator C-27J. Construită pentru susținere proiect academic ATM (Academia Tehnică Militară) — modul autonom integrat cu APK Android tactical display + decision engine MATLAB + ESP32 cabin gateway.

📡 Modules

🛠

Mission Planner

Editor scenarii meteo cu evoluție temporală automată (mișcare, intensificare, decay) și override-uri forțate. Player TV-style pentru briefing.

Auth: HTTP Basic · CRUD via JSON
→ Use case: instructor & briefing officer
📺

Briefing Replay

Player read-only pentru prezentări scenarii — timeline ×30/×60, animație continuă, optimizat proiector.

2 scenarii operaționale
→ Use case: briefing class · debrief AAR
📖

Tech Documentation

Manualul tehnic complet — arhitectură, model date, API, workflow integrat cu APK + MATLAB. Pentru referință și anexă memoriu.

PDF-ready · academic format
→ Use case: redactare memoriu licență

🛰 Tactical Endpoint TOKEN AUTH

Endpoint public read-only pentru clienții C-27J Radar și MATLAB decision engine. Autentificare prin token fix (32+ caractere hex), rate-limit 120/min, audit log.

GET /api/endpoint.php?token=<APK_TOKEN>&action=list&type=wx
GET /api/endpoint.php?token=<APK_TOKEN>&action=get&type=wx&id=<ID>

Token-urile sunt distribuite operatorilor autorizați. Niciodată nu se trimit prin email/Slack — doar transferate manual.

⚙ System Architecture

Componente: 📺 BRIEFING 🛠 PLANNER 📖 DOCS 📱 C-27J RADAR 🖥 MATLAB 📡 ESP32 GW

+---------------+ +----------------+ +---------------+ | BRIEFING | | PLANNER (web) | | DOCS (web) | | ROOM | | ioana / passwd | | /docs/ | +-------+-------+ +--------+-------+ +-------+-------+ | | HTTPS Basic | | v | | +---------------------+ | +---HTTPS----->| IOANAD.MENSOFT.RO |<--------+ | PHP 7.1 + JSON | | /scenarios/wx/* | +----------+----------+ | TOKEN AUTH (read-only) +----------+----------+ v v +-------------------+ +-------------------+ | C-27J RADAR | | MATLAB engine | | (Android tablet) | | decision tree | +---------+---------+ +---------+---------+ | POST /advice | webread /gps | WX OWM + METAR | v ^ +----------------------------+ | ESP32 CABIN GATEWAY | | /gps /advice /display | +----------------------------+

🪖 Operational Workflow

  1. Mission planning — Officer creează scenariul WX în Planner (5-10 min). Salvat ca JSON pe server.
  2. Pre-flight — APK pe tabletă în cabină, tab Replay → Remote, descarcă scenariul ales (cache local nelimitat).
  3. Mission start — MATLAB pornește scenariul de zbor, push fake GPS la ESP32 (pattern /setgpsstart).
  4. In-flight — APK în mod Apply/Run citește GPS de la ESP32 → calculează WX la poziția și timpul curent → push /advice JSON cu OWM + METAR.
  5. Decision loop — MATLAB face webread la ESP32 /gps, primește GPS + secțiunea realwx, evaluează decizii (NORMAL · LATERAL DEV · LEVEL CHG · DIVERT · GO-AROUND).
  6. Debrief — Briefing Replay pe proiector pentru AAR (After Action Review).