Yarab almamari submission branch

[JuniorPrice]

OracleQuant ERP - Package Measurement Conversion API Implementation

Summary

Implementation of the Package Measurement Conversion REST API using Java 17, Spring Boot 3.5.14, JPA, and Oracle XE.

Features

• Conversion Endpoint: GET /convert-measurements?input={string} — parses encoded measurement strings and returns package totals in JSON
• History CRUD: Full REST endpoints for conversion history (GET all, GET by id, PUT update, DELETE all, DELETE by id)
• Oracle XE Persistence: History records stored in Oracle XE database via JPA/Hibernate (falls back to H2 for dev)

Conversion Algorithm

• Supports encoding: a=1 through z=26, _=0
• Multi-character numbers via z chaining (e.g., zza = 26+26+1 = 53)
• Package grouping: first number = count of values, then sum of that many values

Non-Functional

• Logging with rolling file appender (7-day retention)
• Input validation with 400 Bad Request on invalid input
• Unit tests covering all 8 spec examples
• README with build, config, API docs, and Oracle Linux deployment instructions
• CHANGELOG tracking all versions

How to Build & Run

./mvnw clean package
java -jar target/oraclequantapi-0.0.1-SNAPSHOT.jar

See README.md for full details.