SupplyManagerSRM

Dokumentacja Techniczna

System Zarządzania Relacjami z Dostawcami (Supplier Relationship Management)

Informacje o projekcie

Parametr	Wartość
Wersja dokumentu	1.0
Data utworzenia	28 grudnia 2025
Platforma docelowa	.NET 10
Typ aplikacji	WPF (Windows Presentation Foundation)
Baza danych	SQLite
Wzorzec architektoniczny	MVVM
Repozytorium	https://github.com/WoofDeveloper/SupplyManagerSRM

1. Wprowadzenie

1.1. Cel aplikacji

SupplyManagerSRM to desktopowa aplikacja WPF służąca do kompleksowego zarządzania bazą dostawców oraz ich ofertami produktowymi. System umożliwia:

Ewidencjonowanie dostawców wraz z danymi kontaktowymi
Zarządzanie ofertami cenowymi produktów
Śledzenie czasów realizacji zamówień
Filtrowanie i wyszukiwanie dostawców
Przechowywanie informacji o preferencjach płatniczych

1.2. Grupa docelowa

Aplikacja przeznaczona jest dla:

Działów zakupów w firmach produkcyjnych
Małych i średnich przedsiębiorstw handlowych
Specjalistów ds. zaopatrzenia
Osób zarządzających relacjami z dostawcami

1.3. Technologie

Komponent	Technologia
Framework	.NET 10
UI	WPF (Windows Presentation Foundation)
ORM	Entity Framework Core
Baza danych	SQLite
MVVM Toolkit	CommunityToolkit.Mvvm
Język	C# 14.0

2. Wymagania systemowe

2.1. Wymagania sprzętowe

Parametr	Minimum	Zalecane
Procesor	1 GHz	2 GHz lub szybszy
RAM	512 MB	2 GB
Dysk	100 MB	500 MB
Rozdzielczość	1024x768	1280x720 lub wyższa

2.2. Wymagania programowe

System operacyjny: Windows 10 (wersja 1607+) lub Windows 11
.NET 10 Runtime lub SDK
Visual Studio 2022/2026 (do kompilacji)

3. Architektura aplikacji

3.1. Wzorzec MVVM

Aplikacja została zbudowana zgodnie ze wzorcem Model-View-ViewModel (MVVM), który zapewnia:

Separację odpowiedzialności – logika biznesowa jest oddzielona od interfejsu użytkownika
Testowalność – ViewModele można testować niezależnie od widoków
Łatwość utrzymania – zmiany w UI nie wpływają na logikę biznesową
Powiązanie danych (Data Binding) – automatyczna synchronizacja między widokiem a danymi

3.2. Schemat architektury

VIEW (MainWindow.xaml)
   │
   └── Data Binding
         │
         ▼
VIEWMODEL (MainViewModel)
   │
   └── Wywołania serwisu
         │
         ▼
SERVICE (SupplierService)
   │
   └── Entity Framework Core
         │
         ▼
MODEL (AppDbContext + Entities)
   │
   └──
         │
         ▼
DATABASE (SQLite: supply_manager.db)

4. Struktura projektu

SupplyManagerSRM/
│
├── Data/
│   ├── AppDbContext.cs
│   ├── ISupplierService.cs
│   └── SupplierService.cs
│
├── Models/
│   ├── Supplier.cs
│   └── ProductOffer.cs
│
├── ViewModels/
│   ├── Main/
│   │   └── MainViewModel.cs
│   ├── ProductOffer/
│   │   ├── ProductOfferEditViewModel.cs
│   │   └── ProductOfferViewModel.cs
│   └── Supplier/
│       ├── SupplierEditViewModel.cs
│       └── SupplierViewModel.cs
│
├── Views/
│   ├── MainWindow.xaml
│   └── MainWindow.xaml.cs
│
├── App.xaml
├── App.xaml.cs
├── SupplyManagerSRM.csproj
└── supply_manager.db

5. Warstwa danych (Models)

5.1. Model Supplier (Dostawca)

Plik: Models/Supplier.cs

public class Supplier
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
    public string Address { get; set; } = string.Empty;
    public bool IsInvoiceElectronic { get; set; }
    public string PaymentMethod { get; set; } = "Przelew";
    public virtual ICollection<ProductOffer> ProductOffers { get; set; } = new List<ProductOffer>();
}

Opis pól:

