# Tuotevaatimusdokumentin (PRD) pohja

Kuusi linkitettyä asiakirjaa, jotka vievät ominaisuuden ongelmasta julkaisuun: kenelle se on, mitä sen pitää tehdä, miten se kulkee, mistä tiedät sen onnistuneen, ja jokainen päätös matkan varrella. Lataa ne Markdown-tiedostoina: ne aukeavat missä tahansa editorissa, näyttävät kaavionsa GitHubissa ja Obsidianissa ja tuodaan Nodaryyn karttana.

Ilmainen, ei tiliä, ei sähköpostia. Käytä, muokkaa ja jaa vapaasti.

[Lataa pohja (.zip)](https://nodary.ai/downloads/prd-pohja.zip)

## Lue jokainen sivu ennen lataamista

Yleiskatsaus mahtuu yhdelle näytölle ja linkittää viiteen osaan, joten kehitys, suunnittelu ja tuki löytävät kukin oman sivunsa ja muutos pysyy pienenä. Kursivoidut rivit kertovat, mitä kirjoittaa; esimerkit seuraavat yhtä esimerkkiominaisuutta, vanhenevia jakolinkkejä.

- Tuotevaatimusdokumentti: Sivu, jonka kaikki lukevat ensin: ongelma, tavoitteet, mikä kuuluu mukaan ja mikä ei, ja linkki jokaiseen osaan.
- Käyttäjät ja todisteet: Kenelle ominaisuus on, mitä he tekevät nyt ilman sitä ja ongelman taustalla oleva tutkimus.
- Vaatimukset: Mitä ominaisuuden pitää tehdä, jokainen vaatimus prioriteetteineen ja tarkistus, joka sen todistaa.
- Suunnittelu ja käyttäjäpolut: Miten käyttäjä kulkee ominaisuuden läpi: polku, näkymät, tilat ja reunatapaukset.
- Julkaisu ja mittarit: Mistä tiedät, että se toimi, miten se otetaan käyttöön ja mikä saisi sinut perumaan sen.
- Päätökset ja avoimet kysymykset: Jokainen PRD:tä muuttanut päätös, kuka sen teki ja miksi, sekä yhä avoimet kysymykset.

### Tuotevaatimusdokumentti

_Näin käytät pohjaa: kursivoidut rivit ovat ohjeita. Korvaa ne omilla sanoillasi ja poista ne sitten. Hakasulkeissa olevat arvot täytät itse. Pidä tämä sivu yhdellä näytöllä: sen lukee ensin kiireinen lukija, uusi kollega tai tekoälyagentti._

#### Lyhyesti

| Kenttä | Tämä ominaisuus |
| --- | --- |
| Ominaisuus | [Nimi] |
| Yhdellä lauseella | [Mitä käyttäjä voi tehdä julkaisun jälkeen] |
| Tuotteen omistaja | [nimi] |
| Tekninen vastaava | [nimi] |
| Suunnittelun vastaava | [nimi] |
| Tila | [luonnos, tarkistettavana, hyväksytty, julkaistu] |
| Tavoiteversio | [päivämäärä tai versio] |

#### Ongelma

_Kenellä ongelma on, mitä se maksaa nyt ja mistä tiedät sen. Ongelma ilman todisteita on arvaus: linkitä tutkimus kohtaan_ [Käyttäjät ja todisteet](https://nodary.ai/fi/templates/prd#doc-users).

_Esimerkki (esimerkkiominaisuus): Ihmiset jakavat asiakirjan asiakkaalle tarkistettavaksi ja unohtavat sitten, että linkki on olemassa. Kuukausia myöhemmin se aukeaa yhä. Kolme asiakasta kysyi viime neljänneksellä, miten linkin saa lakkaamaan toimimasta tiettynä päivänä._

[Ongelma kahdella tai kolmella lauseella]

#### Tavoitteet ja rajaukset

_Tavoitteet kertovat, mikä muuttuu käyttäjälle, eivät sitä, mitä tiimi rakentaa. Rajaukset ovat päätöksiä, jotka estävät laajuutta kasvamasta huomaamatta._

- Tavoite: [mitä käyttäjä voi tehdä tai mitä hänen ei enää tarvitse tehdä]
- Tavoite: [...]
- Rajaus: [mitä tämä versio jättää tarkoituksella pois]
- Rajaus: [...]

#### Onnistuminen yhdellä rivillä

_Se yksi mittari, joka kuukauden kuluttua julkaisusta kertoo, toimiko tämä. Koko luettelo on kohdassa_ [Julkaisu ja mittarit](https://nodary.ai/fi/templates/prd#doc-launch).

[Mittari] nousee lähtötasosta [lähtöarvo] tasolle [tavoite] mennessä [päivämäärä].

#### PRD:n muut osat

_Jokainen osa on oma asiakirjansa. Linkitä siihen kopioimisen sijaan, jotta jokainen tieto on ja muuttuu yhdessä paikassa._

- [Käyttäjät ja todisteet](https://nodary.ai/fi/templates/prd#doc-users): kenelle ominaisuus on ja ongelman taustalla oleva tutkimus
- [Vaatimukset](https://nodary.ai/fi/templates/prd#doc-requirements): mitä sen pitää tehdä, prioriteetit ja hyväksymiskriteerit
- [Suunnittelu ja käyttäjäpolut](https://nodary.ai/fi/templates/prd#doc-design): käyttäjäpolku, näkymät, tilat ja reunatapaukset
- [Julkaisu ja mittarit](https://nodary.ai/fi/templates/prd#doc-launch): mittarit, julkaisu ja julkaisun tarkistuslista
- [Päätökset ja avoimet kysymykset](https://nodary.ai/fi/templates/prd#doc-decisions): mitä päätettiin, kuka ja miksi, ja mikä on vielä auki

_Pohjaa saa käyttää, muokata ja jakaa vapaasti. Se on peräisin_ [Nodarysta](https://nodary.ai/fi)_, jossa nämä tiedostot tuodaan linkitettyjen asiakirjojen karttana._

### Käyttäjät ja todisteet

**Omistaja:** [nimi] · **Tila:** luonnos · **Viimeksi tarkistettu:** [päivämäärä]

_Kenelle ominaisuus on ja mitä tiedät heistä. Jokaisen väitteen tässä pitää osoittaa lähteeseensä._

#### Kenelle

| Kuka | Mitä hän yrittää tehdä | Mikä on esteenä |
| --- | --- | --- |
| [Pääkäyttäjä] | [...] | [...] |
| [Toissijainen käyttäjä] | [...] | [...] |

_Esimerkki (esimerkkiominaisuus): Asiakkuuspäällikkö jakaa tarjousluonnoksen asiakkaalle viikon kommentointia varten. Nyt hän asettaa muistutuksen linkin sulkemisesta ja unohtaa sen joskus._

#### Nyt, ilman ominaisuutta

_Mitä käyttäjät tekevät nyt, vaihe vaiheelta, kiertotiet mukaan lukien. Kiertotie on usein paras määrittely, jonka saat._

1. [Vaihe]
2. [Vaihe]
3. [Kiertotie]

#### Todisteet

| Lähde | Mitä se kertoo | Päivämäärä | Linkki |
| --- | --- | --- | --- |
| [Asiakashaastattelu] | [...] | [päivämäärä] | [...] |
| [Tukipyynnöt] | [...] | [...] | [...] |
| [Käyttödata] | [...] | [...] | [...] |

#### Avoimet kysymykset

- [ ] [Kysymys], [kuka vastaa], [mihin mennessä]

Katso myös: [Tuotevaatimusdokumentti](https://nodary.ai/fi/templates/prd#doc-overview) · [Vaatimukset](https://nodary.ai/fi/templates/prd#doc-requirements) · [Suunnittelu ja käyttäjäpolut](https://nodary.ai/fi/templates/prd#doc-design)

### Vaatimukset

**Omistaja:** [nimi] · **Tila:** luonnos · **Viimeksi tarkistettu:** [päivämäärä]

_Yksi rivi vaatimusta kohden, kirjoitettuna asiana, jonka käyttäjä voi tehdä. Prioriteetti on pakollinen, tärkeä tai toivottava: versio julkaistaan, kun jokainen pakollinen täyttyy._

#### Käyttäjätarinat

| ID | Roolissa | haluan | jotta | Prioriteetti |
| --- | --- | --- | --- | --- |
| V1 | [käyttäjä] | [...] | [...] | [pakollinen, tärkeä, toivottava] |
| V2 | [...] | [...] | [...] | [...] |
| V3 | [...] | [...] | [...] | [...] |

_Esimerkki (esimerkkiominaisuus): V1. Asiakirjan jakajana haluan valita päivän, jona linkki lakkaa toimimasta, jotta asiakas menettää pääsyn projektin päättyessä. Pakollinen._

#### Hyväksymiskriteerit

_Jokaiselle pakolliselle tarkistukset, jotka todistavat sen toimivan. Kirjoita ne niin, että testaaja tai tekoälyagentti voi ajaa ne kysymättä sinulta._

| Vaatimus | Kun | Ja | Niin |
| --- | --- | --- | --- |
| V1 | [lähtötilanne] | [toiminto] | [tulos, jonka joku voi tarkistaa] |
| V1 | [...] | [...] | [...] |

#### Ei-toiminnalliset vaatimukset

| Alue | Vaatimus |
| --- | --- |
| Suorituskyky | [...] |
| Tietoturva ja yksityisyys | [...] |
| Saavutettavuus | [...] |
| Kielet | [...] |
| Yhteensopivuus | [selaimet, laitteet, versiot] |

#### Laajuuden ulkopuolella

- [Mitä tämä versio ei tee, ja miksi]
- [...]

#### Avoimet kysymykset

- [ ] [Kysymys], [kuka vastaa], [mihin mennessä]

Katso myös: [Käyttäjät ja todisteet](https://nodary.ai/fi/templates/prd#doc-users) · [Suunnittelu ja käyttäjäpolut](https://nodary.ai/fi/templates/prd#doc-design) · [Julkaisu ja mittarit](https://nodary.ai/fi/templates/prd#doc-launch)

### Suunnittelu ja käyttäjäpolut

**Omistaja:** [nimi] · **Tila:** luonnos · **Viimeksi tarkistettu:** [päivämäärä]

_Linkitä suunnittelutiedostot liittämisen sijaan. Pidä tässä polku ja sen taustalla olevat päätökset, jotta teksti ja näkymät eivät koskaan ole ristiriidassa._

#### Käyttäjäpolku

_Pääpolku siitä, mistä käyttäjä aloittaa, siihen, mitä hän saa. Jos tiimi ei osaa piirtää sitä, sitä ei ole vielä päätetty._

```mermaid
flowchart LR
  n0["Aloituskohta"]
  n1["Ensimmäinen toiminto"]
  n2["Keskeinen valinta"]
  n3["Vahvistus"]
  n4["Tulos"]
  n0 --> n1
  n1 --> n2
  n2 --> n3
  n3 --> n4
```
_Pääpolku kohdasta [mistä käyttäjä aloittaa] kohtaan [mitä hän saa]_

#### Näkymät

| Näkymä | Tarkoitus | Suunnittelulinkki | Tila |
| --- | --- | --- | --- |
| [Näkymä] | [...] | [...] | [luonnos, mallikuva, valmis] |
| [Näkymä] | [...] | [...] | [...] |

#### Tilat

_Jokaisella näkymällä on enemmän tiloja kuin onnistunut polku. Rastita jokainen, kun se on suunniteltu, tai kirjoita, miksi sitä ei voi tapahtua._

- [ ] Tyhjä: vielä ei mitään näytettävää
- [ ] Latautuu
- [ ] Virhe, ja mitä käyttäjä voi tehdä seuraavaksi
- [ ] Ei oikeuksia
- [ ] Hidas tai katkennut yhteys
- [ ] Hyvin pitkä teksti ja hyvin suuret luvut

#### Reunatapaukset

| Tapaus | Mitä tapahtuu |
| --- | --- |
| [...] | [...] |
| [...] | [...] |

_Esimerkki (esimerkkiominaisuus): Joku avaa linkin minuutin päättymispäivän jälkeen: hän näkee, että linkki on vanhentunut ja keneltä kysyä, eikä koskaan virhesivua._

#### Avoimet kysymykset

- [ ] [Kysymys], [kuka vastaa], [mihin mennessä]

Katso myös: [Vaatimukset](https://nodary.ai/fi/templates/prd#doc-requirements) · [Julkaisu ja mittarit](https://nodary.ai/fi/templates/prd#doc-launch)

### Julkaisu ja mittarit

**Omistaja:** [nimi] · **Tila:** luonnos · **Viimeksi tarkistettu:** [päivämäärä]

_Yksi päämittari, kaksi tai kolme toissijaista ja yksi suojamittari: jokin, joka ei saa heikentyä päämittarin parantuessa._

#### Mittarit

| Mittari | Laji | Lähtöarvo | Tavoite | Mitataan | Tarkistuspäivä |
| --- | --- | --- | --- | --- | --- |
| [...] | [pää] | [...] | [...] | [...] | [päivämäärä] |
| [...] | [toissijainen] | [...] | [...] | [...] | [...] |
| [...] | [suoja] | [...] | [...] | [...] | [...] |

#### Käyttöönotto

| Vaihe | Kuka sen saa | Päivämäärä | Jatketaan, kun |
| --- | --- | --- | --- |
| [Sisäinen] | [tiimi] | [...] | [...] |
| [Beta] | [...] | [...] | [...] |
| [Kaikki] | [...] | [...] | [...] |

#### Julkaisun tarkistuslista

- [ ] Ohjeartikkeli kirjoitettu
- [ ] Tukitiimi perehdytetty
- [ ] Julkaisutiedote luonnosteltu
- [ ] Analytiikkatapahtumat tarkistettu
- [ ] Peruminen testattu

#### Peruminen

_Mikä saisi sinut sammuttamaan ominaisuuden, ja miten. Päätä se ennen julkaisua, kun kukaan ei ole vielä kiintynyt lopputulokseen._

- Perumme, jos: [...]
- Miten: [lippu, versio, skripti]
- Kuka päättää: [nimi]

Katso myös: [Tuotevaatimusdokumentti](https://nodary.ai/fi/templates/prd#doc-overview) · [Vaatimukset](https://nodary.ai/fi/templates/prd#doc-requirements) · [Päätökset ja avoimet kysymykset](https://nodary.ai/fi/templates/prd#doc-decisions)

### Päätökset ja avoimet kysymykset

**Omistaja:** [nimi] · **Tila:** luonnos · **Viimeksi tarkistettu:** [päivämäärä]

_Kun päätös muuttaa PRD:tä, lisää tähän rivi ja päivitä sivu, jota se koskee. Loki kertoo miksi; sivu kertoo, mikä pätee nyt._

#### Päätösloki

| Päivämäärä | Päätös | Päättäjä | Miksi | Muutettu sivu |
| --- | --- | --- | --- | --- |
| [päivämäärä] | [...] | [...] | [...] | [...] |

_Esimerkki (esimerkkiominaisuus): Linkit toimivat viimeisen päivänsä loppuun omistajan aikavyöhykkeellä, eivät UTC-keskiyöhön. Päättäjinä tuotteen omistaja ja tekninen vastaava, koska betassa muiden aikavyöhykkeiden asiakkaat menettivät pääsyn päivää liian aikaisin. Muutettu sivu: Vaatimukset._

#### Avoimet kysymykset

| Kysymys | Kuka vastaa | Mihin mennessä | Vastaus |
| --- | --- | --- | --- |
| [...] | [nimi] | [päivämäärä] | [...] |

Katso myös: [Tuotevaatimusdokumentti](https://nodary.ai/fi/templates/prd#doc-overview) · [Vaatimukset](https://nodary.ai/fi/templates/prd#doc-requirements) · [Julkaisu ja mittarit](https://nodary.ai/fi/templates/prd#doc-launch)

## Näin käytät sitä

### Kirjoita ongelma ennen ratkaisua

Täytä ensin yleiskatsauksen ongelma, tavoitteet ja rajaukset yhdessä ominaisuuden rakentavan kehittäjän ja suunnittelijan kanssa. Jos te kolme ette ole samaa mieltä ongelmasta, pysähtykää siihen.

### Tee jokaisesta pakollisesta testattava

Anna jokaiselle pakolliselle vaatimukselle hyväksymiskriteerit, jotka joku muu voi tarkistaa. Vaatimus, jota kukaan ei voi testata, on toive.

### Pyydä tarkistus ja pidä se totena

Pyydä tarkistusta, kun vaatimukset ovat valmiit, ja päivitä PRD, kun päätös muuttaa niitä. Aloitukseen jäänyt PRD on julkaisussa väärässä.

### Kirjaa, mikä muuttui ja miksi

Jokainen päätös menee päätöslokiin tekijänsä kanssa. Kun joku kysyy, miksi ominaisuus toimii näin, vastaus on yhden linkin päässä.

## Tuo se Nodaryyn karttana

Nodary on tekoälylle rakennettu työtila, jossa tiimin asiakirjat linkittyvät sen sijaan, että ne kasautuisivat. Tuo .zip, niin PRD saapuu viiden osansa kanssa, sivujen väliset linkit säilyvät ja kaavio piirretään. Merkitse se tarkistettavaksi ja pyydä työtilan tai projektin omistajaa tai ylläpitäjää hyväksymään se, katso, mikä on muuttunut edellisen käyntisi jälkeen, ja anna MCP:n kautta yhdistettyjen tekoälyagenttien lukea vaatimukset ennen kuin ne kirjoittavat koodia.

1. Avaa projektin kartta ja valitse Tuo.
2. Valitse välilehti ”Kansio tai ZIP” ja sitten ”Valitse ZIP-tiedosto”.
3. Valitse ladattu tiedosto, tarkista puurakenne ja aloita tuonti.

Free-paketissa on kymmenen asiakirjaa työtilaa kohden projektin oma sivu mukaan lukien: pohjan kuusi mahtuvat uuteen työtilaan, ja tilaa jää kolmelle lisää. Nodaryssa on myös sisäänrakennettu yhden sivun tuotemäärittely (PRD).

## PRD, jota tiimi oikeasti käyttää

PRD epäonnistuu kahdella tavalla: se kuvaa ratkaisun, jota kukaan ei kyseenalaistanut, tai sen päivittäminen loppuu aloituksen jälkeen. Nämä tavat estävät molemmat.

### Aloita ongelmasta

Kirjoita, kenellä ongelma on ja mitä se hänelle maksaa, ennen mitään ratkaisua. Ongelmasta yksimieliset tiimit riitelevät vähemmän näkymistä.

### Kerro, mitä et tee

Rajauksetkin ovat päätöksiä. Niiden kirjaaminen estää ominaisuutta kasvamasta viikko kerrallaan.

### Tee vaatimuksista testattavia

”Nopea” ja ”helppo” eivät ole tarkistettavissa. ”Linkki lakkaa aukeamasta minuutin kuluessa päättymispäivästä” voidaan rakentaa ja testata.

### Priorisoi: pakollinen, tärkeä, toivottava

Versio julkaistaan, kun jokainen pakollinen täyttyy. Tärkeä ja toivottava ovat se, mistä joustetaan päivän lähestyessä.

### Linkitä todisteet

Jokainen väite käyttäjistä linkittää haastatteluun, tikettiin tai dataan, jolla se perustellaan, jotta tarkistaja voi varmistaa sen eikä vain uskoa.

### Pidä se elävänä

Päivitä PRD, kun päätös muuttaa sitä, ja kirjaa miksi. Lopuksi sen pitää kuvata se, mikä julkaistiin, ei sitä, mitä ensimmäisellä viikolla suunniteltiin.

## Kysymyksiä PRD:stä

### Mikä on PRD?

Tuotevaatimusdokumentti (product requirements document, PRD) kuvaa ominaisuuden tai tuotteen ennen sen rakentamista: ratkaistavan ongelman, kenelle se on, mitä sen pitää tehdä, miten onnistumista mitataan ja mikä jää ulkopuolelle. Yleensä siitä vastaa tuotepäällikkö; kehittäjät, suunnittelijat, tuki ja yhä useammin koodia kirjoittavat tekoälyagentit lukevat sitä.

### Mitä PRD:n pitää sisältää?

Vähintään ongelman ja sen todisteet, tavoitteet ja rajaukset, käyttäjät, priorisoidut vaatimukset hyväksymiskriteereineen, tärkeimmät käyttäjäpolut ja reunatapaukset, onnistumisen mittarit, julkaisusuunnitelman sekä lokin päätöksistä ja avoimista kysymyksistä. Tässä pohjassa on asiakirja jokaiselle ryhmälle.

### Kuinka pitkä PRD:n pitäisi olla?

Niin pitkä, että tiimi voi rakentaa ja testata ominaisuuden kysymättä sinulta samaa asiaa kahdesti. Yleiskatsauksen pitää mahtua yhdelle näytölle; vaatimukset kasvavat päätösten, eivät ideoiden mukana.

### Mitä eroa on PRD:llä ja teknisellä suunnitteludokumentilla?

PRD kertoo, mitä ominaisuuden pitää tehdä ja miksi. Tekninen suunnitteludokumentti kertoo, miten järjestelmä sen tekee: arkkitehtuuri, data, rajapinnat ja riskit. Kirjoita ensin PRD ja linkitä sitten ne yhteen.

### Voivatko tekoälyagentit käyttää PRD:tä?

Kyllä. Linkitetyistä asiakirjoista koostuva PRD antaa agentille sen tarvitseman kontekstin. Nodaryssa MCP:n kautta yhdistetyt agentit, kuten Claude, ChatGPT tai Cursor, lukevat vaatimukset ja päätöslokin sinun oikeuksillasi ennen kuin kirjoittavat.

### Voinko käyttää pohjaa Nodaryn ulkopuolella?

Kyllä. Tiedostot ovat tavallista Markdownia: Obsidian avaa puretun kansion holvina, jossa kaikki linkit toimivat, ja GitHub näyttää tiedostot kaavioineen. Työkalut, jotka tuovat Markdownia tiedosto kerrallaan, säilyttävät tekstin ja taulukot; tarkista, miten ne käsittelevät tiedostojen välisiä linkkejä.

Sivu: https://nodary.ai/fi/templates/prd
