Skille zawierają dokumentację i wzorce programistyczne, które pozwalają asystentom AI efektywnie pomagać w tworzeniu dodatków dla systemu enova365. Dzięki nim AI rozumie specyfikę platformy Soneta: mapowanie obiektowo-relacyjne, strukturę modułów, zarządzanie sesjami i transakcjami.

📦 Dostępne skille

1. soneta-programming-basics

Fundamentalne klasy ORM platformy enova365/Soneta Enterprise.

Zakres:

Mapowanie obiektowo-relacyjne (Row, Table, Module)
Zarządzanie sesją (Session) i transakcjami biznesowymi
Logowanie i dostęp do bazy (Login, Database, BusApplication)
Paczki danych (Datapack, GuidedRow) i synchronizacja
Kontekst aplikacji (Context)

Kiedy używać:

Pytania o podstawowe klasy logiki biznesowej
Praca z sesjami i transakcjami
Tworzenie, modyfikacja i usuwanie obiektów
Zrozumienie hierarchii Row → Table → Module

2. enova365-business-xml

Generator plików business.xml definiujących strukturę obiektów biznesowych.

Zakres:

Definiowanie tabel i kolumn
Typy danych (proste, relacyjne, złożone)
Relacje między obiektami (1:N, N:1, polimorficzne)
Klucze i indeksy
Wzorce: słowniki, dokumenty z pozycjami, historia zmian

Kiedy używać:

Tworzenie nowego modułu biznesowego
Definiowanie encji do przechowywania w bazie
Tworzenie relacji między obiektami
Generowanie plików *.business.xml

🚀 Instalacja

Claude Desktop / Claude.ai

Skopiuj folder ze skillem do katalogu skills w konfiguracji Claude.

Cursor / Windsurf / inne IDE

Dodaj zawartość skilli do kontekstu projektu lub rules.

📁 Struktura repozytorium

soneta-ai-skills/
├── README.md
├── soneta-programming-basics/
│   ├── SKILL.md                    # Główna dokumentacja
│   └── references/
│       ├── session-login.md        # BusApplication, Database, Login, Session
│       ├── datapack-guidedrow.md   # Paczki danych, GuidedRow, synchronizacja
│       ├── context.md              # Klasa Context, komunikacja UI ↔ logika
│       └── examples.md             # Przykłady kodu i wzorce użycia
│
└── enova365-business-xml/
    ├── SKILL.md                    # Główna dokumentacja
    ├── assets/
    │   └── business_struct.xsd     # Schemat XSD dla walidacji
    └── references/
        ├── modules-catalog.md      # Katalog modułów enova365
        ├── table-reference.md      # Dokumentacja atrybutów table i col
        ├── relations-guide.md      # Tworzenie relacji między obiektami
        └── examples.md             # Przykłady z rzeczywistych modułów

💡 Przykłady użycia

Tworzenie nowego obiektu

using (var session = login.CreateSession(false, false, "Dodawanie"))
{
    var tm = session.GetTowary();
    
    using (var transaction = session.Logout(editMode: true))
    {
        var towar = new Towar();
        tm.Towary.AddRow(towar);
        towar.Kod = "NOWY001";
        towar.Nazwa = "Nowy towar";
        transaction.Commit();
    }
    
    session.Save();
}

Definicja obiektu w business.xml

<table name="Towar" tablename="Towary" guided="Root" 
       caption="Towar" tablecaption="Towary">
  <key name="WgKodu" keyunique="true" keyprimary="true">
    <keycol name="Kod"/>
  </key>
  <col name="Kod" type="string" length="100" required="true"/>
  <col name="Nazwa" type="string" length="200" required="true"/>
  <col name="Cena" type="currency"/>
</table>

🔗 Powiązania między skillami

Skille są zaprojektowane do współpracy:

enova365-business-xml → definiuje strukturę obiektów
soneta-programming-basics → pokazuje jak pracować z wygenerowanymi klasami

Generator BusinessGenerator automatycznie tworzy klasy C# z plików *.business.xml podczas kompilacji projektu.

📝 Konwencje nazewnicze

Element	Konwencja	Przykład
Klasa wiersza	PascalCase, l.poj.	`Towar`, `Kontrahent`
Klasa tabeli	PascalCase, l.mn.	`Towary`, `Kontrahenci`
Klasa modułu	Nazwa + Module	`TowaryModule`
Klucz	Wg + nazwa kolumny	`WgKodu`, `WgNazwy`
Namespace	Soneta.NazwaModułu	`Soneta.Towary`

Obiekty biznesowe (domenowe) nazywane są po polsku: Towar, Faktura, Kontrahent. Obiekty systemowe (techniczne) po angielsku: Session, Context, Row.

🤝 Współpraca

Zapraszamy do zgłaszania issues i pull requestów. Szczególnie cenne są:

Nowe przykłady kodu
Poprawki w dokumentacji
Dodatkowe wzorce programistyczne

📄 Licencja

MIT

README.md

Soneta ORM AI Skills

🎯 Cel projektu