Pole	Typ	Opis	Wartość domyślna
Id	int	Klucz główny (PK), auto-increment	-
Name	string	Nazwa firmy dostawcy	""
Address	string	Adres siedziby	""
IsInvoiceElectronic	bool	Czy akceptuje e-faktury	false
PaymentMethod	string	Preferowana metoda płatności	"Przelew"
ProductOffers	ICollection	Kolekcja ofert (relacja 1:N)	new List<>()

5.2. Model ProductOffer (Oferta produktowa)

Plik: Models/ProductOffer.cs

public class ProductOffer
{
    public int Id { get; set; }
    public string ProductName { get; set; } = string.Empty;
    public decimal Price { get; set; }
    public int LeadTimeDays { get; set; }
    public int SupplierId { get; set; }
    public virtual Supplier? Supplier { get; set; }
}

Opis pól:

Pole	Typ	Opis	Wartość domyślna
Id	int	Klucz główny (PK), auto-increment	-
ProductName	string	Nazwa produktu	""
Price	decimal	Cena jednostkowa	0
LeadTimeDays	int	Czas realizacji w dniach	0
SupplierId	int	Klucz obcy (FK) do Supplier	-
Supplier	Supplier?	Właściwość nawigacyjna	null

5.3. Relacje między encjami

Supplier → ProductOffer: relacja jeden-do-wielu (1:N)
Jeden dostawca może mieć wiele ofert produktowych
Każda oferta należy do dokładnie jednego dostawcy

6. Warstwa dostępu do danych (Data)

6.1. AppDbContext

Plik: Data/AppDbContext.cs

public class AppDbContext : DbContext
{
    public DbSet<Supplier> Suppliers { get; set; }
    public DbSet<ProductOffer> ProductOffers { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlite("Data Source=supply_manager.db");
    }
}

6.2. Interfejs ISupplierService

Plik: Data/ISupplierService.cs

public interface ISupplierService
{
    Task<List<Supplier>> GetSuppliersAsync();
    Task AddSupplierAsync(Supplier supplier);
    Task DeleteSupplierAsync(int supplierId);
    Task<List<Supplier>> SearchSuppliersAsync(string searchText);
    Task<List<ProductOffer>> GetProductOffersForSupplierAsync(int supplierId);
    Task AddProductOfferAsync(ProductOffer offer);
    Task DeleteProductOfferAsync(int offerId);
}

6.3. Implementacja SupplierService

Plik: Data/SupplierService.cs

Metoda	Opis	Parametry	Zwraca
GetSuppliersAsync()	Pobiera wszystkich dostawców z ofertami	-	List
AddSupplierAsync()	Dodaje nowego dostawcę	Supplier supplier	Task
DeleteSupplierAsync()	Usuwa dostawcę i jego oferty	int supplierId	Task
SearchSuppliersAsync()	Wyszukuje dostawców po nazwie	string searchText	List
GetProductOffersForSupplierAsync()	Pobiera oferty dostawcy	int supplierId	List
AddProductOfferAsync()	Dodaje ofertę produktową	ProductOffer offer	Task
DeleteProductOfferAsync()	Usuwa ofertę	int offerId	Task

7. Warstwa prezentacji (ViewModels)

7.1. MainViewModel

Plik: ViewModels/Main/MainViewModel.cs

Główny ViewModel aplikacji, zarządzający całym stanem interfejsu użytkownika.

Właściwości stanu

Właściwość	Typ	Opis
Title	string	Tytuł okna aplikacji
Suppliers	ObservableCollection	Lista dostawców
SelectedSupplierOffers	ObservableCollection	Oferty wybranego dostawcy
SelectedSupplier	SupplierViewModel?	Aktualnie wybrany dostawca
SelectedProductOffer	ProductOfferViewModel?	Aktualnie wybrana oferta
PaymentMethods	ObservableCollection	Dostępne metody płatności
SearchText	string	Tekst wyszukiwania

Pod-ViewModele (Edytory)

Właściwość	Typ	Opis
SupplierEditor	SupplierEditViewModel	Dane formularza dostawcy
OfferEditor	ProductOfferEditViewModel	Dane formularza oferty

Komendy

Komenda	Opis
ZaladujDostawcowAsyncCommand	Ładuje listę dostawców
DodajDostawceAsyncCommand	Dodaje nowego dostawcę
UsunDostawceAsyncCommand	Usuwa wybranego dostawcę
FiltrujDostawcowAsyncCommand	Filtruje dostawców
DodajOferteAsyncCommand	Dodaje nową ofertę
UsunOferteAsyncCommand	Usuwa wybraną ofertę

