Skip to content

rgunpal/ABC-backend

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Change Log

Version 3.3.1

  • setElectionDefinition can now be a single JSON upload
  • setElectionVoters can now be a single csv upload
  • Admin "set" methods now validate files; * validation fails, the set call returns failure synchronously * if validation passes, the set method executes
  • EDF can only be set once successfully per election
  • Ballots can only be set once successfully per election

Version 3.3.0

  • Adds setElectionDefinition to set EDF per previous zip file upload
  • Adds setElectionBallots to set ballot PDFs per previous zip file upload
  • Adds setElectionVoters to load voters DB per previous zip file upload
  • Add sample files for admin upload at examples/text_fixtures

Version 3.1.2

  • Add app new endpoints: getCurrentElection
  • Note: getCurrentElection replaces previous getElection
  • Add private endpoints: setCurrentElection
  • Adds private endpoints openElectionTest,closeElectionTest,openElection,closeElection
  • Adds private endpoints: provisionUpload, getElectionDefinitionStatus
  • Voter table support for multipler voter sets (per election, LAT mode)
  • Voter record returned to app filterd to consumer fields, null values now returned
  • User-Agent: test now triggers "lat" mode election/voter queries

Version 3.0.1

  • Updates election default configuration
  • Adds getElectionDefinition
  • Updates DLN, StateID, and SSN4 lookups to use truncated SHA3 256 hash
  • Look up API Key authorization by SHA3 256 hash

Version 1.4.0

  • Add new endpoint: getTestPrintPage
  • Change lookupVoterByAddress endpoint (remove: city,state, streetAddress add: streetNumber)
  • Add new db columns: streetNumber [as string], dateOfBirth [as date string]
  • Allow stateID and DLN to be case insensitive

Version 1.3.0

  • yearOfBirth added to voter specfication; returned in queries
  • Test data update SSN removed; DL and IDN entries updated
  • No current election typo error fixed
  • VIDN replaces IDNumber in lookupVoterEmail
  • "0" attribute values are now preserved in voter data model
  • Updates Affidavit file

Version 1.2.1

  • yearOfBirth replaces dateOfBirth in all lookup queries
  • full SSN based lookup is deprecated. Only SSN4 is supported
  • 404 error for wrong API endpoint
  • 400 errors for: no election, voter not found, missing required param
  • new endpoint /getVoterEmail using VIDN as input
  • DLN data is 6 character length
  • getConfigurations updated with 6 character length for DLN, and 6 character length example DLN

Build Environment

export AWS_PROFILE=abcbackenddeploy

aws s3 mb s3://abc-backend-deploy-development

sam validate

sam build

sam package --output-template-file packaged.yaml --s3-bucket abc-backend-deploy-development

sam deploy --template-file packaged.yaml --capabilities CAPABILITY_IAM --stack-name ABCBackendDevelopment2 --parameter-overrides environment=development

Versioned deploy

aws s3 mb s3://abc-backend-deploy-development-v{majorVersion}-{minorVersion}-{patch}

sam validate sam build sam package --output-template-file packaged.yaml --s3-bucket abc-backend-deploy-development-v{majorVersion}-{minorVersion}-{patch} sam deploy --template-file packaged.yaml --capabilities CAPABILITY_IAM --stack-name ABCBackendDevelopment2-v{majorVersion}-{minorVersion}-{patch} --parameter-overrides environment=development-v{majorVersion}-{minorVersion}-{patch}

non-persistant dynamodb

docker run -p 8000:8000 amazon/dynamodb-local

Seeding data:

sh db-init.sh

Definitions and data in db-json/

aws dynamodb scan --table-name abc_voters_local --endpoint-url http://localhost:8000

http://localhost:8000

Persistant dynamodb data population

Seeding data:

sh dev-db-init.sh

S3 bucket document population

aws s3 sync ./docs s3://abc-documents-development

aws s3 sync ./docs s3://abc-documents-development-v{majorVersion}-{minorVersion}-{patch}

API

localhost

sam local start-api --env-vars local-env-windows.json sam local start-api --env-vars local-env-osx.json sam local start-api --env-vars local-env-linux.json

