This is a project for the Center for Medicaid and CHIP Services (CMCS) to meet needs of CMCS and State staff researching regulations and related guidance, building on the eRegulations open source project.
We have public documentation about our product, design, and research processes in this repository wiki.
- Docker
- Docker Compose
- go version 1.16
- git
- node >= v15 (We suggest using nvm)
git clone https://github.com/cmsgov/cmcs-eregulations
A lot of tasks for local development can be accessed through the Makefile.
Running make
will provide some information about the available tasks.
For example:
make local
Will start a local docker environment and load parts of Title 42 into it.
Proceed to http://localhost:8000 in your browser to see the results.
make local.createadmin
will create an admin superuser for the admin portion of the site.
Proceed to http://localhost:8000/admin to access the admin portion and login with the credentials you created in the previous step
make local.seed
will load data from the fixtures folder setting up a usable amount of data for local use.
This data is not maintained and should not be relied on for any purpose other than development.
make local.stop
will cause the running docker processes to stop without losing data.
make local.clean
will remove the local environment completely, useful when you want to start fresh.
Before running the tests for the first time, you may need to install cypress dependencies.
cd e2e
npm install
Running make test
after make local
will run the cypress suite of end to end tests.
- Navigate to project root
- If project is not already running locally, run
make local
make test
make watch
: scss and js files can be watched an automatically compiled
Every type of model has an "Export to JSON" button that will export the data to a JSON format that can be easily imported
by saving the file to the fixtures folder and importing it with the built in loaddata
command from Django.