# ruhanazevedo/battleship architecture

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

- Interactive diagram: https://gitdiagram.com/ruhanazevedo/battleship
- Repository: https://github.com/ruhanazevedo/battleship

## Overview

Battleship is a desktop PDF coordinate picker for iText developers. A user opens a PDF through the launcher or drops it onto the window; the viewer requests page rendering, displays the page, and records clicks as bottom-left-origin PDF coordinates. Picks appear in session history and can be copied or exported as JSON, CSV, or Java snippets. The viewer also supports page navigation, zoom, hover coordinates, and a click marker. The README documents these capabilities; some viewer-to-renderer and canvas wiring is not visible in the excerpts, so those relationships are marked unverified.

Main entry points: [`src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java`](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java) (PDF viewer), [`src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java`](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java) (PDF launcher), [`src/main/java/com/ruhanazevedo/navalbattle/ui/PdfCanvas.java`](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/PdfCanvas.java) (Page canvas), [`src/main/java/com/ruhanazevedo/navalbattle/App.java`](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/App.java) (Application entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and Launch"]
  node_app["Application entry<br/>[App.java]"]
  node_launcher["PDF launcher"]
  node_ui_util["UI utilities<br/>[UIUtil.java]"]
end

subgraph group_viewing["PDF Viewing"]
  node_viewer["PDF viewer<br/>[ViewerWindow.java]"]
  node_renderer["Page renderer<br/>[PdfRenderer.java]"]
  node_render_result["Rendered page data"]
end

subgraph group_coordinates["Coordinate Picking"]
  node_canvas["Page canvas<br/>[PdfCanvas.java]"]
  node_coordinate_pick["Coordinate pick"]
end

subgraph group_output["History and Export"]
  node_history["Session history<br/>[ViewerWindow.java]"]
  node_export["Export formatting<br/>[ExportService.java]"]
end

node_user(("User"))
node_pdf_file["PDF file"]
node_clipboard["System clipboard"]

node_user -->|"starts"| node_app
node_app -->|"opens"| node_launcher
node_user -->|"chooses or drops"| node_launcher
node_launcher -->|"applies icon"| node_ui_util
node_launcher -->|"opens PDF"| node_viewer
node_pdf_file -.->|"provides input"| node_viewer
node_viewer -.->|"requests rendering"| node_renderer
node_renderer -->|"returns page data"| node_render_result
node_viewer -.->|"displays page"| node_canvas
node_canvas -->|"creates pick"| node_coordinate_pick
node_canvas -.->|"reports click and hover"| node_viewer
node_viewer -->|"records picks"| node_history
node_viewer -->|"formats picks"| node_export
node_export -->|"reads pick fields"| node_coordinate_pick
node_viewer -->|"copies text"| node_clipboard
node_user -->|"navigates and zooms"| node_viewer

click node_app "https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/App.java"
click node_launcher "https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java"
click node_ui_util "https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/UIUtil.java"
click node_viewer "https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java"
click node_renderer "https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/pdf/PdfRenderer.java"
click node_render_result "https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/pdf/PageRenderResult.java"
click node_canvas "https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/PdfCanvas.java"
click node_coordinate_pick "https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/model/CoordinatePick.java"
click node_history "https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java"
click node_export "https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/export/ExportService.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_launcher,node_ui_util,node_user toneBlue
class node_viewer,node_renderer,node_render_result toneAmber
class node_canvas,node_coordinate_pick toneMint
class node_history,node_export toneRose
class node_pdf_file,node_clipboard toneIndigo
```

## Components

### Startup and Launch

- [Application entry](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/App.java): `src/main/java/com/ruhanazevedo/navalbattle/App.java`
- [PDF launcher](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java): `src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java`
- [UI utilities](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/UIUtil.java): `src/main/java/com/ruhanazevedo/navalbattle/ui/UIUtil.java`

### PDF Viewing

- [PDF viewer](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java): `src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java`
- [Page renderer](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/pdf/PdfRenderer.java): `src/main/java/com/ruhanazevedo/navalbattle/pdf/PdfRenderer.java`
- [Rendered page data](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/pdf/PageRenderResult.java): `src/main/java/com/ruhanazevedo/navalbattle/pdf/PageRenderResult.java`

### Coordinate Picking

- [Page canvas](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/PdfCanvas.java): `src/main/java/com/ruhanazevedo/navalbattle/ui/PdfCanvas.java`
- [Coordinate pick](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/model/CoordinatePick.java): `src/main/java/com/ruhanazevedo/navalbattle/model/CoordinatePick.java`

### History and Export

- [Session history](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java): `src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java`
- [Export formatting](https://github.com/ruhanazevedo/battleship/blob/master/src/main/java/com/ruhanazevedo/navalbattle/export/ExportService.java): `src/main/java/com/ruhanazevedo/navalbattle/export/ExportService.java`

### Other components

- **User**
- **PDF file**
- **System clipboard**

## Connections

- User → Application entry: starts (evidence: `src/main/java/com/ruhanazevedo/navalbattle/App.java`)
- Application entry → PDF launcher: opens (evidence: `src/main/java/com/ruhanazevedo/navalbattle/App.java`)
- User → PDF launcher: chooses or drops (evidence: `src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java`)
- PDF launcher → UI utilities: applies icon (evidence: `src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java`)
- PDF launcher → PDF viewer: opens PDF (evidence: `src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java`)
- PDF file → PDF viewer: provides input (evidence: `README.md`)
- PDF viewer → Page renderer: requests rendering (evidence: `src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java`)
- Page renderer → Rendered page data: returns page data (evidence: `src/main/java/com/ruhanazevedo/navalbattle/pdf/PdfRenderer.java`)
- PDF viewer → Page canvas: displays page (evidence: `src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java`)
- Page canvas → Coordinate pick: creates pick (evidence: `src/main/java/com/ruhanazevedo/navalbattle/ui/PdfCanvas.java`)
- Page canvas → PDF viewer: reports click and hover (evidence: `src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java`)
- PDF viewer → Session history: records picks (evidence: `README.md`)
- PDF viewer → Export formatting: formats picks (evidence: `src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java`)
- Export formatting → Coordinate pick: reads pick fields (evidence: `src/main/java/com/ruhanazevedo/navalbattle/export/ExportService.java`)
- PDF viewer → System clipboard: copies text (evidence: `src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java`)
- User → PDF viewer: navigates and zooms (evidence: `README.md`)
