HAI-1526 Add functions to send hanke and application invitation emails

[pitkni]

Description

Add templates for hanke and application invitation emails. Add functionality to send these invitations in EmailSenderService.

Note: It is possible for inviter name to be unknown. In these cases the emails use only the inviter email ([email protected] kutsui sinut..).

Note: mjml.io plugin is used to create the email templates. From mjml documentation:

MJML is a markup language designed to reduce the pain of coding a responsive email. Its semantic syntax makes it easy and straightforward and its rich standard components library speeds up your development time and lightens your email codebase. MJML’s open-source engine generates high quality responsive HTML compliant with best practices.

Note: Email translations are not included in this pr, as mentioned in the Jira ticket.

Using the new email sending features will be implemented on a different upcoming pr.

Jira Issue: https://helsinkisolutionoffice.atlassian.net/browse/HAI-1526

Type of change

• Bug fix
• New feature
• Other

Instructions for testing

This cannot be directly tested, but adding something like this to EmailSenderService can be used for verification:

    @Scheduled(fixedDelay = 60000)
    fun testSendHanke() {
        sendHankeInvitationEmail(
            to = "[email protected]",
            HankeInvitationData(
                inviterName = "Matti Meikäläinen",
                inviterEmail = "[email protected]",
                hankeTunnus = "HAI24-1",
                hankeNimi = "Testi hanke",
                invitationToken = "testtoken"
            )
        )
    }

    @Scheduled(fixedDelay = 60000)
    fun testSendHakemus() {
        sendApplicationInvitationEmail(
            to = "[email protected]",
            ApplicationInvitationData(
                inviterName = "Matti Meikäläinen",
                inviterEmail = "[email protected]",
                applicationType = ApplicationType.CABLE_REPORT,
                applicationIdentifier = "JS002",
                hankeTunnus = "HAI24-1",
                roleType = ContactType.RAKENNUTTAJA,
            )
        )
    }

Then you can check localhost:3003 (email server in docker compose)

Checklist:

• I have written new tests (if applicable)
• I have ran the tests myself (if applicable)
• I have made necessary changes to the documentation, link to confluence
  or other location:

Other relevant info

Please describe here if there is e.g. some requirements for this change or
other info that the tester/user needs to know.

[corvidian]

The mjml files could be moved elsewhere. Under resources, they will be a part of the runtime package, which they clearly don't need to be.

[pitkni]

Do you have any suggestions on where they should be located?

[pitkni]

How about an emailtemplate directory under scripts?

[corvidian]

They're not scripts, so that doesn't feel correct. Emails directory in either project root or services/hanke-service/emails?

[pitkni]

Placed them in project root email/.

[corvidian]

👍 Dividing the common parts to a separate directory was a good addition.

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

96.6% Coverage
0.0% Duplication