7.2. SupplierViewModel

Plik: ViewModels/Supplier/SupplierViewModel.cs

Wrapper dla modelu Supplier, implementujący INotifyPropertyChanged.

7.3. SupplierEditViewModel

Plik: ViewModels/Supplier/SupplierEditViewModel.cs

ViewModel dla formularza edycji dostawcy.

7.4. ProductOfferViewModel i ProductOfferEditViewModel

Analogiczne ViewModele dla ofert produktowych.

8. Interfejs użytkownika (Views)

8.1. Struktura MainWindow.xaml

Okno główne jest podzielone na dwie kolumny:

Lewa kolumna (Dostawcy):

Formularz dodawania dostawcy
Wyszukiwarka dostawców
Lista dostawców (DataGrid)
Przycisk usuwania dostawcy

Prawa kolumna (Oferty):

Lista ofert wybranego dostawcy (DataGrid)
Formularz dodawania oferty
Przycisk usuwania oferty

8.2. Główne komponenty UI

Komponent	Typ	Powiązanie (Binding)
Tytuł okna	Window.Title	{Binding Title}
Lista dostawców	DataGrid	{Binding Suppliers}
Zaznaczony dostawca	DataGrid.SelectedItem	{Binding SelectedSupplier}
Wyszukiwarka	TextBox	{Binding SearchText}
Metody płatności	ComboBox	{Binding PaymentMethods}
Lista ofert	DataGrid	{Binding SelectedSupplierOffers}

8.3. Code-behind (MainWindow.xaml.cs)

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
        DataContext = new MainViewModel(new SupplierService());
    }
}

9. Funkcjonalności aplikacji

9.1. Zarządzanie dostawcami

Funkcja	Opis	Walidacja
Dodawanie	Tworzenie nowego dostawcy	Nazwa nie może być pusta
Wyświetlanie	Lista wszystkich dostawców	-
Wyszukiwanie	Filtrowanie po nazwie	-
Usuwanie	Usunięcie dostawcy i jego ofert	Potwierdzenie użytkownika

9.2. Zarządzanie ofertami

Funkcja	Opis	Walidacja
Dodawanie	Tworzenie oferty dla dostawcy	Wybrany dostawca, nazwa niepusta, cena > 0, dni > 0
Wyświetlanie	Lista ofert wybranego dostawcy	-
Usuwanie	Usunięcie oferty	Potwierdzenie użytkownika

9.3. Walidacja danych

Dostawca:

Nazwa: wymagana, niepusta

Oferta:

Dostawca: wymagany (musi być zaznaczony)
Nazwa produktu: wymagana, niepusta
Cena: wymagana, > 0
Czas realizacji: wymagany, > 0

10. Przepływ danych

10.1. Uruchomienie aplikacji

App.OnStartup() tworzy bazę danych (jeśli nie istnieje)
MainWindow inicjalizuje MainViewModel z SupplierService
MainViewModel automatycznie ładuje listę dostawców

10.2. Dodawanie dostawcy

Użytkownik wypełnia formularz (pola bindowane do SupplierEditor.*)
Kliknięcie "Dodaj dostawcę" wywołuje DodajDostawceAsyncCommand
Walidacja danych
Zapis do bazy przez SupplierService
Czyszczenie formularza
Odświeżenie listy dostawców

10.3. Wybór dostawcy

Kliknięcie wiersza w DataGrid ustawia SelectedSupplier
OnSelectedSupplierChanged() wywołuje ZaladujOfertyAsync()
Lista ofert zostaje zaktualizowana

11. Instrukcja instalacji i uruchomienia

11.1. Klonowanie repozytorium

git clone https://github.com/WoofDeveloper/SupplyManagerSRM.git
cd SupplyManagerSRM

11.2. Kompilacja i uruchomienie

Visual Studio:

Otwórz SupplyManagerSRM.sln
Ustaw SupplyManagerSRM jako projekt startowy
Naciśnij F5 lub wybierz Debug > Start Debugging

CLI (.NET):

dotnet restore
dotnet build
dotnet run --project SupplyManagerSRM

11.3. Pierwsze uruchomienie

Przy pierwszym uruchomieniu aplikacja automatycznie:

