Projektikaardi roll ja ülesehitus

Projektikaardi roll ja ülesehitus

Tunni eesmärk

Selles tunnis vaatad, mis on vibe codingu projektikaart ja milline näeb välja hea projektikaardi näidis.

Sa ei täida selles tunnis veel oma projektikaarti. Selle peatüki eesmärk on aidata sul aru saada, milliseid otsuseid projektikaart nähtavaks teeb ja kuidas eristada hägust ideed kontrollitavast esimesest versioonist.

Projektikaardi täidad järgmises peatükis online-vormis. Seal saad selle kopeerida või PDF-ina alla laadida.

Tunni tulemus

Tunni lõpuks saad aru:

• mis on vibe codingu projektikaart;
• miks projektikaart ei ole pikk projektiplaan;
• millised väljad teevad projekti selgemaks;
• miks mitte-skoop, edukriteeriumid ja kontrolliplaan on olulised;
• kuidas näited aitavad sinu enda ideed hiljem täpsemaks teha.

Pärast seda liigud järgmisse peatükki ja täidad oma projektikaardi.

Mis on vibe codingu projektikaart?

Vibe codingu projektikaart on lühike tööleht, mis aitab enne ehitamist selgeks teha, mida sa tegelikult luua tahad.

Selle mõte on lihtne: enne kui hakkad AI-koodiredaktorile või arendusassistendile juhiseid andma, pead ise teadma, millist tulemust ootad. Kui algus on hägune, tuleb ka tulemus juhuslik. Kui algus on selge, on lihtsam saada esimene toimiv versioon, seda kontrollida ja vajaduse korral parandada.

Projektikaart ei ole pikk projektiplaan. Selle ülesanne on panna paika esimene selge raam: mida ehitatakse, kellele seda tehakse, millist probleemi see lahendab, mis peab esimeses versioonis olemas olema, mis jääb teadlikult välja ja kuidas kontrollitakse, et tulemus töötab.

Miks projektikaarti vaja on?

Vibe codingu puhul ei ole kõige tähtsam küsimus ainult see, kas tööriist suudab koodi kirjutada. Palju olulisem on see, kas inimene suudab anda piisavalt selge lähteülesande.

• Ilma piirita kasvab töö liiga suureks.
• Ilma sihtkasutajata võib lahendus minna päris kasutajast mööda.
• Ilma valmisoleku tingimusteta on tulemust raske kontrollida.

Projektikaart kui esimene kvaliteedivärav

Projektikaarti võib mõelda kui esimest kvaliteediväravat. Enne kui liigud koodi, kujunduse või tehnilise teostuse juurde, kontrollid, kas idee on piisavalt selge.

Hea projektikaart ei tee toodet valmis. Ta teeb mõtlemise korda.

• Kas probleem on selge?
• Kas esimene versioon on piisavalt väike?
• Kas tulemust saab kontrollida?

Projektikaardi põhiosad

Projekti nimi

Projekti nimi peab olema lühike ja arusaadav. See ei pea olema brändinimi.

• Nõrk näide: „Minu rakendus”
• Parem näide: „Raamatuklubi kohtumiste registreerimisleht”
• Veel parem näide: „Raamatuklubi registreerimisvorm koos osalejate nimekirjaga”

Projekti tüüp

Projekti tüüp määrab, millist laadi lahendust ehitatakse.

• registreerimisvorm
• ühe lehega koduleht
• lihtne kalkulaator
• osalejate nimekiri
• harjutuste generaator

Sihtkasutaja

Sihtkasutaja on inimene, kelle jaoks lahendus tehakse. Seda ei tasu kirjeldada liiga üldiselt.

• Nõrk näide: „Kõik inimesed.”
• Parem näide: „Lapsevanem, kes soovib registreerida lapse suvelaagrisse.”
• Veel parem näide: „Lapsevanem, kes täidab telefonis suvelaagri registreerimisvormi ja tahab saada kohe kinnituse, et andmed jõudsid kohale.”

Probleem

Probleem kirjeldab, miks seda lahendust vaja on. Hea probleem ei alga tehnoloogiast, vaid olukorrast.

