Mit kérnek
A KMTR JIRA-projekt, a KMTR Confluence-tér és a KMTR SharePoint-specifikációk kerüljenek be az IIER tudástárba.
Kéréstől a termékig
Egy valódi kérés — „a KMTR is legyen az IIER tudástár része" — és ami vele öt nap alatt történt: az első napon mérés, döntés, specifikáció, tesztek, mechanizmus; a másodikon a kapuk, egyenként, emberi kézzel; utána az éles éjszakák, mind a három forrással.
nem ígéret, hanem mérés · spec előbb, mint kód · piros teszt előbb, mint mechanizmus · az ember tart minden kaput
KMTR kérők · Ulyssys kollégák30 min2026. szeptember–októberkérő · admin · platformkérés → termék
1. nap, reggel
A kérés
Egy rövid e-mail a KMTR projekt szervezőjétől, a két projektvezetővel egyeztetve.
Miért
Ma három helyen, három keresővel élnek ezek a dokumentumok; a tudástárban egy helyen, jogosultság szerint szűrve válnának kereshetővé.
Két kérdés
„Elég így a kérés, vagy nyissak jegyet?" — és: „mikor lesz előadás a tudástárról?" (erre ez az előadás a válasz)
Egy perc háttér
Mi az a tudástár?
A források éjszakánként betöltődnek egy tenant-kulcsú korpuszba; a kereső csak azt adja vissza, amire a kérdező jogosult; a Wikipédia a korpuszból generált, ember által jóváhagyott szócikkek; Laura ezekből válaszol.
1. nap, délelőtt
Első lépés: mérés, nem ígéret
A platform technikai fiókjával, a kiszolgálóról, írás nélkül megnéztük, mi érhető el valójában.
| Forrás | Eredmény | Mi következik belőle |
|---|---|---|
| Confluence KMTR-tér | elérhető — több száz oldal, több száz melléklet olvasható | ez az ág indítható |
| JIRA KMTR-projekt | nem elérhető — a technikai fiók nem látja a projektet | Browse jogot kell kérni |
| SharePoint KMTR-tár | nem igazolható kívülről — hitelesítés nélkül minden útvonal ugyanazt válaszolja | az admin erősíti meg |
| jogosultság-export webhook | nincs bekötve — az utolsó sikeres letöltés két hónapja volt, és erről senki nem tudott | ez a legfontosabb lelet |
A negyedik sor nem a KMTR-ről szól. Két hónapja állt egy csendes hiba, mert egy feladat, ami sosem fut, nem tud hibát jelezni.
1. nap, dél
A jegy: ki · mit · miért · ki fogadja el
A kérésből egy alfeladat lett a tudástár gyűjtőjegye alatt — a mérés eredményével és a teendőkkel, felelősönként.
| Lépés | Ki | Mit |
|---|---|---|
| JIRA-jog | JIRA-admin | Browse jog a KMTR-projektre a tudástár technikai fiókjának |
| SharePoint-jog | SharePoint-admin | olvasási jog a KMTR-tárra + a tár pontos útvonala |
| export-csomag | jogosultság-export üzemeltető | KMTR források felvétele a csomagba, végpont + token átadása |
| hatókör | kérő (szervező) | mely tartalom tartozik bele; ki a szakmai elfogadó |
| bekötés | platformgazda | migrációk, betöltő-fa, útvonal, wiki |
| ellenőrzés | platformgazda | a gépi tesztek zöldek, a jogosultság-szűrés helyes |
| elfogadás | kérő + projektvezetők | próbakeresések: a KMTR-tartalom megvan, más nem látja |
1. nap, délután
Döntés: együtt vagy külön?
Az érvek a chatből
- „nem rossz, ha keveredik — a KMTR is az IIER része"
- „Wikipédia-készítéskor nem szerencsés, ha összefésült a forrás"
- „kérdésnél jó, ha tudja, melyik témában keressen"
- „ha külön van és kiderül, hogy nem kényelmes, később össze lehet rakni?" — igen
A döntés
- a KMTR önálló tenant ugyanabban az adatbázisban, ugyanazon technikai fiók alatt
- az elkülönítés szerkezeti: minden sor, minden függvény tenant-kulcsú
- a wiki csak KMTR-forrásból épül — nem fegyelem kérdése, hanem következmény
- a kérdező útvonallal választ témát; az „együtt" később két útvonal egyesítése
Két modell volt az asztalon: projekt-hatókör egy tenanton belül (olcsóbb, de a tisztaságot tesztekkel kell védeni) és külön tenant (több másolat, de a határ maga a mechanizmus). A kérők a másodikat kérték — és igazuk volt.
A blueprint
Spec előbb, mint kód
Minden nem-triviális változás egy hatfájlos specifikációs mappával indul — és a mappa előbb kerül a verziókezelőbe, mint az első kódsor.
brief
Miért és kinek — a probléma, a célok, a siker mércéje. Üzleti nyelven.
requirements
Mit — EARS-mondatok, egyenként tesztelhetők, mindegyik egy célhoz kötve.
design
Hogyan — minden követelményhez a mechanizmus és a bizonyíték.
tasks
Mikor, ki — a munka sorrendje; egy feladat csak zöld ellenőrzéssel és elfogadással zárul.
tests
Honnan tudjuk — a teszt, ami a kód előtt születik és piros.
audit
Mi a kockázat — ellenséges átvizsgálás, elfogadott maradék kockázat, két aláírás.
A követelmény nyelve
EARS — három példa a KMTR-követelményekből
Mindig: a platform minden KMTR-forrást a kmtr tenanthoz irányít útválasztó sorokon keresztül — soha nem egy betöltőbe írt literállal.
Ha … akkor: ha egy KMTR-forrás az útválasztó sora előtt érkezik, akkor a tároló függvény hibát dob, és a futás megáll, mielőtt egyetlen darab is beíródna — soha nem esik vissza az IIER-re.
Amikor: amikor az admin közzéteszi a kmtr csomagot, a betöltő annak forrásait és jogait a kmtr tenant soraiba vetíti, betöltő-módosítás nélkül.
- minden mondat egy tesztté fordítható — ezért nincs „majd meglátjuk"
- a soha és a megáll nem stílus: ezek a hibás viselkedés kizárásai
- a kérő is el tudja olvasni — ez a szerződés, amit átvesz
A bizonyíték a kód előtt
Tesztek előbb — pirosan, aztán zölden
A teszteket a mechanizmus előtt írtuk meg és tettük be a verziókezelőbe. Az első napon pirosak voltak — pontosan ott, ahol kellett; az első nap estéjére zöldek, a JIRA-hozzáférési teszt a 2. nap délutánján.
útválasztás
„KMTR-forrás → kmtr tenant" — piros volt, amíg az útválasztó sorok migrációja nem létezett. Ma zöld, az éles adatbázison is.
a feloldó
„két tenant egy fiók alatt" — piros: a régi kód egy tenantot feltételezett, és a második sornál összeomlott volna. Ezt a teszt találta meg, nem a tervezés.
JIRA-jog
„a technikai fiók látja a KMTR-projektet" — piros volt, amíg az admin nem adott jogot; a 2. nap délutánján zöld lett. A teszt a másik csapat kapuját is mérte.
a zöld, ami hazudott
A feloldó migrációja a próba-adatbázison zöld volt — az élesen elbukott. A próba egy olyan alakot játszott újra, amilyen az éles sosem volt. Új teszt: az éles alak visszajátszása, állandó kapuként.
Egy utólag írt teszt olyan teszt, amit a kód garantáltan átmegy. És egy zöld teszt is csak annyit bizonyít, amennyit a valóságból mér. Ezért piros előbb — és ezért kell a próbának az éles alakját mérnie.
Mi épül valójában
A mechanizmus: adat, nem kód
Ami a KMTR-hez épül, az adat: két migráció (egy hozzáférési sor, három útválasztó sor, és egy feloldó függvény, ami a tenantot paraméterként kapja), egy lemásolt betöltő-fa, egy csomag az admin oldalán. A motor változatlan — a következő projekt egy ellenőrző lista.
A néma hiba vége
A webhook és a riasztás
Azonnal
Ha a webhook elérhetetlen, a válasz nem szerződés-szerű vagy szabályt sért: Teams-üzenet és e-mail abban a percben, és a futás hibával áll meg — az adatbázis érintetlen.
Másnap reggel
Ha 48 órán át nincs sikeres futás — például mert a feladat el sem indult —, a reggeli őr jelez. Ez az a csend, ami két hónapig tartott.
Egészséges napon
Semmi. Egy kézbesített üzenet mindig azt jelenti: „nézz oda most".
Két kérdés, két ember
Gépi ellenőrzés és emberi kapu
Verifikáció — „jól építettük meg?"
- a gép futtatja: fordítás, tesztek, füstpróba, séma-ellenőrzés
- egy ember átnézi a diffet — és a tesztet is, nem csak a kódot
- a hermetikus adatbázis-tesztek, a betöltő-szabályok ellenőrzése, az adatbázis-szakértő átvizsgálása
- és a tanulság: a próba csak akkor bizonyít, ha az éles alakot méri — ezért kapott a próba egy éles-alak módot
Validáció — „a jót építettük meg?"
- a kérő végigmegy a valódi úton: keres, olvas, kérdez Laurától
- egy IIER-olvasó megerősíti: nem lát KMTR-tartalmat
- a válaszidő nem romlott
Egyik sem helyettesíti a másikat. Zöld teszt és aláírás — ez a „kész".
Mi mikor történik
A kapuk sorban
Összefésülés
A specifikáció és a tesztek átnézve, a fő ágon.
Migráció
A hozzáférési és útválasztó sorok — az adatbázis-gazda alkalmazza, a helyes sorrendben.
Admin-jogok
JIRA, SharePoint, külön export-csomag — másik csapat kapuja.
Telepítés
A betöltő-fa és a környezet a kiszolgálóra — csak emberi paranccsal.
Első futás
Betöltés, korpusz, wiki — a gépi tesztek zölden.
Elfogadás
A kérő aláír.
Minden nyíl egy emberi döntés. A gép mindent előkészít — a kapukat nem nyithatja ki.
A munkamegosztás
Ki mit ad hozzá
| Szereplő | Ad | Kap |
|---|---|---|
| Kérő (szervező, projektvezetők) | a hatókört, a válaszokat, az elfogadást | egy kereshető, jogosultság-szűrt KMTR-tudástárat és wikit |
| Admin csapat | a jogokat és a külön export-csomagot | egy platformot, ami az ő jogosultság-modelljét alkalmazza — nem másolja |
| Platform | specifikációt, teszteket, mechanizmust, riasztást | egy ellenőrző listát a következő projekthez |
| A gép | a napi munka nagy részét: mérés, szöveg, kód, futtatás | soha nem a döntést és soha nem a kaput |
Jogosultság
Aki jogosult, az látja — hogyan?
Szerep
Az adatbázis sor-szintű szabálya: egy technikai fiók csak azokat a tenantokat látja, amelyekre hozzáférési sora van.
Útvonal
Minden olvasó függvény tenant-paramétert kap; a KMTR-útvonal csak a KMTR-tenantot kérdezheti — szerkezetileg.
Felhasználólista
Az útvonalon belül a kereső csak azt adja vissza, amire a kérdezőt az export felhasználólistája feljogosítja.
Aki mindkét listán szerepel, mindkét útvonalat használhatja. Aki csak az egyiken, a másikon nulla sort kap.
Laura
Wiki csak KMTR-forrásból — és a tenant-választó
A wiki
- a szócikkek tenantonként generálódnak — egy KMTR-szócikk csak KMTR-forrásra hivatkozhat
- a 3. napon megszületett az első 30 KMTR-szócikk (vázlatként, tizenkét perc alatt): kárbejelentés és kárenyhítés, szemle és mobilapplikáció, drónos szemle, döntéssablonok, környezetek, telepítés, folyamatmotor, módszertan — egyik sem hivatkozik KMTR-en kívüli forrásra
- ember hagyja jóvá, mielőtt olvasható lesz — ehhez a hub-adminisztrátor is beengedést kapott a KMTR tenantba
- Laura a jóváhagyott szócikkekből válaszol
A választó
- egy felület, nem kettő: a felhasználó beállításként választ tenantot
- a választás az adatbázis munkamenet-változójaként érvényesül minden lekérdezésen
- csak azok a tenantok kínálhatók, ahová a felhasználót beengedték; egy tenant esetén nincs is választó
- Laura „kalapjai" (szerkesztő, forrás, üzleti elemző) ettől független tengely maradnak
- a választó él, és a láblécben is: a
tenant=címke maga a kapcsoló — aki mindkét tudástárba be van engedve, egy kattintással vált; aki egybe, csak a címkét látja
Hibatűrés
Ha valami elromlik
Hangosan
Ismeretlen forrás, hiányzó jog, sértett szabály: a futás megáll, mielőtt írna. Soha nem tippel.
Azonnal
Teams és e-mail a hibás lépés nevével és okával.
Reggel
Az őr jelzi, ha egy várt feladat 48 órája nem futott sikeresen.
Nyomon
Minden manifest letöltése hash-elve, archiválva; minden futás sor a naplóban.
Ami még épült
A második nap többlete
Az első nap a kapukig jutott, a második a kapukon át — és közben hat dolog épült, amit senki nem kért, de mind a kérésből derült ki.
Tenant-váltó a láblécben
Ahol a lábléc kimondja, melyik tudástárban vagy, ott lehet váltani is: egy kattintás, és minden oldal, keresés és Laura a másik tenant alatt fut. Aki egy tenantba jár, csak a címkét látja. A közös alapba került — minden termék megkapja.
A csomag megérkezett
A KMTR jogosultság-exportja külön csomagban jött. A betöltő saját szabályaival, írás nélkül ellenőriztük — szerződés, tenant, csak KMTR-forrás —, és az IIER csomagjából ki is került a KMTR. Ma este fut először élesben.
A háttérmunkás minden tenantot lát
A háttérfolyamat indítója névre szólóan sorolta a tenantokat, így az új tenant kulcsai nem jutottak el hozzá. Most minden tenant-mappát bejár: a következő tenant nem igényel módosítást.
Türelmesebb letöltés, túlélő archívum
A riasztás első éjszakája két valódi dolgot mondott: a lépés kétperces kerete megölte a háromperces letöltést, és a telepítés minden alkalommal letörölte az archívumot. Mindkettő javítva, teszttel rögzítve.
A teszt, ami hibát talált
A kétbérlős olvasók oldalai hibára futottak egy mezőnév miatt, amelyet egyetlen teszt sem járt be. A lábléc-váltó tesztjének írásakor derült ki, egy órán belül javítva. Tanulság: egy adatra kapcsolt ág, amelynek adatát a tesztek sosem adják, nem tesztelt.
Zöld az ellenőrző futás
Az ügyfélcsomag folyamatos ellenőrzése hetek óta piros volt három elavult feltevés miatt; a KMTR-másolat csak kiszélesítette. Most zöld, és tenantonként ellenőriz.
Az első éles futás
A harmadik nap: az első éjszaka és ami kiderült
Az első éjszaka a kérésből termék lett: a KMTR-korpusz bent van. És az éjszaka három olyan hibát is megmutatott, amit nappal senki nem látott volna.
A korpusz megérkezett
A hajnali bejárás a KMTR JIRA-ját és Confluence-ét teljes egészében betöltötte és beágyazta — több ezer feladat, több száz oldal, tízezer szövegdarab. Egyetlen KMTR-tétel sem keveredett az IIER-oldalra; a kérő és a KMTR-gazda a KMTR-forrásokat látja, ugyanaz a felhasználó az IIER-oldalon csak a nyilvánosat.
Harminc szócikk
A wiki-generátor a KMTR Confluence-éből harminc témát talált, és mindhez írt egy vázlatot — tizenkét perc. Mind vázlat marad, amíg egy ember át nem nézi; a KMTR-oldali visszajelzés erre vár.
A sikeres éjszaka, ami nem csinált semmit
A jogosultság-betöltő előző esti sikertelen futása egy mentett állapotot hagyott hátra; az ütemezett futás onnan folytatta, nem talált tennivalót, és „sikert" jelentett. A motor hibája volt, nem a KMTR-é — reggelre javítva, teszttel előbb, délelőtt telepítve.
SharePoint: a jog megvan, a lista hiányzott
Az admin megadta az olvasást — egy próba 150 dokumentumot olvasott hiba nélkül. Az export mégsem sorolta fel a dokumentumtárat, mert az a webhely jogait örökli. A betöltő most a megnevezett mappából a tárat is levezeti: adminisztrátori teendő nélkül bekerült a bejárandók közé.
Az admin is beléphet
A hub-adminisztrátor csoportja csak az IIER-tenantba volt beengedve, így a lábléc váltója számára nem volt kapcsoló. Egy migráció — teszttel előbb — a KMTR tenantba is beengedte: a szócikkeket lektorálni csak beengedett ember tudja.
Ami a gépnek is sok volt
A beágyazó kapacitás háromnegyede éjjel kiesett; a maradék egy példányon az éjszaka mégis lefutott, lassabban. A helyreállítás emberi kézben van — a gép jelezte, nem leplezte.
A termék használható
A negyedik nap: él a keresés, mindhárom forrás bent
A második éjszaka után a KMTR-tudástár kereshető lett — és délelőttre a harmadik forrás is megérkezett. Közben a platform két saját adósságát is rendezte.
A KMTR-keresés él
A külön KMTR keresési útvonal hat eszközzel működik. Élő próba: egy KMTR-felhasználó a KMTR-útvonalon KMTR-oldalakat és KMTR-szócikket kap, ugyanő az IIER-útvonalon nullát; jogosultság nélküli azonosítót mindkét útvonal elutasít.
Mindhárom forrás a tudástárban
Az első SharePoint-bejárás egy első futásra jellemző hibán akadt el — még nem volt tárolt dokumentum, és a lépés ezt leállásként kezelte. Javítva, teszttel előbb; délelőtt 150 dokumentum, 23 509 szövegdarab, mind a KMTR-jogosultsághoz kötve. Egyetlen fájl sem került az IIER-oldalra.
Nyolc perc csend
A KMTR-útvonal telepítésekor a beállítás előbb ért célba, mint a mappája; a szolgáltatás ezt minden útvonalra hibaként kezelte, és nyolc percig egyik tudástár sem válaszolt. A tanulság a tervbe került: a sorrend megfordítva, minden későbbi lépésnél így.
A betöltő nem rendszergazda többé
A jogosultság-betöltő eddig teljes jogú adatbázis-kapcsolattal futott. Most egy saját, szűk szerepkörrel: pontosan azt a három műveletet és a naplóírást kapja, amit a munkája igényel. Élesben igazolva, mindkét tenanton.
Egy IIER-útvonal maradt
A régi és az új IIER keresési útvonal hetek óta párhuzamosan élt. Az ügyfélcsomagok átirányítása után a régi útvonal este leállt; az IIER-nek és a KMTR-nek egy-egy útvonala van.
A napló valós számokat mond
Az éjszakai összesítő sor a lépések lefutása előtt íródott, így kitöltetlen helyőrzőket mutatott. A sorrend javítva: a reggeli állapot már számokból olvasható.
A harmadik éjszaka
Az ötödik nap reggele: a csendes éjszaka
A harmadik éjszaka a KMTR-oldalon esemény nélkül telt — és éppen a csend mutatott meg két apró hibát. Az IIER-oldalon két dolog kívülről jött.
A KMTR-éjszaka tiszta
A jogosultság-betöltés már a szűk szerepkörrel futott; mindhárom forrás frissült (4720 feladat, 313 oldal), a SharePoint-tár 150 dokumentuma változatlan volt.
A csend is hibának látszott
Változás nélküli éjszakán a SharePoint-bejárás „csonka" futást jelentett, és a Confluence-napló kitöltetlen helyőrzőt írt, mert nem volt mit beágyazni. Egyik sem adatvesztés, de egy reggeli olvasónak hibának tűnik. Mindkettő javítva, teszttel előbb; a próba igazolta, hogy a csendes futás most sikerrel zárul.
A telepítés belefutott az ütemezésbe
Egy esti platformtelepítés újraindította a háttérmunkást, egy perccel az IIER jogosultság-betöltés indulása után — a futás megszakadt. Reggel újraindítva, sikerrel. Tanulság: telepítés előtt az ütemtervet is nézni kell.
Egy jog elveszett az IIER-oldalon
Az IIER éjszakai frissítésének JIRA-része azzal állt le, hogy a technikai felhasználó nem látja az IIER-projektet; két nappal korábban még látta. A KMTR-t nem érinti. A kérés az adminnál van.
A beágyazó kapacitás még fél
A négy beágyazó példányból kettő továbbra sem válaszol; az IIER SharePoint-bejárása emiatt hibával zárult. A helyreállítás emberi kézben van — a riasztás jelezte.
Idővonal
Hol tartunk, mi következik
Öt nap
-
- nap: mérés, két jegy felelősökkel, a döntés (külön tenant), a specifikáció, a piros tesztek; este a mechanizmus, a tesztek zöldre
-
- nap: a migrációk élesben, a betöltő és Laura telepítve; a KMTR-csomag érvényes, a lábléc tenant-váltó él; az admin kapuja bezárult
-
- nap: az első éles éjszaka — JIRA és Confluence a korpuszban, az elkülönítés igazolva; harminc szócikk-vázlat; a KMTR keresési útvonal telepítve, egy nyolcperces kiesés árán
-
- nap: a SharePoint is bent — 150 dokumentum —, így mindhárom forrás kereshető; a betöltő szűk szerepkörre váltott; a régi IIER-útvonal leállt
-
- nap reggel: tiszta KMTR-éjszaka; két „csendes éjszaka" naplóhiba javítva, teszttel előbb; a megszakított IIER-betöltés pótolva
Mi vár kire
- admin: a KMTR-oldalon nincs nyitott teendő; az IIER-oldalon egy: a technikai felhasználó IIER-projektjogának visszaadása (a KMTR-t nem érinti)
- platform: a beágyazó kapacitás helyreállítása; a naplójavítás telepítése; a szócikkek lektorálása
- kérő: a harminc szócikk átnézése és visszajelzés — mi hasznos, mi hiányzik —, próbakeresések a KMTR-útvonalon, majd az elfogadás
Az elfogadás mércéje
Mit fogadunk el?
Keresés
Egy KMTR-kérdés a KMTR-útvonalon KMTR-találatot ad helyes hivatkozással; az IIER-útvonalon ugyanaz a kérdés nullát.
Elkülönítés
Egy IIER-olvasó a KMTR-útvonalon nulla sort kap; egy KMTR-szócikk sem hivatkozik IIER-forrásra.
Wiki + Laura
A KMTR-szócikkek látszanak; Laura belőlük válaszol; a tenant-választó a beengedett tenantokat kínálja.
Teljesítmény
Az IIER-keresés válaszideje nem változott a második tenanttól.
Köszönöm
Kérés → mérés → döntés → spec → piros teszt → mechanizmus → kapuk → elfogadás. A gép a kezeket adja. A kapukat mi tartjuk.