Dokumentacja dla administratora¶
Witaj w sekcji dokumentacji przeznaczonej dla administratorów systemu Masaku.
Dla kogo jest ta sekcja?¶
Ta część dokumentacji jest przeznaczona dla:
- Administratorów systemu - zarządzających konfiguracją i użytkownikami
- Zespołu IT - odpowiedzialnego za utrzymanie infrastruktury
- Support team - wspierającego użytkowników końcowych
Zakres odpowiedzialności¶
Jako administrator systemu Masaku, Twoje obowiązki obejmują:
Zarządzanie użytkownikami¶
- Tworzenie i usuwanie kont użytkowników
- Przydzielanie ról i uprawnień
- Zarządzanie dostępem do poszczególnych modułów
- Resetowanie haseł i odblokowanie kont
Konfiguracja systemu¶
- Ustawienia globalne systemu
- Konfiguracja środowisk (DE/AT)
- Zarządzanie parametrami aplikacji
- Integracje z systemami zewnętrznymi
Monitoring i utrzymanie¶
- Monitorowanie wydajności systemu
- Analiza logów i błędów
- Zarządzanie backup'ami
- Planowanie aktualizacji
Bezpieczeństwo¶
- Zarządzanie politykami bezpieczeństwa
- Konfiguracja Azure AD / MSAL
- Zarządzanie certyfikatami
- Audyt dostępu i zmian
Narzędzia administracyjne¶
Panel administracyjny¶
Dostęp do panelu administracyjnego poprzez: - Portal Office (OP) - główny panel zarządzania - Azure Portal - zarządzanie infrastrukturą - SQL Management Tools (DBeaver) - zarządzanie bazą danych
Logi i monitoring¶
- Application Insights - monitoring aplikacji
- Azure Monitor - monitoring infrastruktury
- MailHog (dev) - podgląd wysyłanych emaili
- Liquibase - historia migracji bazy danych
Środowiska¶
System Masaku działa w następujących środowiskach:
| Środowisko | Region DE | Region AT | Cel |
|---|---|---|---|
| Development | localhost:4200 | localhost:4200 | Rozwój lokalny |
| Testing | test-de.masaku.io | test-at.masaku.io | Testy manualne i automatyczne |
| Staging | stage-de.masaku.io | stage-at.masaku.io | Testy przedprodukcyjne |
| Pre-production | preprod-de.masaku.io | preprod-au.masaku.io | Testy akceptacyjne |
| Production | masaku.de | masaku.at | Produkcja |
Procedury operacyjne¶
Wdrażanie zmian¶
- Merge do brancha target
- Automatyczne uruchomienie pipeline'u Azure DevOps
- Deploy do odpowiedniego środowiska
- Weryfikacja po wdrożeniu
Zarządzanie incydentami¶
- Identyfikacja problemu (monitoring/zgłoszenie)
- Priorytetyzacja (krytyczny/wysoki/średni/niski)
- Diagnostyka (logi, baza danych)
- Rozwiązanie i weryfikacja
- Dokumentacja incydentu
Backup i recovery¶
- Codzienne automatyczne backupy bazy danych
- Backupy plików w Azure Storage
- Procedura przywracania danych
- Testy disaster recovery
Najczęstsze zadania¶
Dodanie nowego użytkownika¶
-- Przykładowe zapytanie SQL
INSERT INTO Users (Email, FirstName, LastName, Role)
VALUES ('user@example.com', 'Jan', 'Kowalski', 'User');
Reset hasła użytkownika¶
- Zaloguj się do panelu administracyjnego
- Znajdź użytkownika
- Użyj opcji "Reset hasła"
- Wyślij link resetujący na email
Zmiana konfiguracji środowiska¶
- Edytuj odpowiedni plik
appsettings.{Environment}.json - Commit i push zmian
- Deploy przez Azure Pipeline
- Weryfikuj po wdrożeniu
Kontakt techniczny¶
W przypadku problemów technicznych:
- Deweloperzy: Zobacz Dokumentacja dla developerów
- Eskalacja: Skontaktuj się z zespołem DevOps
- Incydenty krytyczne: Procedura on-call
Zasoby¶
- Azure Portal
- Azure DevOps
- Dokumentacja Microsoft Azure
- Dokumentacja .NET i Angular
Wersja dokumentacji: 1.0 Ostatnia aktualizacja: 2025-10-24