14-olives

Välkomna till projektet! Andryan, Anna, Christoffer, Jennifer, Juri, Leo, Moises, Philip, Viktor

Komma igång

1. Klona repot

Klona repot med SSH eller HTTPS

Obs! SSH kräver att du har lagt till en ssh-nyckel i ditt GitLabskonto.

SSH:

git clone git@git.chas-lab.dev:chas-challenge-2026/grupp-14/14-olives.git
cd 14-olives

HTTPS:

git clone https://git.chas-lab.dev/chas-challenge-2026/grupp-14/14-olives.git
cd 14-olives 

2. Installera Docker (Obligatoriskt!)

Windows/MacOS

• Ladda ner Docker Desktop och följ instruktionerna.

Linux

• Installera Docker Engine.

3. Starta utvecklingsmiljön

cp .env.example .env
docker compose up

Kör med flaggan '-d' för att starta i bakgrunden:

docker compose up -d
docker compose logs -f          # se alla loggar
docker compose logs -f backend  # se loggar för backend
docker compose logs -f db       # se loggar för databas
docker compose logs -f frontend # se loggar för frontend

• Backend: http://localhost:3000
• Frontend: http://localhost:5173
• PostgreSQL: localhost:5432

4. Stoppa utvecklingsmiljön

docker compose down

5. Rensa allt (tar bort databasdata)

docker compose down -v

6. Om Dockerfile eller docker-compose ändrats

När någon av dessa filer ändrats så kör följande:

docker compose up --build

Arbetsflöde

Branch-namngivning

• feature/kort-beskrivning - ny funktionalitet

• fix/kort-beskrivning - buggfix

• chore/kort-beskrivning - underhåll

• docs/kort-beskrivning - dokumentation

• Exempel: feature/user-auth, fix/login-crash

Commit-meddelanden

• feat: ny funktionalitet

• fix: buggfix

• chore: underhåll

• docs: dokumentation

• Exempel: git commit -m "feat: add user authentication"

1. Skapa ny branch

Innan du börjar koda se till att du har den senaste versionen av main.

1. Gå till main

git checkout main 

2. Hämta senaste ändringar

git pull origin main

3. Skapa din nya branch

git branch <namn-på-branch>
git checkout <namn-på-branch>

3. (Alternativt)

git checkout -b <namn-på-branch>

2. Skriva kod

Redigera filer i din editor. Ändringar syns direkt via hot reload.

3. Pusha din kod

När du är klar med dina ändringar eller vill ha feedback:

git add .
git commit -m "Kort beskrivning"
git push -u origin <namn-på-branch>

4. Skapa Merge Request

1. Gå till webbsidan https://git.chas-lab.dev/chas-challenge-2026/grupp-14/14-olives
2. Klicka på knappen "Merge Request"
3. Välj en teammedlem som "Reviewer"
4. När pipelinen (CI/CD) lyser grönt och koden är godkänd kan den mergas i main.

Notera att pipeline ej är på plats ännu.

Tips för en härlig resa tillsammans:

• Hellre 10 små commits än 1 väldigt stor.
• Kör 'git pull origin main' ofta i din branch för att hålla dig synkad.
• .gitignore finns av en anledning. Använd den!