Skip to content

Commit 53259d7

Browse files
Co0ob1ieeCo0ob1iee
committed
Add documentation and update project configuration
Added detailed sprint planning documents for sprints 1-3 under docs/planning. Introduced .cursor/rules/rule.mdc with comprehensive development and documentation standards. Updated PrettyScreenSHOT.csproj to set the application icon. Fixed XAML namespace for ScreenshotHistoryWindow to use the correct Views.Windows namespace.
1 parent d93d395 commit 53259d7

9 files changed

Lines changed: 533 additions & 2 deletions

File tree

‎.cursor/rules/rule.mdc‎

Lines changed: 426 additions & 0 deletions
Large diffs are not rendered by default.

‎PrettyScreenSHOT.csproj‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
<StartupObject>PrettyScreenSHOT.App</StartupObject>
1212
<AssemblyName>$(MSBuildProjectName)</AssemblyName>
1313
<AssemblyTitle>$(MSBuildProjectName)</AssemblyTitle>
14-
<!-- <ApplicationIcon>app.ico</ApplicationIcon> -->
14+
<ApplicationIcon>Assets\Icons\app.ico</ApplicationIcon>
1515
<PlatformTarget>x64</PlatformTarget>
1616
<AllowUnsafeBlocks>True</AllowUnsafeBlocks>
1717
<Platforms>AnyCPU;x64</Platforms>

‎Views/Windows/ScreenshotHistoryWindow.xaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
33
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
44
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
5-
xmlns:local="clr-namespace:PrettyScreenSHOT"
5+
xmlns:local="clr-namespace:PrettyScreenSHOT.Views.Windows"
66
xmlns:helpers="clr-namespace:PrettyScreenSHOT.Helpers"
77
Title="Screenshot History"
88
Height="650"

‎docs/planning/sprint-1-overview.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Sprint 1 – Fundamenty i porządki
2+
3+
## Cel sprintu
4+
Przygotować projekt do modernizacji UI poprzez usunięcie przestarzałych zależności, uporządkowanie struktury zasobów oraz zbudowanie bazowego katalogu stylów.
5+
6+
## Zakres
7+
- Migracja dialogów i komunikatów z Windows Forms do natywnego WPF/Wpf.Ui.
8+
- Ujednolicenie aliasów (`TextBlock`, `MessageBox`, `Toolbar`) w całym kodzie.
9+
- Stworzenie globalnych `ResourceDictionary` (kolory, typografia, spacing) i włączenie ich w `App.xaml`.
10+
- Dokumentacja obecnego interfejsu i przepływów użytkownika.
11+
12+
## Oczekiwane rezultaty
13+
- Brak zależności od Windows Forms w warstwie UI.
14+
- Jeden zestaw stylów ładowany globalnie.
15+
- Udokumentowane ekrany i punkty bólu użytkownika.
16+

‎docs/planning/sprint-1-tasks.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Sprint 1 – Lista zadań
2+
3+
1. **Audyt UI**
4+
- [ ] Zebrać zrzuty ekranu i krótkie nagrania z każdego widoku.
5+
- [ ] Spisać wszystkie obecne dialogi WinForms, konwertery i helpery specyficzne dla widoku.
6+
2. **Migracja z WinForms**
7+
- [ ] Zastąpić `FolderBrowserDialog`, `ColorDialog` i inne kontrolki WinForms natywnymi komponentami WPF/Wpf.Ui.
8+
- [ ] Ujednolicić MessageBoxy do jednego wariantu (np. `Wpf.Ui.Controls.MessageBox`).
9+
3. **Porządki w aliasach i helperach**
10+
- [ ] Usunąć mieszane aliasy `TextBlock`/`MessageBoxButton` poprzez w pełni kwalifikowane nazwy lub middleware.
11+
- [ ] Skonsolidować konwertery (np. `NullToVisibilityConverter`) w jednym katalogu i udostępnić je przez `App.xaml`.
12+
4. **Baza stylów**
13+
- [ ] Utworzyć `Themes/Base.xaml` + pliki kolorów/typografii i włączyć je w `App.xaml`.
14+
- [ ] Przenieść lokalne style z widoków do nowych dictionary (Card, Button, TextBox).
15+
5. **Walidacja**
16+
- [ ] Ręcznie przejść główne scenariusze (zrzut, edycja, historia) i potwierdzić brak regresji.
17+
- [ ] Zaktualizować dokument z wnioskami i listą otwartych tematów na kolejne sprinty.
18+

