Przejdź do treści

Dokumentacja Masaku

Sklonowanie repo

Sklonowanie repozytorium¶

Przygotowanie¶

Zanim sklonujesz repozytoria, upewnij się że masz: - Zainstalowany Git - Dostęp do Azure DevOps - Skonfigurowany klucz SSH lub token PAT (Personal Access Token)

Repozytoria¶

Projekt Masaku składa się z dwóch głównych repozytoriów:

Frontend - masaku-portal¶

# Sklonuj repozytorium frontend
git clone https://dev.azure.com/masaku/masaku-portal.git
cd masaku-portal

# Sprawdź strukturę
ls -la

Backend - masaku-api¶

# Sklonuj repozytorium backend
git clone https://dev.azure.com/masaku/masaku-api.git
cd masaku-api

# Sprawdź strukturę
ls -la

Konfiguracja Git¶

# Ustaw swoją tożsamość
git config user.name "Twoje Imię"
git config user.email "twoj.email@example.com"

# Sprawdź konfigurację
git config --list

Struktura katalogów¶

Po sklonowaniu będziesz mieć:

workspace/
├── masaku-portal/      # Frontend Angular + Nx
│   ├── apps/
│   ├── projects/       # 32+ bibliotek
│   ├── src/
│   └── package.json
│
└── masaku-api/         # Backend .NET
    ├── Masaku.API/
    ├── Masaku.Domain/
    ├── Masaku.Services/
    ├── Masaku.Repository/
    └── docker/         # Docker Compose dla lokalnych usług

Weryfikacja¶

# Frontend
cd masaku-portal
git status
git branch -a

# Backend
cd masaku-api
git status
git branch -a

Troubleshooting¶

Błąd: Permission denied (publickey)¶

# Wygeneruj nowy klucz SSH
ssh-keygen -t ed25519 -C "twoj.email@example.com"

# Dodaj klucz do Azure DevOps
cat ~/.ssh/id_ed25519.pub
# Skopiuj output i dodaj w Azure DevOps → User Settings → SSH Keys

Błąd: Authentication failed¶

Użyj Personal Access Token (PAT): 1. Wejdź do Azure DevOps → User Settings → Personal Access Tokens 2. Utwórz nowy token z uprawnieniami Code (Read) 3. Użyj tokena jako hasła podczas klonowania

Dalsze kroki¶

Po sklonowaniu repozytoriów przejdź do: - Konfiguracja Frontend - Konfiguracja Backend - Lokalne usługi

Dalsze zasoby¶