diff --git a/.gitignore b/.gitignore index 70fd016..0cfbe71 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,3 @@ **-workspace/** -**/.DS_Store \ No newline at end of file +.DS_Store +.idea diff --git a/soneta-mcp-ui-guide/SKILL.md b/soneta-mcp-ui-guide/SKILL.md deleted file mode 100644 index 06733d7..0000000 --- a/soneta-mcp-ui-guide/SKILL.md +++ /dev/null @@ -1,281 +0,0 @@ ---- -name: soneta-mcp-ui-guide -description: >- - Obsługa programów Soneta (enova365, Triva) przez narzędzia MCP soneta_ui. Nawigacja po modułach, - przeglądanie list, otwieranie formularzy, edycja danych, dodawanie obiektów. Używaj tego skilla - ZAWSZE gdy użytkownik: (1) prosi o odczytanie, wyświetlenie lub wyszukanie danych w enova365/Triva - (np. kontrahenci, faktury, pracownicy, towary, stany magazynowe); (2) chce dodać, edytować lub - przeglądać obiekty w programie Soneta; (3) pyta o nawigację w modułach enova365 (Handel, Kadry, - Księgowość, CRM, itp.); (4) wspomina 'otwórz w enova', 'pokaż listę', 'znajdź kontrahenta', - 'dodaj fakturę', 'sprawdź stan magazynu', 'pokaż pracowników'; (5) chce wykonać operację - na danych ERP przez MCP. -version: "1.0" ---- - -# Obsługa programów Soneta (enova365 / Triva) przez MCP - -Skill umożliwia pełną interakcję z działającą instancją enova365 lub Triva poprzez narzędzia MCP `soneta_ui`. Pozwala przeglądać dane, nawigować po modułach, edytować formularze i dodawać nowe obiekty. - -## 1. Przepływ pracy (workflow MCP) - -Narzędzia MCP `soneta_ui` są **zależne od siebie** — muszą być wywoływane w określonej sekwencji: - -``` -get_modules → get_folders → navigate_to_folder → retrieve_list → focus_row / open_form → switch_form_page → update_field_value - ↓ - add_object → update_field_value -``` - -### Zasady sekwencji - -- `retrieve_list` wymaga wcześniejszego `navigate_to_folder` -- `open_form(objectID)` wymaga `objectID` z odpowiedzi `retrieve_list` -- `switch_form_page(pageID)` wymaga `pageID` z odpowiedzi `open_form` -- `update_field_value` działa tylko na polach oznaczonych jako `edytowany` -- `add_object` tworzy nowy obiekt w aktualnie nawigowanym folderze -- `focus_row(objectID)` zaznacza wiersz na liście bez otwierania formularza - -### Narzędzia eksploracyjne (niezależne) - -- `get_modules` — lista modułów (punkt startowy) -- `get_folders(programFolder)` — podfoldery danego modułu/folderu - -## 2. Formaty danych (CultureInfo.InvariantCulture) - -Wszystkie wartości przesyłane z/do programu muszą używać formatu InvariantCulture: - -| Typ | Format | Przykład | -|-----|--------|----------| -| Date | `yyyy-MM-dd` | `2026-03-25` | -| FromTo | `yyyy-MM-dd..yyyy-MM-dd` | `2026-01-01..2026-03-31` | -| Bool | `Tak` / `Nie` | `Tak` | -| Number | kropka dziesiętna | `1234.56` | -| Filter | `["filterID=Wartość"]` | `["_Status=Aktywny", "_DataListy=2026-01-01.."]` | - -## 3. Typowe scenariusze krok po kroku - -### Scenariusz A — Odczyt danych z listy - -``` -1. navigate_to_folder(programFolder) — otwórz folder -2. retrieve_list(filters?, pageNumber?) — pobierz dane (opcjonalnie z filtrami) -3. Prezentuj wyniki użytkownikowi -``` - -### Scenariusz B — Podgląd szczegółów obiektu - -``` -1. navigate_to_folder(programFolder) — otwórz folder -2. retrieve_list() — pobierz listę, znajdź objectID -3. open_form(objectID) — otwórz formularz -4. switch_form_page(pageID) — przełącz zakładkę jeśli potrzeba -``` - -### Scenariusz C — Edycja istniejącego obiektu - -``` -1. navigate_to_folder(programFolder) — otwórz folder -2. retrieve_list() — znajdź obiekt -3. open_form(objectID) — otwórz formularz -4. switch_form_page(pageID) — przejdź do zakładki z polem (jeśli trzeba) -5. update_field_value(["fieldID=value"]) — zmień wartość pola oznaczonego 'edytowany' -``` - -### Scenariusz D — Dodawanie nowego obiektu - -``` -1. navigate_to_folder(programFolder) — otwórz odpowiedni folder -2. add_object() — utwórz nowy obiekt -3. update_field_value(["fieldID=value"]) — wypełnij wymagane pola -``` - -### Scenariusz E — Przeglądanie dużej listy (stronicowanie) - -``` -1. navigate_to_folder(programFolder) -2. retrieve_list(pageNumber=0) — pierwsza strona -3. retrieve_list(pageNumber=1) — kolejna strona -4. ... kontynuuj aż dane się wyczerpią -``` - -### Scenariusz F — Nawigacja eksploracyjna (nieznany folder) - -``` -1. get_modules() — lista modułów -2. get_folders(moduł) — foldery w module -3. get_folders(moduł/podfolder) — dalsze podfoldery (jeśli type=folders) -4. navigate_to_folder(znaleziony_folder) — otwórz właściwy folder -``` - -## 4. Zasady bezpieczeństwa - -- **Edytuj tylko pola** oznaczone jako `edytowany` — nie próbuj wymuszać zmian na polach tylko do odczytu -- **Nie zakładaj filterID filtrów** — odczytaj je z odpowiedzi `retrieve_list` -- **Nie zakładaj fieldID zmienianych pól** — odczytaj je z odpowiedzi `open_form`, `switch_form_page`, `add_object` -- **Edytuj tylko pola na aktualnej zakładce** — żeby zmienić pole na innej zakładce użyj `switch_form_page` -- **Stronicowanie** — używaj `pageNumber` do iteracji po dużych listach, nie próbuj pobrać wszystkiego naraz - -## 5. Obsługa błędów - -| Problem | Rozwiązanie | -|---|---| -| `navigate_to_folder` zwraca błąd | Sprawdź ścieżkę przez `get_folders` — ścieżka może być nieprawidłowa | -| Lista jest pusta | Zasugeruj zmianę lub usunięcie filtrów | -| Pole nie jest `edytowany` | Poinformuj użytkownika — pole jest tylko do odczytu | -| Brak `objectID` | Najpierw wykonaj `retrieve_list` aby uzyskać identyfikatory | -| Brak `pageID` | Najpierw wykonaj `open_form` aby uzyskać listę zakładek | -| Nieznany folder | Użyj `get_modules` → `get_folders` do eksploracji struktury | - -## 6. Parametr navigate_to_folder — newTab - -- `newTab: true` — otwiera folder w nowej karcie (nie zamyka aktualnego widoku) -- `newTab: false` (domyślnie) — zastępuje aktualny widok -- Używaj `newTab: true` gdy użytkownik chce porównać dane z dwóch folderów - -## 7. Najczęściej używane foldery programu - -Poniższa lista zawiera ścieżki folderów (`programFolder`). Używaj ich z `navigate_to_folder`, `retrieve_list`, `open_form`. - -### Handel - -| programFolder | Opis | -|---|---| -| `Handel/Kartoteki/Towary i usługi` | Kartoteka towarów i usług | -| `Handel/Sprzedaż/Faktury sprzedaży` | Faktury sprzedaży, paragony, korekty | -| `Handel/Sprzedaż/Zamówienia od odbiorców` | Zamówienia złożone przez odbiorców | -| `Handel/Sprzedaż/Oferty do odbiorców` | Dokumenty ofert handlowych | -| `Handel/Zakup/Faktury zakupu` | Faktury zakupu oraz korekty | -| `Handel/Zakup/Zamówienia do dostawców` | Zamówienia złożone u dostawców | -| `Handel/Zakup/Faktury wewnętrzne` | Faktury wewnętrzne z wewnątrzunijnych faktur zakupu | -| `Handel/Magazyn/Dokumenty razem` | Wszystkie dokumenty magazynowe (PZ, WZ, PW, RW, MM) | -| `Handel/Magazyn/Stany magazynowe` | Stany towarów w magazynie | -| `Handel/Magazyn/Zasoby` | Stany i partie zasobów magazynowych | -| `Handel/Magazyn/Dokumenty wg kategorii/Przyjęcia magazynowe` | Dokumenty PZ oraz ich korekty | -| `Handel/Magazyn/Dokumenty wg kategorii/Wydania magazynowe` | Dokumenty WZ oraz ich korekty | -| `Handel/Magazyn/Dokumenty wg kategorii/Przesunięcia magazynowe` | Dokumenty przesunięć MM | -| `Handel/Magazyn/Dokumenty wg kategorii/Inwentaryzacja` | Inwentaryzacja, spis z natury | -| `Handel/Magazyn/Okresy magazynowe` | Okresy magazynowe, zasoby, obroty | -| `Handel/Dokumenty razem i pozostałe/Wszystkie dokumenty` | Wszystkie dokumenty handlowe razem | -| `Handel/Dokumenty razem i pozostałe/Pozycje dokumentów` | Zestawienie pozycji ze wszystkich dokumentów | -| `Handel/Sprzedaż/Ceny i rabaty/Cennik kontrahenta` | Cennik towarów dla kontrahenta | -| `Handel/KSeF/Wysyłanie` | Wysyłanie dokumentów do KSeF | -| `Handel/KSeF/Pobrane` | Pliki faktur pobranych z KSeF | -| `Handel/Zestawienia/Obroty wg towarów` | Obroty magazynowe wg towarów | -| `Handel/Zestawienia/Obroty wg kontrahentów` | Obroty magazynowe wg kontrahentów | -| `Handel/Zestawienia/Sprzedaż i zakupy wg towarów` | Sprzedaż i zakupy wg towarów | -| `Handel/Zestawienia/Sprzedaż i zakupy wg kontrahentów` | Sprzedaż i zakupy wg kontrahentów | - -### Kontrahenci i urzędy - -| programFolder | Opis | -|---|---| -| `Kontrahenci i urzędy/Kontrahenci` | Kartoteka kontrahentów | -| `Kontrahenci i urzędy/Osoby` | Osoby związane z kontrahentami | -| `Kontrahenci i urzędy/Kontrahenci wg opiekuna` | Kontrahenci wg opiekunów handlowych | -| `Kontrahenci i urzędy/Banki` | Słownik banków | -| `Kontrahenci i urzędy/Urzędy skarbowe` | Słownik urzędów skarbowych | - -### Ewidencja Środków Pieniężnych - -| programFolder | Opis | -|---|---| -| `Ewidencja Środków Pieniężnych/Raporty` | Raporty zmian w ewidencjach | -| `Ewidencja Środków Pieniężnych/Dokumenty kasowe` | Wpłaty i wypłaty do kasy | -| `Ewidencja Środków Pieniężnych/Przelewy` | Przelewy bankowe | -| `Ewidencja Środków Pieniężnych/Paczki przelewów` | Paczki przelewów do eksportu | -| `Ewidencja Środków Pieniężnych/Rozrachunki wg dokumentów` | Rozrachunki wg dokumentów | -| `Ewidencja Środków Pieniężnych/Rozrachunki wg kontrahentów` | Rozrachunki wg kontrahentów | -| `Ewidencja Środków Pieniężnych/Zobowiązania i należności` | Zobowiązania i należności | -| `Ewidencja Środków Pieniężnych/Wpłaty i wypłaty` | Wpłaty i wypłaty | -| `Ewidencja Środków Pieniężnych/Dokumenty rozliczeniowe/Kompensaty` | Kompensaty | -| `Ewidencja Środków Pieniężnych/Dokumenty rozliczeniowe/Noty odsetkowe` | Noty odsetkowe | -| `Ewidencja Środków Pieniężnych/Dokumenty rozliczeniowe/Wezwania do zapłaty` | Wezwania do zapłaty | -| `Ewidencja Środków Pieniężnych/Dokumenty rozliczeniowe/Rozliczenie delegacji` | Rozliczenie delegacji | -| `Ewidencja Środków Pieniężnych/Sprawy windykacyjne` | Sprawy windykacyjne | - -### Księgowość - -| programFolder | Opis | -|---|---| -| `Księgowość/Obroty i salda` | Zestawienie zapisów na kontach | -| `Księgowość/Dziennik/Dekrety` | Dziennik wg dekretów | -| `Księgowość/Dziennik/Zapisy` | Dziennik wg zapisów | -| `Księgowość/Plan kont` | Plan kont księgowych | -| `Księgowość/Rozrachunki wg dokumentów` | Rozrachunki wg dokumentów | -| `Księgowość/Rozrachunki wg kontrahentów` | Rozrachunki wg kontrahentów | -| `Księgowość/Rozliczenia księgowe` | Rozliczenia na kontach | -| `Księgowość/Definicje zestawień księgowych` | Bilans, rachunek wyników | -| `Księgowość/Wyniki zestawień` | Wyniki zestawień księgowych | -| `Księgowość/Sprawozdania finansowe` | Sprawozdania finansowe | -| `Księgowość/Deklaracje/CIT-8` | Deklaracja CIT-8 | -| `Księgowość/Deklaracje/Zaliczka PIT skala` | Zaliczka PIT — skala | -| `Księgowość/RMK/Dokumenty RMK` | Rozliczenia międzyokresowe kosztów | -| `Księgowość/Złe długi` | Dokumenty złych długów | - -### Ewidencja dokumentów i VAT - -| programFolder | Opis | -|---|---| -| `Ewidencja dokumentów/Dokumenty` | Ewidencja dokumentów | -| `Ewidencja dokumentów/Ewidencja dokumentów VAT` | Dokumenty VAT | -| `Ewidencja dokumentów/Rejestr VAT` | Rejestr VAT | -| `Ewidencja dokumentów/Deklaracja VAT-7` | Deklaracja VAT-7 | -| `Ewidencja dokumentów/Deklaracja VAT-UE` | Deklaracja VAT-UE | -| `Ewidencja dokumentów/Jednolite pliki kontrolne` | JPK | -| `Ewidencja dokumentów/eDeklaracje` | Deklaracje elektroniczne | -| `Ewidencja dokumentów/Noty korygujące` | Noty korygujące | -| `Ewidencja dokumentów/Matryce dokumentów` | Szablony dokumentów | - -### Kadry i płace - -| programFolder | Opis | -|---|---| -| `Kadry i płace/Kadry/Pracownicy` | Kartoteka pracowników | -| `Kadry i płace/Kadry/Zleceniobiorcy` | Kartoteka zleceniobiorców | -| `Kadry i płace/Kadry/Wszyscy` | Wszyscy zatrudnieni | -| `Kadry i płace/Kadry/Umowy` | Umowy cywilnoprawne | -| `Kadry i płace/Kadry/Czas pracy/Nieobecności` | Nieobecności | -| `Kadry i płace/Kadry/Czas pracy/Limity nieobecności` | Limity urlopowe | -| `Kadry i płace/Kadry/Czas pracy/Wnioski o urlopy, delegacje` | Wnioski urlopowe | -| `Kadry i płace/Kadry/Ewidencje/Umowy o pracę` | Umowy o pracę | -| `Kadry i płace/Kadry/Ewidencje/Badania lekarskie` | Badania lekarskie | -| `Kadry i płace/Kadry/Ewidencje/Szkolenia BHP` | Szkolenia BHP | -| `Kadry i płace/Płace/Listy płac` | Listy płac | -| `Kadry i płace/Płace/Wypłaty` | Wypłaty | -| `Kadry i płace/Płace/Elementy wypłaty` | Składniki wypłat | -| `Kadry i płace/Deklaracje ZUS/DRA` | Deklaracje DRA | -| `Kadry i płace/Deklaracje ZUS/Zgłoszeniowe` | Deklaracje zgłoszeniowe | -| `Kadry i płace/Deklaracje PIT/PIT-11` | Deklaracja PIT-11 | -| `Kadry i płace/Deklaracje PIT/PIT-4R` | Deklaracja PIT-4R | -| `Kadry i płace/Dokumenty PPK/Rozliczenie składek` | Rozliczenie składek PPK | - -### Księga inwentarzowa - -| programFolder | Opis | -|---|---| -| `Księga inwentarzowa/Ewidencja środków trwałych` | Środki trwałe | -| `Księga inwentarzowa/Dokumenty środków trwałych` | Dokumenty środków trwałych | - -### CRM - -| programFolder | Opis | -|---|---| -| `CRM/Kontrahenci` | Kartoteka kontrahentów CRM | -| `CRM/Zadania` | Zadania CRM | -| `CRM/Moje zadania` | Zadania bieżącego operatora | -| `CRM/Zdarzenia` | Rejestr zdarzeń CRM | -| `CRM/Aktywności` | Aktywności: rozmowy, spotkania, notatki | -| `CRM/Leady` | Leady sprzedażowe | -| `CRM/Transakcje` | Transakcje sprzedażowe | -| `CRM/Projekty` | Projekty CRM | -| `CRM/Kampanie` | Kampanie marketingowe | -| `CRM/Kanban` | Tablica Kanban | -| `CRM/Kalendarz CRM` | Kalendarz z zadaniami i zdarzeniami | - -### Pozostałe moduły - -| programFolder | Opis | -|---|---| -| `Terminarz` | Zadania do wykonania | -| `DMS` | Zarządzanie dokumentami | -| `Workflow` | Procesy workflow | diff --git a/soneta-mcp-ui-guide/soneta-folders.md b/soneta-mcp-ui-guide/soneta-folders.md deleted file mode 100644 index b0f2f0f..0000000 --- a/soneta-mcp-ui-guide/soneta-folders.md +++ /dev/null @@ -1,148 +0,0 @@ -# Najczęściej używane foldery programu Soneta (enova365) - -Poniższa lista zawiera ścieżki folderów (`programFolder`) wraz z opisami. -Używaj ich z funkcjami MCP `soneta_ui`: `navigate_to_folder`, `retrieve_list`, `open_form`. - -## Handel - -| programFolder | Opis | -|---|---| -| `Handel/Kartoteki/Towary i usługi` | Kartoteka towarów i usług | -| `Handel/Sprzedaż/Faktury sprzedaży` | Faktury sprzedaży, paragony, korekty | -| `Handel/Sprzedaż/Zamówienia od odbiorców` | Zamówienia złożone przez odbiorców | -| `Handel/Sprzedaż/Oferty do odbiorców` | Dokumenty ofert handlowych złożonych odbiorcom | -| `Handel/Zakup/Faktury zakupu` | Faktury zakupu oraz korekty faktur zakupu | -| `Handel/Zakup/Zamówienia do dostawców` | Zamówienia złożone u dostawców | -| `Handel/Zakup/Faktury wewnętrzne` | Faktury wewnętrzne z wewnątrzunijnych faktur zakupu | -| `Handel/Magazyn/Dokumenty razem` | Wszystkie dokumenty magazynowe razem (PZ, WZ, PW, RW, MM) | -| `Handel/Magazyn/Stany magazynowe` | Stany towarów w magazynie | -| `Handel/Magazyn/Zasoby` | Stany i partie zasobów magazynowych | -| `Handel/Magazyn/Dokumenty wg kategorii/Przyjęcia magazynowe` | Dokumenty przyjęć magazynowych (PZ) oraz ich korekty | -| `Handel/Magazyn/Dokumenty wg kategorii/Wydania magazynowe` | Dokumenty wydań magazynowych (WZ) oraz ich korekty | -| `Handel/Magazyn/Dokumenty wg kategorii/Przesunięcia magazynowe` | Dokumenty przesunięć magazynowych MM | -| `Handel/Magazyn/Dokumenty wg kategorii/Inwentaryzacja` | Dokumenty inwentaryzacji, spisu z natury i stanów początkowych | -| `Handel/Magazyn/Okresy magazynowe` | Okresy magazynowe, zasoby, obroty | -| `Handel/Dokumenty razem i pozostałe/Wszystkie dokumenty` | Wszystkie dokumenty faktur, korekt, magazynowe i pozostałe razem | -| `Handel/Dokumenty razem i pozostałe/Pozycje dokumentów` | Zestawienie pozycji ze wszystkich dokumentów handlowych | -| `Handel/Sprzedaż/Ceny i rabaty/Cennik kontrahenta` | Cennik towarów dla kontrahenta (oferta cenowa) | -| `Handel/KSeF/Wysyłanie` | Wysyłanie dokumentów do Krajowego Systemu e-Faktur | -| `Handel/KSeF/Pobrane` | Pliki faktur pobranych z KSeF | -| `Handel/Zestawienia/Obroty wg towarów` | Obroty w magazynie wg towarów | -| `Handel/Zestawienia/Obroty wg kontrahentów` | Obroty w magazynie wg dostawców lub odbiorców | -| `Handel/Zestawienia/Sprzedaż i zakupy wg towarów` | Zestawienie sprzedaży i zakupów według towarów i usług | -| `Handel/Zestawienia/Sprzedaż i zakupy wg kontrahentów` | Zestawienie sprzedaży i zakupów według kontrahentów | - -## Kontrahenci i urzędy - -| programFolder | Opis | -|---|---| -| `Kontrahenci i urzędy/Kontrahenci` | Kartoteka kontrahentów z danymi handlowymi i kontaktowymi | -| `Kontrahenci i urzędy/Osoby` | Osoby związane z kontrahentami, bankami | -| `Kontrahenci i urzędy/Kontrahenci wg opiekuna` | Kontrahenci pogrupowani według opiekunów handlowych | -| `Kontrahenci i urzędy/Banki` | Słownik banków z numerami rozliczeniowymi | -| `Kontrahenci i urzędy/Urzędy skarbowe` | Słownik urzędów skarbowych | - -## Ewidencja Środków Pieniężnych - -| programFolder | Opis | -|---|---| -| `Ewidencja Środków Pieniężnych/Raporty` | Raporty zmian w ewidencjach środków pieniężnych | -| `Ewidencja Środków Pieniężnych/Dokumenty kasowe` | Wpłaty i wypłaty do kasy | -| `Ewidencja Środków Pieniężnych/Przelewy` | Przelewy bankowe do realizacji i zrealizowane | -| `Ewidencja Środków Pieniężnych/Paczki przelewów` | Grupowanie przelewów w paczki do eksportu do banku | -| `Ewidencja Środków Pieniężnych/Rozrachunki wg dokumentów` | Rozrachunki z kontrahentami wg dokumentów | -| `Ewidencja Środków Pieniężnych/Rozrachunki wg kontrahentów` | Rozrachunki z kontrahentami | -| `Ewidencja Środków Pieniężnych/Zobowiązania i należności` | Zobowiązania i należności | -| `Ewidencja Środków Pieniężnych/Wpłaty i wypłaty` | Wpłaty i wypłaty | -| `Ewidencja Środków Pieniężnych/Dokumenty rozliczeniowe/Kompensaty` | Dokumenty kompensat wzajemnych należności i zobowiązań | -| `Ewidencja Środków Pieniężnych/Dokumenty rozliczeniowe/Noty odsetkowe` | Noty odsetkowe | -| `Ewidencja Środków Pieniężnych/Dokumenty rozliczeniowe/Wezwania do zapłaty` | Wezwania do zapłaty | -| `Ewidencja Środków Pieniężnych/Dokumenty rozliczeniowe/Rozliczenie delegacji` | Rozliczenie delegacji | -| `Ewidencja Środków Pieniężnych/Sprawy windykacyjne` | Zarządzanie sprawami windykacyjnymi | - -## Księgowość - -| programFolder | Opis | -|---|---| -| `Księgowość/Obroty i salda` | Zestawienie zapisów księgowych na kontach | -| `Księgowość/Dziennik/Dekrety` | Dziennik wg dekretów | -| `Księgowość/Dziennik/Zapisy` | Dziennik wg zapisów | -| `Księgowość/Plan kont` | Plan kont księgowych | -| `Księgowość/Rozrachunki wg dokumentów` | Rozrachunki pogrupowane według dokumentów źródłowych | -| `Księgowość/Rozrachunki wg kontrahentów` | Rozrachunki wg podmiotów | -| `Księgowość/Rozliczenia księgowe` | Rozliczenia na kontach księgowych | -| `Księgowość/Definicje zestawień księgowych` | Bilans, rachunek wyników i inne | -| `Księgowość/Wyniki zestawień` | Wyniki bilans, rachunek wyników i inne | -| `Księgowość/Sprawozdania finansowe` | Sprawozdania finansowe (e-sprawozdawczość) | -| `Księgowość/Deklaracje/CIT-8` | Deklaracja podatku dochodowego od osób prawnych | -| `Księgowość/Deklaracje/Zaliczka PIT skala` | Zaliczka miesięczna na podatek dochodowy — skala | -| `Księgowość/RMK/Dokumenty RMK` | Dokumenty rozliczeń międzyokresowych kosztów | -| `Księgowość/Złe długi` | Dokumenty złych długów | - -## Ewidencja dokumentów i VAT - -| programFolder | Opis | -|---|---| -| `Ewidencja dokumentów/Dokumenty` | Ewidencjonowanie dokumentów własnych i obcych | -| `Ewidencja dokumentów/Ewidencja dokumentów VAT` | Zaewidencjonowane dokumenty VAT | -| `Ewidencja dokumentów/Rejestr VAT` | Rozliczone dokumenty VAT | -| `Ewidencja dokumentów/Deklaracja VAT-7` | Deklaracja dla podatku od towarów i usług | -| `Ewidencja dokumentów/Deklaracja VAT-UE` | Wewnątrzwspólnotowe dostawy/nabycia towarów | -| `Ewidencja dokumentów/Jednolite pliki kontrolne` | Generowanie JPK dla organów skarbowych | -| `Ewidencja dokumentów/eDeklaracje` | Deklaracje elektroniczne | -| `Ewidencja dokumentów/Noty korygujące` | Wystawianie i przeglądanie not korygujących do faktur | -| `Ewidencja dokumentów/Matryce dokumentów` | Szablony automatycznego tworzenia i dekretowania dokumentów | - -## Kadry i płace - -| programFolder | Opis | -|---|---| -| `Kadry i płace/Kadry/Pracownicy` | Kartoteka pracowników zatrudnionych na umowę o pracę | -| `Kadry i płace/Kadry/Zleceniobiorcy` | Kartoteka osób zatrudnionych na umowy cywilnoprawne | -| `Kadry i płace/Kadry/Wszyscy` | Pracownicy, zleceniobiorcy i osoby niezatrudnione | -| `Kadry i płace/Kadry/Umowy` | Umowy cywilnoprawne zawarte z pracownikami | -| `Kadry i płace/Kadry/Czas pracy/Nieobecności` | Ewidencja nieobecności: urlopy, zwolnienia, delegacje | -| `Kadry i płace/Kadry/Czas pracy/Limity nieobecności` | Limity urlopowe i innych nieobecności | -| `Kadry i płace/Kadry/Czas pracy/Wnioski o urlopy, delegacje` | Wnioski urlopowe i delegacyjne | -| `Kadry i płace/Kadry/Ewidencje/Umowy o pracę` | Umowy o pracę z historią zmian warunków zatrudnienia | -| `Kadry i płace/Kadry/Ewidencje/Badania lekarskie` | Badania lekarskie z terminami ważności | -| `Kadry i płace/Kadry/Ewidencje/Szkolenia BHP` | Szkolenia BHP z terminami ważności | -| `Kadry i płace/Płace/Listy płac` | Generowanie i rozliczanie list płac | -| `Kadry i płace/Płace/Wypłaty` | Naliczone i zrealizowane wypłaty | -| `Kadry i płace/Płace/Elementy wypłaty` | Szczegółowe składniki wypłat | -| `Kadry i płace/Deklaracje ZUS/DRA` | Deklaracje rozliczeniowe DRA | -| `Kadry i płace/Deklaracje ZUS/Zgłoszeniowe` | Deklaracje zgłoszeniowe pracowników | -| `Kadry i płace/Deklaracje PIT/PIT-11` | Informacja o dochodach i pobranych zaliczkach | -| `Kadry i płace/Deklaracje PIT/PIT-4R` | Deklaracja o pobranych zaliczkach na podatek dochodowy | -| `Kadry i płace/Dokumenty PPK/Rozliczenie składek` | Rozliczenie składek PPK | - -## Księga inwentarzowa - -| programFolder | Opis | -|---|---| -| `Księga inwentarzowa/Ewidencja środków trwałych` | Dane identyfikacyjne, parametry amortyzacji | -| `Księga inwentarzowa/Dokumenty środków trwałych` | Dokumenty rejestracji, amortyzacji, likwidacji | - -## CRM - -| programFolder | Opis | -|---|---| -| `CRM/Kontrahenci` | Kartoteka kontrahentów | -| `CRM/Zadania` | Zadania CRM przypisane do operatorów i kontrahentów | -| `CRM/Moje zadania` | Zadania przypisane do bieżącego operatora | -| `CRM/Zdarzenia` | Rejestr zdarzeń CRM (kontakty z klientami, działania handlowe) | -| `CRM/Aktywności` | Rejestr aktywności: rozmowy telefoniczne, spotkania, notatki | -| `CRM/Leady` | Leady sprzedażowe w lejku CRM | -| `CRM/Transakcje` | Transakcje sprzedażowe w lejku CRM | -| `CRM/Projekty` | Zarządzanie projektami CRM | -| `CRM/Kampanie` | Kampanie marketingowe i sprzedażowe | -| `CRM/Kanban` | Widok tablicy Kanban do zarządzania zadaniami | -| `CRM/Kalendarz CRM` | Widok kalendarza z zadaniami i zdarzeniami | - -## Pozostałe moduły - -| programFolder | Opis | -|---|---| -| `Terminarz` | Zadania do wykonania | -| `DMS` | Zarządzanie dokumentami | -| `Workflow` | Procesy i zadania powiązane z Workflow | diff --git a/soneta-mcp-ui-guide/soneta-mcp-skill-guide.md b/soneta-mcp-ui-guide/soneta-mcp-skill-guide.md deleted file mode 100644 index 539fbe2..0000000 --- a/soneta-mcp-ui-guide/soneta-mcp-skill-guide.md +++ /dev/null @@ -1,127 +0,0 @@ -# Skill zarządzania programem Soneta (enova365) przez MCP - -## 1. Przepływ pracy (workflow MCP) - -Narzędzia MCP `soneta_ui` są **zależne od siebie** — muszą być wywoływane w określonej sekwencji: - -``` -get_modules → get_folders → navigate_to_folder → retrieve_list → focus_row / open_form → switch_form_page → update_field_value - ↓ - add_object → update_field_value -``` - -### Zasady sekwencji - -- `retrieve_list` wymaga wcześniejszego `navigate_to_folder` -- `open_form(objectID)` wymaga `objectID` z odpowiedzi `retrieve_list` -- `switch_form_page(pageID)` wymaga `pageID` z odpowiedzi `open_form` -- `update_field_value` działa tylko na polach oznaczonych jako `edytowany` -- `add_object` tworzy nowy obiekt w aktualnie nawigowanym folderze -- `focus_row(objectID)` zaznacza wiersz na liście bez otwierania formularza - -### Narzędzia eksploracyjne (niezależne) - -- `get_modules` — lista modułów (punkt startowy) -- `get_folders(programFolder)` — podfoldery danego modułu/folderu - -## 2. Formaty danych (CultureInfo.InvariantCulture) - -Wszystkie wartości przesyłane z/do programu muszą używać formatu InvariantCulture: - -| Typ | Format | Przykład | -|-----|--------|----------| -| Date | `yyyy-MM-dd` | `2026-03-25` | -| FromTo | `yyyy-MM-dd..yyyy-MM-dd` | `2026-01-01..2026-03-31` | -| Bool | `Tak` / `Nie` | `Tak` | -| Number | kropka dziesiętna | `1234.56` | -| Filter | `["filterID=Wartość"]` | `["_Status=Aktywny", "_DataListy=2026-01-01.."]` | - - -## Foldery w programie - -| Intencja użytkownika | programFolder | -|---|---| -| terminarz, zadania do wykonania | `Terminarz` | -| zarządzanie dokumentami, DMS | `DMS` | -| procesy workflow | `Workflow` | - -## 4. Typowe scenariusze krok po kroku - -### Scenariusz A — Odczyt danych z listy - -``` -1. navigate_to_folder(programFolder) — otwórz folder -2. retrieve_list(filters?, pageNumber?) — pobierz dane (opcjonalnie z filtrami) -3. Prezentuj wyniki użytkownikowi -``` - -### Scenariusz B — Podgląd szczegółów obiektu - -``` -1. navigate_to_folder(programFolder) — otwórz folder -2. retrieve_list() — pobierz listę, znajdź objectID -3. open_form(objectID) — otwórz formularz -4. switch_form_page(pageID) — przełącz zakładkę jeśli potrzeba -``` - -### Scenariusz C — Edycja istniejącego obiektu - -``` -1. navigate_to_folder(programFolder) — otwórz folder -2. retrieve_list() — znajdź obiekt -3. open_form(objectID) — otwórz formularz -4. switch_form_page(pageID) — przejdź do zakładki z polem (jeśli trzeba) -5. update_field_value(["fieldID=value"]) — zmień wartość pola oznaczonego 'edytowany' -``` - -### Scenariusz D — Dodawanie nowego obiektu - -``` -1. navigate_to_folder(programFolder) — otwórz odpowiedni folder -2. add_object() — utwórz nowy obiekt -3. update_field_value(["fieldID=value"]) — wypełnij wymagane pola -``` - -### Scenariusz E — Przeglądanie dużej listy (stronicowanie) - -``` -1. navigate_to_folder(programFolder) -2. retrieve_list(pageNumber=0) — pierwsza strona -3. retrieve_list(pageNumber=1) — kolejna strona -4. ... kontynuuj aż dane się wyczerpią -``` - -### Scenariusz F — Nawigacja eksploracyjna (nieznany folder) - -``` -1. get_modules() — lista modułów -2. get_folders(moduł) — foldery w module -3. get_folders(moduł/podfolder) — dalsze podfoldery (jeśli type=folders) -4. navigate_to_folder(znaleziony_folder) — otwórz właściwy folder -``` - -## 5. Zasady bezpieczeństwa - - -- **Edytuj tylko pola** oznaczone jako `edytowany` — nie próbuj wymuszać zmian na polach tylko do odczytu -- **Nie zakładaj filterID filtrów** — odczytaj je z odpowiedzi `retrieve_list` -- **Nie zakładaj fieldID zmienianych pól** — odczytaj je z odpowiedzi `open_form`, `switch_form_page`, `add_object` -- **Edytuj tylko pola na aktualnej zakładce** — odczytaj je z odpowiedzi `open_form`, `switch_form_page`, `add_object`. Żeby zmienić pole na innej zakładce użyj `switch_form_page` -- **Stronicowanie** — używaj `pageNumber` do iteracji po dużych listach, nie próbuj pobrać wszystkiego naraz - -## 6. Obsługa błędów - -| Problem | Rozwiązanie | -|---|---| -| `navigate_to_folder` zwraca błąd | Sprawdź ścieżkę przez `get_folders` — ścieżka może być nieprawidłowa | -| Lista jest pusta | Zasugeruj zmianę lub usunięcie filtrów | -| Pole nie jest `edytowany` | Poinformuj użytkownika — pole jest tylko do odczytu | -| Brak `objectID` | Najpierw wykonaj `retrieve_list` aby uzyskać identyfikatory | -| Brak `pageID` | Najpierw wykonaj `open_form` aby uzyskać listę zakładek | -| Nieznany folder | Użyj `get_modules` → `get_folders` do eksploracji struktury | - -## 7. Parametr navigate_to_folder — newTab - -- `newTab: true` — otwiera folder w nowej karcie (nie zamyka aktualnego widoku) -- `newTab: false` (domyślnie) — zastępuje aktualny widok -- Używaj `newTab: true` gdy użytkownik chce porównać dane z dwóch folderów