RDM - District Radar Monitor

A lightweight platform that tracks district news and leader bio pages.

What it does

1. Pulls district news from RSS/Atom feeds (Google-Alert-style daily monitoring).
2. Flags likely initiative updates using keyword signals (launches, pilots, grants, etc.).
3. Crawls district leader profile pages and detects:
   • Work-history/professional bio details.
   • Personal-interest details (hobbies, family, volunteer interests, etc.).
4. Exposes API endpoints to generate a daily digest and list leaders with both work and personal-interest bios.

Quick start

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn src.main:app --reload

API

POST /digest

Returns a combined daily digest.

Example request body:

{
  "districts": [
    {
      "district_name": "Sample Unified School District",
      "news_sources": [
        "https://example.org/district-news/rss.xml"
      ],
      "leaders": [
        {
          "name": "Dr. Jordan Smith",
          "profile_url": "https://example.org/about/superintendent"
        }
      ]
    }
  ]
}

POST /leaders/with-bios

Returns only leaders where both a work-oriented bio and personal interests were detected on their profile page.

GET /health

Simple readiness endpoint.

Notes

• This version uses keyword heuristics; you can swap in LLM/NER classification later.
• For production daily schedules, pair this API with a cron job, GitHub Actions, or a task queue.