Skip to content
This repository has been archived by the owner on Nov 3, 2020. It is now read-only.

votingworks/election-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Election Manager

This app is intended to be used on an offline computer by an election admin.

Features

  • manage election configuration
  • create hand-marked paper ballots
  • export an "election ballot package" for Mail Ballot Manager

Workflow

  1. Admin may create a new election or select an existing election configuration file (election.json) to start with (or possibly a previously created election ballot package).

  2. Admin can edit the election configuration via simple UI forms at any time.

  3. Admin can list all ballots by precinct/style.

  4. Admin can view an individual ballot, both HTML and PDF versions.

  5. Admin can export an election ballot package for Mail Ballot Manager.

    Election Ballot Package contains:

    • election.json - VotingWorks data format for election data: contests, canidates,ballot styles, precincts, etc.
    • approved official ballots in pdf format:
      • one for each combination of ballot style and precinct
      • file name pattern: election-${electionId}-precinct-${dashify(precinctName)}-id-${precinctId}-style-${ballotStyleId}.pdf

App Screens

  • Unconfigured App Screen
    • Select election config file
    • Convert from local election files
    • Button to create new election
  • Edit Election Definition
    • basic fields
    • parties (starting with some defaults)
    • districts
    • precincts
    • ballot styles and mappings to precincts and districts
    • contests
      • select district
      • candidate contest
      • measure contest
  • List Ballot Styles
    • Rows:
      • precinct
      • style
      • contest count
      • view ballot link
    • Sort:
      • precinct
      • style
    • Export Election Ballot Package for Mail Ballot Manager
    • View Ballot
      • html ballot in print-ready format (via PagedJS)
      • PDF ballot (in iframe under html ballot or click to open in new window)
      • Previous and Next Ballot Style links
      • Proof all Ballot Style content (from EMS)
    • Export Election Ballot Package screen
      • Mock export UI
      • Hook up to API in kiosk browser
  • Print Test Ballot Deck Results (from EMS)
  • Program Cards (Revert from commit "Remove Smartcard Programming" when ready)
    • Admin
    • Poll Worker
  • Results
    • Load CVR files (from EMS)
    • View results (from EMS)
  • Unconfigure
  • Eject USB (from EMS)

Navigation

Main Nav:

  • Definition
  • Ballots
  • Cards
  • Tally

User Nav

  • Eject USB

Future Features

  • Election Editor with sections to edit, metadata, parties, contests, ballot styles, etc.
    • Edit Contest section
      • List Contests screen
      • Edit Contest Screen with live preview
  • "Export config" button on Config screen

About

Manages election configuration, ballot creation, and more.

Resources

License

Stars

Watchers

Forks

Packages

No packages published