UNOMI-887: Introduce consolidated build.sh; remove legacy build scripts (#737)

* UNOMI-887: Introduce consolidated build.sh; remove legacy build scripts
Add build.sh: unified build/deploy/run script with robust error handling, colorized/structured output, and preflight checks (tools, system resources, Maven settings, ports).
Support rich CLI options: tests/integration, OpenSearch, debug/ports/suspend, offline/cache control, migration-test skip, single-test, deploy to Karaf.
Replace legacy scripts: remove buildAndRun.sh, buildAndRunNoTests.sh, compileDeploy.sh, generate-package.sh.
Improve DX: clearer failures, consistent workflows across environments, NO_COLOR adherence, macOS/Linux friendly (incl. Apple Silicon hints).
Notes: deployment expects UNOMI_VERSION for KAR/package paths; optional Geo databases copied when present.
No code changes to modules; build behavior is unchanged unless new flags are used.

* Address PR review comments for build.sh script

- Fix color readability in build.sh examples section: replace GRAY with NC
  (no color) for better terminal readability. Use NC once at the start
  instead of wrapping each line with color codes.

- Add comprehensive documentation for build.sh script in Building section:
  * Add brief mention at the start of Building section with cross-reference
  * Add new "Using the build.sh script" subsection with:
    - Overview of script features and benefits
    - Step-by-step usage instructions
    - Complete set of examples matching build.sh --help output
    - All examples use plain commands without prompt markers

- Minor formatting: align help output option descriptions for consistency

The documentation examples now exactly match those displayed by build.sh --help,
ensuring consistency between the script and its documentation.

Author: sergehuber