Testing, Frontend development

Clone the following repository

git clone https://github.com/openartcoded/app-docker.git

Go to the directory

cd app-docker

Copy the .env file

cp .env.dev.example .env

For windows users, you will need to change the content of the file with:

COMPOSE_FILE=docker-compose.yml;docker-compose.dev.yml

Once done, up the stack:

docker compose up -d

In the terminal, run:

docker exec -it app-docker-keycloak-1 /opt/keycloak/bin/kc.sh import \
        --file /tmp/import/artcoded-realm.json

For Windows users

docker exec -it app-docker-keycloak-1 /opt/keycloak/bin/kc.sh import --file /tmp/import/artcoded-realm.json

Add the following into your /etc/hosts

    127.0.1.1       auth.somehost.org
    127.0.1.1       somehost.org
    127.0.1.1       backoffice.somehost.org
    127.0.1.1       mail.somehost.org

Open a private browsing window and visit BackOffice

Default credentials:

    username: nordine
    password: 1234

If you get multiple warnings from your browser when opening the link, this is normal. Certificates are self-signed (only local)

Expenses & Reminder Tasks features

Expenses management & reminder tasks use email to receive expenses from a known email address (in the case of expenses), and send email in case of a reminder task. To test both features, follow these instructions:

  • On the top-right of https://backoffice.somehost.org, click on "Personal Info" then "Contact/Bank" and change the email address to noreply@somehost.com

  • Open a new tab & Go to https://mail.somehost.org . You can login with username: noreply@somehost.com , password: noreply

  • Send an email with an attachment (pdf or image) to fee@somehost.com => after a few seconds you should see a notification coming in on https://backoffice.somehost.org

  • Create a new reminder task. Choose "Send Mail". Once the task is triggered, go back to https://mail.somehost.org and login, you should see an email with the reminder.

Contribute to the frontend of the public website

Clone the following repo:

git clone https://github.com/openartcoded/website.git

Go to the directory

cd website

Run npm install

npm i

Run ng serve

ng serve

Visit http://localhost:4200

Contribute to the frontend of the backoffice

Clone the following repository

git clone https://github.com/openartcoded/backoffice.git

Go to the directory

cd backoffice

Run npm install

npm i

Run ng serve

ng serve

Visit http://localhost:4200