How mervearslan1/aviation-platform works
Aviation Platform is a modular-monolith aviation learning and publishing product, with a React flight surface and a separate OPS area. The main learner journey is to browse tower or pilot training, practise listening, speaking and scenarios, and—when signed in—retain progress; cockpit simulations are a separate capability. Writers submit articles for review, while OPS handles applications and feedback. The README documents these product areas, but most controller and service implementations were not sampled, so backend links are shown only where supported or marked unverified.
Main entry points: App.tsx Flight and OPS router · api.ts Learning API · FlightShell.tsx Flight shell · Writer.tsx Article editor
Components 20
Flight surface
- Flight and OPS router
frontend/src/App.tsx - Flight shell
frontend/src/flight/FlightShell.tsx
Training
- Tower practice
frontend/src/flight/TowerGame.tsx - Pilot track
frontend/src/flight/pages/PathPage.tsx - Cockpit surface
frontend/src/flight/pages/Cockpit.tsx - Learning API
frontend/src/shared/api.ts - Aircraft simulation
src/main/java/com/aviation/platform/module/aircraft/service/SimulationEngine.java - Learning service
src/main/java/com/aviation/platform/module/learning/service/LearningService.java
Publishing
- Article editor
frontend/src/flight/pages/Writer.tsx - Article API
src/main/java/com/aviation/platform/module/article/service/ArticleService.java - Article feedback
src/main/java/com/aviation/platform/module/article/service/ArticleFeedbackService.java
Identity and operations
- Sign-in page
frontend/src/flight/pages/Login.tsx - Authentication
src/main/java/com/aviation/platform/module/auth/service/AuthService.java - User administration
src/main/java/com/aviation/platform/module/user/service/UserService.java - OPS applications
frontend/src/ops/pages/Applications.tsx - Team applications
src/main/java/com/aviation/platform/module/user/service/TeamApplicationService.java - Audit logs
src/main/java/com/aviation/platform/module/audit/service/AuditService.java
Backend platform
- JWT service
src/main/java/com/aviation/platform/common/security/jwt/JwtService.java - API response envelope
src/main/java/com/aviation/platform/common/response/ApiResponse.java
Other components
- Learner or writer
Connections 20
- Learner or writer → Flight and OPS router: opens
frontend/src/App.tsx - Flight and OPS router → Flight shell: routes to
frontend/src/App.tsx - Flight and OPS router → Article editor: routes to
frontend/src/App.tsx - Flight and OPS router → Sign-in page: routes to
frontend/src/App.tsx - Flight and OPS router → OPS applications: routes to
frontend/src/App.tsx - Flight shell → Tower practice: offers practice
README.md - Flight shell → Pilot track: offers track
README.md - Flight shell → Cockpit surface: offers cockpit
frontend/src/App.tsx - Tower practice → Learning API: uses
frontend/src/flight/TowerGame.tsx - Article editor → Learning API: uses API client
frontend/src/flight/pages/Writer.tsx - Cockpit surface → Learning API: uses API client
- Learning API → Learning service: calls backend
- Learning API → Aircraft simulation: calls backend
- Article editor → Article API: submits articles
- Article editor → Article feedback: handles feedback
- Sign-in page → Authentication: authenticates
- Authentication → JWT service: issues tokens
- OPS applications → Team applications: reviews applications
frontend/src/ops/pages/Applications.tsx - Flight and OPS router → User administration: offers OPS users
frontend/src/App.tsx - Flight and OPS router → Audit logs: offers OPS audit
frontend/src/App.tsx