| ... | ... | @@ -9,13 +9,13 @@ Backendin GraphQL voi käyttää erilaisia tietokantoja. |
|
|
|
|
|
|
|
## 2. RabbitMQ
|
|
|
|
|
|
|
|
1. Asenna RabbitMQ joko natiivisti tai konttina. Esim. docker konttina:
|
|
|
|
### 1. Asenna RabbitMQ joko natiivisti tai konttina. Esim. docker konttina:
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo docker run -p 5672:5672 -p 15672:15672 -p 15674:15674 --name rabbitmq rabbitmq
|
|
|
|
```
|
|
|
|
|
|
|
|
2. Enabloi web-käyttöliittymä sekä stomp pluginit.
|
|
|
|
### 2. Enabloi web-käyttöliittymä sekä stomp pluginit.
|
|
|
|
|
|
|
|
```
|
|
|
|
rabbitmq-plugins enable rabbitmq_management
|
| ... | ... | @@ -30,26 +30,26 @@ sudo docker exec -it rabbitmq bash |
|
|
|
|
|
|
|
## 3. Backend
|
|
|
|
|
|
|
|
1. Lataa backendin lähdekoodi
|
|
|
|
### 1. Lataa backendin lähdekoodi
|
|
|
|
|
|
|
|
```
|
|
|
|
git clone https://gitlab.labranet.jamk.fi/OverFlow/Backend.git backend
|
|
|
|
```
|
|
|
|
|
|
|
|
2. Asenna tarvittavat paketit
|
|
|
|
### 2. Asenna tarvittavat paketit
|
|
|
|
|
|
|
|
```
|
|
|
|
cd backend
|
|
|
|
npm i
|
|
|
|
```
|
|
|
|
|
|
|
|
3. Kopioi asetustiedoston malli oikeaksi asetustiedostoksi.
|
|
|
|
### 3. Kopioi asetustiedoston malli oikeaksi asetustiedostoksi.
|
|
|
|
|
|
|
|
```
|
|
|
|
cp src/config/config.template src/config/config.js
|
|
|
|
```
|
|
|
|
|
|
|
|
4. Täytä asetukset config.js tiedostoon.
|
|
|
|
### 4. Täytä asetukset config.js tiedostoon.
|
|
|
|
* api: portti jossa itse backend pyörii
|
|
|
|
* db.dialect: tietokanta, jonka sensit [mysql|sqlite|postgres|mssql]
|
|
|
|
* db.schema: luomasi tietokannan nimi
|
| ... | ... | @@ -90,7 +90,7 @@ export default Config; |
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
5. Tietokannan luonti
|
|
|
|
### 5. Tietokannan luonti
|
|
|
|
|
|
|
|
Luo tietokanta ajamalla komento
|
|
|
|
|
| ... | ... | @@ -100,7 +100,7 @@ npm run createdb |
|
|
|
|
|
|
|
Komennon ajaminen ei lopu itsestään, voit lopettaa sen painamalla Ctrl+C.
|
|
|
|
|
|
|
|
5. Käynnistys
|
|
|
|
### 6. Käynnistys
|
|
|
|
|
|
|
|
```
|
|
|
|
npm start
|
| ... | ... | @@ -109,13 +109,13 @@ npm start |
|
|
|
## 4. Frontend
|
|
|
|
|
|
|
|
|
|
|
|
1. Lataa backendin lähdekoodi
|
|
|
|
### 1. Lataa backendin lähdekoodi
|
|
|
|
|
|
|
|
```
|
|
|
|
git clone https://gitlab.labranet.jamk.fi/OverFlow/Frontend.git frontend
|
|
|
|
```
|
|
|
|
|
|
|
|
2. Asenna tarvittavat paketit
|
|
|
|
### 2. Asenna tarvittavat paketit
|
|
|
|
|
|
|
|
```
|
|
|
|
cd frontend
|
| ... | ... | @@ -123,14 +123,14 @@ npm i -g @angular/cli |
|
|
|
npm i
|
|
|
|
```
|
|
|
|
|
|
|
|
3. Kopioi asetustiedostojen mallit oikeiksi asetustiedostoiksi.
|
|
|
|
### 3. Kopioi asetustiedostojen mallit oikeiksi asetustiedostoiksi.
|
|
|
|
|
|
|
|
```
|
|
|
|
cp src/app/core/config/app.config.template src/app/core/config/app.config.ts
|
|
|
|
cp src/app/core/config/stomp.config.template src/app/core/config/stomp.config.ts
|
|
|
|
```
|
|
|
|
|
|
|
|
4. Täytä asetukset *.config.ts tiedostoihin
|
|
|
|
### 4. Täytä asetukset *.config.ts tiedostoihin
|
|
|
|
* apiEndpoint: backendin rajapinnan osoite
|
|
|
|
* agmApiKey: google maps API avain
|
|
|
|
* headers.login: rabbitMQ käyttäjätunnus
|
| ... | ... | @@ -190,7 +190,7 @@ export const STOMP_CONFIG = new InjectionToken<StompConfig>('stomp.config'); |
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
5. Käynnistys
|
|
|
|
### 5. Käynnistys
|
|
|
|
|
|
|
|
Kehitysversiota voi ajaa komennolla
|
|
|
|
|
| ... | ... | @@ -212,14 +212,15 @@ Komento luo dist/frontend kansioon tiedostot, jotka voit tarjoilla esim. nginxil |
|
|
|
|
|
|
|
Yhtä apuvälinetilaa kohden tarvitset 3 kpl Raspberry Pi -tietokoneita, joissa on Bluetooth adapteri.
|
|
|
|
|
|
|
|
1. Asenna Raspberry Pi:t huoneen nurkkiin kuvan mukaisella tavalla.
|
|
|
|
"C" raspi voi olla myös eri kohdassa X-akselilla, mutta X=0 vaatii vähemmän konffausta. (Kts. kuva [Trilateration](https://en.wikipedia.org/wiki/Trilateration))
|
|
|
|
### 1. Asenna Raspberry Pi:t huoneen nurkkiin kuvan mukaisella tavalla.
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
2. Liitä raspit verkkoon esim. langattomasti.
|
|
|
|
"C" raspi voi olla myös eri kohdassa X-akselilla, mutta X=0 vaatii vähemmän konffausta. (Kts. kuva [Trilateration](https://en.wikipedia.org/wiki/Trilateration))
|
|
|
|
|
|
|
|
### 2. Liitä raspit verkkoon esim. langattomasti.
|
|
|
|
|
|
|
|
3. Lisää raspit tietokantaan.
|
|
|
|
### 3. Lisää raspit tietokantaan.
|
|
|
|
|
|
|
|
Avaa GraphQLn käyttöliittymä selaimessa menemällä backendin osoitteeseen esim. http://localhost:9000/graphql
|
|
|
|
|
| ... | ... | @@ -240,9 +241,9 @@ mutation { |
|
|
|
* id: hakuamasi skannerin/raspin "ID" esim. kuten edellisessä kuvassa
|
|
|
|
* exchange: rabbitmq exchangen nimi, pitää olla kaikissa raspeissa sama
|
|
|
|
|
|
|
|
4. Asenna raspeihin skannausohjelma [ohjeiden mukaan](https://gitlab.labranet.jamk.fi/OverFlow/Bluetoothscanner/blob/master/README.md)
|
|
|
|
### 4. Asenna raspeihin skannausohjelma [ohjeiden mukaan](https://gitlab.labranet.jamk.fi/OverFlow/Bluetoothscanner/blob/master/README.md)
|
|
|
|
|
|
|
|
5. Lisää apuvälinetila tietokantaan
|
|
|
|
### 5. Lisää apuvälinetila tietokantaan
|
|
|
|
|
|
|
|
Avaa GraphQLn käyttöliittymä.
|
|
|
|
|
| ... | ... | @@ -285,8 +286,8 @@ mutation { |
|
|
|
|
|
|
|
## 6. Motikan lisäys järjestelmään
|
|
|
|
|
|
|
|
1. Avaa GraphQL:n käyttöliittymä kuten edellisessä kohdassa.
|
|
|
|
2. Lisää uusi Motikka kyselyllä, esim.
|
|
|
|
### 1. Avaa GraphQL:n käyttöliittymä kuten edellisessä kohdassa.
|
|
|
|
### 2. Lisää uusi Motikka kyselyllä, esim.
|
|
|
|
|
|
|
|
```graphql
|
|
|
|
|
| ... | ... | |
| ... | ... | |