# jorgesup841/warfare-vanguard architecture

> Architecture diagram of the GitHub repository jorgesup841/warfare-vanguard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jorgesup841/warfare-vanguard
- Repository: https://github.com/jorgesup841/warfare-vanguard

## Overview

Warfare-Vanguard is an Angular/Spring Boot recreation of Advance Wars. The intended user journey is account registration and verification, then creating and playing a turn-based game; the backend also exposes user administration and game-report capabilities. The shown frontend game-data service currently reads static assets, so a live frontend-to-backend gameplay connection is not evidenced. Backend game creation and OTP handling are visible in excerpts; other controller and gameplay details are inferred only from the tree.

Main entry points: [`AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/GameService.java`](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/GameService.java) (Game orchestration), [`AdvanceWarsFront/src/app/app-routing-module.ts`](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/app-routing-module.ts) (App routes), [`AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/AuthService.java`](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/AuthService.java) (Authentication service), [`AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/AuthController.java`](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/AuthController.java) (Auth API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_app["Angular app<br/>[app.ts]"]
  node_routes["App routes"]
  node_auth_ui["Sign-in and registration"]
  node_verify_ui["OTP verification"]
  node_game_ui["Game screen<br/>[juegocomponent.ts]"]
  node_game_scene["Map scene<br/>[escenamapa.ts]"]
  node_game_data["Game data service<br/>[juegoservice.ts]"]
end

subgraph group_identity["Identity and users"]
  node_auth_controller["Auth API"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_otp_service["OTP service<br/>[OtpService.java]"]
  node_otp_store[("OTP challenges")]
  node_email["Email delivery<br/>[EmailService.java]"]
  node_user_controller["User API"]
  node_user_service["User service<br/>[UserService.java]"]
  node_user_store[("User accounts")]
end

subgraph group_game["Game runtime"]
  node_game_controller["Game API"]
  node_game_service["Game orchestration<br/>[GameService.java]"]
  node_map_generation["Map generation"]
  node_property_generation["Property generation"]
  node_game_state[("Game state<br/>[GameState.java]")]
  node_player_state["Players and units<br/>[Player.java]"]
  node_game_store[("Game persistence")]
end

subgraph group_report["Reporting"]
  node_report_controller["Report API"]
  node_pdf_service["PDF report generator"]
  node_logs_store[("Game event history")]
end

node_player(("Player"))

node_player -->|"uses"| node_app
node_app -->|"routes"| node_routes
node_routes -->|"routes"| node_auth_ui
node_routes -->|"routes"| node_verify_ui
node_routes -->|"routes"| node_game_ui
node_game_ui -.->|"renders"| node_game_scene
node_game_ui -.->|"loads data"| node_game_data
node_auth_ui -.->|"calls API"| node_auth_controller
node_verify_ui -.->|"calls API"| node_auth_controller
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_controller -->|"queries user"| node_user_service
node_auth_service -->|"issues and verifies"| node_otp_service
node_auth_service -->|"sends OTP"| node_email
node_auth_service -->|"saves account"| node_user_store
node_otp_service -->|"persists challenges"| node_otp_store
node_user_controller -->|"delegates to"| node_user_service
node_user_service -->|"reads accounts"| node_user_store
node_game_controller -.->|"delegates to"| node_game_service
node_game_service -->|"generates map"| node_map_generation
node_game_service -->|"generates properties"| node_property_generation
node_game_service -->|"saves game"| node_game_store
node_game_service -->|"creates players"| node_player_state
node_game_state -->|"contains"| node_player_state
node_report_controller -.->|"delegates to"| node_pdf_service
node_pdf_service -->|"reads game"| node_game_store
node_pdf_service -->|"reads history"| node_logs_store

click node_app "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/app.ts"
click node_routes "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/app-routing-module.ts"
click node_auth_ui "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/components/iniciosesioncomponent/iniciosesioncomponent.ts"
click node_verify_ui "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/components/verificarcomponent/verificarcomponent.ts"
click node_game_ui "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/components/juegocomponent/juegocomponent.ts"
click node_game_scene "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/phaser/escenamapa.ts"
click node_game_data "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/services/juegoservice.ts"
click node_auth_controller "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/AuthController.java"
click node_auth_service "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/AuthService.java"
click node_otp_service "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/OtpService.java"
click node_otp_store "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/OtpChallengeRepository.java"
click node_email "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/EmailService.java"
click node_user_controller "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/UserController.java"
click node_user_service "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/UserService.java"
click node_user_store "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/UserRepository.java"
click node_game_controller "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/GameController.java"
click node_game_service "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/GameService.java"
click node_map_generation "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/MapGenerationService.java"
click node_property_generation "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/PropertyGenerationService.java"
click node_game_state "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/model/GameState.java"
click node_player_state "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/model/Player.java"
click node_game_store "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/GameStateRepository.java"
click node_report_controller "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/ReportController.java"
click node_pdf_service "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/PdfReportService.java"
click node_logs_store "https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/GameLogRepository.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_routes,node_auth_ui,node_verify_ui,node_game_ui,node_game_scene,node_game_data toneBlue
class node_auth_controller,node_auth_service,node_otp_service,node_otp_store,node_email,node_user_controller,node_user_service,node_user_store toneAmber
class node_game_controller,node_game_service,node_map_generation,node_property_generation,node_game_state,node_player_state,node_game_store toneMint
class node_report_controller,node_pdf_service,node_logs_store toneRose
class node_player toneIndigo
```

## Components

### Angular client

- [Angular app](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/app.ts): `AdvanceWarsFront/src/app/app.ts`
- [App routes](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/app-routing-module.ts): `AdvanceWarsFront/src/app/app-routing-module.ts`
- [Sign-in and registration](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/components/iniciosesioncomponent/iniciosesioncomponent.ts): `AdvanceWarsFront/src/app/components/iniciosesioncomponent/iniciosesioncomponent.ts`
- [OTP verification](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/components/verificarcomponent/verificarcomponent.ts): `AdvanceWarsFront/src/app/components/verificarcomponent/verificarcomponent.ts`
- [Game screen](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/components/juegocomponent/juegocomponent.ts): `AdvanceWarsFront/src/app/components/juegocomponent/juegocomponent.ts`
- [Map scene](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/phaser/escenamapa.ts): `AdvanceWarsFront/src/app/phaser/escenamapa.ts`
- [Game data service](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWarsFront/src/app/services/juegoservice.ts): `AdvanceWarsFront/src/app/services/juegoservice.ts`

### Identity and users

- [Auth API](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/AuthController.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/AuthController.java`
- [Authentication service](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/AuthService.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/AuthService.java`
- [OTP service](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/OtpService.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/OtpService.java`
- [OTP challenges](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/OtpChallengeRepository.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/OtpChallengeRepository.java`
- [Email delivery](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/EmailService.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/EmailService.java`
- [User API](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/UserController.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/UserController.java`
- [User service](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/UserService.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/UserService.java`
- [User accounts](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/UserRepository.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/UserRepository.java`

### Game runtime

- [Game API](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/GameController.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/GameController.java`
- [Game orchestration](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/GameService.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/GameService.java`
- [Map generation](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/MapGenerationService.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/MapGenerationService.java`
- [Property generation](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/PropertyGenerationService.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/PropertyGenerationService.java`
- [Game state](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/model/GameState.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/model/GameState.java`
- [Players and units](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/model/Player.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/model/Player.java`
- [Game persistence](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/GameStateRepository.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/GameStateRepository.java`

### Reporting

- [Report API](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/ReportController.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/ReportController.java`
- [PDF report generator](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/PdfReportService.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/PdfReportService.java`
- [Game event history](https://github.com/jorgesup841/warfare-vanguard/blob/main/AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/GameLogRepository.java): `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/repository/GameLogRepository.java`

### Other components

- **Player**

## Connections

- Player → Angular app: uses
- Angular app → App routes: routes (evidence: `AdvanceWarsFront/src/app/app-routing-module.ts`)
- App routes → Sign-in and registration: routes (evidence: `AdvanceWarsFront/src/app/app-routing-module.ts`)
- App routes → OTP verification: routes (evidence: `AdvanceWarsFront/src/app/app-routing-module.ts`)
- App routes → Game screen: routes (evidence: `AdvanceWarsFront/src/app/app-routing-module.ts`)
- Game screen → Map scene: renders (evidence: `AdvanceWarsFront/src/app/components/juegocomponent/juegocomponent.ts`)
- Game screen → Game data service: loads data (evidence: `AdvanceWarsFront/src/app/components/juegocomponent/juegocomponent.ts`)
- Sign-in and registration → Auth API: calls API
- OTP verification → Auth API: calls API
- Auth API → Authentication service: delegates to (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/AuthController.java`)
- Auth API → User service: queries user (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/AuthController.java`)
- Authentication service → OTP service: issues and verifies (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/AuthService.java`)
- Authentication service → Email delivery: sends OTP (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/AuthService.java`)
- Authentication service → User accounts: saves account (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/AuthService.java`)
- OTP service → OTP challenges: persists challenges (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/OtpService.java`)
- User API → User service: delegates to (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/UserController.java`)
- User service → User accounts: reads accounts (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/UserService.java`)
- Game API → Game orchestration: delegates to (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/GameController.java`)
- Game orchestration → Map generation: generates map (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/GameService.java`)
- Game orchestration → Property generation: generates properties (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/GameService.java`)
- Game orchestration → Game persistence: saves game (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/GameService.java`)
- Game orchestration → Players and units: creates players (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/GameService.java`)
- Game state → Players and units: contains (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/model/GameState.java`)
- Report API → PDF report generator: delegates to (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/controller/ReportController.java`)
- PDF report generator → Game persistence: reads game (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/PdfReportService.java`)
- PDF report generator → Game event history: reads history (evidence: `AdvanceWars/src/main/java/co/edu/unbosque/advancewars/service/PdfReportService.java`)
