Revised:
1. Model autoryzacji
Serwer działa jako zasób OAuth 2.1: przepływ authorization code z obowiązkowym PKCE (S256), dynamiczna rejestracja klientów dla asystentów, tokeny dostępu i odświeżania oraz punkt końcowy do unieważniania (revocation). Dokumenty discovery są publikowane pod standardowymi adresami well-known na tym samym hoście.
2. Zakresy i role
Dostępne są cztery zakresy tylko do odczytu: catalog.read, inventory.read, orders.read oraz account.read, oraz dwa zakresy zapisu: catalog.write i inventory.write. Zakresy zapisu otrzymują tylko właściciele i administratorzy. Narzędzie jest widoczne dla asystenta tylko wtedy, gdy pozwalają na to przyznany zakres i Twoja rola, więc magazynier nigdy nie zobaczy danych dostępnych tylko dla właściciela.
3. Izolacja organizacji (tenanta)
Każde wywołanie działa w kontekście zalogowanego użytkownika w ramach dokładnie jednej firmy. Wykorzystywany jest ten sam kod uprawnień, walidacji i izolacji, co w aplikacji webowej; nie ma osobnej ścieżki danych dla asystentów.
4. Zmiany tylko z podglądem i potwierdzeniem
Narzędzia zapisu najpierw zwracają podgląd starych i nowych wartości, a zapisują dopiero po ponownym wywołaniu z confirm=true i aktualną wersją produktu, więc nieaktualne lub przypadkowe wywołanie nie nadpisze nowszych danych. Jedno wywołanie zmienia jeden produkt, niczego nie można usunąć, a WareRushAI może w każdej chwili wyłączyć wszystkie zmiany asystentów dla całej platformy.
5. Audyt i odwoływanie dostępu
Każde wywołanie narzędzia jest rejestrowane wraz z nazwą narzędzia, wynikiem i czasem trwania. Możesz w każdej chwili odebrać uprawnienia asystentowi, a unieważnione tokeny natychmiast przestają działać.
6. Minimalizacja danych
Narzędzia zwracają zwięzłe podsumowania i tylko te pola, których asystent faktycznie potrzebuje; szczegóły są pobierane na żądanie. W przypadku przetwarzania danych przez dostawcę asystenta zastosowanie mają regulamin i polityka prywatności tego dostawcy.
