Prerequisites
Required tools
The Maven project declares or uses these local prerequisites:
| Tool or data | Version or location | Why it is needed |
|---|---|---|
| JDK | 25 | The Maven compiler property is 25. |
| Maven | Wrapper downloads 3.9.14 | Builds, tests, and starts Spring Boot. |
| Tesseract | 5.x | Production OCR service. |
tessdata | Repository-relative directory | Tesseract language data path. |
| Vietnamese trained data | vie.traineddata | Selected by the production OCR service. |
JavaCV/OpenCV, Tess4J, OpenCSV, Spring Web, and the test libraries are resolved from Maven dependencies in pom.xml.
Test data
The repository includes five JPEG answer-sheet fixtures in data/: test_1.jpeg through test_5.jpeg. The tests cover flat scans and phone photos, including a double-marked AC answer. These fixtures are evidence for the current test behavior, not a production accuracy guarantee.
Environment boundary
The source does not establish supported operating systems beyond the Ubuntu/Debian Tesseract commands in the README. It also does not establish a supported container image, cloud runtime, reverse proxy, authentication provider, or external OCR service.