• Nõrk näide: „Mul on vaja veebilehte.”
• Parem näide: „Joogatunni korraldaja kogub praegu osalejaid sõnumite kaudu ja kaotab ülevaate, kes on registreerunud.”
• Veel parem näide: „Joogatunni korraldaja vajab lihtsat viisi, kuidas osalejad saavad ise trenni kirja panna ja korraldaja näeb ühest kohast, mitu kohta on täidetud.”

Kasutaja põhitegevus

Kasutaja põhitegevus kirjeldab, mida kasutaja peab saama teha.

1. Kasutaja avab lehe.
2. Ta näeb põhiinfot ja olulisi tingimusi.
3. Ta sisestab vajalikud andmed.
4. Ta vajutab kinnitamise nuppu.
5. Ta näeb kinnitust, et tegevus õnnestus.

Esimene kontrollitav versioon

Esimene kontrollitav versioon tähendab väikseimat lahendust, mida saab päriselt proovida. See ei ole lõplik toode.

Esimeses versioonis ei pea olema makseid, kasutajakontosid, mitut keelt ega keerulist haldusvaadet. Need võivad tulla hiljem, kui põhiloogika on kontrollitud.

Mitte-skoop

Mitte-skoop tähendab seda, mida esimeses versioonis teadlikult ei tehta.

• esimeses versioonis ei ole maksmist
• esimeses versioonis ei ole kasutajakontot
• esimeses versioonis ei saadeta automaatseid meeldetuletusi
• esimeses versioonis ei ole eraldi administraatori sisselogimist

Piirangud

Piirangud teevad nähtavaks, millega peab arvestama juba esimest versiooni planeerides.

• Lahendus peab töötama telefonis.
• Andmeid sisestatakse ainult mõne väljana.
• Esimene versioon peab valmima ilma keeruka backendita.

Edukriteeriumid

Edukriteerium ütleb, mis muutub paremaks siis, kui lahendus töötab.

• Korraldaja näeb registreerunuid ühest kohast.
• Kasutaja saab tegevuse lõpetada vähem kui kahe minutiga.

Vastuvõtukriteeriumid

Vastuvõtukriteeriumid kirjeldavad kontrollitavalt, mis peab valmis versioonis olemas olema.

• Vorm ei luba tühje kohustuslikke välju saata.
• Pärast saatmist kuvatakse selge kinnitusteade.
• Korraldaja näeb vähemalt nime ja e-posti aadressi.

Kontrolliplaan

Kontrolliplaan ütleb, kuidas sa kontrollid, et esimene versioon päriselt töötab.

• Täidan vormi telefonis ja arvutis.
• Proovin tühja välja veateadet.
• Kontrollin, kas saadetud andmed on nähtavad seal, kus pidid olema.

Näide 1: joogatunni registreerimisleht

• Projekti nimi: Joogatunni registreerimisleht vabade kohtade loenduriga
• Projekti tüüp: registreerimisvorm
• Sihtkasutaja: inimene, kes tahab telefonis kiiresti trennikoha broneerida
• Probleem: korraldaja kogub registreerumisi sõnumites ja kaotab ülevaate
• Esimene kontrollitav versioon: nimi, e-post, kohtade arv, kinnitusteade, registreerunute nimekiri
• Mitte-skoop: maksed, kontod, automaatsed meeldetuletused
• Kontrolliplaan: täidan vormi ise läbi ja vaatan, kas nimi jõuab nimekirja

Näide 2: isiklik kulude jälgija

• Projekti nimi: Isiklik kulude jälgija nädalase kokkuvõttega
• Projekti tüüp: lihtne kalkulaator või tabelivaade
• Sihtkasutaja: inimene, kes tahab iga päev kulud kiiresti kirja panna
• Probleem: kulud on laiali märkmetes ja kuu lõpuks puudub ülevaade
• Esimene kontrollitav versioon: kulu lisamine, kategooria valik, nädala kogusumma
• Mitte-skoop: pangaliidestus, mitme kasutaja tugi, automaatne eelarvenõustamine
• Kontrolliplaan: lisan testkulud ja võrdlen, kas summa arvutatakse õigesti

Näide 3: väike retseptikogu

