run.txt

GIT READY RUN GUIDE
Project Folder: Job_Finder_git

Quick Start (Local Python)
1. Open terminal in repository root.
2. Run:
   powershell -ExecutionPolicy Bypass -File .\scripts\setup_local.ps1
3. Start app:
   powershell -ExecutionPolicy Bypass -File .\scripts\start_local.ps1
4. Open dashboard:
   http://127.0.0.1:5050/
5. Discord bot health:
   http://127.0.0.1:5051/health

Quick Start (Docker)
1. Copy env file if missing:
   Copy-Item .env.example .env
2. Start containers:
   powershell -ExecutionPolicy Bypass -File .\scripts\start_docker.ps1
3. Open dashboard:
   http://127.0.0.1:5050/
4. Discord bot health:
   http://127.0.0.1:5051/health

What to configure in .env after clone
- DATABASE_URL (for local Python mode)
- TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID
- TELEGRAM_NOTIFY_ALL_JOBS=true, TELEGRAM_ALERT_MAX_PER_RUN=20
- EMAIL_PROVIDER=outlook_graph
- OUTLOOK_CLIENT_ID, OUTLOOK_TENANT, OUTLOOK_GRAPH_SCOPES, EMAIL_TO
  (Use Graph scopes like Mail.Send,User.Read; do not include reserved scopes such as offline_access)
- EMAIL_NOTIFY_ALL_JOBS=true, EMAIL_ALERT_MAX_PER_RUN=50
- DISCORD_BOT_TOKEN, DISCORD_ALERT_CHANNEL_ID
- Optional: DISCORD_ADMIN_ROLE_ID, DISCORD_COMMAND_GUILD_ID, DISCORD_ALERT_MAX_PER_RUN

Discord command control (after restart)
- /job_help
- /job_run
- /job_status
- /job_settings
- /job_set key value
- /job_add key value
- /job_remove key value
Note: for list settings (roles, locations, skills, scan_times, excluded_companies), pass comma-separated values.

Outlook OAuth one-time setup
1. Ensure OUTLOOK_CLIENT_ID is set in .env
2. Run:
   $env:PYTHONPATH='.'
   .\.venv\Scripts\python scripts\setup_outlook_graph_auth.py
3. Test:
   $env:PYTHONPATH='.'
   .\.venv\Scripts\python scripts\test_email.py --subject "Email connected" --message "Outlook Graph is working"

Useful URLs
- Health: http://127.0.0.1:5050/api/health
- Jobs: http://127.0.0.1:5050/api/jobs?min_score=70
- Analytics: http://127.0.0.1:5050/api/analytics
- Scheduler: http://127.0.0.1:5050/api/scheduler/next-runs
- Excel export: http://127.0.0.1:5050/api/jobs/export/excel?min_score=70&limit=2000

PUBLIC URL DEPLOYMENT (GITHUB ACTIONS + RENDER)
1. In Render, create Blueprint deploy from this repo (render.yaml included).
2. In Render service, copy:
   - Deploy Hook URL
   - Public URL (example: https://job-alert-app.onrender.com)
3. In GitHub repo -> Settings -> Secrets and variables -> Actions, create:
   - RENDER_DEPLOY_HOOK_URL = <deploy hook url>
   - RENDER_PUBLIC_URL = <public app url>  (optional but recommended)
4. In Render service -> Environment, set:
   - TELEGRAM_BOT_TOKEN
   - TELEGRAM_CHAT_ID
   - EMAIL_TO
   - EMAIL_USERNAME
   - EMAIL_PASSWORD
   - EMAIL_FROM
   - OUTLOOK_CLIENT_ID
5. Push to main branch.
6. Workflow "Deploy Render" will trigger and deploy automatically.
7. Open UI at:
   https://<your-render-app>.onrender.com/
8. API health:
   https://<your-render-app>.onrender.com/api/health

Notes
- Do NOT commit .env or token cache files.
- Render does not read your local .env; configure secrets in Render Environment.
- If an endpoint returns Not Found, restart the server from this repository folder.