How c-wilkinson/school-finder works
School Finder turns official English-school datasets into local Parquet data, then lets parents search by postcode, filter and rank schools, compare results, and save personal notes or shortlist decisions. The main runtime path is dataset build → reusable search services → CLI or Streamlit. The graph also includes historical data, benchmarks, subjects, school-detail presentation, and browser persistence. Source-adapter and some UI internals are represented at directory level where their implementation was not excerpted; edges reflect README statements or indexed references, not an inspection of unsampled code.
Main entry points: streamlit_app.py Streamlit app · search.py Search service · parquet.py Parquet datasets · build.py Dataset builder
Components 27
Data ingestion
- Dataset builder
src/school_finder/data/build.py - Source adapters
src/school_finder/data/sources - Parquet datasets
src/school_finder/data/parquet.py - Build manifest
src/school_finder/data/manifest.py - Historical data
src/school_finder/data/history.py
Search and scoring
- Search request
src/school_finder/models/search.py - Hard filters
src/school_finder/models/filters.py - Preference models
src/school_finder/models/preferences.py - School models
src/school_finder/models/school.py - Search service
src/school_finder/services/search.py - Postcode lookup
src/school_finder/services/postcode.py - Preference scoring
src/school_finder/services/scoring.py - Benchmarks
src/school_finder/services/benchmarks.py - Subject data
src/school_finder/services/subjects.py - History service
src/school_finder/services/history.py
User interfaces
- CLI
src/school_finder/cli.py - Streamlit app
src/school_finder/ui/streamlit_app.py - School details
src/school_finder/ui/detail.py - School comparison
src/school_finder/ui/comparison.py - Match display
src/school_finder/ui/match.py - Result formatting
src/school_finder/ui/formatting.py - Search controls
src/school_finder/ui/controls.py
Personalisation
- Session state
src/school_finder/ui/state.py - Personal school state
src/school_finder/models/personalisation.py - Browser persistence
src/school_finder/ui/personalisation_storage.py
Other components
- Public datasets
- Browser storage
Connections 35
- Public datasets → Source adapters: provides data
README.md - Dataset builder → Source adapters: loads sources
src/school_finder/data/build.py - Dataset builder → Parquet datasets: writes datasets
src/school_finder/data/build.py - Dataset builder → Build manifest: records build
src/school_finder/data/build.py - Dataset builder → Historical data: uses history
src/school_finder/data/build.py - Parquet datasets → Public datasets: stores locally
README.md - CLI → Dataset builder: runs build
src/school_finder/cli.py - CLI → Search service: runs lookup
src/school_finder/cli.py - Search request → Hard filters: defines filters
src/school_finder/models/search.py - Search request → Preference models: accepts priorities
src/school_finder/models/search.py - Search service → Parquet datasets: reads datasets
src/school_finder/services/search.py - Search service → Search request: accepts request
src/school_finder/services/search.py - Search service → Postcode lookup: resolves postcode
src/school_finder/services/search.py - Search service → Preference scoring: scores results
src/school_finder/services/search.py - Search service → Benchmarks: loads benchmarks
src/school_finder/services/search.py - Search service → School models: builds results
src/school_finder/services/search.py - Benchmarks → Parquet datasets: reads data
src/school_finder/services/benchmarks.py - History service → Historical data: reads history
src/school_finder/services/history.py - History service → Parquet datasets: reads datasets
src/school_finder/services/history.py - Subject data → Parquet datasets: reads datasets
src/school_finder/services/subjects.py - Streamlit app → Search service: runs search
src/school_finder/ui/streamlit_app.py - Streamlit app → History service: requests history
src/school_finder/ui/streamlit_app.py - Streamlit app → Subject data: requests subjects
src/school_finder/ui/streamlit_app.py - Streamlit app → Search controls: renders controls
src/school_finder/ui/streamlit_app.py - Streamlit app → School details: renders details
src/school_finder/ui/streamlit_app.py - Streamlit app → School comparison: renders comparison
src/school_finder/ui/streamlit_app.py - Streamlit app → Match display: renders matches
src/school_finder/ui/streamlit_app.py - School details → Result formatting: uses formatting
src/school_finder/ui/detail.py - School comparison → Result formatting: uses formatting
src/school_finder/ui/comparison.py - Match display → Result formatting: uses formatting
src/school_finder/ui/match.py - Streamlit app → Session state: manages state
src/school_finder/ui/streamlit_app.py - Session state → Personal school state: stores preferences
src/school_finder/ui/state.py - Streamlit app → Browser persistence: syncs personalisation
src/school_finder/ui/streamlit_app.py - Browser persistence → Personal school state: encodes state
src/school_finder/ui/personalisation_storage.py - Browser persistence → Browser storage: persists locally
README.md