Specifikáció készítés

A projektek nem a kódon buknak el

A szoftverprojektek ott buknak el, hogy rosszul határozták meg, mit kell megírni. A legdrágább hiba mindig az, amit az elején követnek el.

Homályos követelmények, lefektetlen üzleti szabályok, megalapozatlan technológiai döntések: specifikáció készítés nélkül a fejlesztés rossz irányba indul, és minél később derül ki, annál drágább javítani.

Mit old meg a specifikáció:

Egyértelmű követelmények – a követelményfeltárás eredménye egy precíz leírás arról, mit kell megvalósítani, kinek és milyen feltételekkel
Megalapozott technológiai döntések – az architektúra, a stack és az integrációs megközelítés a projekt indulása előtt rögzítve van, nem útközben alakul ki
Reális becslési alap – az időkeret, a költség és az erőforrásigény specifikációra épül, nem megérzésre
Kockázatcsökkentés – a félreértések a specifikációs fázisban derülnek ki, nem a fejlesztés közepén, amikor a javítás nagyságrenddel drágább

Működő prototípus AI eszközökkel - vizualizáció

Prototípus-alapú specifikáció

Vibe coding és AI eszközökkel már a specifikációs fázisban működő prototípust mutatunk. Élő, interaktív alkalmazás, amit ki lehet próbálni.

Az emberi agy működő dolgokból ért, nem dokumentumokból. A hagyományos specifikáció egy PDF, amit az ügyfél elolvas, bólogat rá, és reméli, hogy a végeredmény az lesz, amit elképzelt. Mi ehelyett megmutatjuk.

Miért jobb ez:

Dönteni tudsz, mielőtt elköteleződnél – egy működő dologra mondasz igent, amit kipróbáltál
A félreértések korán kiderülnek – nem a fejlesztés közepén, amikor a javítás nagyságrenddel drágább
A stakeholdereket könnyebb bevonni – a CEO is megérti, a pénzügyes is kipróbálja
A fejlesztőcsapat látja, mit kell megvalósítani – a prototípust veszi alapul, nem a dokumentumot értelmezi

A prototípus nem production kód, és nem is lesz az. De ennek alapján felelősen tudsz dönteni.

Üzleti elemzés – az igénytől a megoldásig

A specifikáció középpontjában az üzleti elemzés (Business Analysis) áll: az üzleti igény és a technológiai megvalósítás közötti fordítás.

Az eszközöket a projekt jellege határozza meg. Az igényfelmérés során azt használjuk, ami az adott helyzetben érthetővé teszi a követelményeket.

Amivel dolgozunk:

User story-k – rövid, felhasználóközpontú leírások: ki, mit és miért szeretne. Agilis környezetben az elsődleges formátum
Use case-ek – forgatókönyv-alapú leírások, amelyek a rendszer és a felhasználó interakcióit rögzítik. Összetett üzleti logikánál hasznosak
BPMN folyamattérképek – üzleti folyamatok, döntési pontok és rendszerhatárok vizuális ábrázolása. Az ügyfél és a fejlesztőcsapat közös nyelve
Adat- és rendszermodellek – adatstruktúrák, entitások, relációk és integrációs pontok

AS-IS és TO-BE – a változás dokumentálása

Az aktuális és a kívánt állapot párhuzamos dokumentálása.

AS-IS: hogyan működik ma
Hogyan zajlanak a folyamatok, milyen rendszerek vesznek részt, milyen adatok mozognak, hol vannak a fájdalompontok. A feltárás eredményeire építjük, nem feltételezésekre.

TO-BE: hogyan fog működni
Hogyan működik majd a folyamat a megoldás bevezetése után, milyen technológiai komponensekre épül, milyen üzleti eredmény várható.

Acceptance criteria
A TO-BE állapot önmagában nem elég - Minden követelmény mellé elfogadási kritériumok tartoznak. Egy követelmény akkor kész, ha egyértelműen megmondható, hogy a megvalósítás megfelel-e neki. Ezek a specifikáció szerves részei, és a tesztelés alapját adják.

