docs(#1163): add backend README with setup instructions

[Abradat]

Description

This pull request adds a new README.md file to the backend directory, providing clear instructions for setting up, configuring, and running the backend service with both Oracle and PostgreSQL databases. The documentation covers prerequisites, environment variables, database configuration, Flyway migrations, and testing procedures.

Documentation improvements:

• Added a comprehensive backend/README.md with setup instructions, environment variable guidance, database configuration details, Flyway migration information, and testing commands for Oracle and PostgreSQL.

Documents #1163

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update
• Documentation update

How Has This Been Tested?

• New unit tests
• New integrated tests
• New component tests
• New end-to-end tests
• New user flow tests
• No new tests are required
• Manual tests (description below)
• Updated existing tests

Checklist

• I have read the CONTRIBUTING doc
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have already been accepted and merged

Further comments

---

Thanks for the PR!

Deployments, as required, will be available below:

• Backend
• Frontend

Please create PRs in draft mode. Mark as ready to enable:

• Analysis Workflow

After merge, new images are deployed in:

• Merge Workflow

[Copilot]

Pull request overview

Adds initial backend-specific documentation to help developers configure and run the Spring Boot service against Oracle and/or PostgreSQL, including Flyway and test commands.

Changes:

• Introduces backend/README.md with prerequisites and run instructions.
• Documents PRIMARY_DB / FLYWAY_ENVIRONMENT usage and Flyway migration locations.
• Adds Maven commands for running backend tests under Oracle vs PostgreSQL modes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[craigyu]

good guide, should we mention how to populate the local postgres db using the tools under ora2pg/tools?

[Abradat]

@craigyu Do you think it's better to provide instructions to load the data from ora2pg/tools or to add a reference to the folder, as it has its own documentation?

[craigyu]

👍