This project aims to create a user-friendly, modern product to streamline the creation, submission, review, and approval of Medicaid APDs and their associated contract documents. It is currently limited to HITECH but may potentially be expanded to other Medicaid programs in the future.
Please note: Any content contained in screenshots from the application within
the eAPD
repo should be considered test data being used for development
purposes ONLY. Project, financial, and timeline information is NOT
representative of any production data from actual users.
First you'll need to get the code onto your computer. The easiest way is to clone it with git. If you're not familiar with git, a tool like Github Desktop or SourceTree can help make the experience easier.
Most people will use the HTTPS link, but if you're a project contributor and you have your SSH keys configured, you'll clone from the SSH link. You can find the link by clicking the green "Clone or download" button above the file listing on this page.
The HTTPS link is https://github.com/Enterprise-CMCS/eAPD.git
If you're familiar with git and just want to work from the command line, you just need to run:
git clone https://github.com/Enterprise-CMCS/eAPD.git
If you can't use git for some reason, you can also download the most recent code as a ZIP file.
The app uses Okta for authentication. If you do not have an Okta application already set up, you can create an Okta account and Okta application following these instructions. Set the following environment variables:
export OKTA_DOMAIN= #from admin, or Applications -> (your application) -> General
export OKTA_SERVER_ID= #from admin, API -> Authorization Server, and the value under Name
export OKTA_CLIENT_ID= #from admin, or Applications -> (your application) -> General
export OKTA_API_KEY= #from admin, API -> Tokens -> Create Token, and the Token Value
export OKTA_AUDIENCE= #from admin, API Audience
export JWT_SECRET=# any string is fine here. It does affect your security posture, but for local development it doesn't matter.
export MONGO_ADMIN_URL="mongodb://admin-user:admin-password@mongo:27017/admin" #This is only a local value. It will be different in production
export MONGO_URL="mongodb://mongo:cms@mongo:27017/eapd?authSource=admin" #This is only a local value. It will be different in production
export MONGO_DATABASE="eapd" #This is only a local value. It will be different in production
Create accounts in your Okta application with the following User Names (these accounts will be used for testing, so they cannot require MFA):
[email protected]
reviewer
fedadmin
stateadmin
statestaff
statecontractor
Make sure you record the passwords that you set them to. You can use fake emails
or if you have a gmail account, you can add +reviewer
to your email username
(e.g. [email protected]) to have them all email to your email.
We recommend using Docker to run the app locally. We provide a Docker configuration that will quickly install and build everything you need, so don't have to. It'll also take care of getting everything running and connected. For more details, see our wiki. If you don't have or can't use Docker, you can also run everything manually.
From your command line, switch to the directory where you put the code and then
run docker-compose up
. This step could take a few minutes. Once it's finished,
you can populate the database. While the docker process is still running, open a
new terminal window or tab and run:
docker-compose exec api yarn run migrate
docker-compose exec api yarn run seed
You should now be able to open the app at
http://localhost:8080. You can login with any of the
accounts that you made above. The [email protected]
account has the role of state
admin. The rest have roles that match their usernames. This is handled in the
seed and does not need to be set in Okta.
See the testing documentation for information about running tests.
Configure gitleaks pre-commit hook by running pre-commit install
in your
local. This will guard secrets from acccidentally being commited to this
repository. Please take a look at
gitleaks for installation instruction
and for more information.
Check out the developer documentation for a deeper dive into how the app works.
Check out our troubleshooting guide if you run into any difficulties.
We would be happy to receive pull requests to fix bugs or make improvements,
though we can't make any promises about having time to review or accept them.
Pull requests should be made into the master
branch. Be sure to check out our
contributing guide for info about our policies.
This project is in the worldwide public domain. As stated in CONTRIBUTING:
This project is in the public domain within the United States. Copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.
All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.