fix(services): Improve status code consistency

[vprashrex]

Issue

Closes #PLEASE_TYPE_ISSUE_NUMBER

Summary

• Before: Error handling was generic and lacked specific exceptions.
• Now: Implemented domain-specific exceptions for better granularity and traceability in error handling.
• Updated error logging to include exception details.
• Modified HTTP status codes in tests and service methods to conform to new conventions.

Checklist

Before submitting a pull request, please ensure that you mark these task.

• Ran fastapi run --reload app/main.py or docker compose up in the repository root and test.
• If you've fixed a bug or added code that is tested and has test cases.

Notes

Please add here if any other information is required for the reviewer.

Original PR description

• Updated error logging to include exception information for better traceability.
• Introduced ConflictError, UpstreamError, and ServiceUnavailableError for more granular HTTP status codes.
• Changed HTTP status codes in various tests and service methods to align with new error handling conventions.
• Added tests to ensure correct behavior when handling exceptions, including cases for missing resources, state conflicts, and upstream errors.
• Updated documentation to reflect changes in exception handling and status code mappings.

Issue

Closes #PLEASE_TYPE_ISSUE_NUMBER

Summary

Explain the motivation for making this change. What existing problem does the pull request solve?

Checklist

Before submitting a pull request, please ensure that you mark these task.

• Ran fastapi run --reload app/main.py or docker compose up in the repository root and test.
• If you've fixed a bug or added code that is tested and has test cases.

Notes

Please add here if any other information is required for the reviewer.

[coderabbitai]

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)

• ready-for-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: c814846b-775e-43a3-af77-3df9c7074a4c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

OpenAPI changes   ⚪ No API surface changes

Note

This PR does not modify the API contract.

_{main ↔ 31671016 · generated by oasdiff}

[codecov]

Codecov Report

❌ Patch coverage is 86.16601% with 35 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
backend/app/crud/config/version.py	11.11%	8 Missing ⚠️
backend/app/crud/config/config.py	12.50%	7 Missing ⚠️
backend/app/crud/credentials.py	58.33%	5 Missing ⚠️
backend/app/crud/evaluations/embeddings.py	50.00%	5 Missing ⚠️
backend/app/services/evaluations/fast.py	44.44%	5 Missing ⚠️
backend/app/core/exception_handlers.py	81.81%	2 Missing ⚠️
...ckend/app/api/routes/stt_evaluations/evaluation.py	0.00%	1 Missing ⚠️
backend/app/crud/evaluations/batch.py	93.75%	1 Missing ⚠️
backend/app/crud/evaluations/core.py	50.00%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!