9-10. Revizija projektne dokumentacije
Uvod
Revizija projektne dokumentacije je proces koji osigurava da svi planovi, zahtevi i tehnički opisi vezani za neki projekat budu tačni, jasni i izvodljivi. Tokom ovog procesa, proveravaju se svi aspekti dokumentacije kako bi se identifikovale greške, nelogičnosti ili propusti, kao i kako bi se osigurala usklađenost sa tehničkim standardima i ciljevima projekta.
Ovaj proces je ključan kako bi se izbegle greške koje mogu dovesti do velikih problema tokom realizacije projekta.
Šta je revizija projektne dokumentacije?
Revizija podrazumeva detaljno pregledanje svih dokumenata vezanih za projekat. Cilj je da se proveri:
- Da li su informacije tačne i potpune
- Da li su tehnički zahtevi usklađeni sa potrebama korisnika?
- Da li postoje greške u proračunima ili specifikacijama?
- Da li su svi delovi dokumentacije međusobno usklađeni?
Zašto je revizija važna?
Revizija dokumentacije pomaže da se:
- Smanje rizici – Greške u dokumentaciji mogu dovesti do kašnjenja projekta ili dodatnih troškova.
- Poboljša kvalitet – Kvalitetno pregledani dokumenti pružaju jasan smer za razvoj i realizaciju.
- Poveća transparentnost – Jasna dokumentacija omogućava svim učesnicima da razumeju svoje uloge i odgovornosti.
Ili, jednostavnije rečeno:
- Sprečava skupe greške tokom razvoja.
- Povećava poverenje klijenata.
- Omogućava bolju koordinaciju između članova tima.
- Poboljšava ukupni kvalitet projekta.
Kako se vrši revizija?
Proces revizije obično uključuje nekoliko koraka:
-
Priprema – Okupiti sve potrebne dokumente i definisati kriterijume za proveru.
-
Analiza – Proveriti da li su dokumenti jasni, precizni i usklađeni sa zahtevima projekta.
-
Identifikacija problema – Zabeležiti sve greške, nedostatke ili nejasnoće.
-
Izmena i dopuna – Uneti ispravke i ažurirati dokumentaciju.
-
Finalna provera – Proveriti ispravljene dokumente i odobriti ih za dalje korišćenje.
Koraci u procesu revizije
- Pregled strukture dokumentacije:
- Da li su sva poglavlja uključena?
- Da li dokumentacija ima logičan tok?
- Provera tehničkih specifikacija:
- Da li su svi podaci tačni i konzistentni?
- Da li su izabrane tehnologije adekvatne?
- Validacija usklađenosti:
- Da li dokumentacija ispunjava zahteve klijenata?
- Da li su standardi kvaliteta zadovoljeni?
- Izveštaj o reviziji:
- Beleženje pronađenih problema i preporučenih ispravki.
- Priprema finalne verzije dokumentacije.
Primer iz prakse
Recimo da radite na projektu razvoja web aplikacije za školu. Dokumentacija sadrži opis funkcionalnosti, kao što su elektronski dnevnik, ocenjivanje i komunikacija sa roditeljima. Tokom revizije otkriveno je da nije jasno opisano kako će se podaci o ocenama čuvati. Ovo može izazvati problem tokom razvoja. Ispravkom ovog nedostatka omogućava se nesmetan rad na aplikaciji.
Praktični deo (vežbe)
Vežba 1: Identifikacija grešaka
Zadatak: Pregledajte sledeći odlomak projektne dokumentacije i pronađite greške:
"Sistem će koristiti relacionu bazu podataka MySQL za skladištenje podataka. Frontend aplikacije razvija se u programskom jeziku Python, dok će se backend implementirati koristeći React.js."
Rešenje:
- MySQL je ispravan izbor za bazu podataka, ali React.js je frontend tehnologija, a ne backend.
- Python se obično koristi za backend, ne za frontend.
- Predlog ispravke:
- "Sistem će koristiti relacijonu bazu podataka MySQL za skladištenje podataka. Frontend aplikacije razvija se u React.js, dok će se backend implementirati koristeći Python."
Vežba 2: Provera usklađenosti sa zahtevima
Zadatak: Proverite da li sledeći opis projekta ispunjava klijentov zahtev:
Klijentov zahtev: Sistem mora podržavati istovremeni pristup za najmanje 100 korisnika. Opis u dokumentaciji: Sistem je testiran za 50 korisnika i pokazao se stabilnim.
Rešenje:
- Problem: Dokumentacija ne zadovoljava klijentov zahtev.
- Predlog: Izvršiti dodatno testiranje za najmanje 100 korisnika i unaprediti sistem kako bi podržavao očekivano opterećenje.
Naziv projekta: Aplikacija za organizaciju školskih takmičenja
Opis projekta:
Cilj ovog projekta je razvoj aplikacije koja će omogućiti učiteljima i nastavnicima da organizuju školska takmičenja. Aplikacija će sadržavati sledeće funkcionalnosti:
- Registracija učenika za takmičenja.
- Pregled liste takmičenja.
- Kreiranje rasporeda takmičenja.
Tehnički zahtevi:
- Aplikacija će biti razvijena kao web aplikacija.
- Podaci će se čuvati u bazi podataka.
Rok za završetak: Jedan mesec od početka projekta.
Budžet: 1000 evra.
-
Nepreciznost opisa funkcionalnosti:
- Šta tačno podrazumeva registracija učenika za takmičenja? Da li to uključuje unos osnovnih podataka (ime, prezime, razred), ili i dodatne podatke poput mentora i rezultata?
- Nije jasno definisano kako će izgledati pregled liste takmičenja (da li korisnik može da filtrira i pretražuje takmičenja?).
- Kreiranje rasporeda takmičenja nije precizirano (ko unosi podatke, kako se vrši provera da li se termini preklapaju?).
-
Nedovoljno definisani tehnički zahtevi:
- Koji tip baze podataka će se koristiti (SQL, NoSQL)?
- Da li aplikacija treba da bude prilagođena za mobilne uređaje?
-
Nerealističan rok:
- S obzirom na kompleksnost zadatka, jedan mesec je verovatno nedovoljan, posebno ako tim koji radi na projektu ima ograničeno iskustvo.
-
Nedovoljno precizan budžet:
- Budžet nije razrađen (koliko će se izdvojiti za programere, dizajn, hosting itd.).
Naziv projekta: Aplikacija za organizaciju školskih takmičenja
Opis projekta:
Cilj ovog projekta je razvoj aplikacije koja će omogućiti učiteljima i nastavnicima da efikasno organizuju školska takmičenja.
Revidirane funkcionalnosti:
- Registracija učenika za takmičenja: Korisnici će uneti osnovne podatke o učenicima (ime, prezime, razred, mentor, kontakt informacije) putem online forme. Sistem će automatski validirati unete podatke.
- Pregled liste takmičenja: Korisnici će moći da pregledaju listu takmičenja sa opcijama za filtriranje (po datumu, predmetu, razredu) i pretraživanje.
- Kreiranje rasporeda takmičenja: Administratori će unositi datume, vreme i lokacije takmičenja. Sistem će automatski proveriti moguće preklapanje termina.
Tehnički zahtevi:
- Aplikacija će biti razvijena kao responzivna web aplikacija (podrška za desktop i mobilne uređaje).
- Koristiće se MySQL baza podataka za čuvanje informacija.
- Hosting na cloud platformi (npr. AWS ili Azure).
Rok za završetak:
- Projektni tim procenjuje da je potrebno minimum 3 meseca za razvoj, uključujući fazu testiranja i ispravke.
Budžet:
- Programerski tim: 700 evra.
- Hosting i baza podataka: 200 evra.
- Rezervni fond za dodatne troškove: 100 evra.
Revizija projektne dokumentacije je neophodna veština koja pomaže u izgradnji uspešnih projekata. Uz pažljivo pregledanje dokumenata, možemo izbeći greške i obezbediti da svaki projekat bude kvalitetno realizovan.