sam build AuthorizationFunction &&
sam local invoke "AuthorizationFunction" -e test-events/api-request-for-login.json

curl http://127.0.0.1:3000/getCurrentElection

curl -H "Content-Type: application/json" --request POST --data '{"IDnumber":"emptyresponse", "firstName":"Rowan", "lastName": "Quinn", "dateOfBirth":"2000-04-01"}' http://localhost:3000/lookupVoterByIDnumber

curl --header "Content-Type: application/json" --request POST --data '{"IDnumber":"12-34-56-79", "firstName":"Rowan", "lastName": "Quinn", "dateOfBirth":"2000-04-01"}' http://localhost:3000/lookupVoterByIDnumber

curl --header "Content-Type: application/json" --request POST --data '{"IDnumber":"C46253", "firstName":"Blake", "lastName": "Emerson", "dateOfBirth":"2000-04-01"}' http://localhost:3000/lookupVoterByIDnumber

API Gateway

V3.3.1 Dev URLs

Base URL: https://hrg7kjw4c3.execute-api.us-east-1.amazonaws.com/development-v3-3-1

V3.3.0 Dev URLs:

Base URL: https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/

Previous version V3.01:

Base URL: https:// tvghm1ioy6.execute-api.us-east-1.amazonaws.com/development-v3-0-1/

//getCurrentElection curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/getCurrentElection

//getConfigurations curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/getConfigurations

//getElectionDefinition curl -H "Cache-Control: no-cache" -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request GET https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/getElectionDefinition

//getAffidavitTemplate curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/getAffidavitTemplate

//Easter eggs

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"IDnumber":"emptyresponse", "firstName":"Rowan", "lastName": "Quinn", "yearOfBirth":"2000"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/lookupVoterByIDnumber curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"IDnumber":"wrongresponse", "firstName":"Rowan", "lastName": "Quinn", "yearOfBirth":"2000"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/lookupVoterByIDnumber curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"IDnumber":"noresponse", "firstName":"Rowan", "lastName": "Quinn", "yearOfBirth":"2000"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/lookupVoterByIDnumber

// DLN lookup

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"IDnumberHashTruncated":"1F15CC9BB9E521DE14600E02E001F375", "firstName":"Qiu", "lastName": "Xun", "yearOfBirth":"2000"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/lookupVoterByIDnumber

// State ID lookup

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"IDnumberHashTruncated":"16333B5622E9528036778FED1165B199", "firstName":"Rowan", "lastName": "Quinn", "yearOfBirth":"2000"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/lookupVoterByIDnumber

// SSN4 lookup

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"SSN4HashTruncated":"95439DD70D46C990F352206BFC1E0CA7", "firstName":"Rowan", "lastName": "Quinn", "yearOfBirth":"2000"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/lookupVoterBySSN4

// Address lookup

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"firstName": "Rowan","lastName": "Quinn","yearOfBirth": "2000","streetNumber": "3","ZIP5": "77707"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/lookupVoterByAddress

// Post Begin

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"VIDN":"P01234567890"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/postBegin

// Post Incomplete

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"VIDN":"P01234567890"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/postIncomplete

// Post Complete

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"VIDN":"P01234567890"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/postComplete

//Get Incremented Incomplete count/timestamp

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"SSN4":"1236", "firstName":"Rowan", "lastName": "Quinn", "yearOfBirth":"2000"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/lookupVoterBySSN4

//Blank Ballot

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"VIDN":"P01234567890"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/getBlankBallot

//Lookup Voter Email

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"VIDN":"A00000000006"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/lookupVoterEmail

curl -H "Authorization: Bearer [Appropriate API KEY HERE]" -H "Content-Type: application/json" --request POST --data '{"IDnumber":"noresponse", "firstName":"Rowan", "lastName": "Quinn", "yearOfBirth":"2000"}' https://3u9zs7ro0h.execute-api.us-east-1.amazonaws.com/development-v3-3-0/lookupVoterByIDnumber

Packages

No packages published

Languages

  • JavaScript 63.1%
  • TypeScript 30.9%
  • Shell 3.4%
  • HTML 2.5%
  • CSS 0.1%