Tworzy plik bazy danych supply_manager.db
Generuje schemat tabel (Suppliers, ProductOffers)
Wyświetla pustą listę dostawców

12. Rozwiązywanie problemów

12.1. Błędy powiązań danych (Binding Errors)

Objaw:

System.Windows.Data Error: 40 : BindingExpression path error

Rozwiązanie:

Sprawdź, czy DataContext jest poprawnie ustawiony
Zweryfikuj nazwy właściwości w XAML i ViewModelu
Upewnij się, że właściwości są publiczne

12.2. Baza danych nie została utworzona

Objaw: Aplikacja nie zapisuje danych

Rozwiązanie:

Sprawdź uprawnienia do zapisu w katalogu aplikacji
Zweryfikuj connection string w AppDbContext
Usuń plik supply_manager.db i uruchom ponownie

12.3. Przyciski są nieaktywne

Objaw: Przyciski nie reagują na kliknięcia

Rozwiązanie:

Sprawdź, czy komendy są poprawnie zainicjalizowane w konstruktorze
Zweryfikuj bindingi Command w XAML
Upewnij się, że metody komend są async Task

13. Możliwości rozwoju

13.1. Planowane funkcjonalności

13.2. Ulepszenia techniczne

Dependency Injection (Microsoft.Extensions.DependencyInjection)
Logging (Serilog / NLog)
Testy jednostkowe (xUnit / NUnit)
Testy UI (Selenium / WinAppDriver)
CI/CD (GitHub Actions)

Autor

WoofDeveloper

GitHub: github.com/WoofDeveloper
Repozytorium: SupplyManagerSRM

Licencja

Ten projekt jest udostępniony na licencji MIT.

MIT License

Copyright (c) 2025 WoofDeveloper

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
Converters		Converters
Data		Data
Extensions		Extensions
Helpers		Helpers
Models		Models
Properties		Properties
ViewModels		ViewModels
Views		Views
.gitignore		.gitignore
App.xaml		App.xaml
App.xaml.cs		App.xaml.cs
AssemblyInfo.cs		AssemblyInfo.cs
README.md		README.md
SupplyManagerSRM.csproj		SupplyManagerSRM.csproj
SupplyManagerSRM.slnx		SupplyManagerSRM.slnx

WoofDeveloper/SupplyManagerSRM

Folders and files

Latest commit

History

Repository files navigation

SupplyManagerSRM

Dokumentacja Techniczna

Informacje o projekcie

Spis treści

1. Wprowadzenie

1.1. Cel aplikacji

1.2. Grupa docelowa

1.3. Technologie

2. Wymagania systemowe

2.1. Wymagania sprzętowe

2.2. Wymagania programowe

3. Architektura aplikacji

3.1. Wzorzec MVVM

3.2. Schemat architektury

4. Struktura projektu

5. Warstwa danych (Models)

5.1. Model Supplier (Dostawca)

5.2. Model ProductOffer (Oferta produktowa)

5.3. Relacje między encjami

6. Warstwa dostępu do danych (Data)

6.1. AppDbContext

6.2. Interfejs ISupplierService

6.3. Implementacja SupplierService

7. Warstwa prezentacji (ViewModels)

7.1. MainViewModel

Właściwości stanu

Pod-ViewModele (Edytory)

Komendy

7.2. SupplierViewModel

7.3. SupplierEditViewModel

7.4. ProductOfferViewModel i ProductOfferEditViewModel

8. Interfejs użytkownika (Views)

8.1. Struktura MainWindow.xaml

8.2. Główne komponenty UI

8.3. Code-behind (MainWindow.xaml.cs)

9. Funkcjonalności aplikacji

9.1. Zarządzanie dostawcami

9.2. Zarządzanie ofertami

9.3. Walidacja danych

10. Przepływ danych

10.1. Uruchomienie aplikacji

10.2. Dodawanie dostawcy

10.3. Wybór dostawcy

11. Instrukcja instalacji i uruchomienia

11.1. Klonowanie repozytorium

11.2. Kompilacja i uruchomienie

11.3. Pierwsze uruchomienie

12. Rozwiązywanie problemów

12.1. Błędy powiązań danych (Binding Errors)

12.2. Baza danych nie została utworzona

12.3. Przyciski są nieaktywne

13. Możliwości rozwoju

13.1. Planowane funkcjonalności

13.2. Ulepszenia techniczne

Autor

Licencja

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages