Marcin Wojas
4.5 KiB
4.5 KiB
name, description
| name | description |
|---|---|
| soneta-addon-planning | Planowanie projektów dodatków dla platformy enova365/Soneta Enterprise. Tworzy kompletną dokumentację projektową obejmującą: strukturę danych (tabele, relacje), elementy konfigurowalne, definicje list i menu, formularze, workery i raporty. Używaj gdy użytkownik prosi o zaplanowanie nowego modułu/dodatku enova365, przygotowanie założeń projektu, stworzenie specyfikacji funkcjonalnej dodatku, lub zdefiniowanie struktury danych i interfejsu użytkownika dla nowego modułu. |
Soneta Addon Planning
Skill do tworzenia planów projektów dodatków dla platformy enova365. Plan projektu stanowi podstawę do dalszych prac implementacyjnych z wykorzystaniem skilli enova365-business-xml i soneta-programming-basics.
Struktura planu projektu
Plan projektu dodatku enova365 składa się z następujących sekcji:
1. Założenia projektu
- Cel biznesowy dodatku
- Zakres funkcjonalny (co dodatek ma robić)
- Elementy konfigurowalne na etapie wdrożenia
- Integracje z istniejącymi modułami enova365
- Ograniczenia i wymagania niefunkcjonalne
2. Model danych
- Lista tabel z podziałem na operacyjne i konfiguracyjne
- Pola każdej tabeli (nazwa, typ, wymagalność, opis)
- Relacje między tabelami (diagram lub lista)
- Klucze i indeksy
3. Struktura menu modułu
- Hierarchia list w menu głównym
- Grupowanie funkcjonalne
4. Definicje list
Dla każdej listy:
- Filtry (pola filtrujące, filtry predefiniowane)
- Kolumny (kolejność, szerokość, formatowanie)
- Czynności (workery) - nazwa i krótki opis
- Raporty/wydruki - nazwa i krótki opis
5. Definicje formularzy
Dla każdego formularza obiektu:
- Zakładki (grupowanie logiczne)
- Pola na zakładkach (pogrupowane)
- Listy szczegółów (sublists) z kolumnami
- Czynności (workery) dostępne z formularza
- Raporty/wydruki dostępne z formularza
6. Słowniki i konfiguracja
- Tabele słownikowe (config=true)
- Wartości domyślne
- Parametry konfiguracyjne modułu
7. Uprawnienia
- Role użytkowników
- Prawa dostępu do obiektów i funkcji
Workflow tworzenia planu
1. Zebranie wymagań
↓
2. Zdefiniowanie założeń i elementów konfigurowalnych
↓
3. Zaprojektowanie modelu danych
↓
4. Określenie struktury menu
↓
5. Zdefiniowanie list (filtry, kolumny, akcje)
↓
6. Zdefiniowanie formularzy (zakładki, pola, sublists)
↓
7. Określenie słowników i konfiguracji
↓
8. Zdefiniowanie uprawnień
Format dokumentu planu
Plan projektu generowany jest jako dokument Markdown z następującą strukturą:
# Plan projektu: [Nazwa dodatku]
## 1. Założenia projektu
### 1.1. Cel biznesowy
### 1.2. Zakres funkcjonalny
### 1.3. Elementy konfigurowalne
### 1.4. Integracje
### 1.5. Ograniczenia
## 2. Model danych
### 2.1. Tabele operacyjne
### 2.2. Tabele konfiguracyjne
### 2.3. Diagram relacji
## 3. Struktura menu
### 3.1. Menu główne modułu
## 4. Listy
### 4.1. [Nazwa listy]
#### Filtry
#### Kolumny
#### Czynności
#### Raporty
## 5. Formularze
### 5.1. [Nazwa formularza]
#### Zakładki i pola
#### Listy szczegółów
#### Czynności
#### Raporty
## 6. Słowniki i konfiguracja
## 7. Uprawnienia
Konwencje nazewnicze
| Element | Konwencja | Przykład |
|---|---|---|
| Tabela operacyjna | PascalCase, l.poj. | Zlecenie, PozycjaZlecenia |
| Tabela konfiguracyjna | PascalCase, l.poj. | DefinicjaZlecenia, StatusZlecenia |
| Worker | PascalCase + Worker | ZatwierdzZlecenieWorker |
| Raport | PascalCase | ZestawienieZlecen, KartaZlecenia |
| Lista | l.mn. lub opis | Zlecenia, ZleceniaDoRealizacji |
Poziom szczegółowości
Plan projektu zawiera ogólne opisy elementów:
- Nazwy i krótkie opisy (1-2 zdania)
- Typy danych bez szczegółów implementacyjnych
- Logiczne grupowanie bez dokładnych pozycji
Szczegóły doprecyzowywane w kolejnych etapach:
- Dokładne atrybuty kolumn (długość, walidacje)
- Implementacja workerów (algorytmy, kroki)
- Szablony raportów (układ, pola)
- Warunki filtrów (wyrażenia, wartości domyślne)
Powiązanie z innymi skillami
Po zatwierdzeniu planu projektu:
- enova365-business-xml - generowanie pliku business.xml na podstawie modelu danych
- soneta-programming-basics - implementacja workerów i logiki biznesowej
Szczegółowa dokumentacja
- references/project-template.md - pełny szablon dokumentu planu projektu
- references/checklist.md - lista kontrolna kompletności planu