@oslokommune/origo-feedback

feedback

feedback er en tjeneste som kan benyttes av alle Origos frontend applikasjoner for å ta i mot tilbakemeldinger fra Tim og sende disse inn til et sett Google regneark. Det kan konfigureres opp hvilket regneark tilbakemeldingene skal havne i slik at f.eks kan ha ulike regneark til ulike applikasjoner og miljøer.

Dette spesifikke repoet er frontend tjenesten til feedback komponenten. Det er mulig å kjøre denne standalone, men det er ment som et bibliotek som kan linkes inn i en annen applikasjon.

Hvis du ønsker å se på backend ligger det her: https://github.oslo.kommune.no/digiskjema/feedback-api

Bruke biblioteket fra en frontend applikasjon

Se mer informasjon her om hvordan tilbakemeldingsløsningen ser ut og hvordan man tar den i bruk: https://confluence.oslo.kommune.no/display/ORIGO/feedback

Installere prosjektet

Denne tjenesten er utviklet i Angular 8 og har krav om:

• >= Node 12

git clone [e-mail]:digiskjema/feedback.git
cd feedback
npm install -g @angular/cli
npm install
npm run build

Kjør prosjektet lokalt

Starte frontend

npm run serve

Frontend tjenesten er da tilgjengelig på http://localhost:4200

Rutiner ved koding

Linter og fikser filer

npm run lint

Kjør enhetstester

npm run test

Kjør build uten enhetstester

npm run build:quick

Bygge release til repo

Foreløpig er det ikke lagt inn støtte for Jenkins i dette prosjektet som trigger på merging av branch til master. Du må derfor selv sørge for at ny versjon i master havner i artifact repo.

• Opprett PR på det du har gjort i branchen din og få denne godkjent
• Merge branch inn i master (gjerne via github)
• Sørg for at du ikke har noen utestående endringer og at lokal master branch er i sync med origin/master før du går videre.

For å bygge og deploye ny versjon av feedback til repo gjør du dette:

# Merk at du MÅ ha med slash på slutten av URLen for at login skal virke
# PS. Dersom du ikke får autentisert deg så kan du også prøve å slette inneholdet av ~/.npmrc
# Brukernavn/passord finner du i kryptert dok (under nexus: # artifacts.oslo.kommune.no)
npm login --registry https://artifacts.oslo.kommune.no/repository/npm-releases/

npm run deploy

Deploy utfører følgende oppgaver:

• Kjører linting
• Bygger tjenesten
• Obfuskerer koden
• Minimaliserer css/less og javascript filer
• Samler alle filer i to filer som kan benyttes av applikasjon som vil dra inn feedback
• Patcher versjonsnummer i package.json
• Publiserer npm release i artifact repo
• Pusher ny tag i git