Kowal_Task to moduł Magento 2 dla firm, które realizują prace projektowe, rozliczają czas pracy i chcą prowadzić zadania klientów bez opuszczania Magento. Moduł łączy prostą ewidencję zadań, wpisy czasu, panel klienta, eksport CSV, REST API oraz generowanie zamówień Magento ze statusem pending, na podstawie których administrator może ręcznie wystawić fakturę w standardowym procesie Magento.

Rozwiązanie jest przeznaczone dla software house’ów, freelancerów, agencji e-commerce, zespołów wsparcia technicznego i firm usługowych pracujących na Magento 2. Jeżeli rozliczasz klientów godzinowo, prowadzisz projekty i na koniec miesiąca przygotowujesz zestawienie czasu pracy do faktury, Kowal_Task porządkuje ten proces w jednym miejscu.

Najważniejsza korzyść

Zamiast prowadzić zadania w zewnętrznej aplikacji, eksportować CSV, ręcznie sumować godziny i osobno przygotowywać faktury, możesz obsłużyć cały proces w Magento:

dodajesz klienta, projekt i zadania,
zapisujesz czas pracy przy zadaniach,
zatwierdzasz wpisy czasu do rozliczenia,
generujesz zamówienie Magento ze statusem pending,
ręcznie wystawiasz fakturę z zamówienia,
zachowujesz historię rozliczeń, zamówień i faktur przy wpisach czasu.

Dla kogo jest Kowal Task?

Moduł sprawdzi się szczególnie wtedy, gdy:

rozliczasz klientów za prace godzinowe,
obsługujesz wiele projektów dla jednego klienta,
potrzebujesz widoku klient → projekt → zadanie,
chcesz udostępnić klientowi podgląd zgłoszeń w jego koncie Magento,
chcesz pozwolić klientowi zlecać zadania z panelu klienta,
potrzebujesz eksportu CSV do kontroli, księgowości albo raportowania,
chcesz integrować zadania z aplikacją desktopową, CRM lub innym systemem przez REST API,
chcesz generować zamówienia Magento na podstawie zaakceptowanych wpisów czasu, ale faktury wystawiać ręcznie.

Jak działa moduł?

Kowal_Task organizuje dane w prostej strukturze drzewa:

klient,
projekt,
zadanie,
wpisy czasu przypisane do zadania.

Każde zadanie ma temat, opis, status, źródło utworzenia oraz historię czasu pracy. Wpis czasu może być dodany ręcznie albo zapisany przez timer. Administrator może zatwierdzić wpisy czasu, oznaczyć je jako nierozliczane, wyeksportować dane do CSV albo przygotować zamówienie rozliczeniowe.

Po wygenerowaniu zamówienia wpisy czasu są blokowane przed zwykłą edycją, co ogranicza ryzyko rozjazdu danych rozliczeniowych. Po ręcznym wystawieniu faktury w Magento moduł synchronizuje status wpisów czasu z fakturą.

Funkcje modułu

Zadania i projekty klientów

struktura klient → projekt → zadanie,
projekty przypisane do natywnych kont klientów Magento,
zadania tworzone przez administratora albo klienta,
statusy zadań: nowe, zaakceptowane, w trakcie, wykonane, odrzucone i zarchiwizowane,
opis zadania i krótka historia pracy,
komentarze do zadań,
komentarze wewnętrzne widoczne tylko dla administratorów,
załączniki do zadań,
załączniki wewnętrzne niewidoczne dla klienta.

Ewidencja czasu pracy

wiele wpisów czasu dla jednego zadania,
ręczne dodawanie liczby minut,
opcjonalny timer pracy na zadaniu,
opis wpisu czasu,
statusy rozliczenia: szkic, zatwierdzone, w zamówieniu, zafakturowane, nierozliczane i zarchiwizowane,
blokada zwykłej edycji wpisów przypisanych do zamówienia lub faktury,
audit log dla operacji wpływających na rozliczenia.

Rozliczenia w Magento

