- Mire való? A rendszer határának kijelölése: mely külső entitásokkal és milyen áramlásokkal (adat, jel, anyag, energia, tevékenység) áll kapcsolatban a rendszer, és mi nem tartozik a fejlesztés tárgyához.
- Tanulási eredmény: az eszközlap feldolgozása után képes leszel kijelölni egy rendszer határát, felrajzolni a kontextusdiagramját, és a határon átmenő kölcsönhatásokat típus szerint besorolni és interfészlistába rendezni.
- V-lépés: 1. Probléma; a követelmények (interfészkövetelmények) és az integráció bemenete.
- Bemenet: a fejlesztési feladat leírása, az érdekelt felek első listája, a meglévő folyamatok és rendszerek ismerete.
- Kimenet: kontextusdiagram, interfészlista gazdákkal, a „mi nem a rendszer része” rögzítése.
- Időigény: az első változat 1–2 óra csapatmunka; a pontosítás az érdekelt felekkel folyamatos.
- Kézikönyv: 3. fejezet, 3.3. szakasz.
3.1. Mikor használd?
- A projekt legelején, amikor még a feladat megfogalmazása zajlik. A kontextusdiagram az egyik leggyorsabb módja annak, hogy a csapat és a megrendelő ugyanazt értse „a rendszeren”.
- Ha vita van arról, mi tartozik a fejlesztéshez. A diagramon minden, ami a középső alakzaton kívül van, a környezet része. Ezt nem tervezzük meg, de illeszkednünk kell hozzá.
- Beszállítói egyeztetéskor, ajánlatkéréskor. A diagram és az interfészlista egyértelművé teszi, mit kell a szállítónak megvalósítania, és mihez kell kapcsolódnia.
- Integráció és átadás előtt. Az interfészlista minden sora egy ellenőrizendő kapcsolat.
3.2. Lépések
- Nevezd meg a rendszert a feladata szerint. Ne a megoldást nevezd meg („MES”, „mobilalkalmazás”), hanem azt, amit a rendszernek el kell végeznie („rendelésteljesítési rendszer”, „közösségi kerékpár-szolgáltatás”). Így a név nem zárja ki idő előtt a lehetséges megoldásokat.
- Gyűjtsd össze a külső entitásokat. Forrásaid: az érdekeltfél-lista (4. eszközlap), a befoglaló rendszer elemei, az életciklus-szakaszok (ki szállít, ki szervizel, ki selejtez), valamint a meglévő informatikai rendszerek. Az entitás lehet szervezet, szereplő, másik rendszer vagy természeti környezet.
- Rögzítsd a kölcsönhatásokat. Minden entitásnál kérdezd meg: mi megy át a határon, milyen irányba, és milyen típusú? A típusok: adat (feldolgozandó információ), jel (reakciót igénylő állapot vagy esemény), anyag, energia, tevékenység (egy külső szereplő munkája a rendszeren) (Kossiakoff és mtsai. 2011, 3.4. szakasz).
- Címkézz konkrétan, és használj egyirányú nyilakat. Az „adatcsere a bankkal” helyett két nyíl: „fizetési kérelem” kifelé, „fizetési visszaigazolás” befelé. Az olyan címkék, mint az „adat” vagy a „kommunikáció”, semmit sem mondanak.
- Ellenőrizd táblázattal. Az interfészlistából számold meg entitásonként a bemeneteket és a kimeneteket. A csak bemenettel vagy csak kimenettel rendelkező entitásnál gondold végig, nem maradt-e ki egy visszairányú áramlás (visszaigazolás, rendelés, elszámolás). Nézd meg azt is, kimaradt-e valamilyen környezeti hatás: hulladék, kibocsátás, zaj. Ha hiányt találsz, térj vissza a 2. lépéshez.
- Egyeztesd az érdekelt felekkel. A diagramot mutasd meg a megrendelőnek és a legfontosabb érdekelteknek. A „kimaradt valami?” kérdésre adott válaszok gyakran a projekt legértékesebb információi.
- Vezesd tovább az interfészlistát. Minden sorhoz rendelj gazdát (ki felel érte), és később kapcsolódó követelményt (9. eszközlap). A belső interfészeket az N²-diagram tárja fel (14. eszközlap).
Az interfészlistában azt is rögzítheted, milyen elem valósítja meg a kapcsolatot. Kossiakoff és szerzőtársai szerint az összekötő átviszi a hatást (kábel, tengelykapcsoló, kezelőpanel), a szigetelő gátolja (árnyékolás, tömítés, védőburkolat), az átalakító megváltoztatja a közeg formáját (A/D átalakító, hajtómű, billentyűzet) (Kossiakoff és mtsai. 2011, 3.5. szakasz). A külső interfészeknél ez a mező a koncepció szakaszában gyakran még üres; ilyenkor „–” jelet írj.
3.3. Kidolgozott példa: a VárosiBringa kontextusdiagramja
A projektcsapat a rendszert VárosiBringa közösségi kerékpár-szolgáltatásnak nevezte el. A szolgáltatás része a flotta, a dokkolók, az alkalmazás, a háttérrendszer, a szerviz és az áthelyező szolgálat. A határ kijelölésekor a legfontosabb döntés az volt, hogy az áthelyezés és a szerviz a rendszer része, akkor is, ha a konzorcium később alvállalkozóra bízza. A szolgáltatás minőségét ugyanis ezek határozzák meg.
A csapat kilenc külső entitást és tizennyolc kölcsönhatást azonosított (3.1. táblázat, a sablon „Példa –” lapjain teljes egészében).
| Külső entitás | Kölcsönhatás | Irány | Típus |
|---|---|---|---|
| Felhasználók | kölcsönzési kérés (alkalmazás vagy kártya) | be | adat |
| Felhasználók | kölcsönzési visszaigazolás, díjtájékoztatás | ki | adat |
| Felhasználók | feltöltött elektromos kerékpár | ki | anyag |
| Felhasználók | visszahozott kerékpár | be | anyag |
| Felhasználók | hibabejelentés | be | adat |
| Fizetési szolgáltató | fizetési kérelem / fizetési visszaigazolás | ki / be | adat |
| Helyi közlekedési társaság | érvényes bérletek listája / közös bérletes kölcsönzések elszámolása | be / ki | adat |
| Önkormányzat | közterület-használati engedély / használati és kibocsátási jelentés | be / ki | adat |
| Energiaszolgáltató | villamos energia a dokkolóknak | be | energia |
| Navigációs szolgáltatók | állomások helye, szabad kerékpárok száma | ki | adat |
| Rendőrség | lopás- és rongálásbejelentés | ki | adat |
| Kerékpár-beszállító | pótalkatrész-rendelés / pótalkatrész, garanciális javítás | ki / be | adat / anyag |
| Akkumulátor-újrahasznosító | elhasznált akkumulátorok | ki | anyag |
Tanulságok:
- Az ellenőrzés talált hiányt. Az első változatban a kerékpár-beszállító csak bemenetként szerepelt („pótalkatrész, garanciális javítás”). A táblázat „csak bemenet – rendben?” jelzésére a csapat rájött, hogy a pótalkatrész-rendelés és a garanciális igény bejelentése kimaradt. Ezek nélkül a szerviz nem tud működni, és mindkettő a háttérrendszer feladata.
- Nem minden jelzés hiba. Az energiaszolgáltató felé valóban nem megy semmi, a navigációs szolgáltatók felől pedig nem érkezik semmi. A csapat ezeket tudatosan jóváhagyta.
- A környezeti hatás is interfész. Az akkumulátor-újrahasznosító eredetileg nem szerepelt. A környezetvédő civilek érdekeltfél-interjúján derült ki, hogy az elhasznált akkumulátorok sorsa számukra kulcskérdés. Az interfész jogszabályi nyilvántartási kötelezettséggel is jár.
- Ami nincs a diagramon, az nem a rendszer része. A buszhálózat menetrendjét, a város parkolási rendszerét és a navigációs alkalmazásokat a VárosiBringa nem tervezi újra, de a velük való kapcsolatát igen.
3.4. Sablon és notebook
- kontextusdiagram_sablon.xlsx: az „Interfészlista” lapon legördülő listák (irány, típus, interfészelem) és automatikus ellenőrzés (hiányzó adat, túl általános címke, gazda nélküli sor). Az „Entitások” lap entitásonként megszámolja a bemeneteket, a kimeneteket és a típusokat, és jelzi a gyanús eseteket. A „Példa –” lapok a VárosiBringa kitöltött listáit tartalmazzák.
- kontextusdiagram.ipynb · Megnyitás Google Colabban: az interfészlistából automatikusan felrajzolja a kontextusdiagramot (a 3.2. ábra így készült), és elvégzi a táblázatos ellenőrzéseket. A beépített példával azonnal futtatható. A saját, kitöltött sablon feltöltéséhez állítsd a
SAJAT_SABLONváltozótTrueértékre.
3.5. Előnyök és korlátok
| Előnyök | Korlátok |
|---|---|
| Egyszerű, gyorsan elkészíthető, bárki számára érthető | Nem mutatja a rendszer belsejét, sem az áramlások időbeli sorrendjét |
| A határvita korán, olcsón lezárható | Sok entitásnál és kölcsönhatásnál zsúfolttá válik; ilyenkor bontsd több nézetre |
| Az interfészlistából közvetlenül követelmények és integrációs tesztek vezethetők le | A minőségi jellemzőket (gyakoriság, késleltetés, adatformátum) csak az interfészlista tartalmazza |
| A hiányzó érdekelt feleket és környezeti hatásokat is felszínre hozza | Csak annyira teljes, amennyire a csapat tudása; az érdekelt felekkel való egyeztetés nem hagyható el |
- Megoldás a középen. Ha a középső alakzat neve „MES-szoftver”, a diagram már a megoldást rögzíti, és kimaradnak belőle az emberek és az eljárások.
- Belső részletek a fekete dobozban. Ha a középső alakzatba alrendszereket rajzolsz, az már architektúra, nem kontextus.
- Kétirányú, semmitmondó nyilak. Az „adatcsere” nyíl nem mondja meg, mi megy át, és merre.
- A „csendes” entitások kihagyása. A hulladékkezelő, a hatóság, az energiaszolgáltató vagy a karbantartó könnyen kimarad, pedig mindegyiknek van interfésze a rendszerrel.
3.6. Mintapromptok
Az alábbiakban egy fejlesztendő rendszer leírása olvasható.
[IDE ILLESZD BE A LEÍRÁST]
Feladat: készíts interfészlista-vázlatot táblázatban a következő
oszlopokkal: külső entitás | kölcsönhatás (mi megy át a határon) |
irány (be/ki a rendszer szemszögéből) | típus (adat, jel, anyag,
energia, tevékenység).
Szabályok: minden sor egyetlen irány; a címke legyen konkrét
(ne „adat” vagy „kommunikáció”); a rendszer belső elemei NE legyenek
külső entitások. Jelöld csillaggal azokat a sorokat, amelyek nem a
leírásból következnek, hanem a te feltételezéseid.
Ez a kontextusdiagram interfészlistája: [TÁBLÁZAT].
Vizsgáld meg a rendszer teljes életciklusát (beszerzés, telepítés,
üzemeltetés, karbantartás, selejtezés) és a környezeti hatásokat
(hulladék, kibocsátás, zaj, energia). Sorold fel, milyen külső
entitások vagy kölcsönhatások hiányozhatnak, és mindegyiknél írd le,
melyik életciklus-szakaszban vagy hatásnál merül fel. Ne egészítsd ki
a táblázatot; a döntés a csapaté.
3.7. Feladat
Készítsd el saját projekted interfészlistáját a sablonban (legalább hat külső entitás, legalább tizenkét kölcsönhatás), és rajzold fel a kontextusdiagramot kézzel vagy a notebookkal. Az ellenőrző lap minden jelzésénél írd le egy mondatban, miért rendben van, vagy mit egészítettél ki. Mutasd meg a diagramot legalább egy érdekelt félnek, és rögzítsd, mit javasolt.