Local installation

Use this process only in a trusted local or internal environment. It is not a public-production deployment recipe.

Install runtime dependencies

Install Tesseract 5.x and its Vietnamese and English language data using your operating system's package manager. Then ensure the project working directory has the data expected by the OCR service:

tessdata/vie.traineddata
tessdata/eng.traineddata

The application code creates Tesseract with tessdata as its relative data path and selects the vie language.

Start locally

From the repository root, with Java 25 active:

./mvnw spring-boot:run

Before sending an image, verify that its printed geometry matches the fixed sheet layout. Then use the two required multipart fields described by the grade endpoint.

Verify the implementation

The repository's tests exercise the bundled images and use a test-only OCR double. Run them with:

JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64 ./mvnw test

Passing tests do not establish OCR accuracy, safety for untrusted uploads, public availability, or suitability for other form designs.