‎docs/planning/sprint-2-overview.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Sprint 2 – Shell, dashboard i sekcje
2+
3+
## Cel sprintu
4+
Zbudować nowoczesny szkielet aplikacji (dashboard startowy, wspólny layout) oraz zmodernizować kluczowe sekcje: ustawienia i historię.
5+
6+
## Zakres
7+
- Nowe główne okno z kartami funkcji i panelami statusu.
8+
- Refaktoryzacja `SettingsWindow` do układu z nawigacją boczną i panelami konfiguracji.
9+
- Przebudowa `ScreenshotHistoryWindow` – filtry, tagi, akcje inline, responsywny layout.
10+
- Wprowadzenie wbudowanych powiadomień (toast) oraz panelu statusu chmury/aktualizacji.
11+
12+
## Oczekiwane rezultaty
13+
- Spójny shell z możliwością łatwego dodawania kolejnych modułów.
14+
- Przyjazny ekran startowy skracający dostęp do najczęstszych akcji.
15+
- Sekcje ustawień i historii zgodne z nowym stylem i wspólnymi komponentami.
16+

‎docs/planning/sprint-2-tasks.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Sprint 2 – Lista zadań
2+
3+
1. **Dashboard / Shell**
4+
- [ ] Zaprojektować makietę dashboardu (kafelki, statusy, ostatnie działania).
5+
- [ ] Zaimplementować nowe główne okno z menu bocznym lub `NavigationView`.
6+
- [ ] Dodać przełącznik motywu (jasny/ciemny/system).
7+
2. **Sekcja Ustawień**
8+
- [ ] Przenieść ustawienia do układu wielokolumnowego z kategoriami w panelu bocznym.
9+
- [ ] Dodać sekcję „Wygląd” (motywy, akcent, tryb minimalny).
10+
- [ ] Zapewnić natychmiastowe podglądy zmian (np. zmiana folderu, hotkey).
11+
3. **Historia zrzutów**
12+
- [ ] Przebudować listę na responsywną siatkę/`ItemsRepeater` z kartami.
13+
- [ ] Dodać filtry (tagi, kategorie, daty) i wyszukiwarkę.
14+
- [ ] Umożliwić akcje inline (edytuj, kopiuj link, usuń, udostępnij).
15+
4. **Powiadomienia i status**
16+
- [ ] Wprowadzić system toastów w aplikacji (sukces/porażka/upload).
17+
- [ ] Stworzyć moduł statusu chmury i aktualizacji (panel boczny lub widget).
18+
5. **Testy i dokumentacja**
19+
- [ ] Testy manualne dashboardu i sekcji, w tym różne DPI.
20+
- [ ] Zaktualizować dokumentację UX oraz listę feedbacku na Sprint 3.
21+

‎docs/planning/sprint-3-overview.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Sprint 3 – Edytor, overlay i release
2+
3+
## Cel sprintu
4+
Zmodernizować doświadczenie edycji i przechwytywania ekranów, domknąć brakujące funkcje oraz przygotować projekt do wydania wersji preview.
5+
6+
## Zakres
7+
- Nowy interfejs edytora (CommandBar, panele narzędzi/właściwości, status bar).
8+
- Uspójniony overlay z trybem szybkiego zaznaczania i podpowiedziami.
9+
- Moduł powiadomień i uploadu w aplikacji (zastąpienie balloon tipów).
10+
- Przygotowanie buildów preview + scenariusze testowe.
11+
12+
## Oczekiwane rezultaty
13+
- Edytor porównywalny z nowoczesnymi narzędziami (Snipping Tool, Monosnap).
14+
- Overlay lekki, czytelny i intuicyjny dla nowych użytkowników.
15+
- Wersja „Preview” gotowa do feedbacku społeczności.
16+

‎docs/planning/sprint-3-tasks.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Sprint 3 – Lista zadań
2+
3+
1. **Edytor**
4+
- [ ] Zaprojektować i zakodować nowy `CommandBar` z najczęściej używanymi narzędziami.
5+
- [ ] Wprowadzić panel narzędzi (ikony) oraz panel właściwości (kolory, grubości, fonty).
6+
- [ ] Dodać status bar (rozmiar, zoom, tryb) i ulepszyć historię akcji (undo/redo).
7+
2. **Overlay**
8+
- [ ] Opracować tryb szybkiego zaznaczania z podpowiedziami klawiszowymi.
9+
- [ ] Dodać ustawienia overlay (kolor maski, poziom przezroczystości).
10+
- [ ] Zapewnić spójność interakcji (animacje, komunikaty).
11+
3. **Powiadomienia i upload**
12+
- [ ] Zastąpić balloon tipy modułem toastów w aplikacji.
13+
- [ ] Dodać panel ostatnich uploadów (status, możliwość ponownego wysłania).
14+
4. **Release Preview**
15+
- [ ] Przygotować build oznaczony jako „Preview” + release notes.
16+
- [ ] Checklist testowa: scenariusze edytora, overlay, powiadomienia, chmura.
17+
- [ ] Zebrać feedback i utworzyć backlog poprawek po preview.
18+

0 commit comments

Comments
 (0)