Az AS-IS / TO-BE páros segít reálisan elképzelni a változást, és konkrét alapot ad a megvalósításhoz.

Specifikációs csomag – funkcionális specifikáció, technikai dokumentáció, roadmap

A specifikációs csomag – mit kapsz konkrétan

Strukturált dokumentumcsomag, amelynek minden eleme konkrét célt szolgál.

A csomag összetétele a projekt jellegétől függ, de jellemzően:

Problématérkép és gyökérok-elemzés – a feltárt kihívások összefüggéseikkel, prioritásaikkal és üzleti hatásukkal együtt, hogy világos legyen, mit és miért oldunk meg
Funkcionális specifikáció (SRS) – leírja a rendszer elvárt működését: funkciókat, felhasználói szerepköröket, üzleti szabályokat és elfogadási kritériumokat, amelyek alapján a fejlesztés és a tesztelés egyaránt elindulhat
Technikai specifikáció – rögzíti az architekturális döntéseket, a technológiai stacket, a rendszerkomponensek kapcsolatait és a nem-funkcionális követelményeket, hogy a fejlesztőcsapat pontosan tudja, mire építsen
API specifikáció – endpoint-ok, adatstruktúrák, autentikáció és hibakezelés dokumentálva, a külső és belső integrációkhoz egyaránt
AS-IS és TO-BE folyamattérképek – BPMN formátumban készülnek, felhasználhatók belső kommunikációra és a stakeholderek bevonására
Wireframe-ek és felhasználói folyamatok – a működő prototípus kiegészítésével nem csak papíron, hanem kipróbálható formában is átadjuk
Build or Buy döntési mátrix – komponensenkénti elemzés arról, mit érdemes házon belül fejleszteni és hol jobb piaci megoldásra támaszkodni

Megvalósíthatósági elemzés és fejlesztési roadmap vizualizáció

Megvalósíthatósági elemzés és roadmap

A specifikáció a "mit" mellett megválaszolja a "hogyan", "mikor" és "mennyiből" kérdéseket is.

Megvalósíthatósági elemzés
Technikai, pénzügyi és szervezeti korlátok vizsgálata. Több forgatókönyvet dolgozunk ki, mindegyikhez várható eredményekkel és kockázatokkal, hogy a döntés ne megérzésre épüljön.

Prioritizált roadmap
Ütemezett fejlesztési terv fázisokba bontva: függőségek, erőforrásigény, becsült időkeretek és várható üzleti hatás. A roadmap tartalmazza azokat a döntési pontokat is, ahol irányváltást kezdeményezhetsz.

A specifikáció a tiéd
A teljes csomagot átadjuk. El lehet vele kezdeni fejleszteni akár velünk, akár más szállítóval. Azért fizetsz, hogy pontos képet kapj arról, mit kell megvalósítani, és ez a tudás nálad marad.

Specifikációs projekt folyamata – feltárástól a végleges dokumentumcsomagig

A specifikáció folyamata

Ugyanolyan strukturáltan kezeljük, mint egy fejlesztési projektet.

Feltárás – Megismerjük az üzleti helyzetet, a meglévő rendszereket, a stakeholdereket. Interjúk, workshopok, dokumentumelemzés.
Probléma-dekompozíció – Lebontjuk a kihívást kezelhetőbb részekre, feltárjuk a gyökérokokat, prioritizálunk.
Prototípus készítés – AI eszközökkel működő prototípust építünk, amelyen az üzleti logika, a felhasználói folyamatok és a felület kipróbálható.
Specifikáció és dokumentálás –Elkészül a funkcionális és technikai specifikáció, az API dokumentáció, a folyamattérképek és az acceptance criteria.
Roadmap és validáció – Összeállítjuk a fázisokra bontott fejlesztési tervet és a megvalósíthatósági elemzést, majd átadjuk és közösen véglegesítjük.

Rendszeres jóváhagyási pontokat építünk be, hogy a munka ne távolodjon el az üzleti céloktól.

Kinek szól a specifikáció?

