Opis programu "ZaplanujTo"
"ZaplanujTo" to aplikacja typu To-Do List, stworzona z myślą o organizowaniu i zarządzaniu codziennymi zadaniami. Program oferuje intuicyjny interfejs użytkownika, który pozwala na łatwe dodawanie, edytowanie oraz filtrowanie zadań. Dzięki przejrzystemu panelowi admina, aplikacja zapewnia także pełną kontrolę nad użytkownikami i ich danymi. Program wspiera obsługę kategorii, umożliwiając użytkownikom dostosowanie organizacji zadań według własnych potrzeb.
Funkcje:
Logowanie: Użytkownicy logują się do aplikacji za pomocą indywidualnych danych dostępowych. Program oferuje bezpieczny system logowania oparty na haszowaniu haseł za pomocą BCrypt.
Panel Admina: Panel administracyjny pozwala administratorowi na:
- Edytowanie danych użytkowników
- Resetowanie haseł użytkowników w przypadku zapomnienia
- Usuwanie użytkowników Panel ten zapewnia pełną kontrolę nad użytkownikami i ich dostępem do aplikacji.
Okno Główne "ZaplanujTo": Na głównym ekranie programu, użytkownicy mogą przeglądać swoje zadania i filtrować je według różnych kryteriów. Aplikacja wspiera filtrację zadań według daty, priorytetu i kategorii, co umożliwia łatwiejsze zarządzanie codziennymi obowiązkami.
Okno Dodawania Nowego Zadania: Użytkownicy mogą dodawać nowe zadania, definiując dla nich szczegóły takie jak nazwa zadania, opis, termin realizacji oraz priorytet. Program pozwala na przypisanie zadania do odpowiedniej kategorii, co dodatkowo ułatwia organizację.
Okno Kategorii Użytkownika: Użytkownicy mogą tworzyć i edytować własne kategorie, co pozwala na bardziej spersonalizowaną organizację zadań. Dzięki temu zadania mogą być łatwiej grupowane i zarządzane w kontekście ich tematyki lub priorytetu.
1. Tworzenie projektu
Otwórz Visual Studio.
Wybierz Nowy projekt.
Wybierz Aplikacja Windows Forms.
Tworząc projekt, najlepiej wybierz wersję .NET 8.0.
2. Instalacja wymaganych zależności
Otwórz Narzędzia -> Menedżer pakietów NuGet -> Zarządzaj pakietami NuGet dla rozwiązania.
Przejdź do zakładki Przeglądaj i zainstaluj następujące pakiety:
BCrypt.Net-Next – do szyfrowania haseł.
Microsoft.EntityFrameworkCore – do obsługi bazy danych na podstawie obiektów.
Microsoft.EntityFrameworkCore.Tools – do generowania migracji bazy danych.
Npgsql.EntityFrameworkCore.PostgreSQL – do obsługi kompatybilności z bazą PostgreSQL.
ReportViewerCore.WinForms – do tworzenia raportów.
Po wykonaniu powyższych kroków masz przygotowane środowisko do dalszego tworzenia aplikacji To-Do List.
3. Tworzenie klasy kontekstu bazy danych
Utwórz nową klasę o nazwie AppDbContext.
Dodaj do niej poniższy kod:
using BCrypt.Net;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Configuration;
using System;
using ZaplanujTo.Inne;
namespace ZaplanujTo.Baza
{
internal class AppDbContext : DbContext
{
protected readonly IConfiguration Configuration;
public AppDbContext()
{
AppContext.SetSwitch("Npgsql.EnableLegacyTimestampBehavior", true);
}
public AppDbContext(IConfiguration configuration)
{
Configuration = configuration;
AppContext.SetSwitch("Npgsql.EnableLegacyTimestampBehavior", true);
}
protected override void OnConfiguring(DbContextOptionsBuilder options)
{
// Połączenie z bazą PostgreSQL
options.UseNpgsql($"Host={staleProgramu.host};Port={staleProgramu.portBazy};Database={staleProgramu.nazwaBazy};Username=postgres;Password=postgres");
}
}
}Aby utworzyć migrację i zaktualizować bazę danych, użyj następujących poleceń w Konsoli Menedżera Pakietów NuGet:
Add-Migration "init" Update-DatabaseAby utworzyć kopię zapasową bazy danych, użyj polecenia:
C:\binPSQL\pg_dump -U postgres -d Organizator20Default -f bazaOrganizerKopia.sql > a.log
W ten sposób skonfigurowaliśmy połączenie z bazą danych PostgreSQL i przygotowaliśmy środowisko do dalszej pracy.
Instrukcja tworzenia klasy do obsługi kontekstu bazy danych
1. Dodanie wymaganych przestrzeni nazw
Na początku należy dodać niezbędne przestrzenie nazw do pliku:
using BCrypt.Net;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Configuration;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using ZaplanujTo.Inne;
using ZaplanujTo.Models;2. Tworzenie klasy AppDbContext
Tworzymy klasę AppDbContext, która dziedziczy po DbContext i jest używana do obsługi połączenia z bazą danych.
namespace ZaplanujTo.Baza
{
internal class AppDbContext : DbContext
{
protected readonly IConfiguration Configuration;3. Definiowanie konstruktorów
Tworzymy dwa konstruktory:
Bezparametrowy – ustawia domyślną konfigurację bazy danych.
Z parametrem
IConfiguration– pobiera konfigurację połączenia z pliku ustawień.
public AppDbContext()
{
AppContext.SetSwitch("Npgsql.EnableLegacyTimestampBehavior", true);
}
public AppDbContext(IConfiguration configuration)
{
Configuration = configuration;
AppContext.SetSwitch("Npgsql.EnableLegacyTimestampBehavior", true);
}4. Konfiguracja połączenia z bazą danych
Nadpisujemy metodę OnConfiguring, aby określić sposób łączenia się z bazą danych PostgreSQL.
protected override void OnConfiguring(DbContextOptionsBuilder options)
{
options.UseNpgsql($"Host={staleProgramu.host};Port={staleProgramu.portBazy}; Database={staleProgramu.nazwaBazy}; Username=postgres; Password=postgres");
}5. Definiowanie DbSetów dla encji
Tworzymy właściwości DbSet<>, które reprezentują tabele w bazie danych.
public DbSet<User> Uzytkownicy { get; set; }
public DbSet<kategoriaZadania> KategorieZadan { get; set; }
public DbSet<Zadanie> Zadania { get; set; }6. Opcjonalne tworzenie relacji w bazie danych
Zakomentowana metoda OnModelCreating pokazuje, jak można dodać relację między encjami, np. między Note a Client.
/*protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Note>()
.HasOne(n => n.Client)
.WithMany(c => c.Notes)
.HasForeignKey(n => n.ClientId);
}*/7. Migracje i aktualizacja bazy danych
Aby utworzyć nową migrację i zaktualizować bazę danych, wykonujemy następujące polecenia:
Tworzenie migracji:
Add-Migration "init"Aktualizacja bazy danych:
Update-Database
8. Tworzenie kopii bazy danych
Aby utworzyć kopię zapasową bazy danych PostgreSQL, używamy polecenia:
C:\binPSQL\pg_dump -U postgres -d Organizator20Default -f bazaOrganizerKopia.sql > a.log
pauseDzięki tej instrukcji można skutecznie utworzyć i skonfigurować kontekst bazy danych w aplikacji korzystającej z Entity Framework Core.
Tworzenie modeli do bazy danych
Aby umożliwić przechowywanie informacji w bazie danych, stworzymy trzy modele:
User – przechowujący dane użytkownika
Zadanie – przechowujący informacje o zadaniu
KategoriaZadania – przechowujący kategorie zadań
1. Tworzenie modelu User
Model User przechowuje dane użytkownika, takie jak login, hasło, imię, nazwisko oraz e-mail. Każdy użytkownik posiada również datę utworzenia konta.
using System;
namespace ZaplanujTo.Models
{
public class User
{
public int Id { get; set; }
public string Login { get; set; }
public string HashPassword { get; set; }
public string Imie { get; set; }
public string Nazwisko { get; set; }
public string Email { get; set; }
public DateOnly DataUtworzenia { get; set; }
}
}2. Tworzenie modelu Zadanie
Model Zadanie reprezentuje pojedyncze zadanie użytkownika. Zawiera informacje o nazwie, priorytecie, statusie, opisie, dacie realizacji oraz dacie utworzenia. Powiązany jest również z użytkownikiem oraz kategorią zadania.
using System;
namespace ZaplanujTo.Models
{
public class Zadanie
{
public int Id { get; set; }
public string NazwaZadania { get; set; }
public int PriorytetZadania { get; set; }
public string StatusZadania { get; set; }
public string OpisZadania { get; set; }
public DateOnly? DataDoZadania { get; set; }
public DateTime DataUtworzenia { get; set; }
public int IdUzytkownika { get; set; }
public KategoriaZadania? KategoriaZadania { get; set; }
public override string ToString()
{
return $"Data Utworzenia: {DataUtworzenia}\nOpis zadania: {OpisZadania}";
}
}
}3. Tworzenie modelu KategoriaZadania
Model KategoriaZadania przechowuje informacje o kategorii, do której może należeć zadanie. Każda kategoria jest powiązana z użytkownikiem i posiada swoją datę utworzenia.
using System;
namespace ZaplanujTo.Models
{
public class KategoriaZadania
{
public int Id { get; set; }
public string NazwaKategorii { get; set; }
public int IdUzytkownika { get; set; }
public DateOnly DataUtworzenia { get; set; }
public override string ToString()
{
return NazwaKategorii;
}
}
}Podsumowanie
Dzięki powyższym modelom mamy strukturę danych pozwalającą na przechowywanie użytkowników, ich zadań oraz kategorii zadań. Każdy model został wyposażony w odpowiednie właściwości oraz metody pomocnicze do czytelnego wyświetlania informacji. Kolejnym krokiem może być utworzenie bazy danych i konfiguracja Entity Framework w celu mapowania tych modeli na tabelę bazy danych.
Instrukcja konfiguracji aplikacji "ZaplanujTo"
1. Cel konfiguratora
Konfigurator aplikacji "ZaplanujTo" odpowiada za:
Tworzenie pliku konfiguracyjnego w folderze
AppDataużytkownika.Wczytywanie konfiguracji przy uruchomieniu aplikacji.
Tworzenie konta administratora, jeśli nie istnieje.
2. Działanie konfiguratora
2.1. Sprawdzanie pliku konfiguracyjnego
Przy uruchomieniu aplikacji wywoływana jest metoda sprawdzczyJestPlikKonfiguracjiAppData(), która:
Sprawdza, czy istnieje folder konfiguracyjny
ZaplanujTowAppData.Jeśli folder nie istnieje, tworzy go.
Sprawdza, czy istnieje plik
konfiguracja.txt.Jeśli plik istnieje, wczytuje konfigurację oraz tworzy konto administratora.
Jeśli plik nie istnieje, uruchamia konfigurator.
2.2. Tworzenie pliku konfiguracyjnego
Jeśli plik konfiguracyjny nie istnieje, użytkownik może go utworzyć za pomocą metody stworzPlikKonfiguracyjny().
Plik będzie zawierał dane dotyczące:
Host: adres serwera bazy danych.
Port: numer portu serwera.
Nazwa bazy danych.
Przykładowa zawartość pliku konfiguracja.txt:
baza=mojabaza
port=5432
host=localhostPo zapisaniu pliku wyświetlony zostaje komunikat potwierdzający jego utworzenie.
2.3. Tworzenie konta administratora
Po wczytaniu pliku konfiguracyjnego metoda stworzKontoAdmina() sprawdza, czy w bazie danych istnieje użytkownik o loginie admin.
Jeśli nie istnieje, konto administratora zostaje automatycznie utworzone.
Jeśli konto istnieje, nie jest podejmowana żadna akcja.
Administrator otrzymuje domyślne dane:
Login:
adminHasło:
admin(zaszyfrowane za pomocąBCrypt)Email:
adminImię i nazwisko:
admin
2.4. Wczytywanie konfiguracji
Metoda wczytajKonfiguracjeAppData() odczytuje dane zapisane w konfiguracja.txt i zapisuje je w zmiennych programu.
Dane są przechowywane w klasie staleProgramu, umożliwiając ich wykorzystanie w dalszej części aplikacji.
3. Obsługa przycisków w konfiguratorze
button1_Click- Wywołuje metodęstworzPlikKonfiguracyjny(), zapisując konfigurację.button2_Click- Zamyka aplikację.
4. Podsumowanie
Konfigurator automatycznie sprawdza i tworzy konfigurację przy pierwszym uruchomieniu aplikacji. Po zakończeniu procesu użytkownik może korzystać z aplikacji z odpowiednimi ustawieniami zapisanymi w AppData.
Kod programu:
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using ZaplanujTo.Baza;
using ZaplanujTo.Inne;
using ZaplanujTo.Models;
namespace ZaplanujTo
{
public partial class konfigurator : Form
{
public konfigurator()
{
InitializeComponent();
sprawdzczyJestPlikKonfiguracjiAppData();
}
public void stworzKontoAdmina()
{
AppDbContext baza = new AppDbContext();
User uzytkownik = baza.Uzytkownicy.FirstOrDefault(p => p.Login == "admin");
if (uzytkownik == null)
{
User administratror = new User();
administratror.Login= "admin";
administratror.HashPassword = BCrypt.Net.BCrypt.HashPassword("admin");
administratror.Email = "admin";
administratror.Imie = "admin";
administratror.Nazwisko= "admin";
administratror.dataUtworzenia = DateOnly.FromDateTime(DateTime.Now);
baza.Uzytkownicy.Add(administratror);
baza.SaveChanges();
}
}
public void stworzPlikKonfiguracyjny()
{
string host=hostInput.Text;
string port=portInput.Text;
string baza=bazaInput.Text;
string localDataPath = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData);
string organizatorFolder = Path.Combine(localDataPath, "ZaplanujTo");
if (!Directory.Exists(organizatorFolder))
{
Directory.CreateDirectory(organizatorFolder);
}
string filePath = Path.Combine(organizatorFolder, "konfiguracja.txt");
string trescPliku = $"""
baza={baza}
port={port}
host={host}
""";
File.WriteAllText(filePath, trescPliku);
MessageBox.Show("Poprawnie stworzono konfiguracje");
this.Close();
}
}
}
Sposób wdrożenia konfiguratora
: w Program.cs dodajemy informacje o konfiguratorze wtedy przy uruchomieniu programu system sprawdza czy jest konfiguracja jak nie ma zainicjujej okno kofiguratora w innym przypadku wyswietli okno logowania.
using ZaplanujTo;
using ZaplanujTo.Okna;
namespace MojeSprawy
{
internal static class Program
{
/// <summary>
/// The main entry point for the application.
/// </summary>
[STAThread]
static void Main()
{
// To customize application configuration such as set high DPI settings or default font,
// see https://aka.ms/applicationconfiguration.
ApplicationConfiguration.Initialize();
konfigurator konfigurator = new konfigurator();
Application.Run(new OknoLogowania());
}
}
}
Logowanie:
Instrukcja obsługi programu zawierającego kod aplikacji logowania w Windows Forms:
1. Opis ogólny aplikacji:
Aplikacja umożliwia użytkownikom logowanie do systemu. Na podstawie wprowadzonego loginu i hasła, aplikacja weryfikuje dane logowania, porównując je z zapisanymi w bazie danych. Po udanej weryfikacji, użytkownik zostaje przekierowany do odpowiedniego okna aplikacji.
2. Opis głównych komponentów aplikacji:
- OknoLogowania (OknoLogowania.cs):
To główne okno aplikacji, gdzie użytkownik wprowadza swoje dane logowania. Składa się z dwóch pól tekstowych (
loginInput,passInput), w których użytkownik wpisuje swoje dane oraz dwóch przycisków:- button1: Służy do rozpoczęcia procesu logowania.
- button2: Służy do zamknięcia aplikacji.
3. Zaloguj użytkownika (zaloguj):
Funkcja zaloguj wykonuje następujące kroki:
- Pobiera dane logowania użytkownika z pól tekstowych.
- Łączy się z bazą danych za pomocą
AppDbContext. - Szuka użytkownika w bazie po nazwie użytkownika (loginie).
- Jeśli użytkownik nie istnieje w bazie lub dane logowania są nieprawidłowe, wyświetla komunikat o błędzie.
- Jeśli dane logowania są poprawne, hasło jest weryfikowane z użyciem algorytmu BCrypt.
- Po pomyślnym zalogowaniu użytkownik zostaje przekierowany do odpowiedniego okna aplikacji:
- Jeśli login to "admin", otwiera się okno administratora (
OknoAdministratora). - Jeśli login to inny użytkownik, otwiera się główne okno aplikacji (
OknoGlowne).
- Jeśli login to "admin", otwiera się okno administratora (
4. Zamykanie aplikacji (button2_Click):
Po kliknięciu przycisku button2, aplikacja wyświetla okno wyboru (OknoWyboru), które pyta użytkownika, czy chce zamknąć program. Jeśli użytkownik zdecyduje się na zamknięcie aplikacji, program kończy działanie, w przeciwnym przypadku pozostaje otwarty.
5. Przyciski:
- Przycisk
button1:- Wywołuje metodę
zaloguj, która próbuje zalogować użytkownika na podstawie wprowadzonych danych.
- Wywołuje metodę
- Przycisk
button2:- Otwiera okno wyboru, które umożliwia użytkownikowi podjęcie decyzji o zamknięciu programu.
6. Zależności:
- Zewnętrzne biblioteki:
BCrypt.Net.BCrypt– Biblioteka do hashowania haseł przy użyciu algorytmu BCrypt.- Entity Framework: Używane do komunikacji z bazą danych i obsługi tabeli użytkowników.
7. Baza danych (AppDbContext):
Aplikacja korzysta z klasy AppDbContext do interakcji z bazą danych, gdzie przechowywane są dane użytkowników. Użytkownicy są przechowywani w tabeli Uzytkownicy, która zawiera kolumny Login i HashPassword.
8. Uruchomienie aplikacji:
Po uruchomieniu aplikacji użytkownik zostaje poproszony o podanie loginu i hasła w oknie logowania. W zależności od wyników weryfikacji danych, aplikacja przekierowuje użytkownika do odpowiedniego okna.
9. Bezpieczeństwo:
Aplikacja korzysta z mechanizmu hashowania haseł za pomocą BCrypt, co zapewnia bezpieczeństwo przechowywanych haseł w bazie danych.
Instrukcja ta przedstawia podstawową funkcjonalność aplikacji logowania oraz interakcje użytkownika z programem.
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using ZaplanujTo.Baza;
using ZaplanujTo.Inne;
using ZaplanujTo.Models;
namespace ZaplanujTo.Okna
{
public partial class OknoLogowania : Form
{
public OknoLogowania()
{
InitializeComponent();
}
public void zaloguj()
{
string login=loginInput.Text;
string haslo=passInput.Text;
AppDbContext baza = new AppDbContext();
User znalezionyUzytkownik=baza.Uzytkownicy.FirstOrDefault(p=>p.Login==login);
if (znalezionyUzytkownik == null)
{
MessageBox.Show("Nie znaleziono użytkownika/nieprawidłowe hasło");
}
else
{
if (BCrypt.Net.BCrypt.Verify(haslo, znalezionyUzytkownik.HashPassword))
{
staleProgramu.zalogowanyUzytkownik = znalezionyUzytkownik;
//MessageBox.Show($"Poprawnie zalogowano użytkownika:{login}");
if (login == "admin")
{
OknoAdministratora oknoAdministratora = new OknoAdministratora();
oknoAdministratora.Show();
this.Hide();
}
else
{
OknoGlowne oknoGlowne = new OknoGlowne();
oknoGlowne.Show();
this.Hide();
}
}
else
{
MessageBox.Show("Nie znaleziono użytkownika/nieprawidłowe hasło");
}
}
}
private void button2_Click(object sender, EventArgs e)
{
OknoWyboru oknoWyboru = new OknoWyboru("Czy zamknąć program?");
oknoWyboru.ShowDialog();
if (oknoWyboru.czyWykonac)
{
Application.Exit();
}
else
{
}
}
private void button1_Click(object sender, EventArgs e)
{
zaloguj();
}
}
}
Komentarze
Prześlij komentarz