Welcome! You are at the root of the Nava Labs Decision Support Tool pilot repo.
To set up your local development environment, follow the instructions in Getting Started.
The application supports loading Guru cards from .json files.
To load a JSON file containing Guru cards in your local environment, from within /app
:
make ingest-guru-cards DATASET_ID=dataset_identifier BENEFIT_PROGRAM=SNAP BENEFIT_REGION=Michigan FILEPATH=path/to/some_cards.json
- The same
DATASET_ID
identifier can be used for multiple documents (FILEPATH
) to represent that the documents belong in the same dataset. - Example
BENEFIT_PROGRAM
values includehousing
,utilities
,food
,medical
,employment
,SNAP
,Medicaid
, etc. BENEFIT_REGION
can correspond to a town, city, state, country, or any geographic area.
The Docker container mounts the /app
folder, so FILEPATH should be relative to /app
. /app/documents
is ignored by git, so is a good place for files you want to load but not commit.
The deployed application includes an S3 bucket, following the format s3://decision-support-tool-app-<env>
, e.g., s3://decision-support-tool-app-dev
.
After authenticating with AWS, from the root of this repo run:
aws s3 cp path/to/some_cards.json s3://decision-support-tool-app-dev/
./bin/run-command app <ENVIRONMENT> '["ingest-guru-cards", "dataset_identifier", "SNAP", "Michigan", "s3://decision-support-tool-app-dev/some_cards.json"]'
Replace <ENVIRONMENT>
with your environment, e.g., dev
.
Note the arguments "dataset_identifier", "SNAP", "Michigan", "s3://decision-support-tool-app-dev/some_cards.json"
are in the same order as described above for ingest-guru-cards
, i.e., DATASET_ID BENEFIT_PROGRAM BENEFIT_REGION FILEPATH
.