Skip to content

Latest commit

 

History

History
155 lines (92 loc) · 3.45 KB

akr.md

File metadata and controls

155 lines (92 loc) · 3.45 KB
Raw

AKR - Auktorisoitujen kääntäjien rekisteriAKR

Backend

Build and Run

Using Maven

mvn clean install
mvn spring-boot:run -Dspring-boot.run.profiles=dev

Or

Using Maven Wrapper

./mvnw clean install
./mvnw spring-boot:run -Dspring-boot.run.profiles=dev

and the app runs on > http://localhost:8080

Required packages get installed automatically.

 

Authentication and Authorisation

Production Profile

CAS configurations are used by default.

 

Development Profile

Dev profile configurations are used by default.

Dev profile uses the following credentials:

  • clerk:clerk
    • User with clerk (virkailija) privileges
  • user:user
    • User with no privileges

Dev profile enables HTTP basic and form authentication for easier command-line tool access.

In order to disable Spring Boot Security use property:

  -Dspring-boot.run.jvmArguments=-Ddev.web.security.off=true

Or

Set AKR_UNSECURE=true environment variable as shown here.

 

Scheduled tasks

EmailScheduledSending does scheduling of sending unsent emails. Every 10 seconds (FIXED_DELAY) it fetches a batch of at most 10 unsent emails (BATCH_SIZE), and tries to send them. If there are loads of emails in the queue, it may send at max. 3600 emails in an hour.

ExpiringAuthorisationsEmailCreator does scheduling of finding expiring authorisations, and creating reminder emails about them. It is run every 12 hours (FIXED_DELAY). The reminder emails that are created are eventually sent via EmailScheduledSending.

Frontend

Build and Run

yarn install
yarn akr:start  # Starts Webpack DevServer

and the app runs on > http://localhost:4000/akr/etusivu

Running tests

End-to-end tests:

yarn akr:test:cypress

Unit and Integration tests

yarn akr:test:jest
yarn akr:test:jest -- -u  # Regenerate snapshots

Documentation

Health check and overall information

Health check:

http://localhost:8080/akr/api/actuator/health

General information about the running application:

http://localhost:8080/akr/api/actuator/info

OpenAPI

http://localhost:8080/akr/api/api-docs

Swagger

http://localhost:8080/akr/api/swagger-ui.html

In order to make requests work in swagger UI, the application needs to be run with parameter:

mvn spring-boot:run -Dtomcat.util.http.parser.HttpParser.requestTargetAllow=|{}

Localizations

Frontend localizations

I18next is used as an internationalization framework. Localizations are stored in JSON files in public/i18n directory and committed to git.

For inspection and modification by OPH clerks, it's possible to create an excel sheet in the application directory as shown below:

 

JSON to XLSX

npx i18n-json-to-xlsx-converter --convert public/i18n/fi-FI/translation.json

XLSX to JSON

npx i18n-json-to-xlsx-converter --convert translation.xlsx

 

External localisations

Koodisto

Koodisto service is used to fetch language translations. To update translations run:

cd scripts
./koodisto_langs.sh

The above script fetches language codes from the Koodisto service and transforms them into localization files. The created localization files are stored in git.