### Wymagania

- go \> 1.23.8
- docker, docker compose

### Co to robi?

1. Tworzy środowisko do testów integracji współdzielonej bazy dla klienta neuca
2. Wprowadza testy integracyjne dla rozwiązania współdzielonej bazy dla klienta neuca (/tests/main\_test.go)

### Na czym ogólnie polega integracja z klientem neuca?

Sprawdź dokumentacje w [DOC.MD](<https://bitbucket.org/logintegraspzoo/neuca-db-integration-tool/src/master/docs/DOC.MD>)

### Jak wygląda środowisko testowe?

1. Środowisko testowe wykorzystuje kontenery dockera
2. Tworzy dwa kontenery gdzie w pierwszym z nich mamy bazę apollo a w drugim bazę dla neuca z widokami dla klienta
3. Inicjalizuje uproszczony schemat apollo (init-apollo.sql)
4. Inicjalizuje schemat bazy dla neuca (init-neuca.sql)
5. Inicjalizuje reszte tabel i widoków w skrypcie napisanym w `go` (lib/sql/)

> UWAGA: Część tabel jest inicjalizowana przy starcie dockera (3. i 4.). Wynika to z początkowych decyzji działania tego toola i tego, że niektóre tabele musimy tworzyć z usera `postgres` a inne z usera `observer` a jeszcze inne z usera `postgres` ale na bazie neuca. W przyszłości myślę, że można przenieść inicjalizowanie całej struktury wyłącznie do skryptu w `go`

### Jak stworzyć nowe środowisko testowe?

1. Wykonaj:

   ```
   make dev
   ```

### Jak dostać się do bazy apollo w kontenerze?

1. Wykonaj:

   ```
   make apollo-shell user=postgres
   ```

> UWAGA: user może być dowolnie wybrany np. observer

### Jak dostać się do bazy neuca w kontenerze?

1. Wykonaj:

   ```
   make neuca-shell user=postgres
   ```

> UWAGA: user może być dowolnie wybrany np. observer

### Jak wyczyścić środowisko testowe?

1. Wykonaj:

   ```
   make clean 
   ```

### Jak uruchomić testy?

1. W konsoli:

   ```
   go run . tests -v
   ```

> UWAGA: Aktualnie testowe dane do bazy są hardkodowane i zadziałają z domyślnymi ustawieniami kontenerów (TODO)
>
> UWAGA2: Testy zakładają, że baza danych jest w pełni zinicjalizowana (istnieją tabelki, widoki itp.). Patrz `Jak stworzyć nowe środowisko testowe?`

### Czy mogę uruchomić testy na produkcji?

Testy sprawdzające schemat można uruchomić bo nie modyfikują danych ani struktur. Innych testów nie polecam w tym momencie wykonywać. Natomiast w przyszłości moglibyśmy stworzyć test-set dla produkcji.

### Referencje

W `go` korzystamy z dwóch zewnętrznych bibliotek: 1. Biblioteka `Cobra` jako framework dla aplikacji konsolowych (cli) 2. Biblioteka `pgx` jako driver dla bazy postgresql

Linki: - [https://github.com/spf13/cobra](<https://github.com/spf13/cobra>) - [https://github.com/jackc/pgx](<https://github.com/jackc/pgx>) - [https://go.dev/](<https://go.dev/>)

Można korzystać z Makefile: - [https://en.wikipedia.org/wiki/Make\_(software)](<https://en.wikipedia.org/wiki/Make_(software)>)

### Znane problemy

1. Czasami gdy czyścimy i tworzymy środowisko na nowo pojawia się taki błąd:

   ```
   [+] Running 3/3
    ✔ Network neuca-shared-db-integration_neuca-integration-network  Created                                                                                                                                                              0.7s 
    ✔ Container neuca-integration-apollo-db                          Started                                                                                                                                                             24.4s 
    ✔ Container neuca-integration-neuca-db                           Started                                                                                                                                                             25.8s 
   Waiting for databases to be ready...
   Services started. Apollo DB on :5433, Neuca DB on :5434
   go run . init-apollo
   2025/06/10 12:10:31 failed to connect to host=localhost port=5433 dbname=apollo user=observer password=observer_pass sslmode=disable database: failed to connect to `user=observer database=apollo`:
           [::1]:5433 (localhost): failed to receive message: read tcp [::1]:53060->[::1]:5433: read: connection reset by peer
           127.0.0.1:5433 (localhost): failed to receive message: read tcp 127.0.0.1:36554->127.0.0.1:5433: read: connection reset by peer
   exit status 1
   make: *** [Makefile:27: init-apollo] Error 1
   ```

Wystarczy powtórzyć komendę `make dev`. Błąd prawdopodobnie wynika z niedostatecznego czekania po czyśczeniu istniejącego środowiska i przed inicjalizacją nowego środowiska.
