CWMS Batch Events provides users an API and user interface to execute water management jobs on a manual or event-driven basis.
To get your local environment setup and/or make contributions please see the contributions documentation: CONTRIBUTING.md
| page | url |
|---|---|
| ElasticMQ Web Interface | http://localhost:9325 |
| Minio Web Interface | http://localhost:9001 |
| Web Dev Server | http://localhost:5173 |
| Swagger Docs | http://localhost:8000/docs |
| Redoc | http://localhost:8000/redoc |
For the best experience, pyenv is recommended for install instructions. If pyenv is available, the setup-pyenv.sh script is provided to create a virtual environment and install the necessary local dev requirements. Be sure to install gcc for your environment.
By default, the local instance of the API uses a mock user account. This account has script-execute permissions for all districts. As a result, the API will return scripts for all offices that contain a corresponding script catalog within the minio instance.
The API will reference district script docker images that exist locally by the name [office-code]-jobs, e.g. lrh-jobs. These can be created by cloning the corresponding district jobs repo, e.g. lrh-wm-cwbi-jobs, and building the images from the local dockerfile with docker build . -t [office-code]-jobs.
Add the office code and repo path for any locally-available district job containers to scripts/catalogs/catalog_config.toml. Then, run scripts/catalogs/build_catalogs.py. This will generate a scripts_catalog.json object under each available district's prefix within minio.
The user interface is deployed locally as a vite development server. To run it, simply enter the ui directory and run npm run dev.