globalna stawka godzinowa w konfiguracji modułu,
globalna waluta rozliczeń,
możliwość nadpisania stawki i waluty na poziomie projektu,
konfiguracja produktu usługowego używanego do pozycji zamówienia,
zaokrąglanie czasu według ustawień modułu,
podgląd rozliczenia przed utworzeniem zamówienia,
generowanie natywnego zamówienia Magento ze statusem pending,
ręczne wystawianie faktury z zamówienia w standardowym panelu Magento,
synchronizacja statusu wpisów czasu po wystawieniu faktury.

Panel klienta

Klient może pracować z modułem bez dostępu do panelu administratora Magento. W swoim koncie widzi przypisane projekty i zadania, może zgłosić nowe zadanie, dodać komentarz, przesłać załącznik oraz pobrać CSV z widocznymi danymi.

Widoczność danych w panelu klienta można kontrolować z konfiguracji modułu, między innymi dla kwot oraz wpisów czasu, które nie trafiły jeszcze do zamówienia albo faktury.

Admin SPA na KnockoutJS

Codzienna obsługa modułu w panelu administratora została zaprojektowana jako szybki ekran SPA oparty o KnockoutJS i natywne mechanizmy Magento Admin. Administrator może z jednego widoku przeglądać drzewo klientów, dodawać projekty, tworzyć zadania, dopisywać czas, zatwierdzać wpisy, obsługiwać komentarze, załączniki, raporty i przygotowanie zamówień.

REST API dla integracji

Kowal_Task udostępnia REST API przez natywny mechanizm webapi.xml Magento. Dzięki temu moduł może być obsługiwany przez:

prostą aplikację desktopową na macOS lub Windows,
zewnętrzny CRM,
narzędzia raportowe,
automatyzacje firmowe,
integracje z systemami obsługi zgłoszeń.

API korzysta z service contracts i natywnej autoryzacji Magento. Można używać tokenów integracyjnych, tokenów administratora oraz tokenów klienta w zakresie jego własnych danych.

Eksport CSV i raporty

Moduł zachowuje praktyczną ścieżkę rozliczeniową przez CSV. Administrator może eksportować dane według filtrów klienta, projektu, daty, statusu zadania, statusu rozliczenia i użytkownika administracyjnego. CSV zawiera między innymi dane klienta, projekt, zadanie, opis pracy, minuty, godziny, stawkę, walutę, kwotę, numer zamówienia i numer faktury.

Dlaczego rozliczenie przez zamówienie Magento?

Kowal_Task nie buduje osobnego systemu faktur obok Magento. Zamiast tego wykorzystuje natywny model sprzedażowy:

wpisy czasu są źródłem danych,
moduł tworzy zamówienie Magento ze statusem pending,
administrator sprawdza zamówienie,
faktura jest wystawiana ręcznie w standardowym workflow Magento,
moduł synchronizuje wpisy czasu z fakturą.

To podejście jest stabilniejsze i łatwiejsze do utrzymania, ponieważ bazuje na mechanizmach Magento: klientach, zamówieniach, fakturach, produktach usługowych, ACL, konfiguracji, cron i REST API.

Przykładowy scenariusz użycia

Agencja e-commerce obsługuje sklep klienta na Magento 2. Klient zgłasza zadanie z poziomu konta klienta: „Poprawić walidację formularza checkout”. Administrator akceptuje zadanie, programista dodaje kilka wpisów czasu, a po zakończeniu miesiąca administrator filtruje zatwierdzone wpisy i generuje zamówienie pending.

Zamówienie zawiera pozycję usługi wyliczoną na podstawie czasu pracy, stawki godzinowej i waluty projektu. Administrator sprawdza dane i ręcznie wystawia fakturę w Magento. Wpisy czasu otrzymują status invoiced, a historia pozostaje dostępna przy zadaniu, projekcie i kliencie.

Podsumowanie

Kowal_Task porządkuje rozliczanie prac projektowych w Magento 2. Moduł łączy zadania, czas pracy, portal klienta, raporty CSV, REST API i natywne zamówienia Magento w jeden proces. Dzięki temu łatwiej kontrolować, co zostało wykonane, ile czasu zajęło, co zostało zaakceptowane do rozliczenia i które wpisy trafiły już do zamówienia lub faktury.