How dcsergio/tombojava works
Tombojava is a Spring Boot tombola-card generator. The main workflow starts in the web UI: submit generation parameters, track an asynchronous job, download its PDF, or verify a generated series against drawn numbers; the UI also provides a clickable 90-number board. Generation builds valid candidate grids, repairs and checks conflicts, then returns accepted series for PDF rendering. The README documents the CLI as an optional alternative. Edges reflect the excerpts, SOURCE INDEX references, and README; UI and CLI links are documented rather than inferred from unsampled implementation.
Main entry points: GenerationJobService.java Generation jobs · ParallelSeriesEngine.java Parallel arbiter · GenerationJobController.java Job API · TombolaSeries.java Generated series
Components 21
Web interface
- Tombola UI
src/main/resources/templates/index.html - Job polling
src/main/resources/static/js/job-polling.js - Job API
src/main/java/it/sdc/tombojava/web/GenerationJobController.java - Home route
src/main/java/it/sdc/tombojava/web/HomeController.java
Job processing
- Generation jobs
src/main/java/it/sdc/tombojava/job/GenerationJobService.java - Job state and status
src/main/java/it/sdc/tombojava/job/GenerationJobStatus.java
Series generation
- Generation request
src/main/java/it/sdc/tombojava/tombola/GenerationRequest.java - Series generator
src/main/java/it/sdc/tombojava/tombola/TombolaSeriesGenerator.java - Parallel arbiter
src/main/java/it/sdc/tombojava/tombola/ParallelSeriesEngine.java - Conflict repair
src/main/java/it/sdc/tombojava/tombola/SeriesRepairer.java - Triple index
src/main/java/it/sdc/tombojava/tombola/TripleIndex.java - Series grid
src/main/java/it/sdc/tombojava/tombola/SeriesGrid.java - Compatibility conflict
src/main/java/it/sdc/tombojava/tombola/CompatibilityConflict.java - Generation result
src/main/java/it/sdc/tombojava/tombola/GenerationResult.java
Cards and output
- Generated series
src/main/java/it/sdc/tombojava/tombola/TombolaSeries.java - Tombola cards
src/main/java/it/sdc/tombojava/tombola/TombolaCard.java - PDF writer
src/main/java/it/sdc/tombojava/tombola/TombolaPdfWriter.java - Verification report writer
src/main/java/it/sdc/tombojava/tombola/TombolaVerificationReportWriter.java - CLI runner
src/main/java/it/sdc/tombojava/cli/TombojavaCliRunner.java
Other components
- Browser user
- PDF download
Connections 33
- Browser user → Tombola UI: uses
README.md - Tombola UI → Job API: calls API
README.md - Job polling → Job API: polls status
README.md - Browser user → Job polling: tracks job
README.md - Browser user → Job API: submits verification
README.md - Job API → Generation jobs: starts and queries
src/main/java/it/sdc/tombojava/web/GenerationJobController.java - Job API → Job state and status: returns status
src/main/java/it/sdc/tombojava/web/GenerationJobController.java - Job API → Generated series: reads for verification
src/main/java/it/sdc/tombojava/web/GenerationJobController.java - Generation jobs → Series generator: generates batch
src/main/java/it/sdc/tombojava/job/GenerationJobService.java - Generation jobs → Generation request: creates request
src/main/java/it/sdc/tombojava/job/GenerationJobService.java - Generation jobs → PDF writer: writes PDF
src/main/java/it/sdc/tombojava/job/GenerationJobService.java - Generation jobs → Generation result: uses result
src/main/java/it/sdc/tombojava/job/GenerationJobService.java - Generation jobs → Job state and status: updates status
src/main/java/it/sdc/tombojava/job/GenerationJobService.java - Generation jobs → Generated series: retains series
src/main/java/it/sdc/tombojava/job/GenerationJobService.java - Generation jobs → PDF download: serves completed file
src/main/java/it/sdc/tombojava/job/GenerationJobService.java - Series generator → Parallel arbiter: runs batch
src/main/java/it/sdc/tombojava/tombola/TombolaSeriesGenerator.java - Parallel arbiter → Conflict repair: repairs candidates
src/main/java/it/sdc/tombojava/tombola/ParallelSeriesEngine.java - Parallel arbiter → Triple index: checks triples
src/main/java/it/sdc/tombojava/tombola/ParallelSeriesEngine.java - Parallel arbiter → Series grid: processes grids
src/main/java/it/sdc/tombojava/tombola/ParallelSeriesEngine.java - Parallel arbiter → Generation request: uses limits
src/main/java/it/sdc/tombojava/tombola/ParallelSeriesEngine.java - Parallel arbiter → Generation result: returns result
src/main/java/it/sdc/tombojava/tombola/ParallelSeriesEngine.java - Parallel arbiter → Compatibility conflict: records conflicts
src/main/java/it/sdc/tombojava/tombola/ParallelSeriesEngine.java - Parallel arbiter → Generated series: accepts series
src/main/java/it/sdc/tombojava/tombola/ParallelSeriesEngine.java - Conflict repair → Series grid: repairs grid
src/main/java/it/sdc/tombojava/tombola/SeriesRepairer.java - Conflict repair → Triple index: checks triples
src/main/java/it/sdc/tombojava/tombola/SeriesRepairer.java - Series grid → Generated series: builds series
src/main/java/it/sdc/tombojava/tombola/SeriesGrid.java - Series grid → Tombola cards: builds cards
src/main/java/it/sdc/tombojava/tombola/SeriesGrid.java - PDF writer → Generated series: renders series
src/main/java/it/sdc/tombojava/tombola/TombolaPdfWriter.java - PDF writer → Tombola cards: renders cards
src/main/java/it/sdc/tombojava/tombola/TombolaPdfWriter.java - Browser user → CLI runner: runs optionally
README.md - CLI runner → Series generator: generates series
src/main/java/it/sdc/tombojava/cli/TombojavaCliRunner.java - CLI runner → PDF writer: writes PDF
src/main/java/it/sdc/tombojava/cli/TombojavaCliRunner.java - CLI runner → Verification report writer: writes report
src/main/java/it/sdc/tombojava/cli/TombojavaCliRunner.java