• Projekti nimi: Pereretseptide kogu otsingu ja filtriga
• Projekti tüüp: sisuloend või väike sisuhaldusvaade
• Sihtkasutaja: kodukokk, kes tahab leida kiiresti sobiva retsepti telefonis
• Probleem: retseptid on eri kohtades laiali ja neid on raske uuesti leida
• Esimene kontrollitav versioon: retsepti pealkiri, koostisosad, kategooria, lihtne filter
• Mitte-skoop: kasutajakontod, pildigalerii, ostunimekirja eksport
• Kontrolliplaan: lisan kolm retsepti ja vaatan, kas filtriga leiab õige tulemuse

Kuidas näiteid lugeda?

Ära vaata näiteid kui malle, mida peab sõna-sõnalt kopeerima. Vaata neid kui otsuste näiteid.

• Kas kasutaja on piisavalt konkreetne?
• Kas probleem kirjeldab päris olukorda?
• Kas esimene versioon on piisavalt väike?
• Kas mitte-skoop hoiab projekti paisumast?
• Kas kontrolliplaan ütleb, kuidas tulemust proovida?

Halb ja parem algus

Enesekontroll enne projektikaardi täitmist

1. Kas minu projekti saab kirjeldada ühe selge lausega?
2. Kas ma tean, kellele see on mõeldud?
3. Kas probleem kirjeldab päris olukorda, mitte ainult soovi teha veebileht?
4. Kas esimene versioon on piisavalt väike, et seda saaks päriselt proovida?
5. Kas ma oskan öelda, mida ma praegu teadlikult ei ehita?
6. Kas ma tean, kuidas kontrollida, et esimene versioon töötab?

Kokkuvõte

Projektikaart aitab muuta häguse idee kontrollitavaks esimeseks versiooniks. Selle väärtus ei ole pikkuses, vaid selguses.

• Saan aru, mis on projektikaart.
• Näen, miks projektikaart ei ole pikk projektiplaan.
• Saan aru, miks projektikaart toimib esimese kvaliteediväravana.
• Näen, kuidas näidetes on kirjeldatud kasutaja, probleem, esimene versioon, mitte-skoop ja kontrolliplaan.
• Oskan enne täitmist kontrollida, kas minu idee on piisavalt väike.
• Tean, et projektikaardi täidan järgmises peatükis.

Järgmine samm

Järgmises peatükis täidad oma projektikaardi online-vormis. Täidetud kaardi saad kopeerida või PDF-ina alla laadida.

Tunni eesmärk

Selles tunnis vaatad, mis on vibe codingu projektikaart ja milline näeb välja hea projektikaardi näidis.

Sa ei täida selles tunnis veel oma projektikaarti. Selle peatüki eesmärk on aidata sul aru saada, milliseid otsuseid projektikaart nähtavaks teeb ja kuidas eristada hägust ideed kontrollitavast esimesest versioonist.

Projektikaardi täidad järgmises peatükis online-vormis. Seal saad selle kopeerida või PDF-ina alla laadida.

Tunni tulemus

Tunni lõpuks saad aru:

• mis on vibe codingu projektikaart;
• miks projektikaart ei ole pikk projektiplaan;
• millised väljad teevad projekti selgemaks;
• miks mitte-skoop, edukriteeriumid ja kontrolliplaan on olulised;
• kuidas näited aitavad sinu enda ideed hiljem täpsemaks teha.

Pärast seda liigud järgmisse peatükki ja täidad oma projektikaardi.

Mis on vibe codingu projektikaart?

Vibe codingu projektikaart on lühike tööleht, mis aitab enne ehitamist selgeks teha, mida sa tegelikult luua tahad.

Enne kui hakkad AI-koodiredaktorile või arendusassistendile juhiseid andma, pead ise teadma, millist tulemust ootad. Kui algus on hägune, tuleb ka tulemus juhuslik. Kui algus on selge, on lihtsam saada esimene toimiv versioon, seda kontrollida ja vajaduse korral parandada.

Projektikaart ei ole pikk projektiplaan. Selle ülesanne on panna paika esimene selge raam: mida ehitatakse, kellele seda tehakse, millist probleemi see lahendab, mis peab esimeses versioonis olemas olema, mis jääb teadlikult välja ja kuidas kontrollitakse, et tulemus töötab.

Miks projektikaarti vaja on?

Vibe codingu puhul ei ole kõige tähtsam küsimus ainult see, kas tööriist suudab koodi kirjutada. Palju olulisem on see, kas inimene suudab anda piisavalt selge lähteülesande.

