How rayssaareis/bureaucracy-translator works
Bureaucracy Translator accepts pasted text or a document image, validates the request, and returns a plain-language explanation with next steps in the selected language. The frontend validates and submits input; the backend routes text directly to Gemini or extracts image text through OCR.space before using the same Gemini flow. The map also includes response/error handling and the documented frontend capabilities. Source excerpts show the main calls; some frontend features and static serving are documented in the README rather than inspected in source.
Main entry points: app.js Input and results UI · TranslateService.java Translation workflow · GlobalExceptionHandler.java Global error mapping · GeminiClient.java Gemini client
Components 19
Static frontend
- Input and results UI
src/main/resources/static/js/app.js - Input validation
src/main/resources/static/js/validation.js - API client
src/main/resources/static/js/api.js - UI configuration
src/main/resources/static/js/config.js
Request handling
- Translate endpoint
src/main/java/com/bureaucracytranslator/controller/TranslateController.java
Document processing
- Translation workflow
src/main/java/com/bureaucracytranslator/service/TranslateService.java - OCR.space client
src/main/java/com/bureaucracytranslator/client/OcrSpaceClient.java - OCR settings
src/main/java/com/bureaucracytranslator/config/OcrSpaceProperties.java - Gemini client
src/main/java/com/bureaucracytranslator/client/GeminiClient.java - Gemini settings
src/main/java/com/bureaucracytranslator/config/GeminiProperties.java - Structured translation
src/main/java/com/bureaucracytranslator/dto/TranslateResponse.java
Response handling
- Global error mapping
src/main/java/com/bureaucracytranslator/exception/GlobalExceptionHandler.java - Error response
src/main/java/com/bureaucracytranslator/dto/ErrorResponse.java - Request validation error
src/main/java/com/bureaucracytranslator/exception/InvalidRequestException.java - OCR service error
src/main/java/com/bureaucracytranslator/exception/OcrServiceException.java - Gemini service error
src/main/java/com/bureaucracytranslator/exception/GeminiServiceException.java
Other components
- User
- OCR.space
- Gemini API
Connections 22
- User → Input and results UI: enters or uploads
README.md - Input and results UI → Input validation: validates input
src/main/resources/static/js/app.js - Input and results UI → API client: submits translation
src/main/resources/static/js/app.js - Input and results UI → UI configuration: reads settings
src/main/resources/static/js/app.js - API client → UI configuration: reads API URL
src/main/resources/static/js/api.js - API client → Translate endpoint: POSTs request
README.md - Translate endpoint → Translation workflow: routes text or image
src/main/java/com/bureaucracytranslator/controller/TranslateController.java - Translation workflow → OCR.space client: extracts image text
src/main/java/com/bureaucracytranslator/service/TranslateService.java - OCR.space client → OCR.space: sends image
README.md - OCR.space client → OCR settings: reads credentials
src/main/java/com/bureaucracytranslator/client/OcrSpaceClient.java - Translation workflow → Gemini client: requests explanation
src/main/java/com/bureaucracytranslator/service/TranslateService.java - Gemini client → Gemini API: generates explanation
README.md - Gemini client → Gemini settings: reads model and key
src/main/java/com/bureaucracytranslator/client/GeminiClient.java - Gemini client → Structured translation: parses structured output
src/main/java/com/bureaucracytranslator/client/GeminiClient.java - Input and results UI → Structured translation: displays result
README.md - Translate endpoint → Request validation error: rejects invalid requests
src/main/java/com/bureaucracytranslator/controller/TranslateController.java - Global error mapping → Error response: builds error body
src/main/java/com/bureaucracytranslator/exception/GlobalExceptionHandler.java - Global error mapping → Request validation error: maps request errors
src/main/java/com/bureaucracytranslator/exception/GlobalExceptionHandler.java - Global error mapping → OCR service error: maps OCR errors
src/main/java/com/bureaucracytranslator/exception/GlobalExceptionHandler.java - Global error mapping → Gemini service error: maps Gemini errors
src/main/java/com/bureaucracytranslator/exception/GlobalExceptionHandler.java - Translation workflow → Gemini service error: raises on invalid output
src/main/java/com/bureaucracytranslator/service/TranslateService.java - Translation workflow → Request validation error: rejects unusable OCR text
src/main/java/com/bureaucracytranslator/service/TranslateService.java