IDS App Store

---

Requirements:

NOTE: Please take note that this project is the frontend componente of the IDS App Store. It strictly requires the IDS App Store Backend component in order to work.

NOTE: This project requires 4 external components, namely a Postgresql database engine, a Keycloak instance to provide AAA (Authentication, Authorization, Accounting) services, the App Store backend system and a Harbor docker registry. All should be deployed, up and running before proceeding with this setup.

NOTE: An optional email account is considered. Ensure a usable mail server URL with a configured account using SMTPS to send mail.

We currently consider the following versions:

1. Postgresql v14: Postgresql should be configured such that the instance is able to receive requests from the address where this project is available. For further instructions, please refer to Postgresql documentation
2. Keycloak v12.0.2 Keycloak should be configured with an admin account. For this setup two realms are considered: a default Master realm and second realm named 'Enershare'.
3. App Store backend deployment available
4. Harbor container registry instance available.

Change application.properties file

The following properties in the application.properties file should be changed, so that they target the Postgresql and Keycloak instances deployed.

	backend: 'App Store backend URL',
    appStoreId: '78ed171b-ad2f-4f2d-9f93-38b47bsd6f',
    registry_url: 'Harbor registry instance',
    appStoreAdmin: 'registered user with Admin role',

Build application (war):

NOTE: This project is currently configured to run in an application server (e.g., Apache Tomcat). The commands will render html files and assume the use of ng client.

NOTE: The commands below assume that you are running them from the root directory of the project (energy-app-backend/)

To compile the code:

ng build --prod

The process will generate all webfiles, which should be made available in an web server.

Contacts:

If you have any questions regarding this project, please contact the following people:

Developers (SW source code / methodology questions):

• Fábio Coelho fabio.a.coelho@inesctec.pt
• Rafael Braga rafael.b.costa@inesctec.pt

Contributors / Reviewers (methodology questions):

• Fábio Coelho fabio.a.coelho@inesctec.pt
• Rafael Braga rafael.b.costa@inesctec.pt