• Ilma piirita kasvab töö liiga suureks.
• Ilma sihtkasutajata võib lahendus minna päris kasutajast mööda.
• Ilma valmisoleku tingimusteta on tulemust raske kontrollida.

Projektikaart kui esimene kvaliteedivärav

Projektikaarti võib mõelda kui esimest kvaliteediväravat. Enne kui liigud koodi, kujunduse või tehnilise teostuse juurde, kontrollid, kas idee on piisavalt selge.

Hea projektikaart ei tee toodet valmis. Ta teeb mõtlemise korda.

• Kas probleem on selge?
• Kas esimene versioon on piisavalt väike?
• Kas tulemust saab kontrollida?

Projektikaardi põhiosad

Projekti nimi

Projekti nimi peab olema lühike ja arusaadav. See ei pea olema brändinimi.

• Nõrk näide: „Minu rakendus”
• Parem näide: „Raamatuklubi kohtumiste registreerimisleht”
• Veel parem näide: „Raamatuklubi registreerimisvorm koos osalejate nimekirjaga”

Projekti tüüp

Projekti tüüp määrab, millist laadi lahendust ehitatakse.

• registreerimisvorm
• ühe lehega koduleht
• lihtne kalkulaator
• osalejate nimekiri
• harjutuste generaator

Sihtkasutaja

Sihtkasutaja on inimene, kelle jaoks lahendus tehakse. Seda ei tasu kirjeldada liiga üldiselt.

• Nõrk näide: „Kõik inimesed.”
• Parem näide: „Lapsevanem, kes soovib registreerida lapse suvelaagrisse.”
• Veel parem näide: „Lapsevanem, kes täidab telefonis suvelaagri registreerimisvormi ja tahab saada kohe kinnituse, et andmed jõudsid kohale.”

Probleem

Probleem kirjeldab, miks seda lahendust vaja on. Hea probleem ei alga tehnoloogiast, vaid olukorrast.

• Nõrk näide: „Mul on vaja veebilehte.”
• Parem näide: „Joogatunni korraldaja kogub praegu osalejaid sõnumite kaudu ja kaotab ülevaate, kes on registreerunud.”
• Veel parem näide: „Joogatunni korraldaja vajab lihtsat viisi, kuidas osalejad saavad ise trenni kirja panna ja korraldaja näeb ühest kohast, mitu kohta on täidetud.”

Kasutaja põhitegevus

Kasutaja põhitegevus kirjeldab, mida kasutaja peab saama teha.

1. Kasutaja avab lehe.
2. Ta näeb põhiinfot ja olulisi tingimusi.
3. Ta sisestab vajalikud andmed.
4. Ta vajutab kinnitamise nuppu.
5. Ta näeb kinnitust, et tegevus õnnestus.

Esimene kontrollitav versioon

Esimene kontrollitav versioon tähendab väikseimat lahendust, mida saab päriselt proovida. See ei ole lõplik toode.

Esimeses versioonis ei pea olema makseid, kasutajakontosid, mitut keelt ega keerulist haldusvaadet. Need võivad tulla hiljem, kui põhiloogika on kontrollitud.

Mitte-skoop

Mitte-skoop tähendab seda, mida esimeses versioonis teadlikult ei tehta.

• esimeses versioonis ei ole maksmist
• esimeses versioonis ei ole kasutajakontot
• esimeses versioonis ei saadeta automaatseid meeldetuletusi
• esimeses versioonis ei ole eraldi administraatori sisselogimist

Piirangud

Piirangud teevad nähtavaks, millega peab arvestama juba esimest versiooni planeerides.

• Lahendus peab töötama telefonis.
• Andmeid sisestatakse ainult mõne väljana.
• Esimene versioon peab valmima ilma keeruka backendita.

Edukriteeriumid

Edukriteerium ütleb, mis muutub paremaks siis, kui lahendus töötab.

• Korraldaja näeb registreerunuid ühest kohast.
• Kasutaja saab tegevuse lõpetada vähem kui kahe minutiga.

Vastuvõtukriteeriumid

Vastuvõtukriteeriumid kirjeldavad kontrollitavalt, mis peab valmis versioonis olemas olema.

• Vorm ei luba tühje kohustuslikke välju saata.
• Pärast saatmist kuvatakse selge kinnitusteade.
• Korraldaja näeb vähemalt nime ja e-posti aadressi.

