Scala Java API Backend Service

This project involves building a modular backend service written in a mix of Scala and Java. Its sole purpose is to expose a clean, well-documented REST/JSON API layer that plugs into an existing SQL database.

Key points you should know:
• Language stack: business logic may be shared between Scala (preferred for the new modules) and existing Java components, so the codebase must compile seamlessly with sbt/Maven and run on the latest OpenJDK.
• Database: the service talks exclusively to a SQL engine (PostgreSQL in staging, MySQL in legacy environments). Expect schema versioning through Flyway and data access via Slick or standard JPA/Hibernate—whichever is lighter for the task.
• Requirements: endpoints must follow REST conventions, include Swagger/OpenAPI docs, handle pagination, validation, logging, and return proper HTTP status codes.
• Non-functional: unit and integration tests in ScalaTest/JUnit, Dockerised build, and CI‐ready scripts are all part of the definition of done.

Deliverables
1. Complete source code with clear package structure
2. Database schema files and migration scripts
3. Postman (or similar) collection plus OpenAPI spec
4. Dockerfile & README showing local run, test, and production build commands

Acceptance criteria
– All endpoints compile and pass tests in CI
– API responds within 200 ms for typical queries against a sample dataset
– No SQL injection or unchecked input reaches the database (static analysis will be run)

Once these items are merged into our Git repository and pass review, the engagement is considered complete.