Struktura pakietów branżowych¶
Zasada kompozycji¶
Pakiet branżowy nie jest osobnym forkiem NORBI. Jest wersjonowanym, podpisanym zestawem manifestów agentów, tools/plugins, workflow, schema domenowych, polityk, datasetów testowych, UI views, dokumentacji i profili sprzętu. Korzysta z tego samego Execution Fabric i nie może osłabić twardych invariantów.
Warstwy pakietu¶
flowchart TB
C["NORBI Core + Execution Fabric"] --> B["Pakiet bazowy organizacji"]
B --> D["Pakiet branżowy"]
D --> L["Lokalizacja: kraj/język/prawo"]
L --> O["Konfiguracja konkretnego klienta"]
Core¶
Jobs, workflows, approvals, artifacts, memory, registries, identity, audit, workers i Control Center. Pakiet nie zastępuje tych komponentów.
Pakiet bazowy organizacji¶
Office, communication, accounts, projects, standardowe role, backup, monitoring i wspólne policy. Stanowi fundament dla kilku domen.
Pakiet branżowy¶
Modele danych, workflow, adaptery, terminologia, testy i dashboardy danej branży: hotel, studio, magazyn, księgowość, budownictwo itd.
Lokalizacja¶
Język, timezone, formaty, profile podatkowe/prawne, święta i wymagane disclosures. Ma ownera, jurysdykcję i valid date. Nie jest generowana raz na zawsze przez model.
Konfiguracja klienta¶
Mapowanie systemów, kont, ról, progów, grafików, brandu i wyjątków. Jest oddzielona od pakietu, aby aktualizacja nie nadpisała polityki klienta.
Zawartość manifestu¶
- identity, version, publisher, license, support i podpis;
- minimalna/kompatybilna wersja platformy;
- data schemas i migrations;
- agents/tools/workflows z wersjami;
- wymagane capabilities i approvals;
- accounts/destinations/network requirements;
- UI routes/widgets i PWA roles;
- model profiles i hardware sizing;
- test fixtures, benchmarks, hard gates;
- retention/classification defaults;
- known limitations, rollback i uninstall behavior;
- dokumentacja dla operatora, użytkownika i auditora.
Przykładowa macierz pakietów¶
| Pakiet | Workflow podstawowe | Integracje typowe | Najważniejszy gate |
|---|---|---|---|
| Office | raport, oferta, meeting follow-up | Office, mail, calendar | źródła i send separation |
| Studio | brief→preview→master | Adobe, DaVinci, Blender | rights + technical QC |
| Hotel | rezerwacja, housekeeping, dyżur | PMS, phone, PWA | availability/price/identity |
| Warehouse | receiving, pick, load, discrepancy | WMS, scanner, camera | triangulacja i no auto-adjust |
| Service | intake, diagnosis, quote, completion | phone, inventory, PWA | zgoda zakresu/kosztu |
| Finance Ops | invoice, reconciliation, reporting | ERP/accounting/bank read | amount/account/duplicate |
| Facility | ticket, inspection, vendor, energy | BMS/IoT, calendar, phone | access, SLA, physical safety |
| Home | concierge, routines, alerts | devices, calendar, voice | interlock i manual override |
SKU produktu¶
Pakiet może mieć poziomy:
- Essentials — read-only, drafty, podstawowe workflow i self-managed;
- Professional — typowane integracje, A2, branżowe dashboardy, więcej użytkowników;
- Autonomy — certyfikowane A3/A4, shadow/canary, monitoring i rozbudowany audit;
- Critical — redundancja, recovery hardware, 24/7 service i wymagane drills.
Nazwa SKU nie nadaje automatycznie capabilities. Każda instalacja aktywuje konkretne role i zakresy.
Instalacja i aktualizacja pakietu¶
Candidate package trafia do quarantine. Weryfikowane są podpis, SBOM, schema, migrations, capabilities diff, network/accounts i testy. Na stagingu wykonuje się sample workflow. Operator zatwierdza instalację, a osobno aktywuje agents/tools/triggers. Aktualizacja może migrować schema, lecz ustawienia klienta są merge'owane przez jawny kontrakt. Rollback nie usuwa nowych danych.
Model ekonomiczny pakietów¶
Przychód może obejmować licencję, wdrożenie, connector fee, certyfikowane aktualizacje, support i partner revenue share. Dataset klienta nie staje się automatycznie własnością wydawcy. Telemetria jakości jest opt-in i zminimalizowana. Pakiet musi oferować eksport danych i odpięcie integracji.
Walidacja i scenariusz awaryjny¶
Pakiet przechodzi testy core invariants, domenowe, localization, performance, migration/rollback, offline i security. Certyfikat wiąże exact wersje. Naruszenie twardej bramki zawiesza dotknięte narzędzie, niekoniecznie cały pakiet. Przy wycofaniu wydawcy klient zachowuje dane, artifacts i dokumentację; aktywne workflow mogą działać na ostatniej bezpiecznej wersji w określonym support window albo przejść read-only.