feat: add scout flow

[loulounassih-prog]

Team Submission

App name: Scout Flow
Team name: Scout Flow Team
Folder: loulounassih-scout-flow/

Checklist

• My app folder is at the repository root
• app.json is present and valid
• [] app.json slug matches the folder name
• .env.example lists all required environment variables
• README.md explains what the app does and how to run it
• At least one preview image exists in assets/
• No real secrets or API keys are committed
• I have not modified files outside my team's folder
• I have not modified any root-level or platform files

What does this app do?

Scout Flow is a recruitment and sourcing app that helps build a shortlist of candidates for a target job. It combines candidates discovered from public sources with candidates already stored in HrFlow.ai Sources, then runs parsing, indexing, scoring, and ranking workflows to surface the most relevant profiles.

How to run

1. Copy .env.example to .env and fill in the required HrFlow.ai credentials and keys.
2. Install the project dependencies.
3. Run the backend scoring pipeline and, if needed, the frontend app for visualization.

Example:

pip install -r requirements.txt
pip install -r frontend/requirements.txt
python backend/scripts/run_scraping_pipeline.py
python backend/ranking/scoring.py
cd frontend
python manage.py runserver

## HrFlow.ai APIs used

- `POST /v1/text/parsing` — parses raw candidate text into structured profile data
- `POST /v1/profile/indexing` — indexes parsed candidates into an HrFlow.ai Source
- `GET /v1/profiles/searching` — retrieves and inspects profiles stored in HrFlow.ai Sources
- `GET /v1/profiles/scoring` — scores indexed profiles against a target job
- `GET /v1/profile/grading` — provides a more detailed evaluation for selected profiles
- `GET /v1/profile/upskilling` — returns recommendation and explanation details for top candidates

[mnouayti]

please fix the validation checks:
--- Validating: loulounassih-scout-flow ---
FAIL: No preview image found in assets/. Expected one of: .png, .jpg, .jpeg, .gif, .svg, .webp
FAIL: Possible secret detected in loulounassih-scout-flow/frontend/hrflow_ui/settings.py: "SECRET_KEY =..."

[mnouayti]

You still have a hardcoded secret key in your folder:
--- Validating: loulounassih-scout-flow ---
FAIL: Possible secret detected in loulounassih-scout-flow/frontend/hrflow_ui/settings.py: "SECRET_KEY =..."