OPG SIRIUS SUPERVISION FINANCE ADMIN

Major dependencies

• Go (>= 1.22)
• docker compose (>= 2.26.0)

Installing dependencies locally:

(This is only necessary if running without docker)

• yarn install
• go mod download

---

Local development

The application ran through Docker can be accessed on localhost:8888/finance-admin.

To enable debugging and hot-reloading of Go files:

make up

Hot-reloading is managed independently for both apps and should happen seamlessly. Hot-reloading for web assets (JS, CSS, etc.) is also provided via a Yarn watch command.

---

Run the unit/integration tests

make test

Run the Cypress tests

make cypress

Run Trivy scanning

make scan

---

Architectural Decision Records

The major decisions made on this project are documented as ADRs in /adrs. The process for contributing to these is documented in the first ADR.

---

HTMX & JS

This project uses HTMX to render partial HTML instead of reloading the whole page on each request. However, this can mean that event listeners added on page load may fail to register/get deregistered when a partial is loaded. To avoid this, you can force event listeners to register on every HTMX load event by putting them within the htmx.onLoad function.

HTMX also includes a range of utility functions that can be used in place of more unwieldy native DOM functions.