Dokumentacja Masaku¶

Witaj w dokumentacji systemu Masaku - kompleksowego rozwiązania do zarządzania budżetami, wydatkami i fakturami.

O systemie¶

Masaku to aplikacja full-stack składająca się z:

masaku-portal - Frontend w Angular 14 z workspace Nx (32+ bibliotek)
masaku-api - Backend w .NET C# z warstwową architekturą

System obsługuje dwa kraje (Niemcy - DE i Austria - AT) z oddzielnymi konfiguracjami dla każdego regionu.

Dla kogo jest ta dokumentacja?¶

👤 Użytkownik ¶

Dowiedz się jak korzystać z systemu Masaku - od logowania po zarządzanie budżetami i wydatkami.

Najważniejsze tematy: - Logowanie - Budżety - Wydatki - Faktury

🔧 Administrator ¶

Instrukcje instalacji, konfiguracji i administrowania systemem.

Najważniejsze tematy: - Instalacja - Konfiguracja środowiska - Monitoring - Troubleshooting

💻 Developer ¶

Szczegółowa dokumentacja architektury, modułów i agregatów systemu.

Najważniejsze tematy: - Architektura systemu - Frontend - Angular/Nx - Backend - .NET - Baza danych

🚀 Onboarding ¶

Przewodnik dla nowych developerów - od zera do pierwszego uruchomienia.

Najważniejsze tematy: - Wymagania - Instalacja narzędzi - Pierwsze uruchomienie - FAQ

Szybki start¶

Dla użytkowników¶

Przeczytaj przewodnik logowania
Zapoznaj się z nawigacją
Wybierz moduł który Cię interesuje

Dla administratorów¶

Przeczytaj instrukcję instalacji
Skonfiguruj środowisko
Zapoznaj się z monitoringiem

Dla nowych developerów¶

Dla doświadczonych developerów¶

Przejrzyj architekturę systemu
Zapoznaj się z bibliotekami frontend
Przeczytaj o warstwach backend

Stack technologiczny¶

Frontend¶

Angular 14
Nx workspace
NGXS (state management)
Angular Material
Transloco (i18n)
MSAL (Azure AD auth)

Backend¶

.NET C#
Entity Framework
Liquibase (migracje)
Azure Services

Infrastruktura¶

Azure DevOps (CI/CD)
Azure SQL Server
Azure Storage
Docker

Pomoc i wsparcie¶

📖 Dokumentacja: Czytasz ją właśnie teraz
🐛 Zgłaszanie błędów: Skontaktuj się z zespołem development
💡 Propozycje: Podziel się swoimi pomysłami z zespołem

Wersja dokumentacji¶

Ostatnia aktualizacja: 2025-10-24

Ta dokumentacja jest generowana z plików Markdown przy użyciu MkDocs.