Feature-Flag: org/project feature flags with DB

[vprashrex]

Summary

Target issue is #790
Explain the motivation for making this change. What existing problem does the pull request solve?

This PR introduces a persistent feature-flag system scoped by organization_id and optional project_id, and applies it to control access to Feature flagged APIs.

Previously, Assessment functionality was not centrally gated per tenant/project, so rollout control was limited and risky. This change solves that by adding:

1. A feature_flag model + migration + CRUD operations.
2. Admin APIs to create/update/delete/list flags (/feature-flags) and a resolved flags endpoint (/features).
3. A reusable require_feature(...) permission dependency that can be used at the top route level or at independent endpoints.
4. Assessment route protection behind FeatureFlag.ASSESSMENT.

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 disabled on base/target branches other than the default branch.

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: defaults

Review profile: CHILL

Plan: Pro

Run ID: 988b642a-7d12-4bcb-8d7e-239d61a64612

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/feature-flag

---

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 and usage tips.}