# Domain glossary (core concepts from Phase 1)

terms:
  Motion:
    short: "A parliamentary motion/decision"
    keys: [id, title, description, date, body_text, url]
  motie:
    short: "Dutch: motion (motie). Equivalent to Motion in code comments and UI."
  MP:
    short: "Member of Parliament (kamerlid)"
    keys: [mp_name, party, van, tot_en_met, persoon_id]
  mp_votes:
    short: "Raw voting rows: motion_id, mp_name, vote, date"
  mp_metadata:
    short: "Per-MP metadata table and fields"
  user_sessions:
    short: "Streamlit user quiz session state (session_id, user_votes, completed_motions...)"
  embeddings:
    short: "Raw text embeddings stored per motion (embeddings table)"
  svd_vectors:
    short: "SVD-derived vectors from the vote matrix (svd_vectors table)"
  fused_embeddings:
    short: "Concatenation of SVD and text embeddings (fused_embeddings table)"
  similarity_cache:
    short: "Precomputed nearest neighbors for each motion"
  window_id:
    short: "Processing window identifier used for SVD/fusion runs"
  controversy_score:
    short: "Numeric measure stored in motions table"
  winning_margin:
    short: "Numeric field indicating margin of win in a vote"
  Politiek_Kompas:
    short: "Political compass; also appears in UI features"
  MP_quiz:
    short: "Interactive quiz derived from motions and mp_votes"
notes:
  - Use these canonical terms in docs, tests, variable names and DB schemas.