PI-1580 Create initial project for cas3-and-delius (#2427)

Co-authored-by: stevomcallister <[email protected]>

.github/workflows/access.yml

@@ -41,6 +41,7 @@ on:
           - '["hmpps-auth-and-delius"]'
           - '["dps-and-delius"]'
           - '["arns-and-delius"]'
+          - '["cas3-and-delius"]'
           # ^ add new projects here
           # GitHub Actions doesn't support dynamic choices, we must add each project here to enable manual deployments
           # See https://github.com/community/community/discussions/11795

.github/workflows/build.yml

@@ -64,6 +64,7 @@ jobs:
           - hmpps-auth-and-delius
           - dps-and-delius
           - arns-and-delius
+          - cas3-and-delius
           # ^ add new projects here
           # GitHub Actions doesn't support dynamic choices, we must add each project here to enable manual deployments
           # See https://github.com/community/community/discussions/11795

.github/workflows/deploy.yml

@@ -54,6 +54,7 @@ on:
           - '["hmpps-auth-and-delius"]'
           - '["dps-and-delius"]'
           - '["arns-and-delius"]'
+          - '["cas3-and-delius"]'
           # ^ add new projects here
           # GitHub Actions doesn't support dynamic choices, we must add each project here to enable manual deployments
           # See https://github.com/community/community/discussions/11795

.github/workflows/docs.yml

@@ -47,6 +47,7 @@ on:
           - '["hmpps-auth-and-delius"]'
           - '["dps-and-delius"]'
           - '["arns-and-delius"]'
+          - '["cas3-and-delius"]'
           # ^ add new projects here
           # GitHub Actions doesn't support dynamic choices, we must add each project here to enable manual deployments
           # See https://github.com/community/community/discussions/11795

.github/workflows/end-to-end-tests.yml

@@ -68,6 +68,7 @@ on:
           - '["hmpps-auth-and-delius"]'
           - '["dps-and-delius"]'
           - '["arns-and-delius"]'
+          - '["cas3-and-delius"]'
           # ^ add new projects here
           # GitHub Actions doesn't support dynamic choices, we must add each project here to enable manual deployments
           # See https://github.com/community/community/discussions/11795

.github/workflows/messaging.yml

@@ -33,6 +33,7 @@ on:
           - workforce-allocations-to-delius-queue
           - manage-offences-and-delius-queue
           - opd-and-delius-queue
+          - cas3-and-delius-queue
           # ^ add new queues here
 
 jobs:

.github/workflows/suppress-trivy.yml

@@ -46,6 +46,7 @@ on:
           - hmpps-auth-and-delius
           - dps-and-delius
           - arns-and-delius
+          - cas3-and-delius
           # ^ add new projects here
           # GitHub Actions doesn't support dynamic choices, we must add each project here to enable manual deployments
           # See https://github.com/community/community/discussions/11795

doc/tech-docs/source/index.html.md.erb

@@ -48,5 +48,6 @@ Follow these links to find out more about each of our integration services.
 * [Hmpps Auth And Delius](https://ministryofjustice.github.io/hmpps-probation-integration-services/tech-docs/projects/hmpps-auth-and-delius)
 * [Dps And Delius](https://ministryofjustice.github.io/hmpps-probation-integration-services/tech-docs/projects/dps-and-delius)
 * [Arns And Delius](https://ministryofjustice.github.io/hmpps-probation-integration-services/tech-docs/projects/arns-and-delius)
+* [Cas3 And Delius](https://ministryofjustice.github.io/hmpps-probation-integration-services/tech-docs/projects/cas3-and-delius)
 <li style="display: none">^ add new projects here</li>
 

projects/cas3-and-delius/.trivyignore

@@ -0,0 +1,3 @@
+# Suppressed as we do not process any untrusted YML content
+# Note: this will be resolved in Spring Boot 3.2: https://github.com/spring-projects/spring-boot/issues/35982
+CVE-2022-1471 exp:2023-12-01

projects/cas3-and-delius/README.md

@@ -0,0 +1,3 @@
+# cas3-and-delius
+
+// TODO Describe the service

projects/cas3-and-delius/applicationinsights.json

@@ -0,0 +1,62 @@
+{
+  "role": {
+    "name": "cas3-and-delius"
+  },
+  "customDimensions": {
+    "service.version": "${VERSION}",
+    "service.team": "probation-integration"
+  },
+  "instrumentation": {
+    "logging": {
+      "level": "DEBUG"
+    },
+    "springScheduling": {
+      "enabled": false
+    }
+  },
+  "selfDiagnostics": {
+    "destination": "console"
+  },
+  "sampling": {
+    "percentage": 100
+  },
+  "preview": {
+    "sampling": {
+      "overrides": [
+        {
+          "telemetryType": "request",
+          "attributes": [
+            {
+              "key": "http.url",
+              "value": "https?://[^/]+/health/?.*",
+              "matchType": "regexp"
+            }
+          ],
+          "percentage": 0
+        },
+        {
+          "telemetryType": "dependency",
+          "attributes": [
+            {
+              "key": "db.statement",
+              "value": ".*CLIENT_IDENTIFIER.*",
+              "matchType": "regexp"
+            }
+          ],
+          "percentage": 0
+        },
+        {
+          "telemetryType": "dependency",
+          "attributes": [
+            {
+              "key": "db.operation",
+              "value": "SELECT",
+              "matchType": "strict"
+            }
+          ],
+          "percentage": 10
+        }
+      ]
+    }
+  }
+}

projects/cas3-and-delius/build.gradle.kts

@@ -0,0 +1,35 @@
+import uk.gov.justice.digital.hmpps.extensions.ClassPathExtension
+
+apply(plugin = "com.google.cloud.tools.jib")
+
+dependencies {
+    implementation(project(":libs:audit"))
+    implementation(project(":libs:commons"))
+    implementation(project(":libs:messaging"))
+
+    implementation("org.springframework.boot:spring-boot-starter-actuator")
+    implementation("org.springframework.boot:spring-boot-starter-data-jpa")
+    implementation("org.springframework.boot:spring-boot-starter-security")
+    implementation("org.springframework.boot:spring-boot-starter-validation")
+    implementation("org.springframework.boot:spring-boot-starter-web")
+    implementation("org.jetbrains.kotlin:kotlin-reflect")
+    implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8")
+    implementation("com.fasterxml.jackson.module:jackson-module-kotlin")
+
+    dev(project(":libs:dev-tools"))
+    dev("com.h2database:h2")
+    dev("org.testcontainers:oracle-xe")
+
+    runtimeOnly("com.oracle.database.jdbc:ojdbc11")
+
+    testImplementation("org.springframework.boot:spring-boot-starter-test")
+    testImplementation(libs.bundles.mockito)
+}
+
+configure<ClassPathExtension> {
+    jacocoExclusions = listOf(
+        "**/config/**",
+        "**/entity/**",
+        "**/AppKt.class"
+    )
+}

projects/cas3-and-delius/deploy/Chart.yaml

@@ -0,0 +1,13 @@
+apiVersion: v2
+appVersion: '1.0'
+description: A Helm chart for Kubernetes
+name: cas3-and-delius
+version: 1.0.0
+
+dependencies:
+  - name: generic-service
+    version: 2.6.0
+    repository: https://ministryofjustice.github.io/hmpps-helm-charts
+  - name: generic-prometheus-alerts
+    version: 1.3.2
+    repository: https://ministryofjustice.github.io/hmpps-helm-charts

projects/cas3-and-delius/deploy/database/access.yml

@@ -0,0 +1,9 @@
+database:
+  access:
+    username_key: /cas3-and-delius/db-username
+    password_key: /cas3-and-delius/db-password
+
+  audit:
+    username: Cas3AndDelius
+    forename: Probation Integration # TODO change this to something meaningful for your service
+    surname: Service

projects/cas3-and-delius/deploy/values-dev.yml

@@ -0,0 +1,15 @@
+enabled: false # TODO set this to true when you're ready to deploy your service
+
+generic-service:
+  ingress:
+    host: cas3-and-delius-dev.hmpps.service.justice.gov.uk
+
+  scheduledDowntime:
+    enabled: true
+
+  env:
+    SENTRY_ENVIRONMENT: dev
+    LOGGING_LEVEL_UK_GOV_DIGITAL_JUSTICE_HMPPS: DEBUG
+
+generic-prometheus-alerts:
+  businessHoursOnly: true

projects/cas3-and-delius/deploy/values-preprod.yml

@@ -0,0 +1,14 @@
+enabled: false # TODO set this to true when you're ready to deploy your service
+
+generic-service:
+  ingress:
+    host: cas3-and-delius-preprod.hmpps.service.justice.gov.uk
+
+  scheduledDowntime:
+    enabled: true
+
+  env:
+    SENTRY_ENVIRONMENT: preprod
+
+generic-prometheus-alerts:
+  businessHoursOnly: true

projects/cas3-and-delius/deploy/values-prod.yml

@@ -0,0 +1,8 @@
+enabled: false # TODO set this to true when you're ready to deploy your service
+
+generic-service:
+  ingress:
+    host: cas3-and-delius.hmpps.service.justice.gov.uk
+
+  env:
+    SENTRY_ENVIRONMENT: prod

projects/cas3-and-delius/deploy/values.yaml

@@ -0,0 +1,25 @@
+# Common values
+generic-service:
+  nameOverride: cas3-and-delius
+  serviceAccountName: cas3-and-delius
+
+  image:
+    repository: ghcr.io/ministryofjustice/hmpps-probation-integration-services/cas3-and-delius
+
+  ingress:
+    tlsSecretName: cas3-and-delius-cert
+
+  namespace_secrets:
+    common:
+      SPRING_DATASOURCE_URL: DB_URL
+    cas3-and-delius-database:
+      SPRING_DATASOURCE_USERNAME: DB_USERNAME
+      SPRING_DATASOURCE_PASSWORD: DB_PASSWORD
+    cas3-and-delius-sentry:
+      SENTRY_DSN: SENTRY_DSN
+    cas3-and-delius-queue:
+      MESSAGING_CONSUMER_QUEUE: QUEUE_NAME
+
+generic-prometheus-alerts:
+  targetApplication: cas3-and-delius
+

projects/cas3-and-delius/settings.gradle.kts

@@ -0,0 +1 @@
+rootProject.name = "cas3-and-delius"

projects/cas3-and-delius/src/dev/kotlin/uk/gov/justice/digital/hmpps/data/DataLoader.kt

@@ -0,0 +1,25 @@
+package uk.gov.justice.digital.hmpps.data
+
+import jakarta.annotation.PostConstruct
+import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty
+import org.springframework.boot.context.event.ApplicationReadyEvent
+import org.springframework.context.ApplicationListener
+import org.springframework.stereotype.Component
+import uk.gov.justice.digital.hmpps.data.generator.UserGenerator
+import uk.gov.justice.digital.hmpps.user.AuditUserRepository
+
+@Component
+@ConditionalOnProperty("seed.database")
+class DataLoader(
+    private val auditUserRepository: AuditUserRepository
+) : ApplicationListener<ApplicationReadyEvent> {
+
+    @PostConstruct
+    fun saveAuditUser() {
+        auditUserRepository.save(UserGenerator.AUDIT_USER)
+    }
+
+    override fun onApplicationEvent(are: ApplicationReadyEvent) {
+        // Perform dev/test database setup here, using JPA repositories and generator classes...
+    }
+}

projects/cas3-and-delius/src/dev/kotlin/uk/gov/justice/digital/hmpps/data/generator/MessageGenerator.kt

@@ -0,0 +1,8 @@
+package uk.gov.justice.digital.hmpps.data.generator
+
+import uk.gov.justice.digital.hmpps.message.HmppsDomainEvent
+import uk.gov.justice.digital.hmpps.resourceloader.ResourceLoader
+
+object MessageGenerator {
+    val EXAMPLE = ResourceLoader.message<HmppsDomainEvent>("example-message")
+}

projects/cas3-and-delius/src/dev/kotlin/uk/gov/justice/digital/hmpps/data/generator/UserGenerator.kt

@@ -0,0 +1,7 @@
+package uk.gov.justice.digital.hmpps.data.generator
+
+import uk.gov.justice.digital.hmpps.user.AuditUser
+
+object UserGenerator {
+    val AUDIT_USER = AuditUser(IdGenerator.getAndIncrement(), "Cas3AndDelius")
+}

projects/cas3-and-delius/src/dev/resources/messages/example-message.json

@@ -0,0 +1,17 @@
+{
+  "Type": "Notification",
+  "MessageId": "aa2c2828-167f-529b-8e19-73735a2fb85c",
+  "TopicArn": "arn:aws:sns:eu-west-2:000000000000:example",
+  "Message": "{\"eventType\":\"example\",\"version\":1,\"description\":\"Example event\",\"detailUrl\":\"http://localhost:{wiremock.port}/example/123\",\"occurredAt\":\"2022-07-27T15:22:08.452612281+01:00\",\"additionalInformation\":{\"exampleId\":\"123\"},\"personReference\":{\"identifiers\":[{\"type\":\"CRN\",\"value\":\"A000001\"}]}}",
+  "Timestamp": "2022-07-27T14:22:08.509Z",
+  "SignatureVersion": "1",
+  "Signature": "EXAMPLE",
+  "SigningCertURL": "https://sns.eu-west-2.amazonaws.com/EXAMPLE.pem",
+  "UnsubscribeURL": "https://sns.eu-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=EXAMPLE",
+  "MessageAttributes": {
+    "eventType": {
+      "Type": "String",
+      "Value": "example"
+    }
+  }
+}

projects/cas3-and-delius/src/integrationTest/kotlin/uk/gov/justice/digital/hmpps/IntegrationTest.kt

@@ -0,0 +1,41 @@
+package uk.gov.justice.digital.hmpps
+
+import org.junit.jupiter.api.Test
+import org.mockito.Mockito.atLeastOnce
+import org.mockito.kotlin.verify
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.beans.factory.annotation.Value
+import org.springframework.boot.test.context.SpringBootTest
+import org.springframework.boot.test.mock.mockito.MockBean
+import uk.gov.justice.digital.hmpps.data.generator.MessageGenerator
+import uk.gov.justice.digital.hmpps.message.Notification
+import uk.gov.justice.digital.hmpps.messaging.HmppsChannelManager
+import uk.gov.justice.digital.hmpps.telemetry.TelemetryService
+import uk.gov.justice.digital.hmpps.telemetry.notificationReceived
+import java.util.concurrent.TimeoutException
+
+@SpringBootTest
+internal class IntegrationTest {
+    @Value("\${messaging.consumer.queue}")
+    lateinit var queueName: String
+
+    @Autowired lateinit var channelManager: HmppsChannelManager
+
+    @MockBean lateinit var telemetryService: TelemetryService
+
+    @Test
+    fun `message is logged to telemetry`() {
+        // Given a message
+        val notification = Notification(message = MessageGenerator.EXAMPLE)
+
+        // When it is received
+        try {
+            channelManager.getChannel(queueName).publishAndWait(notification)
+        } catch (_: TimeoutException) {
+            // Note: Remove this try/catch when the MessageListener logic has been implemented
+        }
+
+        // Then it is logged to telemetry
+        verify(telemetryService, atLeastOnce()).notificationReceived(notification)
+    }
+}

projects/cas3-and-delius/src/main/kotlin/uk/gov/justice/digital/hmpps/App.kt

@@ -0,0 +1,11 @@
+package uk.gov.justice.digital.hmpps
+
+import org.springframework.boot.autoconfigure.SpringBootApplication
+import org.springframework.boot.runApplication
+
+@SpringBootApplication
+class App
+
+fun main(args: Array<String>) {
+    runApplication<App>(*args)
+}