Kontrolliplaan

Kontrolliplaan ütleb, kuidas sa kontrollid, et esimene versioon päriselt töötab.

• Täidan vormi telefonis ja arvutis.
• Proovin tühja välja veateadet.
• Kontrollin, kas saadetud andmed on nähtavad seal, kus pidid olema.

Näide 1: joogatunni registreerimisleht

• Projekti nimi: Joogatunni registreerimisleht vabade kohtade loenduriga
• Projekti tüüp: registreerimisvorm
• Sihtkasutaja: inimene, kes tahab telefonis kiiresti trennikoha broneerida
• Probleem: korraldaja kogub registreerumisi sõnumites ja kaotab ülevaate
• Esimene kontrollitav versioon: nimi, e-post, kohtade arv, kinnitusteade, registreerunute nimekiri
• Mitte-skoop: maksed, kontod, automaatsed meeldetuletused
• Kontrolliplaan: täidan vormi ise läbi ja vaatan, kas nimi jõuab nimekirja

Näide 2: isiklik kulude jälgija

• Projekti nimi: Isiklik kulude jälgija nädalase kokkuvõttega
• Projekti tüüp: lihtne kalkulaator või tabelivaade
• Sihtkasutaja: inimene, kes tahab iga päev kulud kiiresti kirja panna
• Probleem: kulud on laiali märkmetes ja kuu lõpuks puudub ülevaade
• Esimene kontrollitav versioon: kulu lisamine, kategooria valik, nädala kogusumma
• Mitte-skoop: pangaliidestus, mitme kasutaja tugi, automaatne eelarvenõustamine
• Kontrolliplaan: lisan testkulud ja võrdlen, kas summa arvutatakse õigesti

Näide 3: väike retseptikogu

• Projekti nimi: Pereretseptide kogu otsingu ja filtriga
• Projekti tüüp: sisuloend või väike sisuhaldusvaade
• Sihtkasutaja: kodukokk, kes tahab leida kiiresti sobiva retsepti telefonis
• Probleem: retseptid on eri kohtades laiali ja neid on raske uuesti leida
• Esimene kontrollitav versioon: retsepti pealkiri, koostisosad, kategooria, lihtne filter
• Mitte-skoop: kasutajakontod, pildigalerii, ostunimekirja eksport
• Kontrolliplaan: lisan kolm retsepti ja vaatan, kas filtriga leiab õige tulemuse

Kuidas näiteid lugeda?

Ära vaata näiteid kui malle, mida peab sõna-sõnalt kopeerima. Vaata neid kui otsuste näiteid.

• Kas kasutaja on piisavalt konkreetne?
• Kas probleem kirjeldab päris olukorda?
• Kas esimene versioon on piisavalt väike?
• Kas mitte-skoop hoiab projekti paisumast?
• Kas kontrolliplaan ütleb, kuidas tulemust proovida?

Halb ja parem algus

Enesekontroll enne projektikaardi täitmist

1. Kas minu projekti saab kirjeldada ühe selge lausega?
2. Kas ma tean, kellele see on mõeldud?
3. Kas probleem kirjeldab päris olukorda, mitte ainult soovi teha veebileht?
4. Kas esimene versioon on piisavalt väike, et seda saaks päriselt proovida?
5. Kas ma oskan öelda, mida ma praegu teadlikult ei ehita?
6. Kas ma tean, kuidas kontrollida, et esimene versioon töötab?

Kokkuvõte

Projektikaart aitab muuta häguse idee kontrollitavaks esimeseks versiooniks. Selle väärtus ei ole pikkuses, vaid selguses.

• Saan aru, mis on projektikaart.
• Näen, miks projektikaart ei ole pikk projektiplaan.
• Saan aru, miks projektikaart toimib esimese kvaliteediväravana.
• Näen, kuidas näidetes on kirjeldatud kasutaja, probleem, esimene versioon, mitte-skoop ja kontrolliplaan.
• Oskan enne täitmist kontrollida, kas minu idee on piisavalt väike.
• Tean, et projektikaardi täidan järgmises peatükis.

Järgmine samm

Järgmises peatükis täidad oma projektikaardi online-vormis. Täidetud kaardi saad kopeerida või PDF-ina alla laadida.