Mindenkinek, aki szoftvert akar fejlesztetni, de nem akarja a fejlesztés közben kitalálni, mit is akar.

Tipikus helyzetek:

Új rendszert tervezel – a specifikáció garantálja, hogy a fejlesztés pontos követelményekre épüljön
Meglévő rendszert cserélsz vagy digitális transzformáció előtt állsz – az AS-IS és TO-BE dokumentáció segít reálisan megtervezni a migrációt
Több szállítót hasonlítasz össze – azonos feltételek mellett kérhetsz ajánlatot
Belső stakeholdereket kell meggyőznöd – a prototípus és a megvalósíthatósági elemzés konkrét döntési alapot ad

A specifikáció rögzíti, mire gondoltatok, és ezt mindkét fél aláírja, mielőtt a fejlesztés elindul.

Gyakran ismételt kérdések a specifikáció készítésről

❓ Mire jó a specifikáció, ha úgyis változnak a követelmények?
A specifikáció nem merev terv. A lehető legjobban megalapozott indulópont. Ha a követelmények változnak (és változni fognak), a specifikáció alapján tudod, mihez képest változnak, és hatáselemzés alapján felelősen tudsz dönteni a módosításról.

⚖️ Mennyibe kerül egy specifikációs projekt?
A költség a rendszer komplexitásától, az érintett folyamatok számától és a feltárás mélységétől függ. Egy fókuszált specifikáció néhány hetes munka, egy több rendszert és integrációt érintő projekt 2–3 hónapos lehet – az ár ehhez arányosan alakul. A bevezető megbeszélés után indikatív ajánlatot adunk.

⚡ Mi az a prototípus-alapú specifikáció?
AI és vibe coding eszközökkel már a specifikációs fázisban működő alkalmazást építünk, amelyen a felhasználói folyamatok, az üzleti logika és a felület kipróbálható. Ez nem production kód, de olyan eszköz, amely alapján felelősen tudsz dönteni a fejlesztés indításáról. A stakeholderek azonnal értik, mit kapnak, és a félreértések a specifikációs fázisban derülnek ki.

♾️ A specifikáció után kötelező a Loginettel fejlesztetni?
Nem. A specifikációs csomag a tiéd, bármely fejlesztőcéggel megvalósíthatod. A dokumentációt, a prototípust, a technikai specifikációt és a roadmapet mind átadjuk. Sokan velünk folytatják, mert a specifikáció során szerzett tudás átmegy a fejlesztési projektbe.

⚠️ Mi a különbség a funkcionális és a technikai specifikáció között?
A funkcionális specifikáció leírja, MIT csinál a rendszer: funkciókat, felhasználói szerepköröket, üzleti szabályokat és elfogadási kritériumokat. A technikai specifikáció leírja, HOGYAN valósítjuk meg: architekturális döntések, technológiai stack, rendszerkomponensek kapcsolatai, nem-funkcionális követelmények (teljesítmény, skálázhatóság, biztonság).

✅ Mi az az acceptance criteria?
Egyértelmű, tesztelhető állítás, amely megmondja, mikor tekinthető késznek egy funkció. Minden követelmény mellé megfogalmazzuk ezeket, így a fejlesztés végén előre rögzített feltételek döntik el, hogy a megvalósítás megfelel-e az elvárásoknak.

▶️ Mennyi ideig tart egy specifikációs projekt?
Egy kisebb, fókuszált specifikáció 3–6 hét alatt elkészülhet. Egy több rendszert érintő specifikáció 2–3 hónapot vehet igénybe. Az időtartamot a stakeholderek elérhetősége és a feltárandó folyamatok komplexitása befolyásolja.

⚙️ Mi történik, ha a specifikáció során kiderül, hogy más megoldás kell?
A specifikáció célja pont ez: a fejlesztés előtt derüljön ki. Ha a feltárás során kiderül, hogy más architektúra, más technológia vagy más megközelítés szükséges, a specifikáció igazolja. Az irányváltás ilyenkor töredékébe kerül annak, mintha a fejlesztés közepén kellene módosítani.